宅急送项目的第七天笔记！（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号用户可以查询所有用户