漫话规则引擎(4): Java规则引擎规范：JSR94

本文最新版已更新至：http://thinkinside.tk/2012/12/07/jsr94.html

漫话规则引擎(4): Java规则引擎规范：JSR94

Java World似乎总会出现一些接口规范，这样做的好处是可以面向接口编程，可以在实现了该接口的产品/组件之间自由切换，避免被厂商绑架。 本文要介绍的JSR94:Java Rule Engine API，Java规则引擎API规范。

Table of Contents

• 1 概述
• 2 规则管理API
• 3 运行时API
• 4 异常定义
• 5 代码示例
• 6 实现JSR94的产品
• 7 小结

1 概述

JSR-94是JCP(Java Community Process)制定的关于Java规则引擎API的规范，包括接口定义和示例代码。于2004年8月发布。 JSR-94定义了javax.rules和javax.rules.admin,前者包含了Java规则引擎运行时（Rumtime)API及异常（Exception）定义，后者包含了规则管理相关的API和异常定义。

2 规则管理API

规则管理API在javax.rules.admin中定义,主要包括以下类/接口：

类/接口	说明
Rule	规则实体
RuleExecutionSet	执行集，某个规则对应的动作
LocalRuleExecutionSetProvider	用于从本地创建执行集，如InputStream,Reader等
RuleExectuionSetProvider	用于从本地或远程创建执行集，如xml Element，Serializable等
RuleAdministrator	用于获取ExecutionSetProvider，并管理执行集的注册/注销

规则管理API实现的功能包括：

1. 装载规则（Rule）和执行集（RuleExecutionSet)
2. 执行集的注册/注销,只有注册的执行集对应的规则才能被客户访问

3 运行时API

运行时API在javax.rules中定义，主要包括以下类/接口：

类/接口	说明
RuleServiceProviderManager	通过URL注册/注销RuleServiceProvider
RuleServiceProvider	提供对RuleRuntime和RuleAdministrator的访问
RuleRuntime	规则引擎运行时，可以创建规则会话
RuleSession	规则会话，用于执行规则
RuleExecutionSetMetaData	执行集元数据，包括name,url,description等。执行集元数据会被RuleSession使用
StatelessRuleSession	无状态规则会话
StatefulRuleSession	有状态规则会话
Handle和ObjectFilter	有状态会话维护会话状态的帮助类

规则引擎运行时API实现的功能包括：

1. 注册/注销规则引擎实例，只有注册的规则引擎实例才能被使用
2. 从注册的规则引擎实例创建Runtime
3. 从Runtime创建会话，包括有状态和无状态两种会话
4. 通过会话执行规则

4 异常定义

除了前面提到的主要类/接口外，JSR94还规定了规则引擎运行时及管理的一些异常，如下：

5 代码示例

下面是使用Drools作为规则引擎实例的一个例子，规则文件使用了Drools的drl格式：

JSR94Sample.java

package com.sample;

import java.io.FileReader;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;

import javax.rules.ConfigurationException;
import javax.rules.RuleRuntime;
import javax.rules.RuleServiceProvider;
import javax.rules.RuleServiceProviderManager;
import javax.rules.StatelessRuleSession;
import javax.rules.admin.LocalRuleExecutionSetProvider;
import javax.rules.admin.RuleAdministrator;
import javax.rules.admin.RuleExecutionSet;

import org.drools.jsr94.rules.RuleServiceProviderImpl;

public class JSR94Sample {
    private static RuleServiceProvider ruleProvider;
    
    private static void initProvider(){
        String uri = RuleServiceProviderImpl.RULE_SERVICE_PROVIDER;
        Class providerClass = RuleServiceProviderImpl.class;
        
        try{
            //注册ruleProvider
            RuleServiceProviderManager.registerRuleServiceProvider(uri, providerClass);
            
            //从RuleServiceProviderManager获取ruleProvider
            ruleProvider = RuleServiceProviderManager.getRuleServiceProvider(uri);
        }catch(ConfigurationException e){
            e.printStackTrace();
        }
    }
    
    private static void adminSample(){
        

        try{
            //获取RuleAdministrator实例
            RuleAdministrator admin = ruleProvider.getRuleAdministrator();
            
            //获取RuleExectuionSetProvider
            HashMap properties = new HashMap();   
            properties.put("name", "My Rules");   
            properties.put("description", "A trivial rulebase");
            
            LocalRuleExecutionSetProvider ruleExecutionSetProvider = admin.getLocalRuleExecutionSetProvider(properties);
            
            //创建RuleExecutionSet
            FileReader reader = new FileReader("bin/sample.drl");
            RuleExecutionSet reSet = ruleExecutionSetProvider.createRuleExecutionSet(reader, properties);
            
            //注册RuleExecutionSet
            admin.registerRuleExecutionSet("mysample",reSet,properties);
        }catch(Exception e){
            e.printStackTrace();
        }
        
    }
    
    
    private static void runtimeSampe(){
        try{
            //获取RuleRuntime, 创建会话
            RuleRuntime runtime = ruleProvider.getRuleRuntime();
            StatelessRuleSession ruleSession = (StatelessRuleSession)runtime.createRuleSession("mysample",null,RuleRuntime.STATELESS_SESSION_TYPE);
            
            //初始化输入数据
            Message message1 = new Message();
            message1.setMessage("Hello World");
            message1.setStatus(Message.HELLO);
            
            Message message2 = new Message();
            message2.setMessage("Goodbye World");
            message2.setStatus(Message.GOODBYE);
            
            
            List inputs = new ArrayList();
            inputs.add(message1);
            inputs.add(message2);
            
            //执行规则
            List<Message> results = ruleSession.executeRules(inputs);
            for(int i=0;i<results.size();i++){
                Message msg = results.get(i);
                System.out.println(msg.message);
            }
            
            
            //释放会话资源
            ruleSession.release();
            
        }catch(Exception e){
            e.printStackTrace();
        }
    }
    
    
    public static void main(String[] args) {
        // TODO Auto-generated method stub
        initProvider();
        adminSample();
        runtimeSampe();
    }
    
    
    public static class Message {

        public static final int HELLO = 0;
        public static final int GOODBYE = 1;

        private String message;

        private int status;

        public String getMessage() {
            return this.message;
        }

        public void setMessage(String message) {
            this.message = message;
        }

        public int getStatus() {
            return this.status;
        }

        public void setStatus(int status) {
            this.status = status;
        }

    }

}

 

规则文件使用的就是在这里使用的例子。

6 实现JSR94的产品

主要的一些实现了JSR94的规则引擎产品如下：

产品	商业/开源	规则描述语言	算法	规则开发工具	规则保存	部署方式
Drools	开源	DRL,xDRL,DSL,Decision Table	ReteOO	Eclipse,excel	文件系统	jar
Mandarax	开源	RuleML
OpenRules	开源	Decision Table	Rete	excel		war
JLisa	开源
Blaze	商业	SRL
WebSphere ILOG JRules	商业
JESS	商业

7 小结

JSR94为规则引擎提供了公用标准API,为实现规则管理API和运行时API提供了指导规范, 目前已经获得很多开源/商业规则引擎产品的支持。 但是JSR94没有对规则的描述语言进行规范，导致各规则引擎产品大多采用自己私有的描述语言。

Author: Holbrook Wong <wanghaikuo@tsinghua.org.cn>

Date: 2012-12-07 12:49:16 CST

HTML generated by org-mode 6.33x in emacs 23