java.sql

Interface Wrapper

All Known Subinterfaces:

CallableStatement, Connection, DatabaseMetaData, DataSource, ParameterMetaData, PreparedStatement, ResultSet, ResultSetMetaData, RowSet, RowSetMetaData, Statement

All Known Implementing Classes:

JDBCConnection, JDBCDatabaseMetaData, JDBCPreparedStatement, JDBCResultSet, JDBCResultSetMetaData, JDBCStatement

public interface Wrapper

This class is an actual usage of the wrapper pattern for JDBC classes. Developers can get the delegate instance when the instance may be a proxy class.

Since:

1.6

Method Summary

Modifier and Type	Method and Description
boolean	isWrapperFor(Class<?> iface) If the caller is a wrapper of the class or implements the given interface, the methods return false and vice versa.
<T> T	unwrap(Class<T> iface) Returns an object that implements the given interface.

Method Detail

unwrap

<T> T unwrap(Class<T> iface)
      throws SQLException

Returns an object that implements the given interface. If the caller is not a wrapper, a SQLException will be thrown.

Parameters:

iface - - the class that defines the interface

Returns:

- an object that implements the interface

Throws:

SQLException - - if there is no object implementing the specific interface

isWrapperFor

boolean isWrapperFor(Class<?> iface)
              throws SQLException

If the caller is a wrapper of the class or implements the given interface, the methods return false and vice versa.

Parameters:

iface - - the class that defines the interface

Returns:

- true if the instance implements the interface

Throws:

SQLException - - when an error occurs when judges the object