Packaging Java rule sessions for Java SE

To be able to run your application in a web container, you must package a rule session JAR file for Java™ SE.

About this task

You must package the rule session JAR file for Java SE if you intend to run your application in a web container, such as Tomcat or WebSphere Liberty, or within your application packaged in an EAR. To do so, you edit the deployment descriptor for your application and the execution unit (XU) descriptor ra.xml, and you add the rule session JAR file and the other relevant files into a web application archive (WAR) file.
Important: For customized Java SE applications that run on a Tomcat or WebSphere Liberty server, declare each embedded XU with a unique xuName. For example, xuName=xuMyAppName.
Note:

By default, the persistence type is the same for Java XOM resources as for rulesets.

Procedure

To package the Java rule sessions for Java SE:

  1. Write the Java classes to create a rule session and pass the data to the rule engine.

    Use the rule session factory API in your ruleset execution code (IlrJ2SESessionFactory).

  2. Package the .class, .jsp and .html files into a web application archive (WAR).

    You can operate any repackaging, but the goal is to grant access to the classes inside your servlet or JavaServer Pages (JSP). If your rules rely on a Java XOM, package them in the WAR file, in the WEB-INF/lib directory.

  3. Put the Java rule session JAR file jrules-res-execution.jar and execution unit (XU) descriptor ra.xml file in the WEB-INF/lib directory.

Example

Packaging libraries for the execution stack in a web application

Here is an example that uses an Ant script:

<import file="${executionserver.home}/lib/classpath-executionserver.xml"/>
<target name="war">
   <war warfile="myapplication.war" webxml="descriptors/web.xml">
      <!-- Classes of your web application -->
      <classes dir="classes" />

      <!-- The ra.xml file configured to use the data source provider -->
      <classes file="descriptors/ra.xml" />

      <!-- JAR for the Rule Execution
Server in Java SE -->
      <lib dir="${executionserver.home}/lib/">
      <patternset refid="executionserver.j2se.classpath.patternset" />
      </lib>
   </war>
</target>