org.eclipse.persistence.logging

Class DefaultSessionLog

java.lang.Object

org.eclipse.persistence.logging.AbstractSessionLog

org.eclipse.persistence.logging.DefaultSessionLog

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, SessionLog

public class DefaultSessionLog
extends AbstractSessionLog
implements java.io.Serializable

Purpose: Default log used for the session when message logging is enabled. The session can log information such as,

• all SQL executed
• informational messages
• debugging information
• all exceptions that occur within TopLink

As well information about the message can be logged such as,

• the session logging the message
• the connection executing the SQL
• the thread in which the log entry occurred
• the exact time (to milliseconds) that the log entry occurred
• the stack trace to the exception

Author:

Big Country

See Also:

SessionLog, AbstractSessionLog, Serialized Form

Field Summary

Fields inherited from interface org.eclipse.persistence.logging.SessionLog

ALL, ALL_LABEL, CACHE, CONFIG, CONFIG_LABEL, CONNECTION, DDL, DMS, EJB, EJB_OR_METADATA, EVENT, FINE, FINE_LABEL, FINER, FINER_LABEL, FINEST, FINEST_LABEL, INFO, INFO_LABEL, JPA, JPARS, loggerCatagories, METADATA, METAMODEL, MONITORING, OFF, OFF_LABEL, PROPAGATION, PROPERTIES, QUERY, SEQUENCING, SERVER, SEVERE, SEVERE_LABEL, SQL, TRANSACTION, WARNING, WARNING_LABEL, WEAVER

Constructor Summary

Constructors

Constructor and Description
DefaultSessionLog()
DefaultSessionLog(java.io.Writer writer)

Method Summary

Methods

Modifier and Type	Method and Description
int	getLevel(java.lang.String category) PUBLIC: Return the log level for the category name space.
java.lang.String	getWriterFilename() For the given writer, return it's associated filename.
void	log(SessionLogEntry entry) Log the entry.
void	setLevel(int level, java.lang.String category) PUBLIC: Set the log level for the category name space.
void	setWriter(java.lang.String aFileName) Set the writer that will receive the formatted log entries for a file name.
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.

Methods inherited from class org.eclipse.persistence.logging.AbstractSessionLog

clone, config, fine, finer, finest, getDateFormat, getDefaultLoggingLevel, getLevel, getLevelString, getLog, getSession, getWriter, info, isOff, log, log, log, log, log, log, log, log, log, log, log, log, log, logThrowable, logThrowable, setDateFormat, setLevel, setLog, setSession, setShouldDisplayData, setShouldLogExceptionStackTrace, setShouldPrintConnection, setShouldPrintDate, setShouldPrintSession, setShouldPrintThread, setWriter, setWriter, severe, shouldDisplayData, shouldLog, shouldLogExceptionStackTrace, shouldPrintConnection, shouldPrintDate, shouldPrintSession, shouldPrintThread, throwing, translateLoggingLevelToString, translateStringToLoggingLevel, warning

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultSessionLog

public DefaultSessionLog()

DefaultSessionLog

public DefaultSessionLog(java.io.Writer writer)

Method Detail

setLevel

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

Description copied from class: AbstractSessionLog

PUBLIC:

Set the log level for the category name space.

Specified by:

setLevel in interface SessionLog

Overrides:

setLevel in class AbstractSessionLog

Parameters:

level - the new log level

category - the string representation of an EclipseLink category, e.g. "sql", "transaction" ...

getLevel

public int getLevel(java.lang.String category)

Description copied from class: AbstractSessionLog

PUBLIC:

Return the log level for the category name space.

Specified by:

getLevel in interface SessionLog

Overrides:

getLevel in class AbstractSessionLog

Parameters:

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

Returns:

the log level

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.

Specified by:

shouldLog in interface SessionLog

Overrides:

shouldLog in class AbstractSessionLog

Parameters:

level - the log request level

category - the string representation of an EclipseLink category, e.g. "sql", "transaction" ...*

Returns:

true if the given message level will be logged for the given category

log

public void log(SessionLogEntry entry)

Log the entry. This writes the log entries information to a writer such as System.out or a file.

Specified by:

log in interface SessionLog

Specified by:

log in class AbstractSessionLog

Parameters:

entry - org.eclipse.persistence.sessions.LogEntry

setWriter

public void setWriter(java.lang.String aFileName)

Set the writer that will receive the formatted log entries for a file name.

getWriterFilename

public java.lang.String getWriterFilename()

For the given writer, return it's associated filename. If associated writer does not have a filename, return null.