宅急送项目的第七天笔记！（JBPM工作流和介绍 -- 权限管理模型）

一、回顾第一天核心内容 
1、 JBPM是什么？ 为我的项目带来什么？ 
工作流， 就是将业务流程实现自动化，非人工方式，控制任务的执行 -------- 所有业务流程 执行信息 都可以存放到数据库 中 
JBPM 是目前非常流行 一个开源工作流框架 
当项目业务流程非常多，而且非常复杂，使用工作流对项目进行管理，减少业务操作出错，所有业务参照

2、 jbpm工作流使用 
第一个方面： 进行工作流 业务流程设计 安装GPD插件 
第二个方面： 使用jbpm api 完成工作流框架操作  ProcessEngine 、 RepositoryService 、 ExecutionService 、 TaskService 
jar包导入  （今天会将jbpm 集成到 bos 宅急送项目中）

3、 业务流程定义管理 
1)  发布业务流程 classpath文件发布、zip压缩文件发布 
Configuration ----- ProcessEngine ---- RepositoryService (流程定义相关服务) ----- createDeployment() 
--- 添加资源 ddResourceFromClasspath/addResourcesFromZipInputStream  ---- deploy() 发布方法
* 操作 deployment 、 lob 、deployprop  三张表

2) 查询 
RepositoryService.createProcessDefinitionQuery()  查询流程定义
3) 删除  
RepositoryService.deleteDeploymentCascade(java.lang.String deploymentId) 

4）启动流程时，默认启动最新版本流程 startProcessDefinitionByKey ； 如何获取最新版本流程信息  orderDesc(流程id) --- 取第一个

4、 业务流程执行管理
1)  启动流程实例 ExecutionService.startProcessDefinitionByKey 
*** 默认向 jbpm4_execution（实例执行信息） jbpm4_hist_procinst （实例执行历史记录） 插入记录 
*** 根据task操作 jbpm4_task（任务表）、jbpm4_hist_task（历史任务表）、jbpm4_hist_actinst（活动记录表）

2)  查询我的任务 （定义任务时，为任务制定 Assignee） 
*** 查询 必须先创建对应Query对象，再完成查询
第一种
TaskService.createTaskQuery().assignee(java.lang.String userId).list()   ---- 可以分页、排序
第二种
TaskService.findPersonalTasks(java.lang.String userId) 

3） 办理任务
TaskService.completeTask(java.lang.String taskId) 

4) 向后流转一部 （主要用于多个Transition、State节点）
ExecutionService.signalExecutionById(java.lang.String executionId)  执行某个流程实例 向后一步 

5、 实例运行过程中变量
通过 ExecutionService 、 TaskService 设置流程实例变量  ---- 只要同一个流程实例都可以获取变量 
复杂对象保存 （在hibernate配置po类 / 实现Serializable接口）

====================================================================================
二、 流程定义语言 （预定义活动节点）
1、<process name="helloworld" xmlns="http://jbpm.org/4.4/jpdl" key="holiday"> 流程定义节点 
name : 流程定义名称
key : 流程关键字（键值） ，如果不写默认key值就是name值 ，在程序通过key值去启动一个流程实例 
version : 必须在数据库中存入指定版本号 （如果版本之前已经存在，报错），不指定，数据库完成自增 
xmlns ： 引入schema约束，编写文件提示效果 http://jbpm.org/4.4/jpdl 无提示效果 
****  将jbpm解压目录/src/jpdl-4.4.xsd 配置一下有提示 

2、 流转 Transition  节点 
活动都可以添加transition 流转 , 添加一个或者多个 （start 只能一个， end没有）
指定流转节点
第一种方式 ： 完成任务时 getTaskService().completeTask(task.getId(), transition);
第二种方式 ： 通过ExecutionService.signalExecutionById(java.lang.String executionId,transition )  主要用于 state节点

*** 配置jpdl 提示 ， 选择namespace : http://jbpm.org/4.4/jpdl 

3、 流转控制节点（活动节点 Activity） ------ 绘图和UML中活动图 
1） start 开始节点 
2） end  结束节点 （end 正常结束 end-cancel 取消流程 end-error 流程异常终止 ）

3） state 状态节点  （自动完成一些任务节点， 比如 发送确认邮件 ） ---- 该节点会停留
***  通过ExecutionService.signalExecutionById(java.lang.String executionId,transition )  

4）decision 判断节点
*** 用于分支情况 
指定handler 必须实现接口 DecisionHandler 
*** 根据流程中变量，判断走向哪个Transition  

5）fork/join 分支、合并节点 
*** fork用来表示分支，并行一定要执行任务 ，使用fork后，一定要用join 将分支合并 
*** decistion 代表在满足特点条件，分支任选其一 

获得所有获得name ： pi.findActiveActivityNames();
ActivityCoordinates c = processEngine.getRepositoryService()
.getActivityCoordinates(processDefinitionId, activityName);
获得获得节点坐标【x 横坐标 y 纵坐标 width 宽度 height 高度】
System.out.println("x=" + c.getX() 
+ ",y=" + c.getY() 
+ ",width=" + c.getWidth() 
+ ",height=" + c.getHeight());

6）task 任务节点 
**** 存在负责人，由指定负责人进行任务办理 

三种分配任务方式 （个人任务）
第一种 ：绘制图时，指定<task name="办理" assignee="张三">  缺点：负责人固定，不利于维护
将负责人指定为一个变量 格式 #{变量名 } <task name="办理" assignee="#{userId}">
第二种 ：在<task> 中编写 <assignment-handler class="" > 由指定class负责指定负责人  ， 该类必须实现 AssignmentHandler
assignable.setAssignee("负责人");
*** 加入逻辑，比如有流程变量，通过变量来指定，没有流程变量 ，设置默认负责人 
第三种 ：在任务完成前，都可以更换负责人  taskService.assignTask(任务id, 负责个人)

三种分配任务方式 （组任务） ------ 存在一个任务，任务由指定一组人来完成，组内每个人都有完成任务的能力 
第一种 ： assignment type : candidate-users  expression: 小王,小李,小张
JBPM4_PARTICIPATION 表存放组任务用户信息 
查询个人组任务 java.util.List<Task> findGroupTasks(java.lang.String userId) 
**** 只要是组内用户都可以查询到组任务 
**** 拾取任务 ： 组内的一个用户，将组任务 变为 个人任务 TaskService.takeTask(taskid, user);
**** 拾取任务后的操作 ： 1) 小李拾取任务后完成 taskService.completeTask  2) 小李没时间做 ，改变任务负责人 taskService.assignTask 3) 小李没时间做, 找不到负责人 ，将任务归还任务组  
第二种 ： 在<task> 中编写 <assignment-handler class="" > 由handler 指定负责人  
Assignable.addCandicateUser(组任务用户)
第三种 ： 对已经存在任务，添加组用户
processEngine.getTaskService().addTaskParticipatingUser(taskId,userId, Participation.CANDIDATE);

====================================================================================
三、 自定义活动节点
绘制流程图，为图添加custom 节点 （自定义活动节点）
jbpm 提供 Activity 接口 代表一个活动 ， 预定义活动 实现 ActivityBehaviour 接口 ， 如果自定义活动节点实现 ExternalActivityBehaviour

@Override
public void execute(ActivityExecution activityexecution) throws Exception {
// 该活动 被执行了 
}

@Override
public void signal(ActivityExecution activityexecution, String s,
Map<String, ?> map) throws Exception {
// 代表流程 在当前节点停留，离开前执行的操作 
}
**** 自定义活动，默认不会在节点停留 ------ 不停留，就不会signal 
execute方法中操作
1，ActivityExecution.waitForSignal()，在当前节点等待。
2，ActivityExecution.takeDefaultTransition()，使用默认的Transition离开，当前节点中定义的第一个为默认的。
3，ActivityExecution.take(String transitionName)，使用指定的Transition离开
4，ActivityExecution.end()，结束流程实例

四、 流程执行过程中事件对象  （了解）
jbpm 允许为 活动中每个节点指定 事件 

1、 定义监听器  实现 EventListener 接口 

2、 在根元素中，或在节点元素中，使用<on event="">元素指定事件，其中event属性代表事件的类型
a) <on>元素放在根元素（<process>）中，可以指定event为start或end，表示流程的开始与结束。
b) <on>元素放在节点元素中，可以指定event为start或end，表示节点的进入与离开
c) 在Start节点中只有end事件，在End节点中只有start事件。
d) 在<transition>元素中直接写<event-listener class="">，就是配置事件。（因为在这里只有一个事件，所以不用写on与类型）
e) 在<task>元素中还可以配置assign事件，是在分配任务时触发的。

====================================================================================
五、 将jbpm 集成到项目中
1、 将整合后jar 包 复制 bos/WebRoot/WEB-INF/lib  (86个jar包)
2、 配置文件整合 
jbpm : jbpm.cfg.xml  jbpm.hibernate.cfg.xml  log4j.properties 

将 jbpm.cfg.xml  jbpm.hibernate.cfg.xml  两个文件整合到bos 
*** jbpm.hibernate.cfg.xml 本质是hibernate 配置文件  (hibernate配置放到 dao.xml)
<property name="mappingResources">
<list>
<value>jbpm.repository.hbm.xml</value>
<value>jbpm.execution.hbm.xml</value>
<value>jbpm.history.hbm.xml</value>
<value>jbpm.task.hbm.xml</value>
<value>jbpm.identity.hbm.xml</value>
</list>
</property>

***  jbpm.cfg.xml 需要和Spring 整合 
jbpm-4.4/doc/devguide/html_single/index.html
1） 将 jbpm.cfg.xml 复制 bos/config 
将 <import resource="jbpm.tx.hibernate.cfg.xml" /> 改为 <import resource="jbpm.tx.spring.cfg.xml" />
2） 配置jbpm 的 ProcessEngine 
<bean id="springHelper" class="org.jbpm.pvm.internal.processengine.SpringHelper">
 <property name="jbpmCfg" value="jbpm.cfg.xml"></property>
</bean>
<bean id="processEngine" factory-bean="springHelper" factory-method="createProcessEngine" />

3) 想直接得到jbpm服务对象
<bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
<bean id="executionService" factory-bean="processEngine" factory-method="getExecutionService" />

====================================================================================
介绍 权限管理模型 
1、 最简易的权限管理模型 （javaweb）
适用于： 用户种类不多，系统功能不是特别复杂 
在用户表中添加角色字段，用字段区分用户属于哪类角色  

好处： 使用起来方便，编码量不大
缺点： 管理粒度比较粗 ，维护不方便 ，不够灵活  --- 不可复用 

============ 角色和资源路径关系，固定在程序，通过配置文件 xml/txt

2、 标准权限管理模块
功能表 、权限表、角色表、用户表 

好处： 系统菜单可以动态定制 、维护比较方便、控制粒度精细  ---- 可复用 
缺点： 开发复杂 

3、 复杂权限系统 
Oracle  权限控制  ： 系统权限、对象权限 

create table 建表 ---- 属于系统权限 
select 表user 、delete 表customer   ------ 属于对象权限 

参考 php框架 cake  权限模型 
user add / view / list / delete 
new  add / view / list / delete 

表结构 
user编号  模块 功能点
1         news  add  --------- 1号用户可以添加新闻 
4         user  list  -------- 4号用户可以查询所有用户