Interface ClientJDBCObjectFactory

    • Method Detail

      • newClientXAConnection

        ClientXAConnection newClientXAConnection​(BasicClientDataSource40 ds,
                                                 LogWriter logWriter,
                                                 java.lang.String user,
                                                 java.lang.String password)
                                          throws java.sql.SQLException
        This method is used to return an instance of ClientXAConnection (or ClientXAConnection40) class which implements javax.sql.XAConnection.
        Throws:
        java.sql.SQLException
      • newCallableStatement

        ClientCallableStatement newCallableStatement​(Agent agent,
                                                     ClientConnection connection,
                                                     java.lang.String sql,
                                                     int type,
                                                     int concurrency,
                                                     int holdability,
                                                     ClientPooledConnection cpc)
                                              throws SqlException
        Returns an instance of ClientCallableStatement, ClientCallableStatement40 or ClientCallableStatement42 which all implement java.sql.CallableStatement.
        Parameters:
        agent - The instance of NetAgent associated with this CallableStatement 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
        cpc - The PooledConnection object that will be used to notify the PooledConnection reference of the Error Occurred and the Close events.
        Returns:
        a CallableStatement object
        Throws:
        SqlException
      • newCachingLogicalConnection

        LogicalConnection newCachingLogicalConnection​(ClientConnection physicalConnection,
                                                      ClientPooledConnection pooledConnection,
                                                      JDBCStatementCache stmtCache)
                                               throws SqlException
        Returns an instance of a CachingLogicalConnection, which provides caching of prepared statements.
        Parameters:
        physicalConnection - the underlying physical connection
        pooledConnection - the pooled connection
        stmtCache - statement cache
        Returns:
        A logical connection with statement caching capabilities.
        Throws:
        SqlException - if creation of the logical connection fails
      • newPreparedStatement

        ClientPreparedStatement newPreparedStatement​(Agent agent,
                                                     ClientConnection connection,
                                                     java.lang.String sql,
                                                     Section section,
                                                     ClientPooledConnection cpc)
                                              throws SqlException
        This method returns an instance of PreparedStatement (or PreparedStatement40) 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
        Parameters:
        agent - The instance of NetAgent associated with this CallableStatement 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 - Section
        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
      • newPreparedStatement

        ClientPreparedStatement newPreparedStatement​(Agent agent,
                                                     ClientConnection connection,
                                                     java.lang.String sql,
                                                     int type,
                                                     int concurrency,
                                                     int holdability,
                                                     int autoGeneratedKeys,
                                                     java.lang.String[] columnNames,
                                                     int[] columnIndexes,
                                                     ClientPooledConnection cpc)
                                              throws SqlException
        Returns an instance of PreparedStatement (or PreparedStatement40) 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
        Parameters:
        agent - The instance of NetAgent associated with this CallableStatement 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 PreparedSatement object
        Throws:
        SqlException
      • newLogicalPreparedStatement

        LogicalPreparedStatement newLogicalPreparedStatement​(java.sql.PreparedStatement ps,
                                                             StatementKey stmtKey,
                                                             StatementCacheInteractor cacheInteractor)
        Returns a new logical prepared statement object.
        Parameters:
        ps - underlying physical prepared statement
        stmtKey - key for the underlying physical prepared statement
        cacheInteractor - the statement cache interactor
        Returns:
        A logical prepared statement.
      • newLogicalCallableStatement

        LogicalCallableStatement newLogicalCallableStatement​(java.sql.CallableStatement cs,
                                                             StatementKey stmtKey,
                                                             StatementCacheInteractor cacheInteractor)
        Returns a new logical callable statement object.
        Parameters:
        cs - underlying physical callable statement
        stmtKey - key for the underlying physical callable statement
        cacheInteractor - the statement cache interactor
        Returns:
        A logical callable statement.
      • newNetConnection

        ClientConnection newNetConnection​(LogWriter logWriter,
                                          int driverManagerLoginTimeout,
                                          java.lang.String serverName,
                                          int portNumber,
                                          java.lang.String databaseName,
                                          java.util.Properties properties)
                                   throws SqlException
        This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection this implements the java.sql.Connection interface
        Throws:
        SqlException
      • newNetConnection

        ClientConnection newNetConnection​(LogWriter logWriter,
                                          java.lang.String user,
                                          java.lang.String password,
                                          BasicClientDataSource40 dataSource,
                                          int rmId,
                                          boolean isXAConn)
                                   throws SqlException
        This method returns an instance of NetConnection (or NetConnection40) class which extends from ClientConnection. This implements the java.sql.Connection interface.
        Throws:
        SqlException
      • newNetConnection

        ClientConnection newNetConnection​(LogWriter logWriter,
                                          java.lang.String user,
                                          java.lang.String password,
                                          BasicClientDataSource40 dataSource,
                                          int rmId,
                                          boolean isXAConn,
                                          ClientPooledConnection cpc)
                                   throws SqlException
        This method returns an instance of NetConnection (or NetConnection40) class which extends Connection. This implements the java.sql.Connection interface. This method is used to pass the ClientPooledConnection object to the NetConnection object which can then be used to pass the statement events back to the user
        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 Connections
        isXAConn - true if this is a XA connection
        cpc - The ClientPooledConnection object from which this NetConnection constructor was called. This is used to pass StatementEvents back to the pooledConnection object
        Throws:
        SqlException
      • newNetResultSet

        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
        This method returns an instance of NetResultSet(or NetResultSet40) which extends from ClientResultSet which implements java.sql.ResultSet.
        Throws:
        SqlException
      • newNetDatabaseMetaData

        ClientDatabaseMetaData newNetDatabaseMetaData​(Agent netAgent,
                                                      ClientConnection netConnection)
        This method provides an instance of NetDatabaseMetaData (or NetDatabaseMetaData40) which extends from ClientDatabaseMetaData which implements java.sql.DatabaseMetaData.
      • newStatement

        ClientStatement newStatement​(Agent agent,
                                     ClientConnection connection,
                                     int type,
                                     int concurrency,
                                     int holdability,
                                     int autoGeneratedKeys,
                                     java.lang.String[] columnNames,
                                     int[] columnIndexes)
                              throws SqlException
        This method provides an instance of Statement or Statement40 depending on the jdk version under use
        Parameters:
        agent - Agent
        connection - Connection
        type - int
        concurrency - int
        holdability - int
        autoGeneratedKeys - int
        columnNames - String[]
        columnIndexes - int[]
        Returns:
        a java.sql.Statement implementation
        Throws:
        SqlException
      • newColumnMetaData

        ColumnMetaData newColumnMetaData​(LogWriter logWriter)
        Returns an instanceof ColumnMetaData or ColumnMetaData40 depending on the jdk version under use
        Parameters:
        logWriter - LogWriter
        Returns:
        a ColumnMetaData implementation
      • newColumnMetaData

        ColumnMetaData newColumnMetaData​(LogWriter logWriter,
                                         int upperBound)
        Returns an instanceof ColumnMetaData or ColumnMetaData40 depending on the jdk version under use
        Parameters:
        logWriter - LogWriter
        upperBound - int
        Returns:
        a ColumnMetaData implementation
      • newParameterMetaData

        ClientParameterMetaData newParameterMetaData​(ColumnMetaData columnMetaData)
        returns an instance of ParameterMetaData or ParameterMetaData40 depending on the jdk version under use
        Parameters:
        columnMetaData - ColumnMetaData
        Returns:
        a ParameterMetaData implementation
      • newBatchUpdateException

        java.sql.BatchUpdateException newBatchUpdateException​(LogWriter logWriter,
                                                              ClientMessageId msgid,
                                                              java.lang.Object[] args,
                                                              long[] updateCounts,
                                                              SqlException cause)
        Creates a BatchUpdateException depending on the JVM level.