Skip navigation links

oracle.toplink.logging
Class AbstractSessionLog

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

All Implemented Interfaces:

java.lang.Cloneable, SessionLog

Direct Known Subclasses:

DefaultSessionLog, JavaLog, ServerLog

public abstract class AbstractSessionLog

extends java.lang.Object

implements SessionLog, java.lang.Cloneable

Represents the abstract log that implements all the generic logging functions. It contains a singleton SessionLog that logs messages from outside any TopLink session. The singleton SessionLog can also be passed to a TopLink session when messages are logged through that session. When JDK1.4 is used, a singleton JavaLog is created. Otherwise a singleton DefaultSessionLog is created.

See Also:

SessionLog, SessionLogEntry, DefaultSessionLog, JavaLog

Field Summary

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

Constructor Summary

AbstractSessionLog()
Create a new AbstractSessionLog

Method Summary

void	config(java.lang.String message) This method is called when a config level message needs to be logged.
void	fine(java.lang.String message) This method is called when a fine level message needs to be logged.
void	finer(java.lang.String message) This method is called when a finer level message needs to be logged.
void	finest(java.lang.String message) This method is called when a finest level message needs to be logged.
java.text.DateFormat	getDateFormat() Return the date format to be used when printing a log entry date.
static int	getDefaultLoggingLevel() Return the system default log level.
int	getLevel() Return the log level.
int	getLevel(java.lang.String category) Return the log level for the category name space.
java.lang.String	getLevelString() Return the log level as a string value.
static SessionLog	getLog() Return the singleton SessionLog.
Session	getSession() Get the session.
java.io.Writer	getWriter() Return the writer that will receive the formatted log entries.
void	info(java.lang.String message) This method is called when a info level message needs to be logged.
void	log(int level, java.lang.String message) Log a message that does not need to be translated.
void	log(int level, java.lang.String message, java.lang.Object param) Log a message with one parameter that needs to be translated.
void	log(int level, java.lang.String message, java.lang.Object[] params) Log a message with an array of parameters that needs to be translated.
void	log(int level, java.lang.String message, java.lang.Object[] params, boolean shouldTranslate) Log a message.
void	log(int level, java.lang.String message, java.lang.Object param1, java.lang.Object param2) Log a message with two parameters that needs to be translated.
void	log(int level, java.lang.String message, java.lang.Object param1, java.lang.Object param2, java.lang.Object param3) Log a message with three parameters that needs to be translated.
abstract void	log(SessionLogEntry sessionLogEntry) Log a SessionLogEntry
void	log(SessionLogEntry entry) Deprecated. replaced by log(oracle.toplink.logging.SessionLogEntry)
void	logThrowable(int level, java.lang.Throwable throwable) Log a throwable with level.
void	setDateFormat(java.text.DateFormat dateFormat) Set the date format to be used when printing a log entry date.
void	setLevel(int level) Set the log level.
void	setLevel(int level, java.lang.String category) Set the log level for the category name space.
static void	setLog(SessionLog sessionLog) Set the singleton SessionLog.
void	setSession(Session session) Set the session.
void	setShouldLogDebug(boolean shouldLogDebug) Deprecated. replaced by level
void	setShouldLogExceptions(boolean shouldLogExceptions) Deprecated. replaced by level
void	setShouldLogExceptionStackTrace(boolean shouldLogExceptionStackTrace) By default the stack is logged for FINER or less (finest).
void	setShouldPrintConnection(boolean shouldPrintConnection) By default the connection is printed, this can be turned off.
void	setShouldPrintDate(boolean shouldPrintDate) By default the date is always printed, but can be turned off.
void	setShouldPrintSession(boolean shouldPrintSession) By default the session (and its connection is available) are printed, this can be turned off.
void	setShouldPrintThread(boolean shouldPrintThread) By default the thread is logged for FINE or less (finer,etc.).
void	setWriter(java.io.OutputStream outputstream) Set the writer that will receive the formatted log entries.
void	setWriter(java.io.Writer writer) Set the writer that will receive the formatted log entries.
void	severe(java.lang.String message) This method is called when a severe level message needs to be logged.
boolean	shouldLog(int level) Check if a message of the given level would actually be logged.
boolean	shouldLog(int level, java.lang.String category) Check if a message of the given level would actually be logged for the category name space. !
boolean	shouldLogDebug() Deprecated. replaced by level
boolean	shouldLogExceptions() Deprecated. replaced by level
boolean	shouldLogExceptionStackTrace() By default the stack is logged for FINER or less (finest).
boolean	shouldPrintConnection() By default the connection is printed, this can be turned off.
boolean	shouldPrintDate() By default the date is always printed, but can be turned off.
boolean	shouldPrintSession() By default the session (and its connection is available) are printed, this can be turned off.
boolean	shouldPrintThread() By default the thread is logged for FINE or less (finer,etc.).
void	throwing(java.lang.Throwable throwable) Log a throwable at FINER level.
void	warning(java.lang.String message) This method is called when a warning level message needs to be logged.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSessionLog

public AbstractSessionLog()

Create a new AbstractSessionLog

Method Detail

getDefaultLoggingLevel

public static int getDefaultLoggingLevel()

Return the system default log level. This is based on the System property "topink.logging.level", or INFO if not set.

getLevel

public int getLevel()

Return the log level. It is used when session is not available.

Specified by:

getLevel in interface SessionLog

Returns:

the log level

getLevelString

public java.lang.String getLevelString()

Return the log level as a string value.

Specified by:

getLevelString in interface SessionLog

getLevel

public int getLevel(java.lang.String category)

Return the log level for the category name space.

Specified by:

getLevel in interface SessionLog

Parameters:

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

Returns:

the log level

setLevel

public void setLevel(int level)

Set the log level. It is used when session is not available.

Specified by:

setLevel in interface SessionLog

Parameters:

level - the new log level

setLevel

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

Set the log level for the category name space.

Specified by:

setLevel in interface SessionLog

Parameters:

level - the new log level

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

shouldLog

public boolean shouldLog(int level)

Check if a message of the given level would actually be logged. It is used when session is not available.

Specified by:

shouldLog in interface SessionLog

Parameters:

level - the log request level

Returns:

true if the given message level will be logged

shouldLog

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

Check if a message of the given level would actually be logged for the category name space. !isOff() is checked to screen out the possibility when both log level and log request level are set to OFF.

Specified by:

shouldLog in interface SessionLog

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

getLog

public static SessionLog getLog()

Return the singleton SessionLog. If the singleton SessionLog does not exist, a new one is created based on the version of JDK being used from the Version class.

Returns:

the singleton SessionLog

setLog

public static void setLog(SessionLog sessionLog)

Set the singleton SessionLog.

Parameters:

sessionLog - a SessionLog

getSession

public Session getSession()

Get the session.

Specified by:

getSession in interface SessionLog

Returns:

session

setSession

public void setSession(Session session)

Set the session.

Specified by:

setSession in interface SessionLog

Parameters:

session - a Session

log

public void log(int level,
                java.lang.String message)

Log a message that does not need to be translated. This method is intended for external use when logging messages are required within the TopLink output.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level value

message - the string message - this shout not be a bundle key

log

public void log(int level,
                java.lang.String message,
                java.lang.Object param)

Log a message with one parameter that needs to be translated.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level value

message - the string message

param - a parameter of the message

log

public void log(int level,
                java.lang.String message,
                java.lang.Object param1,
                java.lang.Object param2)

Log a message with two parameters that needs to be translated.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level value

message - the string message

param1 - a parameter of the message

param2 - second parameter of the message

log

public void log(int level,
                java.lang.String message,
                java.lang.Object param1,
                java.lang.Object param2,
                java.lang.Object param3)

Log a message with three parameters that needs to be translated.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level value

message - the string message

param1 - a parameter of the message

param2 - second parameter of the message

param3 - third parameter of the message

log

public void log(int level,
                java.lang.String message,
                java.lang.Object[] params)

Log a message with an array of parameters that needs to be translated.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level value

message - the string message

params - array of parameters to the message

log

public void log(int level,
                java.lang.String message,
                java.lang.Object[] params,
                boolean shouldTranslate)

Log a message. shouldTranslate determines if the message needs to be translated.

Specified by:

log in interface SessionLog

Parameters:

level - the log request level

message - the string message

params - array of parameters to the message

shouldTranslate - true if the message needs to be translated

log

public abstract void log(SessionLogEntry sessionLogEntry)

Log a SessionLogEntry

Specified by:

log in interface SessionLog

Parameters:

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

log

public void log(SessionLogEntry entry)

Deprecated. replaced by log(oracle.toplink.logging.SessionLogEntry)

OBSOLETE:

Specified by:

log in interface SessionLog

shouldPrintSession

public boolean shouldPrintSession()

By default the session (and its connection is available) are printed, this can be turned off.

Specified by:

shouldPrintSession in interface SessionLog

setShouldPrintSession

public void setShouldPrintSession(boolean shouldPrintSession)

By default the session (and its connection is available) are printed, this can be turned off.

Specified by:

setShouldPrintSession in interface SessionLog

shouldPrintConnection

public boolean shouldPrintConnection()

By default the connection is printed, this can be turned off.

Specified by:

shouldPrintConnection in interface SessionLog

setShouldPrintConnection

public void setShouldPrintConnection(boolean shouldPrintConnection)

By default the connection is printed, this can be turned off.

Specified by:

setShouldPrintConnection in interface SessionLog

shouldLogExceptions

public boolean shouldLogExceptions()

Deprecated. replaced by level

OBSOLETE:

Specified by:

shouldLogExceptions in interface SessionLog

setShouldLogExceptions

public void setShouldLogExceptions(boolean shouldLogExceptions)

Deprecated. replaced by level

OBSOLETE:

Specified by:

setShouldLogExceptions in interface SessionLog

shouldLogExceptionStackTrace

public boolean shouldLogExceptionStackTrace()

By default the stack is logged for FINER or less (finest). The logging of the stack can also be explicitly turned on or off.

Specified by:

shouldLogExceptionStackTrace in interface SessionLog

setShouldLogExceptionStackTrace

public void setShouldLogExceptionStackTrace(boolean shouldLogExceptionStackTrace)

By default the stack is logged for FINER or less (finest). The logging of the stack can also be explicitly turned on or off.

Specified by:

setShouldLogExceptionStackTrace in interface SessionLog

shouldPrintDate

public boolean shouldPrintDate()

By default the date is always printed, but can be turned off.

Specified by:

shouldPrintDate in interface SessionLog

setShouldPrintDate

public void setShouldPrintDate(boolean shouldPrintDate)

By default the date is always printed, but can be turned off.

Specified by:

setShouldPrintDate in interface SessionLog

shouldPrintThread

public boolean shouldPrintThread()

By default the thread is logged for FINE or less (finer,etc.). The logging of the thread can also be explicitly turned on or off.

Specified by:

shouldPrintThread in interface SessionLog

setShouldPrintThread

public void setShouldPrintThread(boolean shouldPrintThread)

By default the thread is logged for FINE or less (finer,etc.). The logging of the thread can also be explicitly turned on or off.

Specified by:

setShouldPrintThread in interface SessionLog

getWriter

public java.io.Writer getWriter()

Return the writer that will receive the formatted log entries.

Specified by:

getWriter in interface SessionLog

Returns:

the log writer

setWriter

public void setWriter(java.io.Writer writer)

Set the writer that will receive the formatted log entries.

Specified by:

setWriter in interface SessionLog

Parameters:

writer - the log writer

setWriter

public void setWriter(java.io.OutputStream outputstream)

Set the writer that will receive the formatted log entries.

Parameters:

OutputStream - the log writer

shouldLogDebug

public boolean shouldLogDebug()

Deprecated. replaced by level

OBSOLETE:

Specified by:

shouldLogDebug in interface SessionLog

setShouldLogDebug

public void setShouldLogDebug(boolean shouldLogDebug)

Deprecated. replaced by level

OBSOLETE:

Specified by:

setShouldLogDebug in interface SessionLog

getDateFormat

public java.text.DateFormat getDateFormat()

Return the date format to be used when printing a log entry date.

Returns:

the date format

setDateFormat

public void setDateFormat(java.text.DateFormat dateFormat)

Set the date format to be used when printing a log entry date.

Parameters:

dateFormat - java.text.DateFormat

throwing

public void throwing(java.lang.Throwable throwable)

Log a throwable at FINER level.

Specified by:

throwing in interface SessionLog

Parameters:

throwable - a Throwable

severe

public void severe(java.lang.String message)

This method is called when a severe level message needs to be logged. The message will be translated

Specified by:

severe in interface SessionLog

Parameters:

message - the message key

warning

public void warning(java.lang.String message)

This method is called when a warning level message needs to be logged. The message will be translated

Specified by:

warning in interface SessionLog

Parameters:

message - the message key

info

public void info(java.lang.String message)

This method is called when a info level message needs to be logged. The message will be translated

Specified by:

info in interface SessionLog

Parameters:

message - the message key

config

public void config(java.lang.String message)

This method is called when a config level message needs to be logged. The message will be translated

Specified by:

config in interface SessionLog

Parameters:

message - the message key

fine

public void fine(java.lang.String message)

This method is called when a fine level message needs to be logged. The message will be translated

Specified by:

fine in interface SessionLog

Parameters:

message - the message key

finer

public void finer(java.lang.String message)

This method is called when a finer level message needs to be logged. The message will be translated

Specified by:

finer in interface SessionLog

Parameters:

message - the message key

finest

public void finest(java.lang.String message)

This method is called when a finest level message needs to be logged. The message will be translated

Specified by:

finest in interface SessionLog

Parameters:

message - the message key

logThrowable

public void logThrowable(int level,
                         java.lang.Throwable throwable)

Log a throwable with level.

Specified by:

logThrowable in interface SessionLog

Parameters:

level - the log request level value

throwable - a Throwable

Skip navigation links