规则引擎Visual Rules Solution开发基础教程【连载12】--VisualRules接口调用（一）

[align=center][size=x-large][b]VisualRules接口调用（一）[/b][/size][/align]

[size=medium] 前面已经叙述了如何使用规则引擎，那么如何在Eclipse/MyEclipse中引入通过规则引擎编写好的模块呐？在接下来的连载中会详细介绍。
为了能够清晰的描述，还是用规则引擎重新搭建一个实例目吧：[/size]


[size=medium][b]一、编写实例[/b][/size]

[size=medium][b]1.案例场景描述：[/b][/size]

[size=medium] 外部系统传入一些学生基本信息(如：姓名、性别、年龄等)，经规则引擎中的规则转换，学生信息以list信息返回给外部系统。[/size]

[size=medium][b]2.案例规则部分实现：[/b][/size]

[size=medium] 左键点击“文件”—“新建规则工程(N)”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9249/7b1cd701-c320-340b-8509-3565bdc7d984.png[/img]
[/align]

[size=medium] 弹出窗体“创建新工程”，工程名称为“test1”，存放路径默认，勾选上“工程名同名时覆盖”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9251/2d139dc7-f2cb-3764-8585-5a69f712facd.png[/img]
[/align]

[size=medium] [b]新建规则包：[/b]右键点击工程“test1”—“新建规则包”，并将其命名为“学生录入”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9253/850a2852-1335-3e85-8989-be8536c1817d.png[/img]
[/align]

[size=medium] [b]定义变量：[/b]点击对象库，查看其编辑窗体，点击传输数据中的[img]http://dl2.iteye.com/upload/attachment/0112/9279/e9957f04-048a-3f4e-8391-adc357ab3d3f.png[/img]图标，弹出窗体，名称“id”，类型选择“int”，显示名称“编号”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9255/149e4336-57a7-35e6-b124-233cc555fc47.png[/img]
[/align]

[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9257/83f3d609-77a9-38f3-ae4c-697a064c223b.png[/img]
[/align]

[size=medium] [b]添加计算表格：[/b]右键点击“对象库 ”—“添加计算表格”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9259/58dc60d6-0b6f-3b6c-b65e-af3a5209962c.png[/img]
[/align]

[size=medium] 弹出窗体，显示名称“学生表”，变量名称默认，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9261/23b89640-b9d9-3fb0-ac8a-f8c45cb390e9.png[/img]
[/align]

[size=medium] [b]定义表格列：[/b]选择传入数据中的参数，右键点击复制，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9263/6ebc2497-6a9f-3693-b07b-43cf408af584.png[/img]
[/align]

[size=medium] 点击计算表“学生表”，右键点击学生表结构选型卡中空白处，点击“粘贴”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9265/6981e447-5073-33cc-8aaa-7348e24f71a3.png[/img]
[/align]

[size=medium] [b] 规则编写：[/b]右键点击规则包“学生录入”—“添加规则(N)”，并将其命名为“添加”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9267/527aa481-2037-30ef-bdb7-8ab57b32fd2c.png[/img]
[/align]

[size=medium] 右键点击规则“添加”—“内存表格操作向导”—“对表格的列赋值向导”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9269/9216f146-7db0-3fbc-ba0e-0780fe12c596.png[/img]
[/align]

[size=medium] 选择需要插入的学生表的列，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9271/f2bfd9a0-6c13-3efb-afa4-c0ba4657b156.png[/img]
[/align]

[size=medium] 点击确定后，发现提示信息中提示错误信息，解决方法是，属性名“其他表格”，对应的属性值“允许设置起他表格的列”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9273/9ee4b4ee-a036-38d1-bf19-8f28cc4708a8.png[/img]
[/align]

[size=medium] 修改规则包“学生录入”的属性，属性名“[color=red]外部调用[/color]”，修改为“student.add”，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9275/85d9c657-b86c-3ebb-92df-6775ece37c72.png[/img]
[/align]

[size=medium] 勾选内存表中的getListResult方法，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9277/c3563ebc-b313-3dbd-b6e3-4f61b3b6f9b1.png[/img]
[/align]

[size=medium] 点击[img]http://dl2.iteye.com/upload/attachment/0112/9283/f5ff5dec-1a70-30aa-81f8-c060780e45a0.png[/img]图标—“变量赋值”—“传入数据”—“学生信息”，在点击如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9285/b120553c-e0a4-3e28-8b42-334f7e8635fc.png[/img]
[/align]

[size=medium] 选择方法如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9287/b11cf8d5-5202-3d8a-b32f-8c402aa42955.png[/img]
[/align]

[size=medium] 查看规则查询学生信息，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9289/e9afb159-452e-375a-ae75-0ac07bd0756b.png[/img]
[/align]

[size=medium] 点击规则包“学生录入”，选择测试选项卡，双击处输入值对应的列，进行输入值，输入完后，点击[img]http://dl2.iteye.com/upload/attachment/0112/9291/e5863e02-ca3d-3459-8b01-cec5bd462500.png[/img]图标，执行结果查看实际结果值列，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9293/ec32e65e-93cd-3c31-a8de-85e4cae36de2.png[/img]
[/align]

[size=medium] 导出多付编译文件：为外部程序调用不同版本规则预备。
在E盘 根目录下创建文件夹rscfile，再在recfile目录下创建文件夹1.1、1.2和default，点击规则包“学生录入”，点击[img]http://dl2.iteye.com/upload/attachment/0112/9295/1991bdce-1de8-30d2-89c2-dcc3266b1928.png[/img]图标 ，弹出浏览文件夹，选择default，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9297/c7efb8d3-1cef-3051-944b-4a7033969de0.png[/img]
[/align]

[size=medium] 成功后弹出提示，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9299/585c55e3-c8aa-3ad1-b0eb-fa2ff2428b5f.png[/img]
[/align]

[size=medium] [b]修改规则[/b] 如下：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9301/52e76224-278e-3328-9ac0-cb90e9c3d74a.png[/img]
[/align]

[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9303/2cdff9d8-416c-39f5-b413-eb7ea28ced07.png[/img]
[/align]

[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9305/6382bd7e-d772-3376-86d5-1d6d6fe85338.png[/img]
[/align]

[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9307/d79b926e-0861-3a3c-a31f-f8f644705349.png[/img]
[/align]

[size=medium] 导出编译文件到E:\rscfile\1.1目录下，如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9311/19ba420a-8e69-33c7-aa4a-3579e7719592.png[/img]
[/align]

[b][size=medium] 同理修改并保存到1.2版本[/size][/b]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9313/d783f033-e8bc-3a89-b018-7dc40d82e615.png[/img]
[/align]

[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9317/d4239710-c5f8-37f2-8ad7-26359780a066.png[/img]
[/align]

[size=medium] 开发环境要求：打开附带的java工程文件dtoTest。

JDK环境设置：Java工程使用的jdk必须在1.5以上，为了能更好的确定工程的jdk文件，下面我们来查看，操作如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9319/7f9af1a6-797f-3296-b51b-4c823c3afffc.png[/img]
[/align]

[size=medium] 弹出窗体，在左上方文 本框中输入“jdk”，点击Java Compiler，查看jdk,如果低于1.4，可进行更换，[color=red](JDK版本要求1.5以上(含1.5))[/color]如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9321/4c2f3407-ce14-333c-a88a-0c09113060fa.png[/img]
[/align]

[size=medium] [b]引入相关Jar包：[/b]点击工程“dtoTest”—“Build Path”—“Configure Build Path...”，
下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9323/09370d20-6a6c-3410-a4f9-5051bd1ed231.png[/img]
[/align]

[size=medium] 引入的jar位置，是工程目录下的... \Tomcat\webapps\ROOT\WEB-INF\lib ，
如：D:\VisualRules\Tomcat\webapps\ROOT\WEB-INF\lib，引入jar包有
common.jar、commons-beanutils.jar、commons-collections-3.1.jar、commons-lang-2.1.jar、
commons-logging.jar、engine.jar、ezmorph-1.0.5.jar、flservlet.jar、jdom.jar、json.jar，
如下图：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9325/bfd158d2-9e02-35bd-b9c3-6af9a45851c2.png[/img]
[/align]

[size=medium][b] 添加bean类[/b]
在java工程中添加一个java类，名为Student.java，其内容编辑如下：
package com.flagleader;
/**
* 学生信息
* @author
*/
public class Student {
private int id;//编号
private String name;//姓名
private int age;//年龄
private char sex;//性别
private String grade;//年龄
private String remark;//备注
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public char getSex() {
return sex;
}
public void setSex(char sex) {
this.sex = sex;
}
public String getGrade() {
return grade;
}
public void setGrade(String grade) {
this.grade = grade;
}
public String getRemark() {
return remark;
}
public void setRemark(String remark) {
this.remark = remark;
}
public Student() {
// TODO Auto-generated constructor stub
}
public Student(int id, String name, int age, char sex, String grade,
String remark) {
super();
this.id = id;
this.name = name;
this.age = age;
this.sex = sex;
this.grade = grade;
this.remark = remark;
}
@Override
public String toString() {
return "Student [age=" + age + ", grade=" + grade + ", id=" + id
+ ", name=" + name + ", remark=" + remark + ", sex=" + sex
+ "]";
}
}

[/size]

[size=medium][b]二、Java类调用服务接口本地调用[/b][/size]

[size=medium] 在Eclipse中制作一个Test2类，main中接收参数输入姓名，通过接口RuleService调用执行本地规则编译文件，返回结果。[/size]

[size=medium][b] 1.添加java测试类：[/b][/size]

[size=medium] 在java工程中添加一个java类，名为Test2.java，其内容编辑如下：
package com.flagleader;
import java.io.File;
import java.util.ArrayList;
import java.util.List;
import com.flagleader.engine.RuleEngine;
import com.flagleader.engine.RuleEngineException;
import com.flagleader.engine.RuleEngineFactory;
import com.flagleader.engine.RuleEngineManager;
import com.flagleader.engine.RuleService;
import com.flagleader.engine.RuleServiceException;
import com.flagleader.engine.impl.LocalRuleServiceFactory;
/**
* 调用指定目录下默认文件下的编译文件
* 使用的接口是RuleService ，该接口可以用在本地调用，以及服务调用
* @author Administrator
*/
public class Test2 {
public static void main(String[] args) {
try {
// 编译文件指定目录，默认版本目录是指定目录下的default
RuleEngineManager.getInstance().init(new File("e:\\rscfile"));
// 工厂模式，该接口可以用在本地调用，以及服务调用
RuleService engine = new LocalRuleServiceFactory().getRuleService();
// 以dto形式为规则传参
Student student = new Student(1, "李丽", 12, '男', "六年级", "无");
// 执行规则，其中"student.add"为规则全名，student为传入参数
engine.executeBeans("student.add", student);
//判断engine.get("studentList")是不是集合类型
if (engine.get("studentList").getClass().isAssignableFrom(java.util.ArrayList.class)){
// 执行完规则后，获取数据，"studentList"必须和规则中取内存表数据的变量名一致
List list = (List) engine.get("studentList");
// 由于规则中采用的是list<list>类型，需要做两次转换
List list1 = (List) list.get(0);
// 循环次数为对象中字段个数
for (int i = 0; i < 6; i++) {
System.out.print(list1.get(i) + "\t");
}
}
} catch (RuleServiceException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}

[b] 2.执行java测试类[/b]
点击执行后，可以看到如下结果：[/size]
[align=center]
[img]http://dl2.iteye.com/upload/attachment/0112/9331/1a677d14-ead8-374e-8bca-24a2b3cba9b8.png[/img]
[/align]

[size=medium] 说明已经调用了student.add规则包，并且根据传入的参数，返回处理结果以list<list>形式展示。
同理，任何的其他java类，只需加入上述的代码，即可完成调用规则包的工作。[/size]
[size=medium] 对于接口调用有很多方式，例如：Java类调用服务接口本地调用、Java类调用本地调用、Java类调用本地调用指定版本、Java类通过Servlet调用-xml格式、Java类通过Servlet调用-json格式等。对于其他方式，在之后也会详细叙述。[/size]