Package de.uniks.networkparser

Class NetworkParserLog

java.lang.Object

java.util.logging.Handler

de.uniks.networkparser.NetworkParserLog

public class NetworkParserLog
extends java.util.logging.Handler

A simple logging interface abstracting logging APIs. In order to be instantiated successfully by Apache Common Logging, classes that implement this interface must have a constructor that takes a single String parameter representing the "name" of this Log.

The six logging levels used by Log are (in order):

1. trace (the least serious)
2. debug
3. info
4. warn
5. error
6. fatal (the most serious)

The mapping of these log levels to the concepts used by the underlying logging system is implementation dependent. The implementation should ensure, though, that this ordering behaves as expected.

Performance is often a logging concern. By examining the appropriate property, a component can avoid expensive operations (producing information to be logged).

For example, if (log.isDebugEnabled()) { ... do something expensive ... log.debug(theResult); }

Configuration of the underlying logging system will generally be done external to the Logging APIs, through whatever mechanism is supported by that system.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	DEBUG
static java.lang.String	ERROR
static java.lang.String	ERROR_TYP_CONCURRENTMODIFICATION
static java.lang.String	ERROR_TYP_DUPPLICATE
static java.lang.String	ERROR_TYP_NOCREATOR
static java.lang.String	ERROR_TYP_PARSING
static java.lang.String	FATAL
static java.lang.String	INFO
static java.lang.String	LOG
static byte	LOGLEVEL_ALL
static byte	LOGLEVEL_DEBUG
static byte	LOGLEVEL_ERROR
static byte	LOGLEVEL_FATAL
static byte	LOGLEVEL_INFO
static byte	LOGLEVEL_TRACE
static byte	LOGLEVEL_WARNING
static java.lang.String	TRACE
static java.lang.String	WARNING

Constructor Summary

Constructors

Constructor	Description
NetworkParserLog()

Method Summary

Modifier and Type	Method	Description
void	close()
static NetworkParserLog	createLogger(byte flag, boolean removeConsoleHandler, ObjectCondition... conditions)
boolean	debug(java.lang.Object owner, java.lang.String method, java.lang.String message)	Log a message with debug log level.
boolean	error(java.lang.Object owner, java.lang.String method, java.lang.String message, java.lang.Object... params)	Log a message with error log level.
void	flush()
boolean	info(java.lang.Object owner, java.lang.String method, java.lang.String message, java.lang.Object... params)	Log a message with info log level.
boolean	isLevel(byte logLevel)
boolean	log(java.lang.Object owner, java.lang.String method, java.lang.String msg, int level, java.lang.Object... params)
boolean	print(java.lang.Object owner, LogItem item)
void	publish(java.util.logging.LogRecord record)
void	trace(java.lang.Object owner, java.lang.String method, java.lang.String message, java.lang.Object... params)
boolean	warn(java.lang.Object owner, java.lang.String method, java.lang.String message, java.lang.Object... params)	Log a message with warn log level.
NetworkParserLog	withFlag(byte flag)
NetworkParserLog	withListener(ObjectCondition condition)
NetworkParserLog	withoutFlag(byte flag)

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_TYP_PARSING

public static final java.lang.String ERROR_TYP_PARSING

See Also:

Constant Field Values

ERROR_TYP_CONCURRENTMODIFICATION

public static final java.lang.String ERROR_TYP_CONCURRENTMODIFICATION

See Also:

Constant Field Values

ERROR_TYP_NOCREATOR

public static final java.lang.String ERROR_TYP_NOCREATOR

See Also:

Constant Field Values

ERROR_TYP_DUPPLICATE

public static final java.lang.String ERROR_TYP_DUPPLICATE

See Also:

Constant Field Values

LOGLEVEL_TRACE

public static final byte LOGLEVEL_TRACE

See Also:

Constant Field Values

LOGLEVEL_DEBUG

public static final byte LOGLEVEL_DEBUG

See Also:

Constant Field Values

LOGLEVEL_INFO

public static final byte LOGLEVEL_INFO

See Also:

Constant Field Values

LOGLEVEL_WARNING

public static final byte LOGLEVEL_WARNING

See Also:

Constant Field Values

LOGLEVEL_ERROR

public static final byte LOGLEVEL_ERROR

See Also:

Constant Field Values

LOGLEVEL_FATAL

public static final byte LOGLEVEL_FATAL

See Also:

Constant Field Values

LOGLEVEL_ALL

public static final byte LOGLEVEL_ALL

See Also:

Constant Field Values

TRACE

public static final java.lang.String TRACE

See Also:

Constant Field Values

DEBUG

public static final java.lang.String DEBUG

See Also:

Constant Field Values

INFO

public static final java.lang.String INFO

See Also:

Constant Field Values

WARNING

public static final java.lang.String WARNING

See Also:

Constant Field Values

ERROR

public static final java.lang.String ERROR

See Also:

Constant Field Values

FATAL

public static final java.lang.String FATAL

See Also:

Constant Field Values

LOG

public static final java.lang.String LOG

See Also:

Constant Field Values

Constructor Detail

NetworkParserLog

public NetworkParserLog()

Method Detail

debug

public boolean debug(java.lang.Object owner,
                     java.lang.String method,
                     java.lang.String message)

Log a message with debug log level.

Parameters:

owner - The Element with call the Methods

method - The Caller-Method

message - log this message

Returns:

if method must Cancel

print

public boolean print(java.lang.Object owner,
                     LogItem item)

info

public boolean info(java.lang.Object owner,
                    java.lang.String method,
                    java.lang.String message,
                    java.lang.Object... params)

Log a message with info log level.

Parameters:

owner - The Element with call the Methods

method - The Caller-Method

message - log this message

params - advanced Information

Returns:

boolean if method must Cancel

withFlag

public NetworkParserLog withFlag(byte flag)

withoutFlag

public NetworkParserLog withoutFlag(byte flag)

warn

public boolean warn(java.lang.Object owner,
                    java.lang.String method,
                    java.lang.String message,
                    java.lang.Object... params)

Log a message with warn log level.

Parameters:

owner - The Element with call the Methods

method - The Caller-Method

message - log this message

params - advanced Information

Returns:

boolean if method must Cancel

error

public boolean error(java.lang.Object owner,
                     java.lang.String method,
                     java.lang.String message,
                     java.lang.Object... params)

Log a message with error log level.

Parameters:

owner - The Element with call the Methods

method - The Caller-Method

message - Typ of Log Value

params - advanced Information

Returns:

boolean if method must Cancel

log

public boolean log(java.lang.Object owner,
                   java.lang.String method,
                   java.lang.String msg,
                   int level,
                   java.lang.Object... params)

withListener

public NetworkParserLog withListener(ObjectCondition condition)

publish

public void publish(java.util.logging.LogRecord record)

Specified by:

publish in class java.util.logging.Handler

trace

public void trace(java.lang.Object owner,
                  java.lang.String method,
                  java.lang.String message,
                  java.lang.Object... params)

flush

public void flush()

Specified by:

flush in class java.util.logging.Handler

close

public void close()
           throws java.lang.SecurityException

Specified by:

close in class java.util.logging.Handler

Throws:

java.lang.SecurityException

createLogger

public static NetworkParserLog createLogger(byte flag,
                                            boolean removeConsoleHandler,
                                            ObjectCondition... conditions)

isLevel

public boolean isLevel(byte logLevel)