Package org.apache.openjpa.lib.jdbc

Class LoggingConnectionDecorator

java.lang.Object

org.apache.openjpa.lib.jdbc.LoggingConnectionDecorator

All Implemented Interfaces:

ConnectionDecorator

public class LoggingConnectionDecorator
extends java.lang.Object
implements ConnectionDecorator

A ConnectionDecorator that creates logging connections and ReportingSQLExceptions.

Author:

Marc Prud'hommeaux

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	LoggingConnectionDecorator.LoggingConnection	Logging connection.
static interface	LoggingConnectionDecorator.SQLWarningHandler	Interface that allows customization of what to do when SQLWarnings occur.

Constructor Summary

Constructors

Constructor	Description
LoggingConnectionDecorator()

Method Summary

Modifier and Type	Method	Description
java.sql.Connection	decorate(java.sql.Connection conn)	Decorate the given connection if desired.
DataSourceLogs	getLogs()	The log to write to.
boolean	getPrettyPrint()
int	getPrettyPrintLineLength()
boolean	getPrintParameters()	Whether parameter values will be printed in exception messages or in trace.
java.lang.String	getWarningAction()	What to do with SQL warnings.
LoggingConnectionDecorator.SQLWarningHandler	getWarningHandler()	What to do with SQL warnings.
void	setPrettyPrint(boolean prettyPrint)	If set to true, pretty-print SQL by running it through SQLFormatter.prettyPrint(java.lang.Object).
void	setPrettyPrintLineLength(int length)	The number of characters to print per line when pretty-printing of SQL is enabled.
void	setPrintParameters(boolean printParameters)
void	setWarningAction(java.lang.String warningAction)	What to do with SQL warnings.
void	setWarningHandler(LoggingConnectionDecorator.SQLWarningHandler warningHandler)	What to do with SQL warnings.

Methods inherited from class java.lang.Object

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

Constructor Detail

LoggingConnectionDecorator

public LoggingConnectionDecorator()

Method Detail

setPrettyPrint

public void setPrettyPrint(boolean prettyPrint)

If set to true, pretty-print SQL by running it through SQLFormatter.prettyPrint(java.lang.Object). If false, don't pretty-print, and output SQL logs in a single line. Pretty-printed SQL can be easier for a human to read, but is harder to parse with tools like grep.

getPrettyPrint

public boolean getPrettyPrint()

See Also:

setPrettyPrint(boolean)

setPrettyPrintLineLength

public void setPrettyPrintLineLength(int length)

The number of characters to print per line when pretty-printing of SQL is enabled. Defaults to 60 to provide some space for any ant-related characters on the left of a standard 80-character display.

getPrettyPrintLineLength

public int getPrettyPrintLineLength()

See Also:

setPrettyPrintLineLength(int)

getPrintParameters

public boolean getPrintParameters()

Whether parameter values will be printed in exception messages or in trace. This is different from trackParameters which controls whether OpenJPA will track parameters internally (visible while debugging and used in batching).

setPrintParameters

public void setPrintParameters(boolean printParameters)

setWarningAction

public void setWarningAction(java.lang.String warningAction)

What to do with SQL warnings.

getWarningAction

public java.lang.String getWarningAction()

What to do with SQL warnings.

setWarningHandler

public void setWarningHandler(LoggingConnectionDecorator.SQLWarningHandler warningHandler)

What to do with SQL warnings.

getWarningHandler

public LoggingConnectionDecorator.SQLWarningHandler getWarningHandler()

What to do with SQL warnings.

getLogs

public DataSourceLogs getLogs()

The log to write to.

decorate

public java.sql.Connection decorate(java.sql.Connection conn)
                             throws java.sql.SQLException

Description copied from interface: ConnectionDecorator

Decorate the given connection if desired.

Specified by:

decorate in interface ConnectionDecorator

Throws:

java.sql.SQLException