public Interface Accessor

Begin a transaction on the data store.

Return a clone of the accessor.

Close the accessor's connection. This is used only for external connection pooling when it is intended for the connection to be reconnected in the future.

Called from beforeCompletion external transaction synchronization listener callback to close the external connection corresponding to the completing external transaction. Final sql calls could be sent through the connection by this method before it closes the connection.

Commit a transaction on the data store.

Connect to the data store using the configuration information in the login.

Attempts to create ConnectionCustomizer. If created the customizer is cached by the accessor. Called by the owner of accessor (DatabaseSession, ServerSession through ConnectionPool) just once, typically right after the accessor is created. Also called by ClientSession when it acquires write accessor. If accessor already has a customizer set by ConnectionPool then ClientSession's customizer compared with the existing one and if they are not equal (don't produce identical customization) then the new customizer set onto accessor, caching the old customizer so that it could be restored later.

Decrement the number of calls in progress. Used for external pooling.

Disconnect from the data store.

Execute the call. The actual behavior of the execution depends on the type of call. The call may be parameterized where the arguments are in the translation row. The row will be empty if there are no parameters.

Returns:Object

a row, a collection of rows, a row count, or a cursor

Execute any deferred select calls. This method will generally be called after one or more select calls have been collected in a LOBValueWriter (to be executed after all insert calls are executed). Bug 2804663.

See Also

org.eclipse.persistence.internal.helper.LOBValueWriter#buildAndExecuteSelectCalls(AbstractSession)

Return the number of calls currently in progress. Used for load balancing and external pooling.

Return the column metadata for the specified selection criteria.

Return the column metadata for the specified selection criteria limited to the context of the current Accessor.

Return the JDBC connection for relational accessors. This will fail for non-relational accessors.

Return the driver level connection, this will need to be cast to the implementation class for the data access type being used.

Return the associated connection pool this connection was obtained from.

Return sequencing callback.

Return the table metadata for the specified selection criteria.

Return the table metadata for the specified selection criteria limited to the context of the current Accessor.

Increment the number of calls in progress. Used for external pooling.

Return whether the accessor is connected to the data store.

Return whether the accessor is in transaction.

Returns true if this Accessor can continue to be used. This will be false if a communication failure occurred during a call execution. In the case of an invalid accessor the Accessor will not be returned to the pool.

Reconnect to the database. This can be used if the connection was temporarily disconnected or if it timed out.

Clear customizer if it's active and set it to null. Called by the same object that has created customizer (DatabaseSession, ConnectionPool) when the latter is no longer required, typically before releasing the accessor. Ignored if there's no customizer.

Clear and remove customizer if its session is the same as the passed one; in case prevCustomizer exists set it as a new customizer. Called when ClientSession releases write accessor: if the customizer was created by the ClientSession it's removed, and the previous customizer (that ConnectionPool had set) is brought back; otherwise the customizer (created by ConnectionPool) is kept. Ignored if there's no customizer.

Reset the accessor before being released.

Roll back a transaction on the data store.

This should be set to false if a communication failure occurred durring a call execution. In the case of an invalid accessor the Accessor will not be returned to the pool.

Set the associated connection pool this connection was obtained from.

Return whether the accessor uses external connection pooling.

Return whether the accessor uses an external transaction controller (e.g. JTS).

This method will be called after a series of writes have been issued to mark where a particular set of writes has completed. It will be called from commitTransaction and may be called from writeChanges. Its main purpose is to ensure that the batched statements have been executed