org.globus.wsrf
Interface TopicList

All Superinterfaces:
TopicListenerList
All Known Implementing Classes:
SimpleTopicList

public interface TopicList
extends TopicListenerList

Interface for managing and performing queries on a set of root topics.


Method Summary
 void addTopic(Topic topic)
          Add a root topic
 Topic getTopic(java.util.List topicPath)
          Get the topic for the given topic path.
 TopicListMetaData getTopicListMetaData()
          Returns meta data associated with this topic list.
 java.util.Collection getTopics(TopicExpressionType topicExpression)
          Get the set of topics the given topic expression resolves to
 void removeTopic(Topic topic)
          Remove the root topic
 java.util.Iterator topicIterator()
          Iterator for the set of root topics
 
Methods inherited from interface org.globus.wsrf.TopicListenerList
addTopicListener, removeTopicListener, topicListenerIterator
 

Method Detail

addTopic

public void addTopic(Topic topic)
Add a root topic

Parameters:
topic - The topic to add

removeTopic

public void removeTopic(Topic topic)
Remove the root topic

Parameters:
topic - The topic to remove

getTopics

public java.util.Collection getTopics(TopicExpressionType topicExpression)
                               throws UnsupportedTopicExpressionDialectException,
                                      TopicExpressionResolutionException,
                                      InvalidTopicExpressionException,
                                      TopicExpressionException
Get the set of topics the given topic expression resolves to

Parameters:
topicExpression - The topic expression to resolve to a set of topics
Returns:
The resulting set of topics
Throws:
UnsupportedTopicExpressionDialectException - if the topic expression dialect is not supported
TopicExpressionResolutionException - if the expression could not be evaluated
InvalidTopicExpressionException - if the topic expression is invalid
TopicExpressionException - if any other error occurs

getTopic

public Topic getTopic(java.util.List topicPath)
Get the topic for the given topic path.

Parameters:
topicPath - The topic path (list of topic names)
Returns:
The topic corresponding to the given topic path

getTopicListMetaData

public TopicListMetaData getTopicListMetaData()
Returns meta data associated with this topic list.

Returns:
meta data of this topic list.

topicIterator

public java.util.Iterator topicIterator()
Iterator for the set of root topics

Returns:
The iterator