站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Java Platform, Enterprise Edition v1.4 API Specifications

XAQueueConnection (Java 2 Platform Ent. Ed. v1.4) - Java Platform, Enterprise Edition v1.4 API Specifications

JavaTM 2 Platform
Ent. Ed. v1.4

javax.jms
Interface XAQueueConnection

All Superinterfaces:
Connection, QueueConnection, XAConnection

public interface XAQueueConnection
extends XAConnection, QueueConnection

An XAQueueConnection provides the same create options as QueueConnection (optional). The only difference is that an XAConnection is by definition transacted.

The XAQueueConnection interface is optional. JMS providers are not required to support this interface. This interface is for use by JMS providers to support transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.

Version:
1.1 February 2 - 2002
Author:
Mark Hapner, Rich Burridge, Kate Stout
See Also:
XAConnection

Method Summary
 QueueSession createQueueSession(boolean transacted, int acknowledgeMode)
          Creates an XAQueueSession object.
 XAQueueSession createXAQueueSession()
          Creates an XAQueueSession object.
 
Methods inherited from interface javax.jms.XAConnection
createSession, createXASession
 
Methods inherited from interface javax.jms.Connection
close, createConnectionConsumer, createDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop
 
Methods inherited from interface javax.jms.QueueConnection
createConnectionConsumer
 

Method Detail

createXAQueueSession

public XAQueueSession createXAQueueSession()
                                    throws JMSException
Creates an XAQueueSession object.

Returns:
a newly created XAQueueSession
Throws:
JMSException - if the XAQueueConnection object fails to create an XA queue session due to some internal error.

createQueueSession

public QueueSession createQueueSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException
Creates an XAQueueSession object.

Specified by:
createQueueSession in interface QueueConnection
Parameters:
transacted - usage undefined
acknowledgeMode - usage undefined
Returns:
a newly created XAQueueSession
Throws:
JMSException - if the XAQueueConnection object fails to create an XA queue session due to some internal error.
See Also:
Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE

JavaTM 2 Platform
Ent. Ed. v1.4

Submit a bug or feature

Copyright 2003 Sun Microsystems, Inc. All rights reserved.