javax.rules
Interface StatelessRuleSession

All Superinterfaces:

RuleSession

public interface StatelessRuleSession

extends RuleSession

This interface is a representation of a stateless rules engine session. A stateless rules engine session exposes a stateless rule execution API to an underlying rules engine.

See Also:

RuleSession, RuleRuntime, RuleExecutionSet, Rule

Method Summary

java.util.List	executeRules(java.util.List objects) Executes the rules in the bound rule execution set using the supplied list of objects.
java.util.List	executeRules(java.util.List objects, ObjectFilter filter) Executes the rules in the bound rule execution set using the supplied list of objects.

Methods inherited from interface javax.rules.RuleSession

getRuleExecutionSetMetadata, getType, release

Method Detail

executeRules

public java.util.List executeRules(java.util.List objects)
                            throws InvalidRuleSessionException,
                                   java.rmi.RemoteException

Executes the rules in the bound rule execution set using the supplied list of objects. A List is returned containing the objects created by (or passed into the rule session) the executed rules that pass the filter test of the default RuleExecutionSet ObjectFilter (if present).
The returned list may not neccessarily include all objects passed, and may include Objects created by side-effects. The execution of a RuleExecutionSet can add, remove and update objects. Therefore the returned object list is dependent on the rules that are part of the executed RuleExecutionSet as well as the rule vendor's specific rule engine behavior.

Parameters:

objects - the objects used to execute rules.

Returns:

a List containing the objects as a result of executing the rules.

Throws:

InvalidRuleSessionException - on illegal rule session state.

executeRules

public java.util.List executeRules(java.util.List objects,
                                   ObjectFilter filter)
                            throws InvalidRuleSessionException,
                                   java.rmi.RemoteException

Executes the rules in the bound rule execution set using the supplied list of objects. A List is returned containing the objects created by (or passed into the rule engine) the executed rules and filtered with the supplied object filter.
The returned list may not neccessarily include all objects passed, and may include Objects created by side-effects. The execution of a RuleExecutionSet can add, remove and update objects. Therefore the returned object list is dependent on the rules that are part of the executed RuleExecutionSet as well as the rule vendor's specific rule engine behavior.

Parameters:

objects - the objects used to execute rules.

filter - the object filter.

Returns:

a List containing the objects as a result of executing rules, after passing through the supplied object filter.

Throws:

InvalidRuleSessionException - on illegal rule session state.