EclipseLink 2.2.0, build 'v20110202-r8913' API Reference

org.eclipse.persistence.logging
Interface SessionLog

All Superinterfaces:
java.lang.Cloneable
All Known Implementing Classes:
AbstractSessionLog, DefaultSessionLog, JavaLog, ServerLog

public interface SessionLog
extends java.lang.Cloneable

SessionLog is the ever-so-simple interface used by EclipseLink to log generated messages and SQL. An implementor of this interface can be passed to the EclipseLink session (via the #setSessionLog(SessionLog) method); and all logging data will be passed through to the implementor via an instance of SessionLogEntry. This can be used to supplement debugging; or the entries could be stored in a database instead of logged to System.out, etc.

This class defines Eclipselink logging levels (that are used throughout EclipseLink code) with the following integer values:

 ALL  = 0
 FINEST  = 1
 FINER  = 2
 FINE  = 3
 CONFIG  = 4
 INFO  = 5
 WARNING = 6
 SEVERE  = 7
 OFF  = 8

In addition, EclipseLink categories used for logging name space are defined with the following String values:

 SQL  = "sql"
 TRANSACTION  = "transaction"
 EVENT  = "event"
 CONNECTION  = "connection"
 QUERY  = "query"
 CACHE  = "cache"
 PROPAGATION  = "propagation"
 SEQUENCING  = "sequencing"
 EJB  = "ejb"
 DMS  = "dms"
 EJB_OR_METADATA = "ejb_or_metadata"
 METAMODEL = "metamodel"
 WEAVER  = "weaver"
 PROPERTIES  = "properties"
 SERVER  = "server"

See Also:
AbstractSessionLog, SessionLogEntry, Session
Since:
TOPLink/Java 3.0

Field Summary
static int ALL
           
static java.lang.String ALL_LABEL
           
static java.lang.String CACHE
           
static int CONFIG
           
static java.lang.String CONFIG_LABEL
           
static java.lang.String CONNECTION
           
static java.lang.String DMS
           
static java.lang.String EJB
           
static java.lang.String EJB_OR_METADATA
           
static java.lang.String EVENT
           
static int FINE
           
static java.lang.String FINE_LABEL
           
static int FINER
           
static java.lang.String FINER_LABEL
           
static int FINEST
           
static java.lang.String FINEST_LABEL
           
static int INFO
           
static java.lang.String INFO_LABEL
           
static java.lang.String[] loggerCatagories
           
static java.lang.String METAMODEL
           
static int OFF
           
static java.lang.String OFF_LABEL
           
static java.lang.String PROPAGATION
           
static java.lang.String PROPERTIES
           
static java.lang.String QUERY
           
static java.lang.String SEQUENCING
           
static java.lang.String SERVER
           
static int SEVERE
           
static java.lang.String SEVERE_LABEL
           
static java.lang.String SQL
           
static java.lang.String TRANSACTION
           
static int WARNING
           
static java.lang.String WARNING_LABEL
           
static java.lang.String WEAVER
           
 
Method Summary
 java.lang.Object clone()
          PUBLIC: Clone the log.
 void config(java.lang.String message)
          PUBLIC: This method is called when a config level message needs to be logged.
 void fine(java.lang.String message)
          PUBLIC: This method is called when a fine level message needs to be logged.
 void finer(java.lang.String message)
          PUBLIC: This method is called when a finer level message needs to be logged.
 void finest(java.lang.String message)
          PUBLIC: This method is called when a finest level message needs to be logged.
 int getLevel()
          PUBLIC: Return the log level.
 int getLevel(java.lang.String category)
          PUBLIC: Return the log level; category is only needed where name space is available.
 java.lang.String getLevelString()
          PUBLIC: Return the log level as a string value.
 Session getSession()
          PUBLIC: Get the session that owns this SessionLog.
 java.io.Writer getWriter()
          PUBLIC: Return the writer to which an accessor writes logged messages and SQL.
 void info(java.lang.String message)
          PUBLIC: This method is called when a info level message needs to be logged.
 void log(int level, java.lang.String message)
          PUBLIC: Log a message that does not need to be translated.
 void log(int level, java.lang.String message, java.lang.Object param)
          PUBLIC: Log a message with one parameter that needs to be translated.
 void log(int level, java.lang.String message, java.lang.Object[] arguments)
          PUBLIC: This method is called when the log request is from somewhere session is not available.
 void log(int level, java.lang.String message, java.lang.Object[] arguments, boolean shouldTranslate)
          PUBLIC: This method is called when the log request is from somewhere session is not available.
 void log(int level, java.lang.String message, java.lang.Object param1, java.lang.Object param2)
          PUBLIC: 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)
          PUBLIC: Log a message with three 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, java.lang.Object param4)
          PUBLIC: Log a message with four parameters that needs to be translated.
 void log(SessionLogEntry entry)
          PUBLIC: EclipseLink will call this method whenever something needs to be logged (messages, SQL, etc.).
 void logThrowable(int level, java.lang.Throwable throwable)
          PUBLIC: Log a throwable with level.
 void setLevel(int level)
          PUBLIC: Set the log level.
 void setLevel(int level, java.lang.String category)
          PUBLIC: Set the log level.
 void setSession(Session session)
          PUBLIC: Set the session that owns this SessionLog.
 void setShouldDisplayData(java.lang.Boolean shouldDisplayData)
          Set whether bind parameters should be displayed when logging SQL.
 void setShouldLogExceptionStackTrace(boolean flag)
          By default stack trace is logged for SEVERE all the time and at FINER level for WARNING or less.
 void setShouldPrintConnection(boolean flag)
          By default the connection is always printed whenever available, this can be turned off.
 void setShouldPrintDate(boolean flag)
          By default date is printed, this can be turned off.
 void setShouldPrintSession(boolean flag)
          By default the Session is always printed whenever available, this can be turned off.
 void setShouldPrintThread(boolean flag)
          By default the thread is logged at FINE or less level, this can be turned off.
 void setWriter(java.io.Writer log)
          PUBLIC: Set the writer to which an accessor writes logged messages and SQL.
 void severe(java.lang.String message)
          PUBLIC: This method is called when a severe level message needs to be logged.
 boolean shouldDisplayData()
          Return whether bind parameters should be displayed when logging SQL, default is true.
 boolean shouldLog(int level)
          PUBLIC: Check if a message of the given level would actually be logged.
 boolean shouldLog(int level, java.lang.String category)
          PUBLIC: Check if a message of the given level would actually be logged.
 boolean shouldLogExceptionStackTrace()
          By default the stack trace is logged for SEVERE all the time and at FINER level for WARNING or less, this can be turned off.
 boolean shouldPrintConnection()
          By default the connection is always printed whenever available, this can be turned off.
 boolean shouldPrintDate()
          By default the date is always printed, this can be turned off.
 boolean shouldPrintSession()
          By default the Session is always printed whenever available, this can be turned off.
 boolean shouldPrintThread()
          By default the thread is logged at FINE or less level, this can be turned off.
 void throwing(java.lang.Throwable throwable)
          PUBLIC: This method is called when a throwable at finer level needs to be logged.
 void warning(java.lang.String message)
          PUBLIC: This method is called when a warning level message needs to be logged.
 

Field Detail

OFF

static final int OFF
See Also:
Constant Field Values

OFF_LABEL

static final java.lang.String OFF_LABEL
See Also:
Constant Field Values

SEVERE

static final int SEVERE
See Also:
Constant Field Values

SEVERE_LABEL

static final java.lang.String SEVERE_LABEL
See Also:
Constant Field Values

WARNING

static final int WARNING
See Also:
Constant Field Values

WARNING_LABEL

static final java.lang.String WARNING_LABEL
See Also:
Constant Field Values

INFO

static final int INFO
See Also:
Constant Field Values

INFO_LABEL

static final java.lang.String INFO_LABEL
See Also:
Constant Field Values

CONFIG

static final int CONFIG
See Also:
Constant Field Values

CONFIG_LABEL

static final java.lang.String CONFIG_LABEL
See Also:
Constant Field Values

FINE

static final int FINE
See Also:
Constant Field Values

FINE_LABEL

static final java.lang.String FINE_LABEL
See Also:
Constant Field Values

FINER

static final int FINER
See Also:
Constant Field Values

FINER_LABEL

static final java.lang.String FINER_LABEL
See Also:
Constant Field Values

FINEST

static final int FINEST
See Also:
Constant Field Values

FINEST_LABEL

static final java.lang.String FINEST_LABEL
See Also:
Constant Field Values

ALL

static final int ALL
See Also:
Constant Field Values

ALL_LABEL

static final java.lang.String ALL_LABEL
See Also:
Constant Field Values

SQL

static final java.lang.String SQL
See Also:
Constant Field Values

TRANSACTION

static final java.lang.String TRANSACTION
See Also:
Constant Field Values

EVENT

static final java.lang.String EVENT
See Also:
Constant Field Values

CONNECTION

static final java.lang.String CONNECTION
See Also:
Constant Field Values

QUERY

static final java.lang.String QUERY
See Also:
Constant Field Values

CACHE

static final java.lang.String CACHE
See Also:
Constant Field Values

PROPAGATION

static final java.lang.String PROPAGATION
See Also:
Constant Field Values

SEQUENCING

static final java.lang.String SEQUENCING
See Also:
Constant Field Values

EJB

static final java.lang.String EJB
See Also:
Constant Field Values

DMS

static final java.lang.String DMS
See Also:
Constant Field Values

EJB_OR_METADATA

static final java.lang.String EJB_OR_METADATA
See Also:
Constant Field Values

METAMODEL

static final java.lang.String METAMODEL
See Also:
Constant Field Values

WEAVER

static final java.lang.String WEAVER
See Also:
Constant Field Values

PROPERTIES

static final java.lang.String PROPERTIES
See Also:
Constant Field Values

SERVER

static final java.lang.String SERVER
See Also:
Constant Field Values

loggerCatagories

static final java.lang.String[] loggerCatagories
Method Detail

log

void log(SessionLogEntry entry)
PUBLIC: EclipseLink will call this method whenever something needs to be logged (messages, SQL, etc.). All the pertinent information will be contained in the specified entry.

Parameters:
entry - org.eclipse.persistence.sessions.LogEntry

shouldLogExceptionStackTrace

boolean shouldLogExceptionStackTrace()
By default the stack trace is logged for SEVERE all the time and at FINER level for WARNING or less, this can be turned off.


shouldPrintDate

boolean shouldPrintDate()
By default the date is always printed, this can be turned off.


shouldPrintThread

boolean shouldPrintThread()
By default the thread is logged at FINE or less level, this can be turned off.


shouldDisplayData

boolean shouldDisplayData()
Return whether bind parameters should be displayed when logging SQL, default is true.


shouldPrintConnection

boolean shouldPrintConnection()
By default the connection is always printed whenever available, this can be turned off.


shouldPrintSession

boolean shouldPrintSession()
By default the Session is always printed whenever available, this can be turned off.


setShouldDisplayData

void setShouldDisplayData(java.lang.Boolean shouldDisplayData)
Set whether bind parameters should be displayed when logging SQL.


setShouldLogExceptionStackTrace

void setShouldLogExceptionStackTrace(boolean flag)
By default stack trace is logged for SEVERE all the time and at FINER level for WARNING or less. This can be turned off.


setShouldPrintDate

void setShouldPrintDate(boolean flag)
By default date is printed, this can be turned off.


setShouldPrintThread

void setShouldPrintThread(boolean flag)
By default the thread is logged at FINE or less level, this can be turned off.


setShouldPrintConnection

void setShouldPrintConnection(boolean flag)
By default the connection is always printed whenever available, this can be turned off.


setShouldPrintSession

void setShouldPrintSession(boolean flag)
By default the Session is always printed whenever available, this can be turned off.


getWriter

java.io.Writer getWriter()
PUBLIC: Return the writer to which an accessor writes logged messages and SQL. If not set, this reference usually defaults to a writer on System.out. To enable logging, logMessages must be turned on in the session.


setWriter

void setWriter(java.io.Writer log)
PUBLIC: Set the writer to which an accessor writes logged messages and SQL. If not set, this reference usually defaults to a writer on System.out. To enable logging, logMessages() is used on the session.


getLevel

int getLevel()
PUBLIC: Return the log level. Used when session is not available.

The EclipseLink logging levels returned correspond to:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


getLevelString

java.lang.String getLevelString()
PUBLIC:

Return the log level as a string value.


getLevel

int getLevel(java.lang.String category)
PUBLIC: Return the log level; category is only needed where name space is available.

The EclipseLink logging levels returned correspond to:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8

The EclipseLink categories for the logging name space are:

 SQL  = "sql"
 TRANSACTION  = "transaction"
 EVENT  = "event"
 CONNECTION  = "connection"
 QUERY  = "query"
 CACHE  = "cache"
 PROPAGATION  = "propagation"
 SEQUENCING  = "sequencing"
 EJB  = "ejb"
 DMS  = "dms"
 EJB_OR_METADATA = "ejb_or_metadata"
 METAMODEL = "metamodel"
 WEAVER  = "weaver"
 PROPERTIES  = "properties"
 SERVER  = "server"


setLevel

void setLevel(int level)
PUBLIC: Set the log level. Used when session is not available.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


setLevel

void setLevel(int level,
              java.lang.String category)
PUBLIC: Set the log level. Category is only needed where name space is available.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8

The EclipseLink categories for logging name space are:

 SQL  = "sql"
 TRANSACTION  = "transaction"
 EVENT  = "event"
 CONNECTION  = "connection"
 QUERY  = "query"
 CACHE  = "cache"
 PROPAGATION  = "propagation"
 SEQUENCING  = "sequencing"
 EJB  = "ejb"
 DMS  = "dms"
 EJB_OR_METADATA = "ejb_or_metadata"
 METAMODEL = "metamodel"
 WEAVER  = "weaver"
 PROPERTIES  = "properties"
 SERVER  = "server"


shouldLog

boolean shouldLog(int level)
PUBLIC: Check if a message of the given level would actually be logged. Used when session is not available.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


shouldLog

boolean shouldLog(int level,
                  java.lang.String category)
PUBLIC: Check if a message of the given level would actually be logged. Category is only needed where name space is available.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8

The EclipseLink categories for logging name space are:

 SQL  = "sql"
 TRANSACTION  = "transaction"
 EVENT  = "event"
 CONNECTION  = "connection"
 QUERY  = "query"
 CACHE  = "cache"
 PROPAGATION  = "propagation"
 SEQUENCING  = "sequencing"
 EJB  = "ejb"
 DMS  = "dms"
 EJB_OR_METADATA = "ejb_or_metadata"
 METAMODEL = "metamodel"
 WEAVER  = "weaver"
 PROPERTIES  = "properties"
 SERVER  = "server"


log

void log(int level,
         java.lang.String message)
PUBLIC: Log a message that does not need to be translated. This method is intended for external use when logging messages are wanted within the EclipseLink output.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object param)
PUBLIC: Log a message with one parameter that needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object param1,
         java.lang.Object param2)
PUBLIC: Log a message with two parameters that needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object param1,
         java.lang.Object param2,
         java.lang.Object param3)
PUBLIC: Log a message with three parameters that needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object param1,
         java.lang.Object param2,
         java.lang.Object param3,
         java.lang.Object param4)
PUBLIC: Log a message with four parameters that needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object[] arguments)
PUBLIC: This method is called when the log request is from somewhere session is not available. The message needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


log

void log(int level,
         java.lang.String message,
         java.lang.Object[] arguments,
         boolean shouldTranslate)
PUBLIC: This method is called when the log request is from somewhere session is not available. shouldTranslate flag determines if the message needs to be translated.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


throwing

void throwing(java.lang.Throwable throwable)
PUBLIC: This method is called when a throwable at finer level needs to be logged.


severe

void severe(java.lang.String message)
PUBLIC: This method is called when a severe level message needs to be logged. The message will be translated


warning

void warning(java.lang.String message)
PUBLIC: This method is called when a warning level message needs to be logged. The message will be translated


info

void info(java.lang.String message)
PUBLIC: This method is called when a info level message needs to be logged. The message will be translated


config

void config(java.lang.String message)
PUBLIC: This method is called when a config level message needs to be logged. The message will be translated


fine

void fine(java.lang.String message)
PUBLIC: This method is called when a fine level message needs to be logged. The message will be translated


finer

void finer(java.lang.String message)
PUBLIC: This method is called when a finer level message needs to be logged. The message will be translated


finest

void finest(java.lang.String message)
PUBLIC: This method is called when a finest level message needs to be logged. The message will be translated


logThrowable

void logThrowable(int level,
                  java.lang.Throwable throwable)
PUBLIC: Log a throwable with level.

The EclipseLink logging levels available are:

ALL  = 0
FINEST  = 1
FINER  = 2
FINE  = 3
CONFIG  = 4
INFO  = 5
WARNING = 6
SEVERE  = 7
OFF  = 8


getSession

Session getSession()
PUBLIC: Get the session that owns this SessionLog.


setSession

void setSession(Session session)
PUBLIC: Set the session that owns this SessionLog.


clone

java.lang.Object clone()
PUBLIC: Clone the log.


EclipseLink 2.2.0, build 'v20110202-r8913' API Reference