oracle.sdp.messaging.driver
Interface DriverConnectionFactory

All Superinterfaces:

javax.naming.Referenceable, Serializable

public interface DriverConnectionFactory
extends Serializable, javax.resource.Referenceable

DriverConnectionFactory provides a client interface for getting connections to an external messaging gateway. A default implementation of this interface is provided in the Messaging Driver Base Library.

Since:

11.0.0

Method Summary

DriverConnection	getDriverConnection(java.lang.String fromAddr) Get a DriverConnection instance given a from-address.
DriverMetaData	getMetaData() Get the driver meta data.

Methods inherited from interface javax.resource.Referenceable

setReference

Methods inherited from interface javax.naming.Referenceable

getReference

Method Detail

getDriverConnection

DriverConnection getDriverConnection(java.lang.String fromAddr)
                                     throws javax.resource.ResourceException

Get a DriverConnection instance given a from-address. If the driver created with this factory supports from-address override, the given from-address does not have to be one of the login addresses of the driver. If the from-address is not one of the login addresses, this method should always return a driver the same as that when the default from-address is given. If the driver does not support from-address override, and the given from-address is not one of the login addresses, and the given from-address is not null, a resource exception should be thrown.

If the given from-address is null, the method should work the same as if the default from-address is given.

Parameters:

fromAddr - the given login address a driver is requested.

Returns:

a driver with the given login address.

Throws:

javax.resource.ResourceException

getMetaData

DriverMetaData getMetaData()
                           throws javax.resource.ResourceException

Get the driver meta data.

Returns:

the meta data of driver connections this factory can create.

Throws:

javax.resource.ResourceException