org.apache.openjpa.lib.jdbc
Class LoggingConnectionDecorator

java.lang.Object
  extended by org.apache.openjpa.lib.jdbc.LoggingConnectionDecorator
All Implemented Interfaces:
ConnectionDecorator

public class LoggingConnectionDecorator
extends Object
implements ConnectionDecorator

A ConnectionDecorator that creates logging connections and ReportingSQLExceptions.

Author:
Marc Prud'hommeaux

Nested Class Summary
static interface LoggingConnectionDecorator.SQLWarningHandler
          Interface that allows customization of what to do when SQLWarnings occur.
 
Constructor Summary
LoggingConnectionDecorator()
           
 
Method Summary
 Connection decorate(Connection conn)
          Decorate the given connection if desired.
 DataSourceLogs getLogs()
          The log to write to.
 boolean getPrettyPrint()
           
 int getPrettyPrintLineLength()
           
 boolean getTrackParameters()
          Whether to track parameters for the purposes of reporting exceptions.
 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 setTrackParameters(boolean trackParameters)
          Whether to track parameters for the purposes of reporting exceptions.
 void setWarningAction(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)

setTrackParameters

public void setTrackParameters(boolean trackParameters)
Whether to track parameters for the purposes of reporting exceptions.


getTrackParameters

public boolean getTrackParameters()
Whether to track parameters for the purposes of reporting exceptions.


setWarningAction

public void setWarningAction(String warningAction)
What to do with SQL warnings.


getWarningAction

public 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 Connection decorate(Connection conn)
                    throws SQLException
Description copied from interface: ConnectionDecorator
Decorate the given connection if desired.

Specified by:
decorate in interface ConnectionDecorator
Throws:
SQLException


Copyright © 2006-2007 Apache Software Foundation. All Rights Reserved.