bradleyross.library.helpers

Class ExceptionHelper

java.lang.Object

bradleyross.library.helpers.ExceptionHelper

public class ExceptionHelper
extends Object

An attempt to write a generic exception logger that will provide both the location of the exception and the location of the log request.

The following is a sample log using this class.

 2015-11-29 19:21:03,278 INFO  [SQLExample] -       Database is now open
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:92)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)

 2015-11-29 19:21:03,279 INFO  [SQLExample] -       First statement is SELECT STATE, NAME FROM STATE
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:93)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)

 2015-11-29 19:21:03,280 INFO  [SQLExample] -       Statement created
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:96)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)

 2015-11-29 19:21:03,288 INFO  [SQLExample] -       ResultSet created
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:98)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,291 INFO  [SQLExample] -       Second statement is SELECT STATE, NAME FROM NOTTHERE
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:120)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,292 INFO  [SQLExample] -       Statement created
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:123)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,302 ERROR [SQLExample] -       Problem with second statement
    Subclass of SQLException
    Location of exception
       com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: Table 'sample.notthere' doesn't exist
        at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
        at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57)
        at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
        at java.lang.reflect.Constructor.newInstance(Constructor.java:526)
        at com.mysql.jdbc.Util.handleNewInstance(Util.java:408)
        at com.mysql.jdbc.Util.getInstance(Util.java:383)
        at com.mysql.jdbc.SQLError.createSQLException(SQLError.java:1062)
        at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4208)
        at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4140)
        at com.mysql.jdbc.MysqlIO.sendCommand(MysqlIO.java:2597)
        at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:2758)
        at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2820)
        at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2769)
        at com.mysql.jdbc.StatementImpl.executeQuery(StatementImpl.java:1569)
        at bradleyross.library.debugging.SQLExample.run(SQLExample.java:124)
        at bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
    Exception is subclass of SQLException
    Vendor specific error code is 1146
    SQL State is 42S02
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.error(ExceptionHelper.java:273)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:131)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,303 INFO  [SQLExample] -       Third statement is SELECT STATE, NAME, NOTTHERE FROM STATE
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:144)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,303 INFO  [SQLExample] -       Statement created
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:147)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:21:03,304 ERROR [SQLExample] -       Problem with third statement
    Subclass of SQLException
    Location of exception
       com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: Unknown column 'NOTTHERE' in 'field list'
        at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
        at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57)
        at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
        at java.lang.reflect.Constructor.newInstance(Constructor.java:526)
        at com.mysql.jdbc.Util.handleNewInstance(Util.java:408)
        at com.mysql.jdbc.Util.getInstance(Util.java:383)
        at com.mysql.jdbc.SQLError.createSQLException(SQLError.java:1062)
        at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4208)
        at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4140)
        at com.mysql.jdbc.MysqlIO.sendCommand(MysqlIO.java:2597)
        at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:2758)
        at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2820)
        at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2769)
        at com.mysql.jdbc.StatementImpl.executeQuery(StatementImpl.java:1569)
        at bradleyross.library.debugging.SQLExample.run(SQLExample.java:148)
        at bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
    Exception is subclass of SQLException
    Vendor specific error code is 1054
    SQL State is 42S22
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.error(ExceptionHelper.java:273)
            bradleyross.library.debugging.SQLExample.run(SQLExample.java:155)
            bradleyross.library.debugging.SQLExample.main(SQLExample.java:177)
 
 2015-11-29 19:22:29,874 INFO  [test3] - Starting test with log4j
 2015-11-29 19:22:29,876 INFO  [test3] -       Trap and throw in level 2 - level info
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:592)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
 
 2015-11-29 19:22:29,876 WARN  [test3] -       Trap and throw in level 2 - level warn
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.warn(ExceptionHelper.java:323)
            bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:593)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
 
 2015-11-29 19:22:29,877 INFO  [test3] -       Trapping in method level1
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:584)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
 
 2015-11-29 19:22:29,878 INFO  [test3] -       Trapping in method run
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:577)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:641)
 
 2015-11-29 19:22:29,878 INFO  [ExceptionHelper] -       Starting test with org.slf4j
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:379)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:643)
 
 2015-11-29 19:22:29,879 INFO  [ExceptionHelper] -       Trap and throw in level 2 - level info
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:592)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
 
 2015-11-29 19:22:29,879 WARN  [ExceptionHelper] -       Trap and throw in level 2 - level warn
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.warn(ExceptionHelper.java:323)
            bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:593)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
 
 2015-11-29 19:22:29,880 INFO  [ExceptionHelper] -       Trapping in method level1
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:584)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
 
 2015-11-29 19:22:29,881 INFO  [ExceptionHelper] -       Trapping in method run
    Location of exception
       java.io.IOException: Triggering IOException
        at bradleyross.library.helpers.ExceptionHelper$Tester.level3(ExceptionHelper.java:598)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level2(ExceptionHelper.java:590)
        at bradleyross.library.helpers.ExceptionHelper$Tester.level1(ExceptionHelper.java:582)
        at bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:575)
        at bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
    Location where log statement called
            java.lang.Thread.getStackTrace(Thread.java:1589)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:123)
            bradleyross.library.helpers.ExceptionHelper.logException(ExceptionHelper.java:168)
            bradleyross.library.helpers.ExceptionHelper.info(ExceptionHelper.java:372)
            bradleyross.library.helpers.ExceptionHelper$Tester.run(ExceptionHelper.java:577)
            bradleyross.library.helpers.ExceptionHelper.main(ExceptionHelper.java:645)
 

Author:

Bradley Ross

See Also:

ExceptionProcessor, SQLExample

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ExceptionHelper.DummyExceptionProcessor An implementation of ExceptionProcessor can be used to customize the log messages for various types of exceptions.
protected class	ExceptionHelper.Tester Demonstrates many of the features of the ExceptionHelper class.

Field Summary

Fields

Modifier and Type	Field and Description
protected Logger	apacheLogger Logger for use with log4j 1.x logging framework API.
static int	DEBUG
static int	ERROR
protected ExceptionProcessor	extra This object can be used to provide extra processing of various exception subclasses.
static int	FATAL
static int	INFO
protected Logger	log4j2Logger Logger for use with log4j 2 logging framework API.
protected Logger	slf4jLogger Logger for use with slf4j logging framework API.
static int	TRACE
static int	WARN

Constructor Summary

Constructors

Constructor and Description
ExceptionHelper(Logger logger) Constructor for working with log4j 1 logging framework API.
ExceptionHelper(Logger logger) Constructor for working with slf4j logging framework API.
ExceptionHelper(Logger logger) Constructor for working with log4j 2 logging framework API.

Method Summary

Modifier and Type	Method and Description
protected void	apache2Log(int level, String message, Exception e)
protected void	apacheLog(int level, String message, Exception e)
void	debug(List<String> strings) Helper method for debug messages.
void	debug(List<String> strings, Exception e) Helper method for debug messages.
void	debug(String string) Helper method for debug messages.
void	debug(String[] strings) Helper method for debug messages.
void	debug(String[] strings, Exception e) Helper method for debug messages.
void	debug(String string, Exception e) Helper method for debug messages.
void	error(List<String> strings) Helper method for error messages.
void	error(List<String> strings, Exception e) Helper method for error messages.
void	error(String string) Helper method for error messages.
void	error(String[] strings) Helper method for error messages.
void	error(String[] strings, Exception e) Helper method for error messages.
void	error(String string, Exception e) Helper method for error messages.
void	fatal(List<String> strings) Helper method for fatal messages.
void	fatal(List<String> strings, Exception e) Helper method for fatal messages.
void	fatal(String string) Helper method for fatal messages.
void	fatal(String[] strings) Helper method for fatal messages.
void	fatal(String[] strings, Exception e) Helper method for fatal messages.
void	fatal(String string, Exception e) Helper method for fatal messages.
void	info(List<String> strings) Helper method for info messages.
void	info(List<String> strings, Exception e) Helper method for info messages.
void	info(String string) Helper method for info messages.
void	info(String[] strings) Helper method for info messages.
void	info(String[] strings, Exception e) Helper method for info messages.
void	info(String string, Exception e) Helper method for info messages.
protected void	logException(int level, List<String> value, Exception e)
void	logException(int level, String string, Exception e)
static void	main(String[] params) Test driver.
protected void	printList(List<String> list)
protected void	printList(List<String> list, PrintStream out) Internal debugging aid for printing list of strings.
void	setExceptionProcessor(ExceptionProcessor value) Setter for extra allowing additional features to be added.
protected void	slf4jLog(int level, String message, Exception e)
protected List<String>	splitLines(List<String> start)
List<String>	splitLines(List<String> start, int indent)
protected List<String>	splitLines(String start)
void	trace(List<String> strings) Helper method for trace messages.
void	trace(List<String> strings, Exception e) Helper method for trace messages.
void	trace(String string) Helper method for trace messages.
void	trace(String[] strings) Helper method for trace messages.
void	trace(String[] strings, Exception e) Helper method for trace messages.
void	trace(String string, Exception e) Helper method for trace messages.
void	warn(List<String> strings) Helper method for warn messages.
void	warn(List<String> strings, Exception e) Helper method for warn messages.
void	warn(String string) Helper method for warn messages.
void	warn(String[] strings) Helper method for warn messages.
void	warn(String[] strings, Exception e) Helper method for warn messages.
void	warn(String string, Exception e) Helper method for warn messages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FATAL

public static final int FATAL

See Also:

Constant Field Values

ERROR

public static final int ERROR

See Also:

Constant Field Values

WARN

public static final int WARN

See Also:

Constant Field Values

INFO

public static final int INFO

See Also:

Constant Field Values

DEBUG

public static final int DEBUG

See Also:

Constant Field Values

TRACE

public static final int TRACE

See Also:

Constant Field Values

apacheLogger

protected Logger apacheLogger

Logger for use with log4j 1.x logging framework API.

slf4jLogger

protected Logger slf4jLogger

Logger for use with slf4j logging framework API.

log4j2Logger

protected Logger log4j2Logger

Logger for use with log4j 2 logging framework API.

extra

protected ExceptionProcessor extra

This object can be used to provide extra processing of various exception subclasses.

Constructor Detail

ExceptionHelper

public ExceptionHelper(Logger logger)

Constructor for working with log4j 1 logging framework API.

Parameters:

logger - Logger object to which messages will be passed.

ExceptionHelper

public ExceptionHelper(Logger logger)

Constructor for working with slf4j logging framework API.

Parameters:

logger - Logger object to which messages will be sent.

ExceptionHelper

public ExceptionHelper(Logger logger)

Constructor for working with log4j 2 logging framework API.

Parameters:

logger - Logger object to which messages will be sent.

Method Detail

setExceptionProcessor

public void setExceptionProcessor(ExceptionProcessor value)

Setter for extra allowing additional features to be added.

Parameters:

value - object to be used for extra processing

logException

protected void logException(int level,
                            List<String> value,
                            Exception e)

logException

public void logException(int level,
                         String string,
                         Exception e)

apacheLog

protected void apacheLog(int level,
                         String message,
                         Exception e)

apache2Log

protected void apache2Log(int level,
                          String message,
                          Exception e)

slf4jLog

protected void slf4jLog(int level,
                        String message,
                        Exception e)

fatal

public void fatal(String string,
                  Exception e)

Helper method for fatal messages.

Parameters:

string - messages

e - exception

fatal

public void fatal(String string)

Helper method for fatal messages.

Parameters:

string - message

fatal

public void fatal(List<String> strings,
                  Exception e)

Helper method for fatal messages.

Parameters:

strings - messages

e - exception

fatal

public void fatal(List<String> strings)

Helper method for fatal messages.

Parameters:

strings - messages

fatal

public void fatal(String[] strings,
                  Exception e)

Helper method for fatal messages.

Parameters:

strings - messages

e - exception

fatal

public void fatal(String[] strings)

Helper method for fatal messages.

Parameters:

strings - messages

error

public void error(String string,
                  Exception e)

Helper method for error messages.

Parameters:

string - message

e - exception

error

public void error(String string)

Helper method for error messages.

Parameters:

string - message

error

public void error(List<String> strings,
                  Exception e)

Helper method for error messages.

Parameters:

strings - messages

e - exception

error

public void error(List<String> strings)

Helper method for error messages.

Parameters:

strings - messages

error

public void error(String[] strings,
                  Exception e)

Helper method for error messages.

Parameters:

strings - messages

e - exception

error

public void error(String[] strings)

Helper method for error messages.

Parameters:

strings - messages

warn

public void warn(String string,
                 Exception e)

Helper method for warn messages.

Parameters:

string - messages

e - exception

warn

public void warn(String string)

Helper method for warn messages.

Parameters:

string - message

warn

public void warn(List<String> strings,
                 Exception e)

Helper method for warn messages.

Parameters:

strings - messages

e - exception

warn

public void warn(List<String> strings)

Helper method for warn messages.

Parameters:

strings - messages

warn

public void warn(String[] strings,
                 Exception e)

Helper method for warn messages.

Parameters:

strings - messages

e - exception

warn

public void warn(String[] strings)

Helper method for warn messages.

Parameters:

strings - messages

info

public void info(String string,
                 Exception e)

Helper method for info messages.

Parameters:

string - message

e - exception

info

public void info(String string)

Helper method for info messages.

Parameters:

string - message

info

public void info(List<String> strings,
                 Exception e)

Helper method for info messages.

Parameters:

strings - messages

e - exception

info

public void info(List<String> strings)

Helper method for info messages.

Parameters:

strings - messages

info

public void info(String[] strings,
                 Exception e)

Helper method for info messages.

Parameters:

strings - messages

e - exception

info

public void info(String[] strings)

Helper method for info messages.

Parameters:

strings - messages

debug

public void debug(String string,
                  Exception e)

Helper method for debug messages.

Parameters:

string - messages

e - exception

debug

public void debug(String string)

Helper method for debug messages.

Parameters:

string - message

debug

public void debug(List<String> strings,
                  Exception e)

Helper method for debug messages.

Parameters:

strings - messages

e - exception

debug

public void debug(List<String> strings)

Helper method for debug messages.

Parameters:

strings - messages

debug

public void debug(String[] strings,
                  Exception e)

Helper method for debug messages.

Parameters:

strings - messages

e - exception

debug

public void debug(String[] strings)

Helper method for debug messages.

Parameters:

strings - messages

trace

public void trace(String string,
                  Exception e)

Helper method for trace messages.

Parameters:

string - message

e - exception

trace

public void trace(String string)

Helper method for trace messages.

Parameters:

string - message

trace

public void trace(List<String> strings,
                  Exception e)

Helper method for trace messages.

Parameters:

strings - messages

e - exception

trace

public void trace(List<String> strings)

Helper method for trace messages.

Parameters:

strings - messages

trace

public void trace(String[] strings,
                  Exception e)

Helper method for trace messages.

Parameters:

strings - messages

e - exception

trace

public void trace(String[] strings)

Helper method for trace messages.

Parameters:

strings - messages

splitLines

protected List<String> splitLines(List<String> start)
                           throws IOException

Throws:

IOException

splitLines

public List<String> splitLines(List<String> start,
                               int indent)
                        throws IOException

Throws:

IOException

splitLines

protected List<String> splitLines(String start)
                           throws IOException

Throws:

IOException

printList

protected void printList(List<String> list,
                         PrintStream out)

Internal debugging aid for printing list of strings.

Parameters:

list - list to be printed

out - destination for printing

printList

protected void printList(List<String> list)

main

public static void main(String[] params)

Test driver.

Log4j or Slf4j must be set up separately so that this code will work.

Parameters:

params - - not used