JBPM4.3+SSH环境筹建(转)

JBPM4.3+SSH环境搭建(转) .

http://yy629.iteye.com/category/78025

你要用jBPM4.3，首先至少你要了解
1.UML2.0的活动图（因为jBPM是Activity Diagram模型）
2.Hibernate（因为jBPM集成了Hibernate作为引擎的持久框架）
当然最重要的是你对工作流的系统结构有初步的了解。

具体指引请参考 用户手册和开发手册，这里只是一些简单补充。
一、jBPM4.3下载
sourceforge下载
http://sourceforge.net/projects/jbpm/

svn仓库里下载
http://anonsvn.jboss.org/repos/jbpm/jbpm4

二、搭建环境（GDP在Eclipse上的安装）
当你无法在Eclipse安装jBPM4.3 GDP插件，把你的Eclipse SDK版本升级到3.42就OK了。
本人用Myeclipse8.5

三、Myeclipse8.5安装jbpm4插件
下载好的jBPM4.3解包，找到jbpm-4.3/install/src/gpd/jbpm-gpd-site.zip
菜单【Help】-【MyEclipse Configuration Center】-选中【Software】点击【add site】-【Add from Archive File】选中jbpm-gpd-site.zip 点击ok
在【Personal Sites】将里面的接口右击 add to profile ，再点击右上角 Apply 7 change。自己重启，新建就能看到jbpm的菜单，毕！

四、jBPM4.3+SSH
1.在jbpm-4.3/install/src/db/create下选择你使用的数据库脚本（总共有18张表）
2.使用jbpm-4.3/install/src/demo下的SQL脚本生成测试用的数据
3.spring2.5+
4.hibernate用jbpm4.3的包，不支持ehcache。
四、主要配置文件
jbpm.hibernate.cfg.xml

applicationContext.xml


jbpm.cfg.xml? --这个文件一定要放到src目录下，不然系统找不到，开始半天没调通就是这个问题。



jbpmTemplate.java

package?com.meibiye.util; ????import?java.util.List; ??import?java.util.Map; ????import?org.jbpm.api.Execution; ??import?org.jbpm.api.ExecutionService; ??import?org.jbpm.api.HistoryService; ??import?org.jbpm.api.ManagementService; ??import?org.jbpm.api.ProcessEngine; ??import?org.jbpm.api.ProcessInstance; ??import?org.jbpm.api.RepositoryService; ??import?org.jbpm.api.TaskService; ??import?org.jbpm.api.task.Task; ????/** ??*?jbpm模板类(初步实现) ??*? ??*?@author?Administrator ??*? ??*/??public?class?JbpmTemplate?{ ????????/** ??????*?部署流程到数据库 ??????*? ??????*?@param?resourceName ??????*????????????资源文件名字?比如(org/forever/jbpm/jpdl/process.jpdl.xml) ??????*?@return?返回流程定义id(格式：key-version) ??????*/??????public?String?Deploy(String?resourceName)?{ ??????????return?repositoryService.createDeployment().addResourceFromClasspath( ??????????????????resourceName).deploy(); ??????} ????????/** ??????*?创建一个新的流程实例 ??????*? ??????*?@param?processDefinitionKey ??????*????????????(process.jpdl.xml中process标签的key) ??????*?@param?processInstanceKey ??????*????????????(用户给的key，比如一个请假单的id) ??????*?@return?流程实例 ??????*/??????public?ProcessInstance?addProcessInstance(String?processDefinitionKey, ??????????????String?processInstanceKey)?{ ??????????return?executionService.startProcessInstanceByKey(processDefinitionKey, ??????????????????processInstanceKey); ????????} ?????? ??????/** ??????*?创建一个新的流程实例 ??????*?@param?processDefinitionKey(process.jpdl.xml中process标签的key) ??????*?@param?variables?该流程实例要用到的变量 ??????*?@param?processInstanceKey(用户给定的业务key) ??????*?@return ??????*/??????public?ProcessInstance?addProcessInstance( ??????????????String?processDefinitionKey, ??????????????Map<String,??>?variables, ??????????????String?processInstanceKey){ ??????????return?executionService.startProcessInstanceByKey(processDefinitionKey,?variables,?processInstanceKey); ??????} ?????? ??????/** ??????*?提交任务 ??????*?@param?taskId?任务id ??????*/??????public?void?completeTask(String?taskId){ ??????????taskService.completeTask(taskId); ??????} ?????? ??????/** ??????*?将任务流转到指定名字的流程中去 ??????*?@param?taskId ??????*?@param?outcome ??????*/??????public?void?completeTask(String?taskId,String?outcome){ ??????????taskService.completeTask(taskId,?outcome); ??????} ????????/** ??????*?根据key获取流程实例(这里我使用的uuid) ??????*? ??????*?@param?key ??????*????????????(对应于数据库表jbpm4_execution中的KEY_字段) ??????*?@return?返回查找到得流程实例，没有返回null ??????*/??????public?ProcessInstance?getProcessInstance(String?key)?{ ??????????return?executionService.createProcessInstanceQuery() ??????????????????.processInstanceKey(key).uniqueResult(); ??????} ?????? ?????? ??????/** ??????*?根据executionId获取指定的变量值 ??????*?@param?executionId ??????*?@param?variableName ??????*?@return ??????*/??????public?Object?getVariableByexecutionId(String?executionId,String?variableName){ ??????????return?executionService.getVariable(executionId,?variableName); ??????} ?????? ?????? ??????/** ??????*?根据任务id获取指定变量值 ??????*?@param?taskId ??????*?@param?variableName ??????*?@return ??????*/??????public?Object?getVariableByTaskId(String?taskId,String?variableName){ ??????????return?taskService.getVariable(taskId,?variableName); ??????} ?????? ??????/** ??????*?获取指定用户名字的任务 ??????*?@param?userId ??????*?@return ??????*/??????public?List<Task>?findPersonalTasks(String?userId){ ??????????return?taskService.findPersonalTasks(userId); ??????} ?????? ??????/** ??????*?根据任务id获取任务 ??????*?@param?taskId ??????*?@return ??????*/??????public?Task?getTask(String?taskId)?{ ??????????return?taskService.getTask(taskId); ?????????? ??????} ?????? ??????/** ??????*?根据流程实例id获取 ??????*?@param?executionId ??????*?@return ??????*/??????public?Execution?findExecutionById(String?executionId)?{ ??????????return?executionService.findExecutionById(executionId); ??????} ????????/** ??????*?彻底删除文件的部署 ??????*? ??????*?@param?deploymentId流程定义id ??????*/??????public?void?deleteDeploymentCascade(String?deploymentId)?{ ??????????repositoryService.deleteDeploymentCascade(deploymentId); ??????} ????????public?JbpmTemplate()?{ ?????????? ??????} ????????public?JbpmTemplate(ProcessEngine?processEngine)?{ ??????????this.processEngine?=?processEngine; ??????????repositoryService?=?processEngine.getRepositoryService(); ??????????executionService?=?processEngine.getExecutionService(); ??????????taskService?=?processEngine.getTaskService(); ??????????historyService?=?processEngine.getHistoryService(); ??????????managementService?=?processEngine.getManagementService(); ??????} ????????private?ProcessEngine?processEngine; ??????private?RepositoryService?repositoryService?=?null; ??????private?ExecutionService?executionService?=?null; ??????private?TaskService?taskService?=?null; ??????private?HistoryService?historyService?=?null; ??????private?ManagementService?managementService?=?null; ????????public?ProcessEngine?getProcessEngine()?{ ??????????return?processEngine; ??????} ????????public?void?setProcessEngine(ProcessEngine?processEngine)?{ ??????????this.processEngine?=?processEngine; ??????????System.out.println(processEngine); ??????????repositoryService?=?processEngine.getRepositoryService(); ??????????executionService?=?processEngine.getExecutionService(); ??????????taskService?=?processEngine.getTaskService(); ??????????historyService?=?processEngine.getHistoryService(); ??????????managementService?=?processEngine.getManagementService(); ??????} ????????public?RepositoryService?getRepositoryService()?{ ??????????return?repositoryService; ??????} ????????public?void?setRepositoryService(RepositoryService?repositoryService)?{ ??????????this.repositoryService?=?repositoryService; ??????} ????????public?ExecutionService?getExecutionService()?{ ??????????return?executionService; ??????} ????????public?void?setExecutionService(ExecutionService?executionService)?{ ??????????this.executionService?=?executionService; ??????} ????????public?TaskService?getTaskService()?{ ??????????return?taskService; ??????} ????????public?void?setTaskService(TaskService?taskService)?{ ??????????this.taskService?=?taskService; ??????} ????????public?HistoryService?getHistoryService()?{ ??????????return?historyService; ??????} ????????public?void?setHistoryService(HistoryService?historyService)?{ ??????????this.historyService?=?historyService; ??????} ????????public?ManagementService?getManagementService()?{ ??????????return?managementService; ??????} ????????public?void?setManagementService(ManagementService?managementService)?{ ??????????this.managementService?=?managementService; ??????} ?????? ????}??

package com.meibiye.util; import java.util.List; import java.util.Map; import org.jbpm.api.Execution; import org.jbpm.api.ExecutionService; import org.jbpm.api.HistoryService; import org.jbpm.api.ManagementService; import org.jbpm.api.ProcessEngine; import org.jbpm.api.ProcessInstance; import org.jbpm.api.RepositoryService; import org.jbpm.api.TaskService; import org.jbpm.api.task.Task; /** * jbpm模板类(初步实现) * * @author Administrator * */ public class JbpmTemplate { /** * 部署流程到数据库 * * @param resourceName * 资源文件名字 比如(org/forever/jbpm/jpdl/process.jpdl.xml) * @return 返回流程定义id(格式：key-version) */ public String Deploy(String resourceName) { return repositoryService.createDeployment().addResourceFromClasspath( resourceName).deploy(); } /** * 创建一个新的流程实例 * * @param processDefinitionKey * (process.jpdl.xml中process标签的key) * @param processInstanceKey * (用户给的key，比如一个请假单的id) * @return 流程实例 */ public ProcessInstance addProcessInstance(String processDefinitionKey, String processInstanceKey) { return executionService.startProcessInstanceByKey(processDefinitionKey, processInstanceKey); } /** * 创建一个新的流程实例 * @param processDefinitionKey(process.jpdl.xml中process标签的key) * @param variables 该流程实例要用到的变量 * @param processInstanceKey(用户给定的业务key) * @return */ public ProcessInstance addProcessInstance( String processDefinitionKey, Map<String, ?> variables, String processInstanceKey){ return executionService.startProcessInstanceByKey(processDefinitionKey, variables, processInstanceKey); } /** * 提交任务 * @param taskId 任务id */ public void completeTask(String taskId){ taskService.completeTask(taskId); } /** * 将任务流转到指定名字的流程中去 * @param taskId * @param outcome */ public void completeTask(String taskId,String outcome){ taskService.completeTask(taskId, outcome); } /** * 根据key获取流程实例(这里我使用的uuid) * * @param key * (对应于数据库表jbpm4_execution中的KEY_字段) * @return 返回查找到得流程实例，没有返回null */ public ProcessInstance getProcessInstance(String key) { return executionService.createProcessInstanceQuery() .processInstanceKey(key).uniqueResult(); } /** * 根据executionId获取指定的变量值 * @param executionId * @param variableName * @return */ public Object getVariableByexecutionId(String executionId,String variableName){ return executionService.getVariable(executionId, variableName); } /** * 根据任务id获取指定变量值 * @param taskId * @param variableName * @return */ public Object getVariableByTaskId(String taskId,String variableName){ return taskService.getVariable(taskId, variableName); } /** * 获取指定用户名字的任务 * @param userId * @return */ public List<Task> findPersonalTasks(String userId){ return taskService.findPersonalTasks(userId); } /** * 根据任务id获取任务 * @param taskId * @return */ public Task getTask(String taskId) { return taskService.getTask(taskId); } /** * 根据流程实例id获取 * @param executionId * @return */ public Execution findExecutionById(String executionId) { return executionService.findExecutionById(executionId); } /** * 彻底删除文件的部署 * * @param deploymentId流程定义id */ public void deleteDeploymentCascade(String deploymentId) { repositoryService.deleteDeploymentCascade(deploymentId); } public JbpmTemplate() { } public JbpmTemplate(ProcessEngine processEngine) { this.processEngine = processEngine; repositoryService = processEngine.getRepositoryService(); executionService = processEngine.getExecutionService(); taskService = processEngine.getTaskService(); historyService = processEngine.getHistoryService(); managementService = processEngine.getManagementService(); } private ProcessEngine processEngine; private RepositoryService repositoryService = null; private ExecutionService executionService = null; private TaskService taskService = null; private HistoryService historyService = null; private ManagementService managementService = null; public ProcessEngine getProcessEngine() { return processEngine; } public void setProcessEngine(ProcessEngine processEngine) { this.processEngine = processEngine; System.out.println(processEngine); repositoryService = processEngine.getRepositoryService(); executionService = processEngine.getExecutionService(); taskService = processEngine.getTaskService(); historyService = processEngine.getHistoryService(); managementService = processEngine.getManagementService(); } public RepositoryService getRepositoryService() { return repositoryService; } public void setRepositoryService(RepositoryService repositoryService) { this.repositoryService = repositoryService; } public ExecutionService getExecutionService() { return executionService; } public void setExecutionService(ExecutionService executionService) { this.executionService = executionService; } public TaskService getTaskService() { return taskService; } public void setTaskService(TaskService taskService) { this.taskService = taskService; } public HistoryService getHistoryService() { return historyService; } public void setHistoryService(HistoryService historyService) { this.historyService = historyService; } public ManagementService getManagementService() { return managementService; } public void setManagementService(ManagementService managementService) { this.managementService = managementService; } }



配置文件就是这些，毕！

五、请假流程
下面完成一个简单的请假流程。
参见：http://abstractforever.javaeye.com/blog/608189

附录：
JBPM4表结构说明

JBPM4_DEPLOYMENT?? 流程定义表
JBPM4_DEPLOYPROP 流程定义属性表

JBPM4_EXECUTION? 流程实例表
JBPM4_HIST_ACTINST 流程活动(节点)实例表

JBPM4_HIST_DETAIL? 流程历史详细表

JBPM4_HIST_PROCINST 流程实例历史表

JBPM4_HIST_TASK? 流程任务实例历史表
JBPM4_HIST_VAR? 流程变量(上下文)历史表

JBPM4_ID_GROUP 组表
JBPM4_ID_MEMBERSHIP 用户角色表
JBPM4_ID_USER? 用户表
JBPM4_JOB? 定时表
JBPM4_LOB? 存储表
JBPM4_PARTICIPATION 参与者表
JBPM4_SWIMLANE? 泳道表
JBPM4_TASK 任务表
JBPM4_VARIABLE 上下文表

红 色的表为经常使用的表.这里不使用JBPM自己的权限角色定义.
发布一个流程deploy后
jbpm4_deployment新增一条记录
jbpm4_deployprop新增三条记录
jbpm4_lob 新增一条记录

开始一个流程startProcessInstanceByKey后
jbpm4_execution新增一条记录
jbpm4_hist_actinst 新增一条记录
jbpm4_hist_procinst新增一条记录
jbpm4_hist_task新增一条记录
jbpm4_task 新增一条记录
流程定义相关的布署信息就存储在（1） JBPM4_DEPLOYMENT、（2） JBPM4_DEPLOYPROP 及（3） JBPM4_LOB 中。上传一个包含png和jpdl.xml的zip包后，JBPM4_DEPLOYMENT多一条记录 JBPM4_DEPLOYPROP 多三条， JBPM4_LOB多两条。
（4）J B PM4_HIST_PROCINST 与（5） JBPM4_HIST_ACTINST 分别存放的是Process Instance、Activity Instance的历史记录。
（6）JBPM4_EXECUTION 主要是存放JBPM4的执行信息，Execution机制代替了JBPM3的Token机制（详细参阅JBPM4的PVM机制，过段时间我也会进一步分析）。
（7）JBPM4_TASK 存放需要人来完成的Activities，需要人来参与完成的Activity 被称为Task。
（8）JBPM4_PARTICIPATION 存放 Participation的信息，Participation的种类有Candidate、Client、Owner、 Replaced Assignee和Viewer。而具体的Participation既可以是单一用户，也可以是用户组。
（9）JBPM4_SWIMLANE。 Swim Lane是一种Runtime Process Role。通过Swim Lane，多个Task可以一次分配到同一Actor身上。
（10） JBPM4 _VARIABLE 存的是进行时的临时变量。
（11） JBPM4_HIST_DETAIL 保存 Variable的变更记录。
（12）JBPM4_HIST_VAR 保存历史的变量 。
（13） JBPM4_HIST_TASK Task的历史信息。
（14）JBPM4_ID_GROUP （15）JBPM_ID_MEMBERSHIP （16）JBPM4_ID_USER 这三张表很常见了，基本的权限控制，关于用户认证方面建议还是自己开发一套，JBPM4的功能太简单了，使用中有很多需要难以满足。
（17） JBPM4_JOB 存放的是Timer 的定义。
（18） JBPM4_PROPERTY? JBPM引擎参数表。