com.sap.aii.af.lib.ra.cci

Interface XIConnectionFactory

All Superinterfaces:

ConnectionFactory, Referenceable, Serializable

public interface XIConnectionFactory
extends ConnectionFactory

XIConnectionFactory extends the CCI ConnectionFactory by adding a method to create XIConnectionSpec

Method Summary

Modifier and Type	Method and Description
XIConnectionSpec	getXIConnectionSpec() getConnectionSpec() returns a NetWeaver XI CCI connection spec that can be used to allocate JCA CCI connections.
XIRecordFactory	getXIRecordFactory() getRecordFactory returns a NetWeaver XI specific record factory that allows to construct NetWeaver specific CCI custom records such as the XIMessageRecord.

Methods inherited from interface javax.resource.cci.ConnectionFactory

getConnection, getConnection, getMetaData, getRecordFactory

Methods inherited from interface javax.resource.Referenceable

setReference

Methods inherited from interface javax.naming.Referenceable

getReference

Method Detail

getXIConnectionSpec

XIConnectionSpec getXIConnectionSpec()
                              throws NotSupportedException

getConnectionSpec() returns a NetWeaver XI CCI connection spec that can be used to allocate JCA CCI connections. JCA 1.0 does not specify how a application can create the ConnectionSpec. Hence all NetWeaver XI JCA adapters MUST provide a connection spec create method in the connection factory.

Returns:

returns a NetWeaver XI CCI connection spec

Throws:

NotSupportedException - Thrown if specified type of connection spec is not supported

getXIRecordFactory

XIRecordFactory getXIRecordFactory()
                            throws NotSupportedException,
                                   ResourceException

getRecordFactory returns a NetWeaver XI specific record factory that allows to construct NetWeaver specific CCI custom records such as the XIMessageRecord. The CCI connection factory returns a record factory as well. However, according to the JCA specification it is foreseen for map and index record sets only. But in some NetWeaver components the usage of custom records such as XIMessageRecord is necessary. Hence an NetWeaver compliant ra MUST be able to return a record factory that is able to create custom records of a given type.

Returns:

returns a NetWeaver XI specific record factory

Throws:

NotSupportedException - Thrown if specified type of record factory is not supported

ResourceException - Thrown else, details see exception text