深入浅出JBPM读书笔记(四)_jbpm基础

1.JbpmConfiguration和JbpmContext讲解
它们是操作jbpm流程的对象，通过它们可以实现针对jbpm流程的所有操作。
JbpmConfiguration：
用来读取JBPM配置文件的对象。
通过该对象，可以获取JBPM配置文件里的所有配置信息。
该对象提供了JBPM流程在运行过程中所需要的各种服务对象。

JBPM默认配置文件：jbpm-jpdl-3.2.3\src\jpdl\org\jbpm\default.jbpm.cfg.xml
如果要修改默认配置文件，只需要在工程的Classpath下建一个名为jbpm.cfg.xml文件，然后重写default.jbpm.cfg.xml里面的相应内容即可。
修改例子如下：
<jbpm-configuration>
<string name="jbpm.mail.smtp.host" value="smtp.163.com"/>
<bean name="jbpm.mail.address.resolver" class="test.TestMailResolver" singleton="true"/>
<string name="jbpm.mail.from.address" value="[e-mail]"/>
</jbpm-configuration>

是一个单例对象，可通过JbpmConfiguration.getInstance()得到一个对象。

最大的作用：创建一个JbpmContext对象。jbpmConfiguration.createJbpmContext()

JbpmContext：
封装了大部分操纵JBPM流程的方法。
通过该对象，可以开始一个新的流程实例、根据任务的参与者快速找到该参与者的所有待办任务以及根据任务实例的ID加载对应的任务实例对象，可以快速拿到Hibernate Session（可以直接操作数据库）、Job Session（对JBPM里的Job进行管理）和Log Session（可以进行Log的读写操作）等。默认情况下，通过JbpmContext对象对流程数据进行持久化操作会自动产生一个事务。

2.构建JBPM数据库
两种方法：
1）.利用schema文件进行创建；
打开JBPM开发套件下的db目录，在该目录下可以找到目前主流数据库的建库脚本，找到和目标数据库相吻合的数据库脚本，在目标数据库当中执行JBPM数据库的建库工作。
2）.通过JbpmConfiguration对象提供的createSchema方法进行创建。
jbpmConfiguration.createSchema();
注：该方法主要是生成表，所以执行之前要创建好数据库，配置好hibernate.cfg.xml中的数据库数据和目标数据库方言，同时加相关的jar包

  <property name="format_sql">true</property>
	<property name="myeclipse.connection.profile">MySql</property>
	<property name="connection.url">jdbc:mysql://localhost:3306/jbpm_test</property>
	<property name="connection.username">root</property>
	<property name="connection.password">123</property>
	<property name="connection.driver_class">
		com.mysql.jdbc.Driver
	</property>
	<property name="dialect">
		org.hibernate.dialect.MySQLDialect
	</property>

3.JBPM流程定义的三个文件：
gpd.xml:节点位置的定位文件
processdefinition.xml:流程定义文件
processimage:产生的流程图片
4.流程发布
将流程设计器里产生的流程模板文件(流程定义的三个文件)发布到数据库中，这样流程引擎就可以直接对数据库进行操作，从而实现流程的控制。
流程发布的两种方法：
    1）.利用JBPM的流程设计器结合可以发布流程的Servlet实现
    2）.将流程文件从设计器里导出一个zip包文件，然后利用应用程序将其发布到数据库中。方法如下：
切换到Deployment视图，可分为四个区域：
区域A：流程发布时的流程文件选择区，processdefinition.xml必选，一般情况下三个都选
区域B：选择当前流程模板中所依赖的java类。
       流程模板所依赖的java类指的是在流程模板中自定义的ActionHandler.java,AssignmentHandler.java,DecisionHandler.java
       对于将jbpm流程引擎用一个无状态的SessionBean装起来，以一个EJB组件的形式单独运行于一个EJB容器的方式来说要选择好。
区域C：将区域A和B选择的流程文件打包过程指定的zip文件当中。
区域D：将区域A和B选择的流程文件打包，然后通过标准的Http Post方式上传到一个指定的Servlet去处理

	/**
	 * 发布流程
	 * 
	 * @throws Exception
	 */
	@Test
	public void testJbpmContextDeployProcess() throws Exception {
		JbpmContext jbpmContext = JbpmConfiguration.getInstance()
				.createJbpmContext();

		try {

			FileInputStream fin = new FileInputStream("c:/helloworld.zip");
			ZipInputStream zipin = new ZipInputStream(fin);
			ProcessDefinition pd = ProcessDefinition
					.parseParZipInputStream(zipin);
			// 通过JbpmContext对象将流程定义对象发布到数据库中
			jbpmContext.deployProcessDefinition(pd);
			System.out.println("发布成功......");
			
			zipin.close();
			fin.close();

		} finally {

			jbpmContext.close();

		}
	}

5.从数据库中读取helloworld流程

/**
	 * 从数据库中读取helloworld流程
	 * 
	 */
	@Test
	public void testHelloWorldWithDB() {
		JbpmContext jbpmContext = JbpmConfiguration.getInstance()
				.createJbpmContext();

		try {

			//从数据库中获取helloworld流程定义对象
			ProcessDefinition processDefinition=jbpmContext.getGraphSession().findLatestProcessDefinition("helloworld");
			ProcessInstance processInstance=new ProcessInstance(processDefinition);
			Token token=processInstance.getRootToken();
			//因为只建立了流程实例，流程实例并没有向下流转，所以该实例停留在start-state1节点上
			System.out.println("1 当前流程所处的节点名称：" + token.getNode().getName());

			//让流程实例向下流转一步
			token.signal();
			
			//state1
			System.out.println("2 当前流程所处的节点名称：" + token.getNode().getName());

			token.signal();

			//自动执行node1节点，流程向下流转，停留在state2
			System.out.println("3 当前流程所处的节点名称：" + token.getNode().getName());

			token.signal();

			System.out.println("4 当前流程所处的节点名称：" + token.getNode().getName());

			//打印出当前流程是否结束
			System.out.println("5 当前流程状态：" + token.getProcessInstance().hasEnded());

		} finally {

			jbpmContext.close();

		}
	}

6.模板与实例
流程模板(ProcessDefinition)与流程实例(ProcessInstance)的关系是一对多的关系
阅读这两个类的API文档
7.版本
当将流程发布到数据库的时候，JPBM安排一个版本号给它，如果数据库中有这个模板，它的版本号就加1，依次类推
8.Token
当一个流程实例创建出来的时候，一个Token（根令牌）也被创建了，此时的Token自然就指向开始节点
流程实例的运行过程实际上就是Token在流程图上的各个节点传递的过程
Token需要一个信号才能从一个节点流向下一个节点（token.signal()）
Token可以有子Token
Token离开某个节点时，触发node leave事件
Token到达某个节点时，触发node enter事件
当Token在某个节点停下来时，JBPM会将其状态记录到数据库对应的表中，方便下次继续运行
阅读Token的API
9.流程上下文（ContextInstance）
主要是用来存储流程变量的。
流程变量是流程实例在运行过程中存储在流程上下文当中的键值对。
流程变量最终是存储在数据库当中。
当通过流程模板产生一个流程实例时，一个流程上下文也产生了。
流程变量支持覆盖操作。
流程变量的作用域依赖于Token,根Token相当于全局环境，子Token相当于局部环境
JBPM提供了一种临时变量（Transient Variable）,此变量不会存到数据库当中。
阅读API文档，怎样创建和操作流程上下文
10.JPDL表达式
是在流程模板设计期间，定义在流程模板里的Action或Event里面，用来访问流程上下文或任务变量的表达式语言。
语法格式：#{xxx}
11.动作(Action)
是实现ActionHandler接口的类。
可以配置在流程相关节点（Node,Transition）或相关节点的相关事件当中，一旦该事件触发，定义大该事件里的Action类就会执行。
主要属性：name,class,ref-name,expression,accept-propagated-events,config-type,async
12.任务(Task)
有四种类型的事件可能被触发：
           task-create,task-assign,task-start,task-end
如果想在这些事件触发的时候做一些事情，可以通过Expression和Action类的方式
13.路由(Transition)
用来处理Token的流转的，将Token从一个节点送到另一个节点
动态创建Transition
主要属性：name,to,condition,exception-handler,action/scription/create-timer/cancel-timer
14.异常处理
在JBPM中分为元素(各种类型的节点或Transition)和流程两个级别
15.身份组件
用户，组，角色，权限
user,groups,memberships,permissions
16.BeanShell脚本
是JPBM中JPDL使用的脚本语言
下载：http://www.beanshell.org
BeanShell的方法基础
BeanShell在JBPM中的用法