|
Oracle Fusion Middleware Java API Reference for Oracle TopLink 11g Release 1 (11.1.1) B32476-02 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Deprecated. Please use oracle.toplink.logging.SessionLog
public interface SessionLog
SessionLog is the ever-so-simple interface used by TopLink to log generated messages and SQL. An implementor of this interface can be passed to the TopLink 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 Toplink logging levels (that are used throughout Toplink 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, TopLink categories used for logging name space are defined with the following String values:
SQL | = "sql" | ||
TRANSACTION | = "transaction" | ||
EVENT | = "event" | ||
QUERY | = "query" | ||
CACHE | = "cache" | ||
PROPAGATION | = "propagation" | ||
SEQUENCING | = "sequencing" | ||
EJB | = "ejb" | ||
DMS | = "dms" | ||
EJB_ANNOTATION | = "ejb_annotation" | ||
WEAVER | = "weaver" |
AbstractSessionLog
, SessionLogEntry
, Session
Field Summary | |
---|---|
static int |
ALL Deprecated. |
static java.lang.String |
CACHE Deprecated. |
static int |
CONFIG Deprecated. |
static java.lang.String |
CONNECTION Deprecated. |
static java.lang.String |
DMS Deprecated. |
static java.lang.String |
EJB Deprecated. |
static java.lang.String |
EJB_OR_METADATA Deprecated. |
static java.lang.String |
EVENT Deprecated. |
static int |
FINE Deprecated. |
static int |
FINER Deprecated. |
static int |
FINEST Deprecated. |
static int |
INFO Deprecated. |
static java.lang.String[] |
loggerCatagories Deprecated. |
static int |
OFF Deprecated. |
static java.lang.String |
PROPAGATION Deprecated. |
static java.lang.String |
PROPERTIES Deprecated. |
static java.lang.String |
QUERY Deprecated. |
static java.lang.String |
SEQUENCING Deprecated. |
static java.lang.String |
SERVER Deprecated. |
static int |
SEVERE Deprecated. |
static java.lang.String |
SQL Deprecated. |
static java.lang.String |
TRANSACTION Deprecated. |
static int |
WARNING Deprecated. |
static java.lang.String |
WEAVER Deprecated. |
Method Summary | |
---|---|
void |
config(java.lang.String message) Deprecated. This method is called when a config level message needs to be logged. |
void |
fine(java.lang.String message) Deprecated. This method is called when a fine level message needs to be logged. |
void |
finer(java.lang.String message) Deprecated. This method is called when a finer level message needs to be logged. |
void |
finest(java.lang.String message) Deprecated. This method is called when a finest level message needs to be logged. |
int |
getLevel() Deprecated. Return the log level. |
int |
getLevel(java.lang.String category) Deprecated. Return the log level; category is only needed where name space is available. |
java.lang.String |
getLevelString() Deprecated. Return the log level as a string value. |
Session |
getSession() Deprecated. Get the session that owns this SessionLog. |
java.io.Writer |
getWriter() Deprecated. Return the writer to which an accessor writes logged messages and SQL. |
void |
info(java.lang.String message) Deprecated. This method is called when a info level message needs to be logged. |
void |
log(int level, java.lang.String message) Deprecated. Log a message that does not need to be translated. |
void |
log(int level, java.lang.String message, java.lang.Object param) Deprecated. Log a message with one parameter that needs to be translated. |
void |
log(int level, java.lang.String message, java.lang.Object[] arguments) Deprecated. 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) Deprecated. 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) Deprecated. 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) Deprecated. Log a message with three parameters that needs to be translated. |
void |
log(SessionLogEntry entry) Deprecated. TopLink will call this method whenever something needs to be logged (messages, SQL, etc.). |
void |
log(SessionLogEntry entry) Deprecated. Replaced by log(oracle.toplink.logging.SessionLogEntry) |
void |
logThrowable(int level, java.lang.Throwable throwable) Deprecated. Log a throwable with level. |
void |
setLevel(int level) Deprecated. Set the log level. |
void |
setLevel(int level, java.lang.String category) Deprecated. Set the log level. |
void |
setSession(Session session) Deprecated. Set the session that owns this SessionLog. |
void |
setShouldLogDebug(boolean flag) Deprecated. replaced by level |
void |
setShouldLogExceptions(boolean flag) Deprecated. replaced by level |
void |
setShouldLogExceptionStackTrace(boolean flag) Deprecated. By default stack trace is logged for SEVERE all the time and at FINER level for WARNING or less. |
void |
setShouldPrintConnection(boolean flag) Deprecated. By default the connection is always printed whenever available, this can be turned off. |
void |
setShouldPrintDate(boolean flag) Deprecated. By default date is printed, this can be turned off. |
void |
setShouldPrintSession(boolean flag) Deprecated. By default the Session is always printed whenever available, this can be turned off. |
void |
setShouldPrintThread(boolean flag) Deprecated. By default the thread is logged at FINE or less level, this can be turned off. |
void |
setWriter(java.io.Writer log) Deprecated. Set the writer to which an accessor writes logged messages and SQL. |
void |
severe(java.lang.String message) Deprecated. This method is called when a severe level message needs to be logged. |
boolean |
shouldLog(int level) Deprecated. Check if a message of the given level would actually be logged. |
boolean |
shouldLog(int level, java.lang.String category) Deprecated. Check if a message of the given level would actually be logged. |
boolean |
shouldLogDebug() Deprecated. replaced by level |
boolean |
shouldLogExceptions() Deprecated. replaced by level |
boolean |
shouldLogExceptionStackTrace() Deprecated. 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() Deprecated. By default the connection is always printed whenever available, this can be turned off. |
boolean |
shouldPrintDate() Deprecated. By default the date is always printed, this can be turned off. |
boolean |
shouldPrintSession() Deprecated. By default the Session is always printed whenever available, this can be turned off. |
boolean |
shouldPrintThread() Deprecated. By default the thread is logged at FINE or less level, this can be turned off. |
void |
throwing(java.lang.Throwable throwable) Deprecated. This method is called when a throwable at finer level needs to be logged. |
void |
warning(java.lang.String message) Deprecated. This method is called when a warning level message needs to be logged. |
Field Detail |
---|
static final int OFF
static final int SEVERE
static final int WARNING
static final int INFO
static final int CONFIG
static final int FINE
static final int FINER
static final int FINEST
static final int ALL
static final java.lang.String SQL
static final java.lang.String TRANSACTION
static final java.lang.String EVENT
static final java.lang.String CONNECTION
static final java.lang.String QUERY
static final java.lang.String CACHE
static final java.lang.String PROPAGATION
static final java.lang.String SEQUENCING
static final java.lang.String EJB
static final java.lang.String DMS
static final java.lang.String EJB_OR_METADATA
static final java.lang.String WEAVER
static final java.lang.String PROPERTIES
static final java.lang.String SERVER
static final java.lang.String[] loggerCatagories
Method Detail |
---|
void log(SessionLogEntry entry)
entry
- oracle.toplink.sessions.LogEntryvoid log(SessionLogEntry entry)
boolean shouldLogDebug()
boolean shouldLogExceptions()
boolean shouldLogExceptionStackTrace()
boolean shouldPrintDate()
boolean shouldPrintThread()
boolean shouldPrintConnection()
boolean shouldPrintSession()
void setShouldLogDebug(boolean flag)
void setShouldLogExceptions(boolean flag)
void setShouldLogExceptionStackTrace(boolean flag)
void setShouldPrintDate(boolean flag)
void setShouldPrintThread(boolean flag)
void setShouldPrintConnection(boolean flag)
void setShouldPrintSession(boolean flag)
java.io.Writer getWriter()
void setWriter(java.io.Writer log)
int getLevel()
The Toplink logging levels returned correspond to:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
java.lang.String getLevelString()
Return the log level as a string value.
int getLevel(java.lang.String category)
The Toplink logging levels returned correspond to:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
The Toplink categories for logging name space are:
SQL | = "sql" | |
TRANSACTION | = "transaction" | |
EVENT | = "event" | |
QUERY | = "query" | |
CACHE | = "cache" | |
PROPAGATION | = "propagation" | |
SEQUENCING | = "sequencing" | |
EJB | = "ejb" | |
DMS | = "dms" | |
EJB_ANNOTATION | = "ejb_annotation" | |
WEAVER | = "weaver" | |
PROPERTIES | = "properties" | |
SERVER | = "server" |
void setLevel(int level)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void setLevel(int level, java.lang.String category)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
The Toplink categories for logging name space are:
SQL | = "sql" | |
TRANSACTION | = "transaction" | |
EVENT | = "event" | |
QUERY | = "query" | |
CACHE | = "cache" | |
PROPAGATION | = "propagation" | |
SEQUENCING | = "sequencing" | |
EJB | = "ejb" | |
DMS | = "dms" | |
EJB_ANNOTATION | = "ejb_annotation" | |
WEAVER | = "weaver" |
boolean shouldLog(int level)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
boolean shouldLog(int level, java.lang.String category)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
The Toplink categories for logging name space are:
SQL | = "sql" | |
TRANSACTION | = "transaction" | |
EVENT | = "event" | |
QUERY | = "query" | |
CACHE | = "cache" | |
PROPAGATION | = "propagation" | |
SEQUENCING | = "sequencing" | |
EJB | = "ejb" | |
DMS | = "dms" | |
EJB_ANNOTATION | = "ejb_annotation" | |
WEAVER | = "weaver" |
void log(int level, java.lang.String message)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void log(int level, java.lang.String message, java.lang.Object param)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void log(int level, java.lang.String message, java.lang.Object param1, java.lang.Object param2)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void log(int level, java.lang.String message, java.lang.Object param1, java.lang.Object param2, java.lang.Object param3)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void log(int level, java.lang.String message, java.lang.Object[] arguments)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void log(int level, java.lang.String message, java.lang.Object[] arguments, boolean shouldTranslate)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
void throwing(java.lang.Throwable throwable)
void severe(java.lang.String message)
void warning(java.lang.String message)
void info(java.lang.String message)
void config(java.lang.String message)
void fine(java.lang.String message)
void finer(java.lang.String message)
void finest(java.lang.String message)
void logThrowable(int level, java.lang.Throwable throwable)
The Toplink logging levels available are:
ALL | = 0 | |
FINEST | = 1 | |
FINER | = 2 | |
FINE | = 3 | |
CONFIG | = 4 | |
INFO | = 5 | |
WARNING | = 6 | |
SEVERE | = 7 | |
OFF | = 8 |
Session getSession()
void setSession(Session session)
|
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |