IBM WebSphere Application ServerTM
Release 8

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
 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, 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 8