Package org.eclipse.persistence.eis

Class EISAccessor

  • All Implemented Interfaces:
    java.lang.Cloneable, org.eclipse.persistence.internal.databaseaccess.Accessor
    public class EISAccessor
extends org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor

    EISAccessor is an implementation of the Accessor interface. It is responsible for:

    • Connecting via connection factory
    • Local transactions
    • Interaction execution
    • Record translation
    See Also:
    EISInteraction, EISLogin
    Author:
    James
    Since:
    OracleAS TopLink 10g (10.0.3)

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected javax.resource.cci.Connection cciConnection  
      protected javax.resource.cci.RecordFactory recordFactory  

      • Fields inherited from class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor

        callCount, currentSession, customizer, datasourceConnection, isConnected, isInTransaction, isValid, login, platform, pool, possibleFailure, READ_STATEMENTS_COUNT_PROPERTY, readStatementsCount, sequencingCallback, shouldCheckConnection, STOREDPROCEDURE_STATEMENTS_COUNT_PROPERTY, storedProcedureStatementsCount, usesExternalConnectionPooling, WRITE_STATEMENTS_COUNT_PROPERTY, writeStatementsCount

    • Constructor Summary

      Constructors 
      Constructor Description
      EISAccessor()
      Default Constructor.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      protected void basicBeginTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
      Begin a local transaction.
      protected void basicCommitTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
      Commit the local transaction.
      java.lang.Object basicExecuteCall​(Call call, org.eclipse.persistence.internal.sessions.AbstractRecord translationRow, org.eclipse.persistence.internal.sessions.AbstractSession session)
      Execute the interaction.
      void basicRollbackTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
      Rollback the local transaction on the datasource.
      protected void buildConnectLog​(org.eclipse.persistence.internal.sessions.AbstractSession session)
      If logging is turned on and the CCI implementation supports meta data then display connection info.
      protected void closeDatasourceConnection()
      Close the connection.
      java.lang.Object executeCall​(Call call, org.eclipse.persistence.internal.sessions.AbstractRecord translationRow, org.eclipse.persistence.internal.sessions.AbstractSession session)
      Avoid super to have logging occur after possible manual auto-commit.
      javax.resource.cci.Connection getCCIConnection()
      Return the CCI connection to the EIS resource adapter.
      EISPlatform getEISPlatform()
      Return and cast the platform.
      javax.resource.cci.RecordFactory getRecordFactory()
      Return the RecordFactory.
      protected boolean isDatasourceConnected()
      Return if the connection to the "data source" is connected.
      void setRecordFactory​(javax.resource.cci.RecordFactory recordFactory)
      Set the RecordFactory.

      • Methods inherited from class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor

        beginTransaction, clone, closeConnection, closeJTSConnection, commitTransaction, connect, connectInternal, createCustomizer, decrementCallCount, disconnect, flushSelectCalls, getCallCount, getColumnInfo, getConnection, getDatasourceConnection, getDatasourcePlatform, getLogin, getPool, getReadStatementsCount, getSequencingCallback, getStoredProcedureStatementsCount, getTableInfo, getWriteStatementsCount, incrementCallCount, isConnected, isInTransaction, isPossibleFailure, isValid, reconnect, reestablishConnection, reestablishCustomizer, releaseCustomizer, releaseCustomizer, reset, rollbackTransaction, setCallCount, setCustomizer, setDatasourceConnection, setDatasourcePlatform, setIsConnected, setIsInTransaction, setIsValid, setLogin, setPool, setPossibleFailure, usesExternalConnectionPooling, usesExternalTransactionController, writesCompleted

      • Methods inherited from class java.lang.Object

        equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • cciConnection

        protected javax.resource.cci.Connection cciConnection

      • recordFactory

        protected javax.resource.cci.RecordFactory recordFactory

    • Constructor Detail

      • EISAccessor

        public EISAccessor()
        Default Constructor.

    • Method Detail

      • basicBeginTransaction

        protected void basicBeginTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
                              throws EISException
        Begin a local transaction.
        Specified by:
        basicBeginTransaction in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor
        Throws:
        EISException

      • closeDatasourceConnection

        protected void closeDatasourceConnection()
        Close the connection.
        Specified by:
        closeDatasourceConnection in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor

      • basicCommitTransaction

        protected void basicCommitTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
                               throws EISException
        Commit the local transaction.
        Specified by:
        basicCommitTransaction in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor
        Throws:
        EISException

      • buildConnectLog

        protected void buildConnectLog​(org.eclipse.persistence.internal.sessions.AbstractSession session)
        If logging is turned on and the CCI implementation supports meta data then display connection info.
        Specified by:
        buildConnectLog in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor

      • executeCall

        public java.lang.Object executeCall​(Call call,
                                    org.eclipse.persistence.internal.sessions.AbstractRecord translationRow,
                                    org.eclipse.persistence.internal.sessions.AbstractSession session)
                             throws DatabaseException
        Avoid super to have logging occur after possible manual auto-commit.
        Specified by:
        executeCall in interface org.eclipse.persistence.internal.databaseaccess.Accessor
        Overrides:
        executeCall in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor
        Throws:
        DatabaseException

      • basicExecuteCall

        public java.lang.Object basicExecuteCall​(Call call,
                                         org.eclipse.persistence.internal.sessions.AbstractRecord translationRow,
                                         org.eclipse.persistence.internal.sessions.AbstractSession session)
                                  throws DatabaseException
        Execute the interaction. The execution can differ slightly depending on the type of interaction. The call may be parameterized where the arguments are in the translation row. The row will be empty if there are no parameters.
        Specified by:
        basicExecuteCall in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor
        Returns:
        depending of the type either the row count, row or vector of rows.
        Throws:
        DatabaseException

      • getCCIConnection

        public javax.resource.cci.Connection getCCIConnection()
        Return the CCI connection to the EIS resource adapter.

      • getEISPlatform

        public EISPlatform getEISPlatform()
        Return and cast the platform.

      • getRecordFactory

        public javax.resource.cci.RecordFactory getRecordFactory()
        Return the RecordFactory. The record factory is acquired from the ConnectionManager, and used to create record to pass to interactions.

      • setRecordFactory

        public void setRecordFactory​(javax.resource.cci.RecordFactory recordFactory)
        Set the RecordFactory. The record factory is acquired from the ConnectionManager, and used to create record to pass to interactions.

      • basicRollbackTransaction

        public void basicRollbackTransaction​(org.eclipse.persistence.internal.sessions.AbstractSession session)
                              throws DatabaseException
        Rollback the local transaction on the datasource.
        Specified by:
        basicRollbackTransaction in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor
        Throws:
        DatabaseException

      • isDatasourceConnected

        protected boolean isDatasourceConnected()
        Return if the connection to the "data source" is connected.
        Specified by:
        isDatasourceConnected in class org.eclipse.persistence.internal.databaseaccess.DatasourceAccessor