|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.cayenne.access.QueryLogger
public class QueryLogger
QueryLogger is intended to log special events that happen whenever Cayenne interacts with a database. This includes execution of generated SQL statements, result counts, connection events, etc. Normally QueryLogger methods are not invoked directly by the user. Rather it is a single logging point used by the framework.
Internally QueryLogger uses Log4J. See a chapter on logging in Cayenne User Guide on how to setup Log4J.
Field Summary | |
---|---|
static org.apache.log4j.Level |
DEFAULT_LOG_LEVEL
Deprecated. unused since 1.2 |
static int |
TRIM_VALUES_THRESHOLD
|
Constructor Summary | |
---|---|
QueryLogger()
|
Method Summary | |
---|---|
protected static void |
appendFormattedByte(java.lang.StringBuffer buffer,
byte byteValue)
Deprecated. since 1.2 use a namesake method from IDUtil. |
static org.apache.log4j.Level |
getLoggingLevel()
Returns current logging level. |
static boolean |
isLoggable()
Returns true if current thread default log level is high enough for QueryLogger to generate output. |
static boolean |
isLoggable(org.apache.log4j.Level logLevel)
Deprecated. since 1.2 |
static void |
log(java.lang.String message)
|
static void |
logBeginTransaction(org.apache.log4j.Level logLevel,
java.lang.String transactionLabel)
Deprecated. since 1.2 |
static void |
logBeginTransaction(java.lang.String transactionLabel)
|
static void |
logCommitTransaction(org.apache.log4j.Level logLevel,
java.lang.String transactionLabel)
Deprecated. since 1.2 |
static void |
logCommitTransaction(java.lang.String transactionLabel)
|
static void |
logConnect(org.apache.log4j.Level logLevel,
java.lang.String dataSource)
Deprecated. since 1.2 |
static void |
logConnect(org.apache.log4j.Level logLevel,
java.lang.String url,
java.lang.String userName,
java.lang.String password)
Deprecated. since 1.2 |
static void |
logConnect(java.lang.String dataSource)
Logs database connection event using container data source. |
static void |
logConnect(java.lang.String url,
java.lang.String userName,
java.lang.String password)
|
static void |
logConnectFailure(org.apache.log4j.Level logLevel,
java.lang.Throwable th)
Deprecated. since 1.2 |
static void |
logConnectFailure(java.lang.Throwable th)
|
static void |
logConnectSuccess()
|
static void |
logConnectSuccess(org.apache.log4j.Level logLevel)
Deprecated. since 1.2 |
static void |
logPoolCreated(DataSourceInfo dsi)
Logs database connection event. |
static void |
logPoolCreated(org.apache.log4j.Level logLevel,
DataSourceInfo dsi)
Deprecated. since 1.2 |
static void |
logQuery(org.apache.log4j.Level logLevel,
java.lang.String queryStr,
java.util.List params)
Deprecated. since 1.2 |
static void |
logQuery(org.apache.log4j.Level logLevel,
java.lang.String queryStr,
java.util.List params,
long time)
Deprecated. since 1.2 |
static void |
logQuery(java.lang.String queryStr,
java.util.List params)
|
static void |
logQuery(java.lang.String queryStr,
java.util.List params,
long time)
Log query content using Log4J Category with "INFO" priority. |
static void |
logQueryError(org.apache.log4j.Level logLevel,
java.lang.Throwable th)
Deprecated. since 1.2 |
static void |
logQueryError(java.lang.Throwable th)
|
static void |
logQueryParameters(org.apache.log4j.Level logLevel,
java.lang.String label,
java.util.List parameters)
Deprecated. since 1.2 |
static void |
logQueryParameters(java.lang.String label,
java.util.List parameters)
|
static void |
logQueryStart(int count)
|
static void |
logQueryStart(org.apache.log4j.Level logLevel,
int count)
Deprecated. since 1.2 |
static void |
logRollbackTransaction(org.apache.log4j.Level logLevel,
java.lang.String transactionLabel)
Deprecated. since 1.2 |
static void |
logRollbackTransaction(java.lang.String transactionLabel)
|
static void |
logSelectCount(int count)
|
static void |
logSelectCount(int count,
long time)
|
static void |
logSelectCount(org.apache.log4j.Level logLevel,
int count)
Deprecated. since 1.2 |
static void |
logSelectCount(org.apache.log4j.Level logLevel,
int count,
long time)
Deprecated. since 1.2 |
static void |
logUpdateCount(int count)
|
static void |
logUpdateCount(org.apache.log4j.Level logLevel,
int count)
Deprecated. since 1.2 |
static void |
setLoggingLevel(org.apache.log4j.Level level)
Sets logging level for the current thread. |
static void |
sqlLiteralForObject(java.lang.StringBuffer buf,
java.lang.Object anObject)
Utility method that appends SQL literal for the specified object to the buffer. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final org.apache.log4j.Level DEFAULT_LOG_LEVEL
public static final int TRIM_VALUES_THRESHOLD
Constructor Detail |
---|
public QueryLogger()
Method Detail |
---|
public static void sqlLiteralForObject(java.lang.StringBuffer buf, java.lang.Object anObject)
Note: this method is not intended to build SQL queries, rather this is used in logging routines only. In particular it will trim large values to avoid flooding the logs.
buf
- buffer to append valueanObject
- object to be transformed to SQL literal.protected static void appendFormattedByte(java.lang.StringBuffer buffer, byte byteValue)
public static org.apache.log4j.Level getLoggingLevel()
public static void setLoggingLevel(org.apache.log4j.Level level)
public static void log(java.lang.String message)
public static void logConnect(java.lang.String dataSource)
public static void logConnect(java.lang.String url, java.lang.String userName, java.lang.String password)
public static void logPoolCreated(DataSourceInfo dsi)
public static void logConnectSuccess()
public static void logConnectFailure(java.lang.Throwable th)
public static void logQuery(java.lang.String queryStr, java.util.List params)
public static void logQuery(java.lang.String queryStr, java.util.List params, long time)
queryStr
- Query SQL stringparams
- optional list of query parameters that are used when executing query
in prepared statement.public static void logQueryParameters(java.lang.String label, java.util.List parameters)
public static void logSelectCount(int count)
public static void logSelectCount(int count, long time)
public static void logUpdateCount(int count)
public static void logBeginTransaction(java.lang.String transactionLabel)
public static void logCommitTransaction(java.lang.String transactionLabel)
public static void logRollbackTransaction(java.lang.String transactionLabel)
public static void logQueryError(java.lang.Throwable th)
public static void logQueryStart(int count)
public static boolean isLoggable()
public static void logConnect(org.apache.log4j.Level logLevel, java.lang.String dataSource)
public static void logConnect(org.apache.log4j.Level logLevel, java.lang.String url, java.lang.String userName, java.lang.String password)
public static void logPoolCreated(org.apache.log4j.Level logLevel, DataSourceInfo dsi)
public static void logConnectSuccess(org.apache.log4j.Level logLevel)
public static void logConnectFailure(org.apache.log4j.Level logLevel, java.lang.Throwable th)
public static void logQuery(org.apache.log4j.Level logLevel, java.lang.String queryStr, java.util.List params)
public static void logQuery(org.apache.log4j.Level logLevel, java.lang.String queryStr, java.util.List params, long time)
public static void logQueryParameters(org.apache.log4j.Level logLevel, java.lang.String label, java.util.List parameters)
public static void logSelectCount(org.apache.log4j.Level logLevel, int count)
public static void logSelectCount(org.apache.log4j.Level logLevel, int count, long time)
public static void logUpdateCount(org.apache.log4j.Level logLevel, int count)
public static void logBeginTransaction(org.apache.log4j.Level logLevel, java.lang.String transactionLabel)
public static void logCommitTransaction(org.apache.log4j.Level logLevel, java.lang.String transactionLabel)
public static void logRollbackTransaction(org.apache.log4j.Level logLevel, java.lang.String transactionLabel)
public static void logQueryError(org.apache.log4j.Level logLevel, java.lang.Throwable th)
public static void logQueryStart(org.apache.log4j.Level logLevel, int count)
public static boolean isLoggable(org.apache.log4j.Level logLevel)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |