|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.activemq.ActiveMQQueueBrowser
A client uses a QueueBrowser
object to look at messages on a
queue without removing them.
The getEnumeration
method returns a
java.util.Enumeration
that is used to scan the queue's messages. It
may be an enumeration of the entire content of a queue, or it may contain
only the messages matching a message selector.
Messages may be arriving and expiring while the scan is done. The JMS API does not require the content of an enumeration to be a static snapshot of queue content. Whether these changes are visible or not depends on the JMS provider.
A QueueBrowser
can be created from either a Session
or a QueueSession
.
Session.createBrowser(javax.jms.Queue)
,
QueueSession.createBrowser(javax.jms.Queue)
,
QueueBrowser
,
QueueReceiver
Constructor Summary | |
protected |
ActiveMQQueueBrowser(ActiveMQSession session,
ActiveMQQueue destination,
String selector,
int cnum)
Constructor for an ActiveMQQueueBrowser - used internally |
Method Summary | |
void |
close()
|
Enumeration |
getEnumeration()
Gets an enumeration for browsing the current queue messages in the order they would be received. |
String |
getMessageSelector()
|
Queue |
getQueue()
Gets the queue associated with this queue browser. |
boolean |
hasMoreElements()
|
Object |
nextElement()
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected ActiveMQQueueBrowser(ActiveMQSession session, ActiveMQQueue destination, String selector, int cnum) throws JMSException
selector
- cnum
-
JMSException
Method Detail |
public Enumeration getEnumeration() throws JMSException
getEnumeration
in interface QueueBrowser
JMSException
- if the JMS provider fails to get the enumeration for this
browser due to some internal error.public boolean hasMoreElements()
hasMoreElements
in interface Enumeration
public Object nextElement()
nextElement
in interface Enumeration
public void close() throws JMSException
close
in interface QueueBrowser
JMSException
public Queue getQueue() throws JMSException
getQueue
in interface QueueBrowser
JMSException
- if the JMS provider fails to get the queue associated
with this browser due to some internal error.public String getMessageSelector() throws JMSException
getMessageSelector
in interface QueueBrowser
JMSException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |