Index Changes
This is version 5. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Business Rules Service Engine (Status: Incubation)

Overview

Business Rules Service Engine (a.k.a "rules4jbi") is a JBI (JSR 208) compliant service engine that allows to integrate a JSR 94 compliant rules engine into a JBI container and expose a deployed ruleset as a stateless service within the JBI environment. The accompanied NetBeans plugins allow for easy creation of the deployment artifacts and integrate well with the rest of the NetBeans SOA/enterprise pack.

This project was originally donated and is still being developed by Milan Fort.

Downloads and Installation

Service Engine

To install the service engine into OpenESB V2/GlassFish ESB runtime, follow these steps:

  1. Download rules4jbi.jar(info) to a location on disk
  2. Go to Netbeans - Services Panel - Servers - GlassFish - JBI - Service Engines
  3. Right click on Service engines node and select Install to browse for the file you downloaded at step 1
  4. Right click on installed engine and select Start

NetBeans Tooling

To install the NetBeans tooling support, follow these steps:

  1. Download org-openesb-components-rules4jbi-netbeans.nbm(info) and org-openesb-components-rules4jbi-netbeans-spi.nbm(info) to a location on disk
  2. Go to Netbeans -> Tools -> Plugins
  3. Click on the Downloaded tab
  4. Click Add Plugins to browse for the files you downloaded at step 1
  5. Click on Install and follow the prompts

Optionally, using the steps outlined above, you may want to install some or all of the following NetBeans modules:

Please note that the NetBeans tooling support for any rules engine is out of scope of this project. These modules only plug-in JSR 94 configuration values for the respective rules engines to the rules engine configuration panel in project's properties dialog and into the new project wizard.

Rules Engine

Rules4JBI is not a rules engine by itself and does not ship with any bundled rules engine either. Therefore, for proper operation, it requires you to install/deploy your chosen JSR 94 compliant rules engine. First, please consult your rules engine vendor's documentation to determine which jar files you need. Then, you have two options how to install/use the rules engine:

  1. you can copy the jar files into your GlassFish domain's lib/ext folder. This way, the rules engine will be available for all service units deployed into the service engine. This is a convenient way to install the rules engine, best suitable for testing purposes. Don't forget to restart GlassFish if it is already running as this mechanism does not support hot deployment.
  2. you can deploy the rules engine's jars along with the service unit. This will allow you to use different versions of the rules engine for different deployments.

Note that you are free to combine these two approaches, e.g. you can install one version into the lib/ext folder and then deploy a different version as part of your service unit. The version bundled with the service unit will take precedence. And obviously, nothing prevents you from using different rules engines for different service units.

As of December 2008, we do not officially support or endorse any rules engine. However, the project is tested to work with Jess (the JSR 94 reference implementation), Jamocha (a CLIPS-based rules engine like Jess, but Open Source), and Drools (a.k.a JBoss Rules). We encourage other vendors of JSR 94 compliant rules engines to test their implementations against this component and report the results/problems to the users mailing list at OpenESB mailing lists.

Getting Started

Screencast

Watch the screencast (coming soon) to see rules4jbi in action.

Quick Start Guide

The Quick Start Guide contains a step-by-step explanations of what you have seen in the screencast.

Sample Project

SampleRules4JBIProject.zip(info) contains the JSR 94 TCK example with Drools we have created in the Quick Start Guide. Contrary to that example, this sample project bundles Drools rules engine within the service unit, for easy, out-of-the-box experience. Please see the enclosed LICENSE.txt file for the license of Drools and its dependencies.

Steps to Use:

  1. The sample project's zip file contains Rules Module project and a Composite Application project. Extract the zip file and open both projects in NetBeans
  2. Build and deploy the Composite Application project
  3. Run the TestCase included in the Composite Application project

Development Status

The current version of rules4jbi is 0.4. The project has incubator status.

License

Rules4JBI is open source software licensed under the Common Development and Distribution License v1.0.

Source Code

The source code for rules4jbi is located under Open JBI Components CVS. The source is located under the contrib-fort/rules4jbi directory.

Issue Tracker

Go to the OpenESB issue tracker to submit issues. Please choose Business Rules Service Engine as the subcomponent.

Mailing Lists

For questions and feedback please use the OpenESB mailing lists.

Contacts

JSPWiki v2.4.100
[RSS]
« Home Index Changes Prefs
This particular version was published on 07-Jan-09 17:14 PM, -0800 by MilanFort