activiti学习--04流程定义:流程定义组成+部署流程定义+查询流程定义+删除流程定义+删除流程定义+查询最新版本的流程定+查询最新版本的流程定义

Deployment 部署对象

1、一次部署的多个文件的信息。对于不需要的流程可以删除和修改。
修改的的意思是重新部署，原有的流程继续走，走完就走新的流程，新的流程一部署，新人就走新流程，相同流程（key）通过版本来控制。
2、对应的表：
  act_re_deployment：部署对象表
  act_re_procdef：流程定义表
  act_ge_bytearray：资源文件表
  act_ge_property：主键生成策略表

ProcessDefinition 流程定义
1、解析.bpmn后得到的流程定义规则的信息，工作流系统就是按照流程定义的规则执行的。

askForLeave.bpmn
BPMN 2.0根节点是definitions节点。 这个元素中，可以定义多个流程定义（不过我们建议每个文件只包含一个流程定义， 可以简化开发过程中的维护难度）。 一个空的流程定义看起来像下面这样。注意，definitions元素 最少也要包含xmlns 和 targetNamespace的声明。 targetNamespace可以是任意值，它用来对流程实例进行分类

流程定义组成：
bpmn文件
流程规则文件。在部署后，每次系统启动时都会被解析，把内容封装成流程定义放入项目缓存中。Activiti框架结合这个xml文件自动管理流程，流程的执行就是按照bpmn文件定义的规则执行的，bpmn文件是给计算机执行用的。
展示流程图的图片
在系统里需要展示流程的进展图片，图片是给用户看的。

Key和Name的值为：bpmn文件process节点的id和name的属性值

<process id="askForLeave" name="askForLeaveProcess" isExecutable="true">
key属性被用来区别不同的流程定义。
带有特定key的流程定义第一次部署时，version为1。之后每次部署都会在当前最高版本号上加1
Id的值的生成规则为:{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的generated-id是一个自动生成的唯一的数字
重复部署一次，deploymentId的值以一定的形式变化规则act_ge_property表生成

act_ge_property表生成

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
  <process id="askForLeave" name="askForLeaveProcess" isExecutable="true">
    <startEvent id="startevent1" name="Start"></startEvent>
    <endEvent id="endevent1" name="End"></endEvent>
    <userTask id="usertask1" name="请假申请" activiti:assignee="小黄"></userTask>
    <userTask id="usertask2" name="部门经理审批" activiti:assignee="陈经理"></userTask>
    <userTask id="usertask3" name="总经理审批" activiti:assignee="陈总裁"></userTask>
    <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
    <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="usertask2"></sequenceFlow>
    <sequenceFlow id="flow3" sourceRef="usertask2" targetRef="usertask3"></sequenceFlow>
    <sequenceFlow id="flow4" sourceRef="usertask3" targetRef="endevent1"></sequenceFlow>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_askForLeave">
    <bpmndi:BPMNPlane bpmnElement="askForLeave" id="BPMNPlane_askForLeave">
      <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="375.0" y="40.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="375.0" y="460.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
        <omgdc:Bounds height="55.0" width="105.0" x="340.0" y="120.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2">
        <omgdc:Bounds height="55.0" width="105.0" x="340.0" y="220.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask3" id="BPMNShape_usertask3">
        <omgdc:Bounds height="55.0" width="105.0" x="340.0" y="340.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
        <omgdi:waypoint x="392.0" y="75.0"></omgdi:waypoint>
        <omgdi:waypoint x="392.0" y="120.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
        <omgdi:waypoint x="392.0" y="175.0"></omgdi:waypoint>
        <omgdi:waypoint x="392.0" y="220.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3">
        <omgdi:waypoint x="392.0" y="275.0"></omgdi:waypoint>
        <omgdi:waypoint x="392.0" y="340.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow4" id="BPMNEdge_flow4">
        <omgdi:waypoint x="392.0" y="395.0"></omgdi:waypoint>
        <omgdi:waypoint x="392.0" y="460.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

部署流程定义
结构

         // 这一步在数据库中将操作三张表：
        // act_re_deployment（部署对象表）:存放流程定义的显示名和部署时间，每部署一次增加一条记录
        // act_re_procdef（流程定义表）:存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。
        // 注意：当流程定义的key相同的情况下，使用的是版本升级
        // act_ge_bytearray（资源文件表）:存储流程定义相关的部署信息。即流程定义文档的存放地。
        // 注意：每部署一次就会增加两条记录，一条是关于bpmn规则文件的，一条是图片的
  // 如果部署时只指定了bpmn一个文件，activiti会在部署时解析bpmn文件内容自动生成流程图，以二进制形式存储在数据库中。

方式1

   /** 部署流程定义（从classpath） */
    @Test
    public void deploymentProcessDefinition1() {

        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("askForLeave.bpmn");
        InputStream inputStreamPng = this.getClass().getResourceAsStream("askForLeave.png");
        Deployment deployment = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
                .createDeployment()// 创建一个部署对象
                .name("请假申请流程定义")// 添加部署的名称
                .addInputStream("askForLeave.bpmn", inputStreamBpmn)
                .addInputStream("askForLeave.png", inputStreamPng)
                .deploy();// 完成部署
        System.out.println("部署ID："+deployment.getId());
        System.out.println("部署名称："+deployment.getName());  
        System.out.println("部署时间："+deployment.getDeploymentTime()); 
//        输出：
//        部署ID：1101
//        部署名称：请假申请流程定义
//        部署时间：Tue Sep 05 21:22:18 CST 2017
    }

方式2

    /** 部署流程定义（从zip） */
    @Test
    public void deploymentProcessDefinition2() {
//      InputStream in = this.getClass().getResourceAsStream("askForLeave.zip");
        InputStream in = this.getClass().getClassLoader().getResourceAsStream("cn/fei/test2/askForLeave.zip");
        ZipInputStream zipInputStream = new ZipInputStream(in);
        Deployment deployment = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
                .createDeployment()// 创建一个部署对象
                .name("请假申请流程定义")// 添加部署的名称
                .addZipInputStream(zipInputStream)// 指定zip格式的文件完成部署
                .deploy();// 完成部署
        System.out.println("部署ID："+deployment.getId());
        System.out.println("部署名称："+deployment.getName());  
        System.out.println("部署时间："+deployment.getDeploymentTime());  
//       输出：
//        部署ID：1201
//        部署名称：请假申请流程定义
//        部署时间：Tue Sep 05 21:23:46 CST 2017
    }

影响的表
ACT_RE_DEPLOYMENT
存放流程定义的显示名和部署时间，每部署一次增加一条记录

ACT_RE_PROCDEF
存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。
注意：当流程定义的key相同的情况下，使用的是版本升级

ACT_GE_BYTEARRAY
存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录，一条是关于bpmn规则文件的，一条是图片的（如果部署时只指定了bpmn一个文件，activiti会在部署时解析bpmn文件内容自动生成流程图）。两个文件不是很大，都是以二进制形式存储在数据库中。

查询流程定义

    /** 查询流程定义 */
    @Test
    public void findProcessDefinition() {
        List<ProcessDefinition> list = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
                .createProcessDefinitionQuery()// 创建一个流程定义的查询
                /** 指定查询条件,where条件 */
//                 .deploymentId(deploymentId)//使用部署对象ID查询
//                 .processDefinitionId(processDefinitionId)//使用流程定义ID查询
//                 .processDefinitionKey(processDefinitionKey)//使用流程定义的key查询
//                 .processDefinitionNameLike(processDefinitionNameLike)//使用流程定义的名称模糊查询

                /** 排序 */
                .orderByProcessDefinitionVersion().asc()// 按照版本的升序排列
                // .orderByProcessDefinitionName().desc()//按照流程定义的名称降序排列

                /** 返回的结果集 */
                .list();// 返回一个集合列表，封装流程定义
        // .singleResult();//返回惟一结果集
        // .count();//返回结果集数量
        // .listPage(firstResult, maxResults);//分页查询
        if (list != null && list.size() > 0) {
            for (ProcessDefinition pd : list) {
                System.out.println("-----------当前流程："+pd.getName()+"-----对应的表ACT_RE_PROCDEF------------------------");
                System.out.println("流程定义ID:" + pd.getId());// 流程定义的key+版本+随机生成数
                System.out.println("流程定义的名称:" + pd.getName());// 对应askForLeave.bpmn文件中的name属性值
                System.out.println("流程定义的key:" + pd.getKey());// 对应askForLeave.bpmn文件中的id属性值
                System.out.println("流程定义的版本:" + pd.getVersion());// 当流程定义的key值相同的相同下，版本升级，默认1
                System.out.println("资源名称bpmn文件:" + pd.getResourceName());
                System.out.println("资源名称png文件:" + pd.getDiagramResourceName());
                System.out.println("部署对象ID：" + pd.getDeploymentId());
//                输出：
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:1:4
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:1
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：1
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:2:204
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:2
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：201
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:3:704
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:3
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：701
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:4:804
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:4
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：801
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:5:904
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:5
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：901
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:6:1004
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:6
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：1001
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:7:1104
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:7
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：1101
//                -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
//                流程定义ID:askForLeave:8:1204
//                流程定义的名称:askForLeaveProcess
//                流程定义的key:askForLeave
//                流程定义的版本:8
//                资源名称bpmn文件:askForLeave.bpmn
//                资源名称png文件:askForLeave.png
//                部署对象ID：1201

            }
        }
    }

删除流程定义

   /** 删除流程定义 */
    @Test
    public void deleteProcessDefinition() {
        // 使用部署ID，完成删除
        String deploymentId = "1201";
        /**
         * 不带级联的删除 只能删除没有启动的流程，如果流程启动，就会抛出异常
         */
        // processEngine.getRepositoryService()
//        .deleteDeployment(deploymentId);
        // 

        /**
         * 级联删除 不管流程是否启动，都能可以删除
         */
        processEngine.getRepositoryService()//
                .deleteDeployment(deploymentId, true);
        System.out.println("删除成功！"+deploymentId);
//        输出：
//        删除成功！1201
    }
对应的3个表的数据也删除

查看流程图

    @Test
    public void viewPic() throws IOException {
        /** 将生成图片放到文件夹下 */
        String deploymentId = "901";
        // 获取图片资源名称，
        List<String> list = processEngine.getRepositoryService()//
        //获取指定部署下得所有文件的名称
                .getDeploymentResourceNames(deploymentId);
        // 定义图片资源的名称
        String resourceName = "";
        if (list != null && list.size() > 0) {
            for (String name : list) {
                if (name.indexOf(".png") >= 0) {
                    resourceName = name;
                }
            }
        }

        // 可以获取部署下指定名称文件的输入流
        InputStream in = processEngine.getRepositoryService()//
                .getResourceAsStream(deploymentId, resourceName);

        // 将图片生成当前目录下
        System.out.println(this.getClass().getResource("").getPath());
        File file = new File(this.getClass().getResource("").getPath()+"1"+ resourceName);

        // 将输入流的图片写到D盘下
        FileUtils.copyInputStreamToFile(in, file);
    }

查询最新版本的流程定义

  /*** 查询最新版本的流程定义 */
    @Test
    public void findLastVersionProcessDefinition() {
        List<ProcessDefinition> list = processEngine.getRepositoryService()//
                .createProcessDefinitionQuery()//
                .orderByProcessDefinitionVersion().asc()// 使用流程定义的版本升序排列
                .list();
        /**
         * Map<String,ProcessDefinition> 
         *当map集合key值相同的情况下，后一次的值将替换前一次的值
         */
        Map<String, ProcessDefinition> map = new LinkedHashMap<String, ProcessDefinition>();
        if (list != null && list.size() > 0) {
            for (ProcessDefinition pd : list) {
                map.put(pd.getKey(), pd);
            }
        }
        List<ProcessDefinition> pdList = new ArrayList<ProcessDefinition>(map.values());
        if (pdList != null && pdList.size() > 0) {
            for (ProcessDefinition pd : pdList) {
                System.out.println("-----------当前流程："+pd.getName()+"-----对应的表ACT_RE_PROCDEF------------------------");
                System.out.println("流程定义ID:" + pd.getId());// 流程定义的key+版本+随机生成数
                System.out.println("流程定义的名称:" + pd.getName());// 对应askForLeave.bpmn文件中的name属性值
                System.out.println("流程定义的key:" + pd.getKey());// 对应askForLeave.bpmn文件中的id属性值
                System.out.println("流程定义的版本:" + pd.getVersion());// 当流程定义的key值相同的相同下，版本升级，默认1
                System.out.println("资源名称bpmn文件:" + pd.getResourceName());
                System.out.println("资源名称png文件:" + pd.getDiagramResourceName());
                System.out.println("部署对象ID：" + pd.getDeploymentId());
            }
        }
    }
    输出：
    -----------当前流程：askForLeaveProcess-----对应的表ACT_RE_PROCDEF------------------------
流程定义ID:askForLeave:7:1104
流程定义的名称:askForLeaveProcess
流程定义的key:askForLeave
流程定义的版本:7
资源名称bpmn文件:askForLeave.bpmn
资源名称png文件:askForLeave.png
部署对象ID：1101

删除流程定义

    /** 删除流程定义（删除key相同的所有不同版本的流程定义） */
    @Test
    public void deleteProcessDefinitionByKey() {
        // 流程定义的key
        String processDefinitionKey = "askForLeave";
        // 先使用流程定义的key查询流程定义，查询出所有的版本
        List<ProcessDefinition> list = processEngine.getRepositoryService()//
                .createProcessDefinitionQuery()//
                .processDefinitionKey(processDefinitionKey)// 使用流程定义的key查询
                .list();
        // 遍历，获取每个流程定义的部署ID
        if (list != null && list.size() > 0) {
            for (ProcessDefinition pd : list) {
                // 获取部署ID
                String deploymentId = pd.getDeploymentId();
                processEngine.getRepositoryService()//
                        .deleteDeployment(deploymentId, true);
            }
        }
    }