|
|||||||||||
| 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,
java.lang.String selector,
int cnum)
Constructor for an ActiveMQQueueBrowser - used internally |
| Method Summary | |
void |
close()
|
java.util.Enumeration |
getEnumeration()
Gets an enumeration for browsing the current queue messages in the order they would be received. |
java.lang.String |
getMessageSelector()
|
javax.jms.Queue |
getQueue()
Gets the queue associated with this queue browser. |
boolean |
hasMoreElements()
|
java.lang.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,
java.lang.String selector,
int cnum)
throws javax.jms.JMSException
selector - cnum -
javax.jms.JMSException| Method Detail |
public java.util.Enumeration getEnumeration()
throws javax.jms.JMSException
getEnumeration in interface javax.jms.QueueBrowserjavax.jms.JMSException - if the JMS provider fails to get the enumeration for this
browser due to some internal error.public boolean hasMoreElements()
hasMoreElements in interface java.util.Enumerationpublic java.lang.Object nextElement()
nextElement in interface java.util.Enumeration
public void close()
throws javax.jms.JMSException
close in interface javax.jms.QueueBrowserjavax.jms.JMSException
public javax.jms.Queue getQueue()
throws javax.jms.JMSException
getQueue in interface javax.jms.QueueBrowserjavax.jms.JMSException - if the JMS provider fails to get the queue associated
with this browser due to some internal error.
public java.lang.String getMessageSelector()
throws javax.jms.JMSException
getMessageSelector in interface javax.jms.QueueBrowserjavax.jms.JMSException
|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||