oracle.toplink.logging
Class JavaLog

java.lang.Object
  oracle.toplink.logging.AbstractSessionLog
      oracle.toplink.logging.JavaLog

All Implemented Interfaces:

java.lang.Cloneable, SessionLog

public class JavaLog
extends AbstractSessionLog

This is a wrapper class for java.util.logging. It is used when messages need to be logged through java.util.logging.

See Also:

SessionLog, AbstractSessionLog, SessionLogEntry, Session

Field Summary

static java.lang.String	DEFAULT_TOPLINK_NAMESPACE
static java.lang.String	SESSION_TOPLINK_NAMESPACE
static java.lang.String	TOPLINK_NAMESPACE Stores the default session name in case there is the session name is missing.

Fields inherited from interface oracle.toplink.logging.SessionLog

ALL, ALL_LABEL, CONFIG, CONFIG_LABEL, FINE, FINE_LABEL, FINER, FINER_LABEL, FINEST, FINEST_LABEL, INFO, INFO_LABEL, OFF_LABEL, SEVERE, SEVERE_LABEL, WARNING, WARNING_LABEL

Fields inherited from interface oracle.toplink.sessions.SessionLog

CACHE, CONNECTION, DMS, EJB, EJB_OR_METADATA, EVENT, loggerCatagories, OFF, PROPAGATION, PROPERTIES, QUERY, SEQUENCING, SERVER, SQL, TRANSACTION, WEAVER

Method Summary

int	getLevel(java.lang.String category) Return the effective log level for the name space extracted from session and category.
void	log(SessionLogEntry entry) Log a SessionLogEntry
void	setLevel(int level, java.lang.String category) Set the log level to a logger with name space extracted from the given category.
void	setSession(Session session) Set the session and session namespace.
void	setWriter(java.io.OutputStream fileOutputStream) Set the output stream that will receive the formatted log entries.
boolean	shouldLog(int level, java.lang.String category) Check if a message of the given level would actually be logged by the logger with name space built from the given session and category.
void	throwing(java.lang.Throwable throwable) Log a throwable.

Methods inherited from class oracle.toplink.logging.AbstractSessionLog

config, fine, finer, finest, getDateFormat, getDefaultLoggingLevel, getLevel, getLevelString, getLog, getSession, getWriter, info, log, log, log, log, log, log, log, logThrowable, setDateFormat, setLevel, setLog, setShouldLogDebug, setShouldLogExceptions, setShouldLogExceptionStackTrace, setShouldPrintConnection, setShouldPrintDate, setShouldPrintSession, setShouldPrintThread, setWriter, severe, shouldLog, shouldLogDebug, shouldLogExceptions, shouldLogExceptionStackTrace, shouldPrintConnection, shouldPrintDate, shouldPrintSession, shouldPrintThread, warning

Methods inherited from class java.lang.Object

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

Field Detail

TOPLINK_NAMESPACE

public static final java.lang.String TOPLINK_NAMESPACE

Description copied from class: JavaLog

Stores the default session name in case there is the session name is missing.

See Also:

Constant Field Values

DEFAULT_TOPLINK_NAMESPACE

public static final java.lang.String DEFAULT_TOPLINK_NAMESPACE

See Also:

Constant Field Values

SESSION_TOPLINK_NAMESPACE

public static final java.lang.String SESSION_TOPLINK_NAMESPACE

See Also:

Constant Field Values

Method Detail

getLevel

public int getLevel(java.lang.String category)

Return the effective log level for the name space extracted from session and category. If a Logger's level is set to be null then the Logger will use an effective Level that will be obtained by walking up the parent tree and using the first non-null Level.

Specified by:

getLevel in interface SessionLog

Overrides:

getLevel in class AbstractSessionLog

Parameters:

category - the string representation of a TopLink category, e.g. "sql", "transaction" ...

Returns:

the effective log level.

setLevel

public void setLevel(int level,
                     java.lang.String category)

Set the log level to a logger with name space extracted from the given category.

Specified by:

setLevel in interface SessionLog

Overrides:

setLevel in class AbstractSessionLog

Parameters:

level - the new log level

category - the string representation of a TopLink category, e.g. "sql", "transaction" ...

setWriter

public void setWriter(java.io.OutputStream fileOutputStream)

Set the output stream that will receive the formatted log entries.

Overrides:

setWriter in class AbstractSessionLog

Parameters:

fileOutputStream - the file output stream will receive the formatted log entries.

setSession

public void setSession(Session session)

Set the session and session namespace.

Specified by:

setSession in interface SessionLog

Overrides:

setSession in class AbstractSessionLog

Parameters:

session - a Session

shouldLog

public boolean shouldLog(int level,
                         java.lang.String category)

Check if a message of the given level would actually be logged by the logger with name space built from the given session and category. Return the shouldLog for the given category from

Specified by:

shouldLog in interface SessionLog

Overrides:

shouldLog in class AbstractSessionLog

Parameters:

level - the log request level

category - the string representation of a TopLink category, e.g. "sql", "transaction" ...*

Returns:

true if the given message level will be logged

log

public void log(SessionLogEntry entry)

Log a SessionLogEntry

Specified by:

log in interface SessionLog

Specified by:

log in class AbstractSessionLog

Parameters:

entry - SessionLogEntry that holds all the information for a TopLink logging event

throwing

public void throwing(java.lang.Throwable throwable)

Log a throwable.

Specified by:

throwing in interface SessionLog

Overrides:

throwing in class AbstractSessionLog

Parameters:

throwable - a throwable