com.j_spaces.jms

Class GSQueueBrowserImpl

java.lang.Object

com.j_spaces.jms.GSQueueBrowserImpl

All Implemented Interfaces:

javax.jms.QueueBrowser

public class GSQueueBrowserImpl
extends Object
implements javax.jms.QueueBrowser

GigaSpaces implementation of the javax.jms.QueueBrowser interface. A client uses a QueueBrowser object to look at messages on a m_queue without removing them.

The getEnumeration method returns a java.util.Enumeration that is used to scan the m_queue's messages. It may be an enumeration of the entire content of a m_queue, or it may contain only the messages matching a message m_selector. (currently we support only a custom m_selector hash based implementation) The getEnumeration() calls the space GSIterator method which returns all the currently existing ExternalEntries from the specified Queue/class name.

Version:

4.0 Copyright: Copyright (c) 2004 Company: GigaSpaces Technologies,Ltd.

Author:

Gershon Diner

Method Summary

Modifier and Type	Method and Description
void	close() API method.
Enumeration	getEnumeration() API method.
String	getMessageSelector() API method.
javax.jms.Queue	getQueue() API method.
String	toString() Returns a string view of this browser.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

toString

public String toString()

Returns a string view of this browser.

Overrides:

toString in class Object

getQueue

public javax.jms.Queue getQueue()
                         throws javax.jms.JMSException

API method.

Specified by:

getQueue in interface javax.jms.QueueBrowser

Throws:

javax.jms.IllegalStateException - If the browser is m_closed.

javax.jms.JMSException

getMessageSelector

public String getMessageSelector()
                          throws javax.jms.JMSException

API method.

Specified by:

getMessageSelector in interface javax.jms.QueueBrowser

Throws:

javax.jms.IllegalStateException - If the browser is m_closed.

javax.jms.JMSException

getEnumeration

public Enumeration getEnumeration()
                           throws javax.jms.JMSException

API method.

Specified by:

getEnumeration in interface javax.jms.QueueBrowser

Throws:

javax.jms.IllegalStateException - If the browser is m_closed, or if the connection is broken.

javax.jms.JMSSecurityException - If the client is not a READER on the m_queue.

javax.jms.JMSException - If the request fails for any other reason.

close

public void close()
           throws javax.jms.JMSException

API method.

Specified by:

close in interface javax.jms.QueueBrowser

Throws:

javax.jms.JMSException - Actually never thrown.