Rule Execution Server API

Package ilog.rules.res.session

Provides the core classes and interfaces to manage JRules rule sessions.

See:
          Description

Interface Summary
IlrManagementSession IlrManagementSession is the base interface for management sessions.
IlrSession IlrSession is the top-level markup interface for sessions.
IlrSessionFactory IlrSessionFactory is the interface implemented by all rule session factories.
IlrSessionRequest IlrSessionRequest is the interface for session requests.
IlrSessionResponse IlrSessionResponse encapsulates the response to a stateless rule session invocation or to an execute of a stateful rule session invocation.
IlrStatefulSession IlrStatefulSession represents a stateful rule session.
IlrStatefulSessionEJB IlrStatefulSessionEJB is an interface implemented by stateful rule session EJB3 components.
IlrStatelessSession IlrStatelessSession represents a stateless rule session.
IlrTraceFilter Use the class IlrTraceFilter to select the information that you want to see in the execution trace.
IlrWarning Use IlrWarning for warnings emitted by a rule session.
 

Class Summary
IlrEJB3SessionFactory IlrEJB3SessionFactory is a session factory for EJB3 rule sessions.
IlrJ2SESessionFactory The IlrJ2SESessionFactory class is a rule session factory for Java SE environments.
IlrPOJOSessionFactory Use the IlrPOJOSessionFactory class to create sessions in Java EE environments.
 

Exception Summary
IlrRuleServiceException Exception thrown to indicate an error during the use of ilog.rules.res.session.IlrRuleService.
IlrSessionCreationException An IlrSessionCreationException exception is raised when an error occurs during rule session creation.
IlrSessionException An IlrSessionException exception is raised if a problem occurs during the execution of a rule session method.
 

Package ilog.rules.res.session Description

Provides the core classes and interfaces to manage JRules rule sessions. Rule sessions provide an API on top of the JRules execution stack, that is, the Execution Unit (XU) and rule engine. Use this API to call rulesets and management operations.

Overview

Rule Execution Server is an environment for executing rules. It provides management, performance, security, and logging capabilities. Using Rule Execution Server, you can dynamically change the business logic in both Java SE and Java EE environments.

The Rule Execution Server architecture is based on a number of independent, but cooperating, software modules.

Rule sessions

A rule session is a runtime connection between a client and a rule engine. It is associated with a single ruleset and consumes rule engine resources. Rule sessions use a factory interface so that client applications can reference implementations of a session.

A rule session:

Rule sessions are either stateless or stateful. The following rule session types are provided:

Ruleset execution path

A ruleset execution path is used in Rule Execution Server to locate a deployed RuleApp and ruleset.

The path is composed of:

/{RuleApp name}[/{version}]/{ruleset name}[/{version}]

where:

Examples of valid ruleset paths are:

Code example

In the following code example, you use the IlrSessionFactory object to create and access rule sessions after a rule session factory has been instantiated for the target environment:

    // create rule session factory
    IlrSessionFactory sessionFactory = new IlrPOJOSessionFactory();

    // use stateless session for invocation
    IlrStatelessSession statelessSession = sessionFactory.createStatelessSession();
    statelessSession....();

    // use stateful session for invocation
    IlrStatefulSession statefulSession = sessionFactory.createStatefulSession(...);
    try {
        statefulSession....();
    } finally {
        statefulSession.close();
    }

    // use management session
    IlrManagementSession managementSession = sessionFactory.createManagementSession();
    managementSession....();


Rule Execution Server API

© Copyright IBM Corp. 1987, 2012