Class JdbcAccessorImpl
- java.lang.Object
-
- com.ibm.websphere.rsadapter.JdbcAccessorImpl
-
- All Implemented Interfaces:
- WSNativeConnectionAccessor
Deprecated.This class will likely be removed in a future release.
@Deprecated public class JdbcAccessorImpl extends java.lang.Object implements WSNativeConnectionAccessor
This class provides a conduit for the WebSphere ResourceAdapter CCI function to access the Native Connection. All Native Connection accesses are funneled through the methods on this object.This is the Generic JdbcAccessor, for accessing non-WebSphere-specific Native Connections.
A DataSource is passed to this object on the constructor. The getConnection() methods use the DataSource to create new Native Connections. The Native Connections are stored in the CCI Connection objects, and passed back to this object when a Native Connection method is invoked.
-
-
Constructor Summary
Constructors Constructor and Description JdbcAccessorImpl()
Deprecated.JdbcAccessorImpl(javax.sql.DataSource datasource)
Deprecated.This constructor takes a Datasource as an input parameter.
-
Method Summary
Methods Modifier and Type Method and Description void
clearWarnings(java.lang.Object nativeConnection, WSInteractionSpec interactionSpec)
Deprecated.This method clears all the warnings for an Interaction associated with the Native Connection.void
close(java.lang.Object nativeConnection)
Deprecated.This method initiates a close of the connection.java.lang.Object
getConnection()
Deprecated.This method gets a native connection.java.lang.Object
getConnection(WSCciConnectionSpec connectionSpec)
Deprecated.This method gets a native connection.javax.resource.cci.ConnectionMetaData
getMetaData(java.lang.Object nativeConnection)
Deprecated.This method gets the information on the underlying database instance represented through an active connection.javax.resource.cci.ResultSetInfo
getResultSetInfo(java.lang.Object nativeConnection)
Deprecated.This method returns an object from which information on the ResultSet functionality can be determined.javax.resource.cci.ResourceWarning
getWarnings(java.lang.Object nativeConnection, WSInteractionSpec interactionSpec)
Deprecated.This method returns the first ResourceWarning of the chain of warnings for an Interaction associated with the Native Connection.boolean
isClosed(java.lang.Object nativeConnection)
Deprecated.This method checks to see if the native connection is closed.void
localTransactionBegin(java.lang.Object nativeConnection)
Deprecated.This method initiates a local transaction begin().void
localTransactionCommit(java.lang.Object nativeConnection)
Deprecated.This method initiates a local transaction commit().void
localTransactionRollback(java.lang.Object nativeConnection)
Deprecated.This method initiates a local transaction rollback().
-
-
-
Constructor Detail
-
JdbcAccessorImpl
public JdbcAccessorImpl()
Deprecated.
-
JdbcAccessorImpl
public JdbcAccessorImpl(javax.sql.DataSource datasource)
Deprecated.This constructor takes a Datasource as an input parameter. The getConnection() methods use the DataSource to create native Connections.The parameter is required -- NullPointerExceptions might occur if it is null.
- Parameters:
datasource
- - a javax.sql.DataSource
-
-
Method Detail
-
getConnection
public java.lang.Object getConnection(WSCciConnectionSpec connectionSpec) throws javax.resource.ResourceException
Deprecated.This method gets a native connection. A component must use the getConnection variant with com.ibm.websphere.rsadapter.WSConnectionSpec parameter if it needs to pass any resource adapter specific security information and connection parameters. In the component-managed sign-on case, an application component passes security information (example: username, password) through the ConnectionSpec instance.It is important to note that the properties passed through the getConnection method are be client-specific (for example: username, password, language) and not related to the configuration of a target database instance (example: port number, server name). The ManagedConnectionFactory instance is configured with the complete set of properties required for the creation of a connection to a database instance.
- Specified by:
getConnection
in interfaceWSNativeConnectionAccessor
- Parameters:
connectionSpec
- - Connection parameters and security information specified as a com.ibm.websphere.rsadapter.WSConnectionSpec instance- Returns:
- a Native Connection instance
- Throws:
javax.resource.ResourceException
- - Failed to get a connection instance. Examples of error cases are:- Specification of input parameters that are not valid
- Configuration of ManagedConnectionFactory that is not valid; for example: a server name that is not valid
- Application server-internal error; for example: connection pool related error
- Communication error
- EIS-specific error; for example: database not active
- Resource adapter-internal error
- Security related error; for example: user that is not valid
- Failure to allocate system resources
-
getConnection
public java.lang.Object getConnection() throws javax.resource.ResourceException
Deprecated.This method gets a native connection. Use this getConnection variant when a component wants the container to manage EIS sign-on. This case is termed container-managed sign-on. The component does not pass any security information.- Specified by:
getConnection
in interfaceWSNativeConnectionAccessor
- Returns:
- a Native Connection instance
- Throws:
javax.resource.ResourceException
- - Failed to get a connection instance. Examples of error cases are:- Configuration that is not valid of ManagedConnectionFactory; for example: a server name that is not valid
- Application server-internal error; for example: connection pool related error
- Communication error
- EIS-specific error; for example: EIS not active
- Resource adapter-internal error
- Security related error; example: user that is not
- Failure to allocate system resources
-
close
public void close(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method initiates a close of the connection. A client should not use a closed connection.- Specified by:
close
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection on which to do the close()- Throws:
javax.resource.ResourceException
- - Exception thrown if close on a connection fails.Any invalid connection close invocation--example, calling close on a connection that is already closed--should also throw this exception.
-
isClosed
public boolean isClosed(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method checks to see if the native connection is closed.- Specified by:
isClosed
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection on which to do isClosed()- Throws:
javax.resource.ResourceException
- - Exception thrown if there is a problem checking if the connection is closed.
-
clearWarnings
public void clearWarnings(java.lang.Object nativeConnection, WSInteractionSpec interactionSpec) throws javax.resource.ResourceException
Deprecated.This method clears all the warnings for an Interaction associated with the Native Connection.- Specified by:
clearWarnings
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection associated with the InteractioninteractionSpec
- - the WSInteractionSpec associated with the Interaction- Throws:
javax.resource.ResourceException
- - Failed to clear ResourceWarnings
-
getWarnings
public javax.resource.cci.ResourceWarning getWarnings(java.lang.Object nativeConnection, WSInteractionSpec interactionSpec) throws javax.resource.ResourceException
Deprecated.This method returns the first ResourceWarning of the chain of warnings for an Interaction associated with the Native Connection.- Specified by:
getWarnings
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection associated with the InteractioninteractionSpec
- - the WSInteractionSpec associated with the Interaction- Returns:
- - the ResourceWarning at top of the warning chain or null if there are none
- Throws:
javax.resource.ResourceException
- - Failed to get ResourceWarnings
-
localTransactionBegin
public void localTransactionBegin(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method initiates a local transaction begin().- Specified by:
localTransactionBegin
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection on which to do the begin()- Throws:
javax.resource.ResourceException
- - Failed to begin a local transaction
-
localTransactionCommit
public void localTransactionCommit(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method initiates a local transaction commit().- Specified by:
localTransactionCommit
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection on which to do the commit()- Throws:
javax.resource.ResourceException
- - Failed to commit a local transaction
-
localTransactionRollback
public void localTransactionRollback(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method initiates a local transaction rollback().- Specified by:
localTransactionRollback
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection on which to do the rollback()- Throws:
javax.resource.ResourceException
- - Failed to roll back a local transaction
-
getMetaData
public javax.resource.cci.ConnectionMetaData getMetaData(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method gets the information on the underlying database instance represented through an active connection.- Specified by:
getMetaData
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection from which to get the MetaData- Returns:
- a javax.resource.cci.ConnectionMetaData instance representing information about the database instance
- Throws:
javax.resource.ResourceException
- - Failed to get information about the connected database instance. Error can be resource adapter-internal, EIS-specific or communication related.
-
getResultSetInfo
public javax.resource.cci.ResultSetInfo getResultSetInfo(java.lang.Object nativeConnection) throws javax.resource.ResourceException
Deprecated.This method returns an object from which information on the ResultSet functionality can be determined.- Specified by:
getResultSetInfo
in interfaceWSNativeConnectionAccessor
- Parameters:
nativeConnection
- - the Connection used by the returned object to get the ResultSetInfo- Returns:
- a javax.resource.cci.ResultSetInfo instance
- Throws:
javax.resource.ResourceException
- - Failed to get ResultSet related information
-
-