|
Java EE 5 SDK 深圳电信培训中心.徐海蛟老师. |
||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造器 | 方法 | 详细信息: 字段 | 构造器 | 方法 |
javax.jms Interface QueueSession
public interface QueueSession
- extends Session
A QueueSession
object provides methods for creating
QueueReceiver
, QueueSender
,
QueueBrowser
, and TemporaryQueue
objects.
If there are messages that have been received but not acknowledged
when a QueueSession
terminates, these messages will be retained
and redelivered when a consumer next accesses the queue.
A QueueSession
is used for creating Point-to-Point specific
objects. In general, use the Session
object.
The QueueSession
is used to support
existing code. Using the Session
object simplifies the
programming model, and allows transactions to be used across the two
messaging domains.
A QueueSession
cannot be used to create objects specific to the
publish/subscribe domain. The following methods inherit from
Session
, but must throw an
IllegalStateException
if they are used from QueueSession
:
createDurableSubscriber
createTemporaryTopic
createTopic
unsubscribe
- 版本:
- 1.1 - April 2, 2002
- 作者:
- Mark Hapner, Rich Burridge, Kate Stout
- 另请参见:
Session
,QueueConnection.createQueueSession(boolean, int)
,XAQueueSession.getQueueSession()
字段摘要 |
---|
Fields inherited from interface javax.jms.Session |
---|
AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED |
方法摘要 | |
---|---|
QueueBrowser |
createBrowser(Queue queue)
Creates a QueueBrowser object to peek at the messages on
the specified queue. |
QueueBrowser |
createBrowser(Queue queue,
String messageSelector)
Creates a QueueBrowser object to peek at the messages on
the specified queue using a message selector. |
Queue |
createQueue(String queueName)
Creates a queue identity given a Queue name. |
QueueReceiver |
createReceiver(Queue queue)
Creates a QueueReceiver object to receive messages from the
specified queue. |
QueueReceiver |
createReceiver(Queue queue,
String messageSelector)
Creates a QueueReceiver object to receive messages from the
specified queue using a message selector. |
QueueSender |
createSender(Queue queue)
Creates a QueueSender object to send messages to the
specified queue. |
TemporaryQueue |
createTemporaryQueue()
Creates a TemporaryQueue object. |
方法详细信息 |
---|
createQueue
Queue createQueue(String queueName) throws JMSException
- Creates a queue identity given a
Queue
name.This facility is provided for the rare cases where clients need to dynamically manipulate queue identity. It allows the creation of a queue identity with a provider-specific name. Clients that depend on this ability are not portable.
Note that this method is not for creating the physical queue. The physical creation of queues is an administrative task and is not to be initiated by the JMS API. The one exception is the creation of temporary queues, which is accomplished with the
createTemporaryQueue
method. - 规范说明:
createQueue
in interfaceSession
- 参数:
queueName
- the name of thisQueue
- 返回:
- a
Queue
with the given name - 抛出异常:
JMSException
- if the session fails to create a queue due to some internal error.
createReceiver
QueueReceiver createReceiver(Queue queue) throws JMSException
- Creates a
QueueReceiver
object to receive messages from the specified queue. - 参数:
queue
- theQueue
to access- 抛出异常:
JMSException
- if the session fails to create a receiver due to some internal error.InvalidDestinationException
- if an invalid queue is specified.
createReceiver
QueueReceiver createReceiver(Queue queue, String messageSelector) throws JMSException
- Creates a
QueueReceiver
object to receive messages from the specified queue using a message selector. - 参数:
queue
- theQueue
to accessmessageSelector
- only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that there is no message selector for the message consumer.- 抛出异常:
JMSException
- if the session fails to create a receiver due to some internal error.InvalidDestinationException
- if an invalid queue is specified.InvalidSelectorException
- if the message selector is invalid.
createSender
QueueSender createSender(Queue queue) throws JMSException
- Creates a
QueueSender
object to send messages to the specified queue. - 参数:
queue
- theQueue
to access, or null if this is an unidentified producer- 抛出异常:
JMSException
- if the session fails to create a sender due to some internal error.InvalidDestinationException
- if an invalid queue is specified.
createBrowser
QueueBrowser createBrowser(Queue queue) throws JMSException
- Creates a
QueueBrowser
object to peek at the messages on the specified queue. - 规范说明:
createBrowser
in interfaceSession
- 参数:
queue
- theQueue
to access- 抛出异常:
JMSException
- if the session fails to create a browser due to some internal error.InvalidDestinationException
- if an invalid queue is specified.
createBrowser
QueueBrowser createBrowser(Queue queue, String messageSelector) throws JMSException
- Creates a
QueueBrowser
object to peek at the messages on the specified queue using a message selector. - 规范说明:
createBrowser
in interfaceSession
- 参数:
queue
- theQueue
to accessmessageSelector
- only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that there is no message selector for the message consumer.- 抛出异常:
JMSException
- if the session fails to create a browser due to some internal error.InvalidDestinationException
- if an invalid queue is specified.InvalidSelectorException
- if the message selector is invalid.
createTemporaryQueue
TemporaryQueue createTemporaryQueue() throws JMSException
- Creates a
TemporaryQueue
object. Its lifetime will be that of theQueueConnection
unless it is deleted earlier. - 规范说明:
createTemporaryQueue
in interfaceSession
- 返回:
- a temporary queue identity
- 抛出异常:
JMSException
- if the session fails to create a temporary queue due to some internal error.
|
Java EE 5 SDK 深圳电信培训中心.徐海蛟老师. |
||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造器 | 方法 | 详细信息: 字段 | 构造器 | 方法 |
提交错误或意见
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.