org.ofbiz.core.entity.jdbc.interceptors.connection

Class SafeDelegatingSqlConnectionInterceptor

java.lang.Object

org.ofbiz.core.entity.jdbc.interceptors.connection.SafeDelegatingSqlConnectionInterceptor

All Implemented Interfaces:

SQLConnectionInterceptor, SQLInterceptor

public class SafeDelegatingSqlConnectionInterceptor
extends Object
implements SQLConnectionInterceptor

Wraps a SQLConnectionInterceptor such that the callbacks are guaranteed not to throw runtime exceptions or linkage errors.

Since:

v1.0.67 / v1.1.7

Constructor Summary

Constructors

Constructor and Description
SafeDelegatingSqlConnectionInterceptor(SQLConnectionInterceptor delegate)

Method Summary

Modifier and Type	Method and Description
void	afterSuccessfulExecution(String sqlString, List<String> parameterValues, Statement statement, ResultSet resultSet, int rowsUpdated) This is called after a successful (ie no SQLException generated) JDBC query is run.
void	beforeExecution(String sqlString, List<String> parameterValues, Statement statement) This is called before an JDBC query is run.
void	onConnectionReplaced(Connection connection, ConnectionPoolState connectionPoolState) Called when a connection is returned to the underlying pool
void	onConnectionTaken(Connection connection, ConnectionPoolState connectionPoolState) Called when a connection is taken from the underlying pool
void	onException(String sqlString, List<String> parameterValues, Statement statement, SQLException sqlException) This is called if an SQLException is thrown during the JDBC query If this method runs then by design the SQLInterceptor.afterSuccessfulExecution(String, java.util.List, java.sql.Statement, java.sql.ResultSet, int) (String, java.util.List, java.sql.Statement, java.sql.SQLException)} will have NOT run.

Methods inherited from class java.lang.Object

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

Constructor Detail

SafeDelegatingSqlConnectionInterceptor

public SafeDelegatingSqlConnectionInterceptor(SQLConnectionInterceptor delegate)

Method Detail

onConnectionTaken

public void onConnectionTaken(Connection connection,
                              ConnectionPoolState connectionPoolState)

Description copied from interface: SQLConnectionInterceptor

Called when a connection is taken from the underlying pool

Specified by:

onConnectionTaken in interface SQLConnectionInterceptor

Parameters:

connection - the connection that has been borrowed

connectionPoolState - info about the connection pool in at the time the connection was taken

onConnectionReplaced

public void onConnectionReplaced(Connection connection,
                                 ConnectionPoolState connectionPoolState)

Description copied from interface: SQLConnectionInterceptor

Called when a connection is returned to the underlying pool

Specified by:

onConnectionReplaced in interface SQLConnectionInterceptor

Parameters:

connection - the connection that has been returned

connectionPoolState - info about the connection pool in at the time the connection was taken

beforeExecution

public void beforeExecution(String sqlString,
                            List<String> parameterValues,
                            Statement statement)

Description copied from interface: SQLInterceptor

This is called before an JDBC query is run.

Specified by:

beforeExecution in interface SQLInterceptor

Parameters:

sqlString - thw SQL string in play

parameterValues - this list of the Java parameters passed to this statement. This is a simple String.valueOf() on these parameters

statement - the JDBC Statement in play

afterSuccessfulExecution

public void afterSuccessfulExecution(String sqlString,
                                     List<String> parameterValues,
                                     Statement statement,
                                     ResultSet resultSet,
                                     int rowsUpdated)

Description copied from interface: SQLInterceptor

This is called after a successful (ie no SQLException generated) JDBC query is run.

If this method runs then by design the SQLInterceptor.onException(String, java.util.List, java.sql.Statement, java.sql.SQLException) will NOT run.

Specified by:

afterSuccessfulExecution in interface SQLInterceptor

Parameters:

sqlString - the SQL string in play

parameterValues - this list of the Java parameters passed to this statement. This is a simple String.valueOf() on these parameters

statement - the JDBC Statement in play

resultSet - a JDBC ResultSet. In the case of an update, this will be NULL.

rowsUpdated - the number of rows updated. In the case of a SELECT, this will be -1

onException

public void onException(String sqlString,
                        List<String> parameterValues,
                        Statement statement,
                        SQLException sqlException)

Description copied from interface: SQLInterceptor

This is called if an SQLException is thrown during the JDBC query

If this method runs then by design the SQLInterceptor.afterSuccessfulExecution(String, java.util.List, java.sql.Statement, java.sql.ResultSet, int) (String, java.util.List, java.sql.Statement, java.sql.SQLException)} will have NOT run.

Specified by:

onException in interface SQLInterceptor

Parameters:

sqlString - thw SQL string in play

parameterValues - this list of the Java parameters passed to this statement. This is a simple String.valueOf() on these parameters

statement - the JDBC Statement in play

sqlException - the exception that occurred