Package ilog.rules.bres.session

Provides the core classes and interfaces of the JRules rule sessions.

See:
Description

Interface Summary

IlrManagementSession	Authorizes a local invalidation of the ruleset inside the local Execution Unit (XU).
IlrRuleSessionMetaData	Deprecated. As of JRules 6.5, replaced by IlrSessionExecutionResult.
IlrRuleSessionProvider	Defines a rule session provider.
IlrStatefulRuleSession	Provides methods to alter stateful rule sessions.
IlrStatelessRuleSession	Provides methods to execute a previously deployed ruleset.

Class Summary

IlrRuleExecutionResult	Deprecated. As of JRules 6.0, replaced by IlrRulesetExecutionResponse.
IlrRuleSessionProviderFactory	Creates a specific rule session provider.
IlrRuleSessionProviderFactory.Builder	Provides constructors and methods to build a specific rule session provider.
IlrRulesetExecutionRequest	Deprecated. As of JRules 6.5, replaced by IlrSessionRequest.
IlrRulesetExecutionResponse	Deprecated. As of JRules 6.5, replaced by IlrSessionResponse.
IlrSessionDescriptor	Models the static part of an execution: the user data, the trace filters, and the use of an interceptor.
IlrSessionExecutionProperties	Models the execution properties such as host and user names, ruleset archive properties, and so on.
IlrSessionExecutionResult	Models an execution result.
IlrSessionExecutionSettings	Organizes the information needed for an execution.
IlrSessionFilter	Models the filters that determine the required execution trace level.
IlrSessionParameters	Models the ruleset parameters.
IlrSessionRequest	Models an execution request.
IlrSessionResponse	Models the response to an execution request.
IlrSessionStatefulExecutionSettings	Models the execution settings for stateful execution.

Exception Summary

IlrRuleSessionCreationException	This exception is raised if a problem occurs when creating a rule session.
IlrRuleSessionException	This exception is raised if any problem occurs during the execution of a rule session method.

Package ilog.rules.bres.session Description

Provides the core classes and interfaces of the JRules rule sessions. The rule sessions cooperate with the Execution Unit (XU) to execute rulesets. The XU is the JRules implementation of a J2EE connector that handles the low-level details of ruleset execution for Rule Execution Server.

Rule sessions can be either stateless or stateful, and are provided for both J2SE and J2EE. All rule sessions provide a way to get the canonical ruleset path used.

There are three types of sessions:

• EJB rule sessions (EJB-JAR) that can be accessed locally or remotely.
• Simple Java component (JAR) that can only be accessed locally. A simple rule session can be seen as a set of helper classes on the Execution Unit (XU).
• J2SE rule sessions (JAR) that can only be accessed locally.

The following is recommended:

• Local access outside of a J2EE container--use J2SE rule sessions and package the jrules-bres-execution.jar inside your application.
• Local access, with or without transaction control--use the Plain Old Java Objects (POJO).
• Local access with transaction control at the rule session level--use the local interface of a stateful or a stateless EJB rule session.
• Remote access with transaction control at the rule session level--use the remote interface of a stateful or a stateless EJB rule session.

Regardless of your targeted platform you will need to instantiate a rule session provider and a result writer. The following code shows how to instantiate a logger, get a provider, and create a J2SE rule session:

        // Instantiate a loggerPrinter.
        FileOutputStream outFile = new FileOutputStream("execution.log");
        PrintWriter loggerPrinter = new PrintWriter(outFile);
        // Get the rule session provider.
        ruleSessionProvider = IlrJ2SERuleSessionProvider
                .getProvider(loggerPrinter);
        try {
            // Create the stateless rule session.
            session = ruleSessionProvider.createStatelessRuleSession();