Overview | Package | Class | Tree | Deprecated | Index | Help
| Copyright © 2008 BEA Systems, Inc. All Rights Reserved
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.bea.p13n.rules.manager
Interface RulesManager

All Superinterfaces
  javax.ejb.EJBObject, Remote, RuleSetRepository

    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`
  This interface is intended to be implemented only by BEA Weblogic Portal. BEA Systems reserves the right to add abstract methods to this interface without notice. Implementations of this interface by other parties must not be expected to compile without change in future versions of BEA Weblogic Portal.

Field Summary
`static String` | `RULESET_REPOSITORY_CLASS_NAME` The environment entry key for reading the `RuleSetRepository` implementation class name.

Fields inherited from interface com.bea.p13n.rules.manager.RuleSetRepository
`BINARY_FORMAT, STRING_FORMAT`

Method Summary
`Iterator` | `evaluateRule(String ruleSetUri, String ruleName, 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.
`Iterator` | `evaluateRule(String ruleSetUri, String ruleName, 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.
`Iterator` | `evaluateRuleSet(String ruleSetUri, 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.
`Iterator` | `evaluateRuleSet(String ruleSetUri, 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.
`String` | `getRuleSet(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

    static final 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.

  See Also
    Constants Summary

Method Detail

### evaluateRuleSet

    Iterator evaluateRuleSet(String ruleSetUri,
                             Object[] inputObjects)
                             throws RemoteException,
                                    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
    `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.
    `RemoteException` - if a communication error occurs during the execution of a remote method call.

### evaluateRuleSet

    Iterator evaluateRuleSet(String ruleSetUri,
                             Object[] inputObjects,
                             ObjectFilter filter)
                             throws RemoteException,
                                    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
    `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.
    `RemoteException` - if a communication error occurs during the execution of a remote method call.

### evaluateRule

    Iterator evaluateRule(String ruleSetUri,
                          String ruleName,
                          Object[] inputObjects)
                          throws RemoteException,
                                 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
    `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.
    `RemoteException` - if a communication error occurs during the execution of a remote method call.

### evaluateRule

    Iterator evaluateRule(String ruleSetUri,
                          String ruleName,
                          Object[] inputObjects,
                          ObjectFilter filter)
                          throws RemoteException,
                                 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
    `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.
    `RemoteException` - if a communication error occurs during the execution of a remote method call.

### getRuleSet

    String getRuleSet(String ruleSetUri)
                      throws RuleSetNotFoundException,
                             ApplicationException,
                             IllegalArgumentException,
                             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.
    `IllegalArgumentException` - if the `ruleSetUri` is an invalid rule set URI.
    `RemoteException` - if a communication error occurs during the execution of a remote method call.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2008 BEA Systems, Inc. All Rights Reserved