Package org.apache.derby.client.net
Class ClientJDBCObjectFactoryImpl
java.lang.Object
org.apache.derby.client.net.ClientJDBCObjectFactoryImpl
- All Implemented Interfaces:
ClientJDBCObjectFactory
- Direct Known Subclasses:
ClientJDBCObjectFactoryImpl42
Implements the the ClientJDBCObjectFactory interface and returns the classes
that implement the JDBC3.0/2.0 interfaces
For example, newCallableStatement would return ClientCallableStatement
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final MessageUtil
The message utility instance we use to find messages It's primed with the name of the client message bundle so that it knows to look there if the message isn't found in the shared message bundle. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected BatchUpdateException
newBatchUpdateException
(String message, String sqlState, int errorCode, long[] updateCounts, SqlException cause) This method is overridden on JVM 8newBatchUpdateException
(LogWriter logWriter, ClientMessageId msgid, Object[] args, long[] updateCounts, SqlException cause) Creates a BatchUpdateException depending on the JVM level.newCachingLogicalConnection
(ClientConnection physicalConnection, ClientPooledConnection pooledConnection, JDBCStatementCache stmtCache) Returns an instance of aCachingLogicalConnection
, which provides caching of prepared statements.newCallableStatement
(Agent agent, ClientConnection connection, String sql, int type, int concurrency, int holdability, ClientPooledConnection cpc) Returns an instance of ClientCallableStatement.newClientPooledConnection
(BasicClientDataSource40 ds, LogWriter logWriter, String user, String password) This method is used to return an instance of theClientPooledConnection
class which implementsjavax.sql.PooledConnection
.newClientXAConnection
(BasicClientDataSource40 ds, LogWriter logWriter, String user, String password) This method is used to return an instance of ClientXAConnection (or ClientXAConnection40) class which implementsjavax.sql.XAConnection
.newColumnMetaData
(LogWriter logWriter) Returns an instance of ColumnMetaDatanewColumnMetaData
(LogWriter logWriter, int upperBound) Returns an instance of ColumnMetaData or ColumnMetaData40 depending on the JDK version under usenewLogicalCallableStatement
(CallableStatement cs, StatementKey stmtKey, StatementCacheInteractor cacheInteractor) Returns a new logical callable statement object.newLogicalConnection
(ClientConnection physicalConnection, ClientPooledConnection pooledConnection) Returns an instance of LogicalConnection.newLogicalPreparedStatement
(PreparedStatement ps, StatementKey stmtKey, StatementCacheInteractor cacheInteractor) Returns a new logical prepared statement object.newNetConnection
(LogWriter logWriter, int driverManagerLoginTimeout, String serverName, int portNumber, String databaseName, Properties properties) This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection this implements the java.sql.Connection interfacenewNetConnection
(LogWriter logWriter, String user, String password, BasicClientDataSource40 dataSource, int rmId, boolean isXAConn) This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection.newNetConnection
(LogWriter logWriter, String user, String password, BasicClientDataSource40 dataSource, int rmId, boolean isXAConn, ClientPooledConnection cpc) Returns an instance of NetConnection.newNetDatabaseMetaData
(Agent netAgent, ClientConnection netConnection) This method provides an instance of NetDatabaseMetaData (or NetDatabaseMetaData40) which extends from ClientDatabaseMetaData which implementsjava.sql.DatabaseMetaData
.newNetResultSet
(Agent netAgent, MaterialStatement netStatement, Cursor cursor, int qryprctyp, int sqlcsrhld, int qryattscr, int qryattsns, int qryattset, long qryinsid, int actualResultSetType, int actualResultSetConcurrency, int actualResultSetHoldability) This method returns an instance of NetResultSet(or NetResultSet40) which extends from ClientResultSet which implementsjava.sql.ResultSet
.newParameterMetaData
(ColumnMetaData columnMetaData) returns an instance of ParameterMetaDatanewPreparedStatement
(Agent agent, ClientConnection connection, String sql, int type, int concurrency, int holdability, int autoGeneratedKeys, String[] columnNames, int[] columnIndexes, ClientPooledConnection cpc) This method returns an instance of ClientPreparedStatement which implementsjava.sql.PreparedStatement
.newPreparedStatement
(Agent agent, ClientConnection connection, String sql, Section section, ClientPooledConnection cpc) This method returns an instance of ClientPreparedStatement which implements java.sql.PreparedStatement.newStatement
(Agent agent, ClientConnection connection, int type, int concurrency, int holdability, int autoGeneratedKeys, String[] columnNames, int[] columnIndexes) This method provides an instance of Statement
-
Field Details
-
msgutil_
The message utility instance we use to find messages It's primed with the name of the client message bundle so that it knows to look there if the message isn't found in the shared message bundle.
-
-
Constructor Details
-
ClientJDBCObjectFactoryImpl
public ClientJDBCObjectFactoryImpl()
-
-
Method Details
-
newClientPooledConnection
public ClientPooledConnection newClientPooledConnection(BasicClientDataSource40 ds, LogWriter logWriter, String user, String password) throws SQLException Description copied from interface:ClientJDBCObjectFactory
This method is used to return an instance of theClientPooledConnection
class which implementsjavax.sql.PooledConnection
.- Specified by:
newClientPooledConnection
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
ClientPooledConnection
- Throws:
SQLException
-
newClientXAConnection
public ClientXAConnection newClientXAConnection(BasicClientDataSource40 ds, LogWriter logWriter, String user, String password) throws SQLException Description copied from interface:ClientJDBCObjectFactory
This method is used to return an instance of ClientXAConnection (or ClientXAConnection40) class which implementsjavax.sql.XAConnection
.- Specified by:
newClientXAConnection
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
ClientXAConnection
- Throws:
SQLException
-
newCallableStatement
public ClientCallableStatement newCallableStatement(Agent agent, ClientConnection connection, String sql, int type, int concurrency, int holdability, ClientPooledConnection cpc) throws SqlException Returns an instance of ClientCallableStatement.- Specified by:
newCallableStatement
in interfaceClientJDBCObjectFactory
- Parameters:
agent
- The instance of NetAgent associated with thisClientCallableStatement
object.connection
- The connection object associated with this PreparedStatement Object.sql
- A String object that is the SQL statement to be sent to the database.type
- One of the ResultSet type constantsconcurrency
- One of the ResultSet concurrency constantsholdability
- One of the ResultSet holdability constantscpc
- The PooledConnection object that will be used to notify the PooledConnection reference of the Error Occurred and the Close events.- Returns:
- a
ClientCallableStatement
object - Throws:
SqlException
-
newLogicalConnection
public LogicalConnection newLogicalConnection(ClientConnection physicalConnection, ClientPooledConnection pooledConnection) throws SqlException Description copied from interface:ClientJDBCObjectFactory
Returns an instance of LogicalConnection. This method returns an instance of LogicalConnection (or LogicalConnection40) which implementsjava.sql.Connection
.- Specified by:
newLogicalConnection
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
LogicalConnection
- Throws:
SqlException
-
newCachingLogicalConnection
public LogicalConnection newCachingLogicalConnection(ClientConnection physicalConnection, ClientPooledConnection pooledConnection, JDBCStatementCache stmtCache) throws SqlException Returns an instance of aCachingLogicalConnection
, which provides caching of prepared statements.- Specified by:
newCachingLogicalConnection
in interfaceClientJDBCObjectFactory
- Parameters:
physicalConnection
- the underlying physical connectionpooledConnection
- the pooled connectionstmtCache
- statement cache- Returns:
- A logical connection with statement caching capabilities.
- Throws:
SqlException
- if creation of the logical connection fails
-
newPreparedStatement
public ClientPreparedStatement newPreparedStatement(Agent agent, ClientConnection connection, String sql, Section section, ClientPooledConnection cpc) throws SqlException This method returns an instance of ClientPreparedStatement which implements java.sql.PreparedStatement. It has the ClientPooledConnection as one of its parameters this is used to raise the Statement Events when the prepared statement is closed.- Specified by:
newPreparedStatement
in interfaceClientJDBCObjectFactory
- Parameters:
agent
- The instance of NetAgent associated with thisClientCallableStatement
object.connection
- The connection object associated with this PreparedStatement Object.sql
- A String object that is the SQL statement to be sent to the database.section
- Sectioncpc
- The ClientPooledConnection wraps the underlying physical connection associated with this prepared statement. It is used to pass the Statement closed and the Statement error occurred events that occur back to the ClientPooledConnection.- Returns:
- a PreparedStatement object
- Throws:
SqlException
-
newPreparedStatement
public ClientPreparedStatement newPreparedStatement(Agent agent, ClientConnection connection, String sql, int type, int concurrency, int holdability, int autoGeneratedKeys, String[] columnNames, int[] columnIndexes, ClientPooledConnection cpc) throws SqlException This method returns an instance of ClientPreparedStatement which implementsjava.sql.PreparedStatement
. It has theClientPooledConnection
as one of its parameters this is used to raise the Statement Events when the prepared statement is closed.- Specified by:
newPreparedStatement
in interfaceClientJDBCObjectFactory
- Parameters:
agent
- The instance of NetAgent associated with thisClientCallableStatement
object.connection
- The connection object associated with this PreparedStatement Object.sql
- A String object that is the SQL statement to be sent to the database.type
- One of the ResultSet type constants.concurrency
- One of the ResultSet concurrency constants.holdability
- One of the ResultSet holdability constants.autoGeneratedKeys
- a flag indicating whether auto-generated keys should be returned.columnNames
- an array of column names indicating the columns that should be returned from the inserted row or rows.columnIndexes
- an array of column indexes indicating the columns that should be returned form the inserted row.cpc
- The ClientPooledConnection wraps the underlying physical connection associated with this prepared statement it is used to pass the Statement closed and the Statement error occurred events that occur back to the ClientPooledConnection.- Returns:
- a PreparedStatement object
- Throws:
SqlException
-
newLogicalPreparedStatement
public LogicalPreparedStatement newLogicalPreparedStatement(PreparedStatement ps, StatementKey stmtKey, StatementCacheInteractor cacheInteractor) Returns a new logical prepared statement object.- Specified by:
newLogicalPreparedStatement
in interfaceClientJDBCObjectFactory
- Parameters:
ps
- underlying physical prepared statementstmtKey
- key for the underlying physical prepared statementcacheInteractor
- the statement cache interactor- Returns:
- A logical prepared statement.
-
newLogicalCallableStatement
public LogicalCallableStatement newLogicalCallableStatement(CallableStatement cs, StatementKey stmtKey, StatementCacheInteractor cacheInteractor) Returns a new logical callable statement object.- Specified by:
newLogicalCallableStatement
in interfaceClientJDBCObjectFactory
- Parameters:
cs
- underlying physical callable statementstmtKey
- key for the underlying physical callable statementcacheInteractor
- the statement cache interactor- Returns:
- A logical callable statement.
-
newNetConnection
public ClientConnection newNetConnection(LogWriter logWriter, int driverManagerLoginTimeout, String serverName, int portNumber, String databaseName, Properties properties) throws SqlException Description copied from interface:ClientJDBCObjectFactory
This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection this implements the java.sql.Connection interface- Specified by:
newNetConnection
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
NetConnection
- Throws:
SqlException
-
newNetConnection
public ClientConnection newNetConnection(LogWriter logWriter, String user, String password, BasicClientDataSource40 dataSource, int rmId, boolean isXAConn) throws SqlException Description copied from interface:ClientJDBCObjectFactory
This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection. This implements thejava.sql.Connection
interface.- Specified by:
newNetConnection
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
NetConnection
- Throws:
SqlException
-
newNetConnection
public ClientConnection newNetConnection(LogWriter logWriter, String user, String password, BasicClientDataSource40 dataSource, int rmId, boolean isXAConn, ClientPooledConnection cpc) throws SqlException Returns an instance of NetConnection.- Specified by:
newNetConnection
in interfaceClientJDBCObjectFactory
- Parameters:
logWriter
- LogWriter object associated with this connection.user
- user id for this connection.password
- password for this connection.dataSource
- The DataSource object passed from the PooledConnection object from which this constructor was called.rmId
- The Resource Manager ID for XA ConnectionsisXAConn
- true if this is a XA connectioncpc
- The ClientPooledConnection object from which this NetConnection constructor was called. This is used to pass StatementEvents back to the pooledConnection object.- Returns:
- a
ClientConnection
object - Throws:
SqlException
-
newNetResultSet
public ClientResultSet newNetResultSet(Agent netAgent, MaterialStatement netStatement, Cursor cursor, int qryprctyp, int sqlcsrhld, int qryattscr, int qryattsns, int qryattset, long qryinsid, int actualResultSetType, int actualResultSetConcurrency, int actualResultSetHoldability) throws SqlException Description copied from interface:ClientJDBCObjectFactory
This method returns an instance of NetResultSet(or NetResultSet40) which extends from ClientResultSet which implementsjava.sql.ResultSet
.- Specified by:
newNetResultSet
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
NetResultSet
- Throws:
SqlException
-
newNetDatabaseMetaData
public ClientDatabaseMetaData newNetDatabaseMetaData(Agent netAgent, ClientConnection netConnection) Description copied from interface:ClientJDBCObjectFactory
This method provides an instance of NetDatabaseMetaData (or NetDatabaseMetaData40) which extends from ClientDatabaseMetaData which implementsjava.sql.DatabaseMetaData
.- Specified by:
newNetDatabaseMetaData
in interfaceClientJDBCObjectFactory
- Returns:
- an instance of
NetDatabaseMetaData
-
newStatement
public ClientStatement newStatement(Agent agent, ClientConnection connection, int type, int concurrency, int holdability, int autoGeneratedKeys, String[] columnNames, int[] columnIndexes) throws SqlException This method provides an instance of Statement- Specified by:
newStatement
in interfaceClientJDBCObjectFactory
- Parameters:
agent
- Agentconnection
- Connectiontype
- intconcurrency
- intholdability
- intautoGeneratedKeys
- intcolumnNames
- String[]columnIndexes
- int[]- Returns:
- a ClientStatement implementation
- Throws:
SqlException
-
newColumnMetaData
Returns an instance of ColumnMetaData- Specified by:
newColumnMetaData
in interfaceClientJDBCObjectFactory
- Parameters:
logWriter
- LogWriter- Returns:
- a ColumnMetaData implementation
-
newColumnMetaData
Returns an instance of ColumnMetaData or ColumnMetaData40 depending on the JDK version under use- Specified by:
newColumnMetaData
in interfaceClientJDBCObjectFactory
- Parameters:
logWriter
- LogWriterupperBound
- int- Returns:
- a ColumnMetaData implementation
-
newParameterMetaData
returns an instance of ParameterMetaData- Specified by:
newParameterMetaData
in interfaceClientJDBCObjectFactory
- Parameters:
columnMetaData
- ColumnMetaData- Returns:
- a ParameterMetaData implementation
-
newBatchUpdateException
public BatchUpdateException newBatchUpdateException(LogWriter logWriter, ClientMessageId msgid, Object[] args, long[] updateCounts, SqlException cause) Creates a BatchUpdateException depending on the JVM level.- Specified by:
newBatchUpdateException
in interfaceClientJDBCObjectFactory
-
newBatchUpdateException
protected BatchUpdateException newBatchUpdateException(String message, String sqlState, int errorCode, long[] updateCounts, SqlException cause) This method is overridden on JVM 8
-