com.bea.p13n.rules.manager
Interface RulesManager

public interface RulesManager

extends javax.ejb.EJBObject, RuleSetRepository

This interface defines a stateless API for executing named rule sets and/or rules using the underlying BEA rules engine. This interface is exposed as a stateless session EJB that can be created using the RulesManagerHome.

See Also:

RulesManagerHome

Field Summary

static java.lang.String

RULESET_REPOSITORY_CLASS_NAME The environment entry key for reading the RuleSetRepository implementation class name.

Fields inherited from class com.bea.p13n.rules.manager.RuleSetRepository

BINARY_FORMAT, STRING_FORMAT

Method Summary

java.util.Iterator	evaluateRule(java.lang.String ruleSetUri, java.lang.String ruleName, java.lang.Object[] inputObjects) Applies a named rule to the set of objects provided by the caller and returns an iterator over the resultant set of objects.
java.util.Iterator	evaluateRule(java.lang.String ruleSetUri, java.lang.String ruleName, java.lang.Object[] inputObjects, ObjectFilter filter) Applies a named rule to the set of objects provided by the caller and returns an iterator over the resultant set of objects that pass the given filter.
java.util.Iterator	evaluateRuleSet(java.lang.String ruleSetUri, java.lang.Object[] inputObjects) Applies a named set of rules to the set of objects provided by the caller and returns an iterator over the resultant set of objects.
java.util.Iterator	evaluateRuleSet(java.lang.String ruleSetUri, java.lang.Object[] inputObjects, ObjectFilter filter) Applies a named set of rules to the set of objects provided by the caller and returns an iterator over the resultant set of objects that pass the given filter.
java.lang.String	getRuleSet(java.lang.String ruleSetUri) Deprecated. replaced by RuleSetRepository.getRuleSet(String, int)

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Methods inherited from interface com.bea.p13n.rules.manager.RuleSetRepository

getRuleSet, getRuleSets, removeRuleSet, setRuleSet

Field Detail

RULESET_REPOSITORY_CLASS_NAME

public static final java.lang.String RULESET_REPOSITORY_CLASS_NAME

The environment entry key for reading the RuleSetRepository implementation class name. All methods defined on the RuleSetRespository interface are delegated to an instance of this class.

Method Detail

evaluateRuleSet

public java.util.Iterator evaluateRuleSet(java.lang.String ruleSetUri,
                                          java.lang.Object[] inputObjects)
                                   throws java.rmi.RemoteException,
                                          java.lang.IllegalArgumentException,
                                          ApplicationException

Applies a named set of rules to the set of objects provided by the caller and returns an iterator over the resultant set of objects.

Parameters:

ruleSetUri - The URI of the rule set which contains the set of rules.

inputObjects - The set of objects to which the rules are to be applied.

Returns:

The set of objects which resulted from the application of the rules.

Throws:

java.lang.IllegalArgumentException - if ruleSetUri is null or zero-length, or if inputObjects is null.

ApplicationException - if the rule set execution subsystem is unable to execute the rule set.

java.rmi.RemoteException - if a communication error occurs during the execution of a remote method call.

evaluateRuleSet

public java.util.Iterator evaluateRuleSet(java.lang.String ruleSetUri,
                                          java.lang.Object[] inputObjects,
                                          ObjectFilter filter)
                                   throws java.rmi.RemoteException,
                                          java.lang.IllegalArgumentException,
                                          ApplicationException

Applies a named set of rules to the set of objects provided by the caller and returns an iterator over the resultant set of objects that pass the given filter.

Parameters:

ruleSetUri - The URI of the rule set which contains the set of rules.

inputObjects - The set of objects to which the rules are to be applied

filter - An ObjectFilter used to filter the results of rule exection.

Returns:

A filtered set of objects which resulted from the application of the rules.

Throws:

java.lang.IllegalArgumentException - if ruleSetUri is null or zero-length, or if inputObjects is null.

ApplicationException - if the rule set execution subsystem is unable to execute the rule set.

java.rmi.RemoteException - if a communication error occurs during the execution of a remote method call.

evaluateRule

public java.util.Iterator evaluateRule(java.lang.String ruleSetUri,
                                       java.lang.String ruleName,
                                       java.lang.Object[] inputObjects)
                                throws java.rmi.RemoteException,
                                       java.lang.IllegalArgumentException,
                                       ApplicationException

Applies a named rule to the set of objects provided by the caller and returns an iterator over the resultant set of objects.

Parameters:

ruleSetUri - The URI of the rule set which contains the rule to be executed.

ruleName - The name of the rule to be executed.

inputObjects - The set of objects to which the rule is to be applied

Returns:

The set of objects which resulted from the application of the rule.

Throws:

java.lang.IllegalArgumentException - if ruleSetUri or ruleName are null or zero-length, or if inputObjects is null.

ApplicationException - if the rule set execution subsystem is unable to execute the rule.

java.rmi.RemoteException - if a communication error occurs during the execution of a remote method call.

evaluateRule

public java.util.Iterator evaluateRule(java.lang.String ruleSetUri,
                                       java.lang.String ruleName,
                                       java.lang.Object[] inputObjects,
                                       ObjectFilter filter)
                                throws java.rmi.RemoteException,
                                       java.lang.IllegalArgumentException,
                                       ApplicationException

Applies a named rule to the set of objects provided by the caller and returns an iterator over the resultant set of objects that pass the given filter.

Parameters:

ruleSetUri - The URI of the rule set which contains the rule to be executed.

ruleName - The name of the rule to be executed.

inputObjects - The set of objects to which the rule is to be applied

filter - An ObjectFilter used to filter the results of rule exection.

Returns:

A filtered set of objects which resulted from the application of the rule.

Throws:

java.lang.IllegalArgumentException - if ruleSetUri or ruleName are null or zero-length, or if inputObjects is null.

ApplicationException - if the rule set execution subsystem is unable to execute the rule.

java.rmi.RemoteException - if a communication error occurs during the execution of a remote method call.

getRuleSet

public java.lang.String getRuleSet(java.lang.String ruleSetUri)
                            throws RuleSetNotFoundException,
                                   ApplicationException,
                                   java.lang.IllegalArgumentException,
                                   java.rmi.RemoteException

Deprecated. replaced by RuleSetRepository.getRuleSet(String, int)

Retrieves the XML string representation of the rule set with the given URI.

Parameters:

ruleSetUri - the URI of the target rule set.

Returns:

the XML representing the rule set.

Throws:

RuleSetNotFoundException - if the rule set referenced by the supplied URI cannot be located by the rule set repository subsystem.

ApplicationException - if the rule set repository subsystem is unable to retrieve the rule set.

java.lang.IllegalArgumentException - if the ruleSetUri is an invalid rule set URI.

java.rmi.RemoteException - if a communication error occurs during the execution of a remote method call.