org.apache.ws.notification.topics.expression
Interface TopicExpressionEvaluator

public interface TopicExpressionEvaluator

A TopicExpressionEvaluator is used to evaluate a topic expression of a known dialect against a set of topic namespaces. An evaluator can be registered with a TopicExpressionEngine, which in turn delegates to the evaluator evaluation of expressions with the corresponding dialect.

Method Summary

Topic[]	evaluate(TopicNamespaceRegistry topicNsRegistry, TopicExpression topicExpr) Evaluates the expression over a TopicSpace and returns the set of matching topics.
java.lang.String[]	getDialects() Gets the URIs for the dialects that this evaluator can handle

Method Detail

getDialects

public java.lang.String[] getDialects()

Gets the URIs for the dialects that this evaluator can handle

Returns:

array of URIs supported by this evaluator

evaluate

public Topic[] evaluate(TopicNamespaceRegistry topicNsRegistry,
                        TopicExpression topicExpr)
                 throws TopicPathDialectUnknownException,
                        TopicExpressionResolutionException,
                        InvalidTopicExpressionException,
                        TopicExpressionException

Evaluates the expression over a TopicSpace and returns the set of matching topics.

Parameters:

topicNsRegistry -

topicExpr - object passed by client representing the topic expression

Returns:

the set of topics that matched the specified expression

Throws:

TopicPathDialectUnknownException - 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