public interface DBConnectionTester
Modifier and Type | Method and Description |
---|---|
boolean |
isAuthFailure(java.sql.Connection connection,
java.sql.SQLException sql,
com.novell.nds.dirxml.driver.Trace trace)
Returns whether an authentication error has been encountered.
|
boolean |
isBad(java.sql.Connection connection,
java.sql.SQLException sql,
com.novell.nds.dirxml.driver.Trace trace)
Returns the state of
connection . |
boolean |
isBad(java.sql.Connection connection,
com.novell.nds.dirxml.driver.Trace trace)
Deprecated.
|
boolean |
isFatal(java.sql.Connection connection,
java.sql.SQLException sql,
com.novell.nds.dirxml.driver.Trace trace)
Returns whether a fatal error has been encountered.
|
boolean |
isRetry(java.sql.Connection connection,
java.sql.SQLException sql,
com.novell.nds.dirxml.driver.Trace trace)
Returns whether a timeout or retry condition has been encountered.
|
boolean isBad(java.sql.Connection connection, com.novell.nds.dirxml.driver.Trace trace)
connection
.
Statement
object be allocated. All operations MUST be read-only.
This method MUST close any allocated
Statement
or ResultSet
objects.
A finally block is recommended for this purpose.
Disregarding these constraints will likely cause the driver to malfunction.
connection
- the connection being tested; will not be null
trace
- allows messages to be output to DSTrace; will not be null
true
if connection
is bad;
false
if connection
is goodboolean isBad(java.sql.Connection connection, java.sql.SQLException sql, com.novell.nds.dirxml.driver.Trace trace)
connection
.
Statement
object be allocated. All operations MUST be read-only.
This method MUST close any allocated
Statement
or ResultSet
objects.
A finally block is recommended for this purpose.
Disregarding these constraints will likely cause the driver to malfunction.
connection
- the connection being tested; will not be null
sql
- contains database-specific error code info; will not be null
trace
- allows messages to be output to DSTrace; will not be null
true
if connection
is bad;
false
if connection
is goodboolean isRetry(java.sql.Connection connection, java.sql.SQLException sql, com.novell.nds.dirxml.driver.Trace trace)
Statement
object be allocated. All operations MUST be read-only.
This method MUST close any allocated
Statement
or ResultSet
objects.
A finally block is recommended for this purpose.
Disregarding these constraints will likely cause the driver to malfunction.
connection
- the connection object that generated sql
; will not be null
sql
- contains database-specific error code info; will not be null
trace
- allows messages to be output to DSTrace; will not be null
true
if a retry condition has been detected;
false
otherwiseboolean isAuthFailure(java.sql.Connection connection, java.sql.SQLException sql, com.novell.nds.dirxml.driver.Trace trace)
Statement
object be allocated. All operations MUST be read-only.
This method MUST close any allocated
Statement
or ResultSet
objects.
A finally block is recommended for this purpose.
Disregarding these constraints will likely cause the driver to malfunction.
connection
- the connection object that generated sql
; will not be null
sql
- contains database-specific error code info; will not be null
trace
- allows messages to be output to DSTrace; will not be null
true
if an authentication error has been detected;
false
otherwiseboolean isFatal(java.sql.Connection connection, java.sql.SQLException sql, com.novell.nds.dirxml.driver.Trace trace)
Statement
object be allocated. All operations MUST be read-only.
This method MUST close any allocated
Statement
or ResultSet
objects.
A finally block is recommended for this purpose.
Disregarding these constraints will likely cause the driver to malfunction.
connection
- the connection object that generated sql
; will not be null
sql
- contains database-specific error code info; will not be null
trace
- allows messages to be output to DSTrace; will not be null
true
if a fatal error has been detected;
false
otherwise