Oracle® Streams Advanced Queuing Java API Reference
10g Release 2 (10.2)

B14291-01


oracle.jms
Class AQjmsXAConnectionFactory

java.lang.Object
  extended byoracle.jms.AQjmsConnectionFactory
      extended byoracle.jms.AQjmsXAConnectionFactory

All Implemented Interfaces:
ConnectionFactory, javax.naming.spi.ObjectFactory, javax.naming.Referenceable, java.io.Serializable, XAConnectionFactory

public class AQjmsXAConnectionFactory
extends AQjmsConnectionFactory
implements XAConnectionFactory

Oracle class implementing javax.jms.XAConnectionFactory

See Also:
Serialized Form

Method Summary
XAConnection createXAConnection()
Creates a XAConnection with the default user identity.
XAConnection createXAConnection(java.lang.String userName, java.lang.String password)
Creates a XAConnection with the specified user identity.
javax.naming.Reference getReference()
Creates a JMS connection factory reference suitable for passing to AQjmsConnectionFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable).

Methods inherited from class oracle.jms.AQjmsConnectionFactory
createConnection, createConnection, getObjectInstance

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createXAConnection

public XAConnection createXAConnection()
                                throws JMSException
Creates a XAConnection with the default user identity. The XAConnection is created in stopped mode. No messages will be delivered until the XAConnection.start method is explicitly called.
Specified by:
createXAConnection in interface XAConnectionFactory
Returns:
a newly created XAConnection
Throws:
JMSException - if the JMS provider fails to create the connection due to some internal error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.
Since:
1.1

createXAConnection

public XAConnection createXAConnection(java.lang.String userName,
                                       java.lang.String password)
                                throws JMSException
Creates a XAConnection with the specified user identity. The XAConnection is created in stopped mode. No messages will be delivered until the XAConnection.start method is explicitly called.
Specified by:
createXAConnection in interface XAConnectionFactory
Parameters:
userName - the caller's user name
password - the caller's password
Returns:
a newly created XAConnection
Throws:
JMSException - if the JMS provider fails to create the XAConnection due to some internal error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.
Since:
1.1

getReference

public javax.naming.Reference getReference()
Description copied from class: AQjmsConnectionFactory
Creates a JMS connection factory reference suitable for passing to AQjmsConnectionFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable).
Specified by:
getReference in interface javax.naming.Referenceable
Overrides:
getReference in class AQjmsConnectionFactory
Returns:
a connection factory reference with object and factory class names set

Oracle® Streams Advanced Queuing Java API Reference
10g Release 2 (10.2)

B14291-01


Copyright © 2003, 2005, Oracle. All rights reserved.