com.ibm.wsspi.rsadapter

Interface WSOptimizedDataSource

  • All Superinterfaces:
    javax.sql.CommonDataSource, javax.sql.DataSource, java.sql.Wrapper


    public interface WSOptimizedDataSource
    extends javax.sql.DataSource
    This interface provides APIs that should only be used by advanced users.
    Please consult WebSphere support for more information
    Since:
    WAS 6.0
    • Method Summary

      Methods 
      Modifier and Type Method and Description
      java.sql.Connection getConnection(long passkey, boolean shareWithCMPOnly)
      This method is used to return a java.sql.Connection.
      • Methods inherited from interface javax.sql.DataSource

        getConnection, getConnection
      • Methods inherited from interface javax.sql.CommonDataSource

        getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter
      • Methods inherited from interface java.sql.Wrapper

        isWrapperFor, unwrap
    • Method Detail

      • getConnection

        java.sql.Connection getConnection(long passkey,
                                        boolean shareWithCMPOnly)
                                          throws java.sql.SQLException
        This method is used to return a java.sql.Connection. This API should only be used by advanced
        users. Please consult WebSphere support for more information and to get
        the passkey needed to use this API.
        Parameters:
        passkey - long used to verify the legitimacy of the caller
        shareWithCMPOnly - boolean to indicate the type of returned connection:
      • true: returned connection can be shared with CMP connections
      • false: returned connection can not be enlisted in transactions. This option assumes that the transactions are being enlisted by another party.
      • Returns:
        if shareWithCMPOnly is false, java.sql.Connection that will not be enlisted in transactions by WebSphere runtime and can not be shared with CMP connections
        if shareWithCMPOnly is true, java.sql.Connection that can enlist in transactions and can only be shared with CMP connections.
        Throws:
        java.sql.SQLException - SQLException will be thrown in the following cases:
      • if database throws an exception
      • if passkey is not valid
      • Since:
        WebSphere 6.0
IBM WebSphere Application ServerTM
Release 9.0