【知識總結】Activiti工作流學習入門

 1. 我理解的工作流：

　　　在工作中慢慢接觸的業務流程，就向流程控制語言一樣，一步一步都對應的不同的業務，但整體串聯起來就是一個完整的業務。而且實際工作中尤其是在企業內部系統的研發中，確實需要對應許多審批流程的管理。

　　而工作流就是能夠在程序中，將這些支離破碎的流程，通過配置的方式管理起來，整體作為一個流程，方便修改，也方便維護。

2. 什么是Activiti：

　　Activiti是一個比較出名的框架，或者說就是一個工作流引擎，通俗的說，就是Activiti引擎我們只要按照它已有的配置，來進行現有業務的對應，它就能夠自動幫助我們完成以前不好控制的流程問題。

3. 如何獲取Activiti

　　1. 官網通用打包下載：http://www.activiti.org/ 

　　3. 源代碼github：https://github.com/Activiti/Activiti

　　2. maven自行配置：https://git.oschina.net/flyPiglet/ActivitiStudy/      （我的碼雲、使用git方式可以取得代碼）

3. 如何整合到自己的項目中：

　　1. 編程式整合

　　　　

/** 使用代碼創建工作流需要的23張表 */
    @Test
    public void createTable(){
        // 獲取流程引擎配置(創建一個單例子的流程引擎)
        ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration
                                                                        .createStandaloneProcessEngineConfiguration();
        // 設置數據庫信息
        processEngineConfiguration.setJdbcDriver("com.mysql.jdbc.Driver"); 
        processEngineConfiguration.setJdbcUrl("jdbc:mysql://localhost:3306/fsop?useUnicode=true&characterEndocing=utf8");
        processEngineConfiguration.setJdbcUsername("root");
        processEngineConfiguration.setJdbcPassword("root");
        /**
         *  processEngineConfiguration 中的配置
         *  DB_SCHEMA_UPDATE_FALSE = "false"; // 不能自動創建表（能夠使用腳本創建）
           *    DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop"; // 先刪除再更新
         *  DB_SCHEMA_UPDATE_TRUE = "true"; // 如果表不存在我就自動創建表
         */
        // 設置數據庫操作的設置
        processEngineConfiguration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        // 獲取工作流的核心對象
        ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine();
        Assert.assertNotNull(processEngine);
    }

　　2. activit引擎使用獨立配置文件

　　

/** 使用配置文件創建流程引擎 */
    @Test
    public void createByConfig(){
        ProcessEngine processEngine = ProcessEngineConfiguration
                                                .createProcessEngineConfigurationFromResource("activiti.cfg.xml")
                                                .buildProcessEngine();
        Assert.assertNotNull(processEngine);
    }

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
  xmlns:jee="http://www.springframework.org/schema/jee" xmlns:aop="http://www.springframework.org/schema/aop"
  xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
       http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
       http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
       http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-3.0.xsd
       http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd">
       
    <!-- 創建單例子的流程引擎的配置文件 -->
    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!-- 鏈接數據庫配置 -->
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property>
        <!-- 轉義的話，需要加入& = &amp; -->
        <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/fsop?useUnicode=true&amp;characterEndocing=utf8"></property>
        <property name="jdbcUsername" value="root"></property>
        <property name="jdbcPassword" value="root"></property>
        <!-- 創建表配置自動創建 -->
        <property name="databaseSchemaUpdate" value="true"></property>
    </bean>
</beans>

　　3. 通過Spring配置文件整合

　　　　其實法2就是Spring的整合方式，說白了Activiti就是提供一個入口，操作數據的25張表，較為規范的完成工作流的實現。

4. 使用流程介紹：

　　1. 流程定義：

　　　　1. 在activiti中流程通過什么方式來管理。

　　　　　　　activiti的流程發布是通過數據庫加上配置文件的形式來管理的，而配置文件也是具有版本的，activit會將配置文件存儲在數據庫的。

　　　　　　bpmd的標准規范中，流程是具有代碼表述以及流程圖表述的。所以這兩個的資源都會存儲在數據庫中，以數據庫解析出來的資源為准。

　　　　2. 定義使用BPMN的規范定義，也就是用XML來管理。

　　　　　　生成BPMN的方式主要有三種：Activiti Modeler（activit提供的專門里管理流程文件的war包程序）、Activiti Designer（Eclipse插件，先通過代碼生成后，在進行部署工作）

　　　　　　Activiti Kickstart（基於表格的流程設計工具）上面兩個都包含其中

　　　　3. Activit提供Activit Explorer以及Activiti REST等寫好的組件來提供方便的后台調用。

　　　　4. 代碼：其實流程定義有好幾種方式，重點還是能夠使用BPMN標准畫出符合業務需求的流程圖。

　　2. 部署流程：

　　　　1. 使用文件部署

　　　　

/**部署流程定義*/
    @Test
    public void deploymentProcessDefinition_classpath(){
        Deployment deployment = processEngine.getRepositoryService() // 與流程定義和部署對象相關的Service
                            .createDeployment() // 創建一個部署對象
                            .name("流程定義") // 設置對應流程的名稱
                            .addClasspathResource("diagrams/helloworld.bpmn") // 從Classpath的資源中加載，一次只能加載一個文件(windows與linux下面要區分)
                            .addClasspathResource("diagrams/helloworld.bpmn") // 從Classpath的資源中加載，圖片
                            .deploy(); // 完成部署

        System.out.println("部署Id："+deployment.getId()); // 部署Id：20001
        System.out.println("部署名稱："+deployment.getName()); // 部署名稱：流程定義
    }

　　　　2. 使用流程定義zip文件部署

/**部署流程定義zip文件*/
    @Test
    public void deploymentProcessDefinition_zip(){
        InputStream in = this.getClass().getClassLoader().getResourceAsStream("zip/helloworld.zip");
        ZipInputStream zipInputStream = new ZipInputStream(in);
        Deployment deployment = processEngine.getRepositoryService() // 與流程定義和部署對象相關的Service
                        .createDeployment() // 創建一個部署對象
                        .name("zip流程定義") // 添加部署的名稱
                        .addZipInputStream(zipInputStream) // 制定zip格式文件完成部署
                        .deploy(); // 完成部署
        System.out.println("部署Id："+deployment.getId()); // 部署Id:22501
        System.out.println("部署名稱："+deployment.getName()); // 部署名稱:zip流程定義
    }

　　　3. 使用輸入流部署：

/**部署流程定義zip文件*/
    @Test
    public void deploymentProcessDefinition_inputStream(){
        InputStream inputStreambpmn = this.getClass().getResourceAsStream("/diagrams/processVariables.bpmn");
        InputStream inputStreampng = this.getClass().getResourceAsStream("/diagrams/processVariables.png");
        
        
        Deployment deployment = processEngine.getRepositoryService() // 與流程定義和部署對象相關的Service
                        .createDeployment() // 創建一個部署對象
                        .name("流程定義輸入流") // 添加部署的名稱
                        .addInputStream("processVariables.bpmn", inputStreambpmn)// 使用資源文件名稱（要求與資源文件的名稱要一致），和輸入流完成部署
                        .addInputStream("processVariables.png", inputStreampng)// 使用資源文件名稱（要求與資源文件的名稱要一致），和輸入流完成部署
                        .deploy(); // 完成部署
        System.out.println("部署Id："+deployment.getId()); // 部署Id:55001
        System.out.println("部署名稱："+deployment.getName()); // 部署名稱:流程定義輸入流
    }

　　3. 啟動流程實例：

　　　　1. 什么是流程實例：就是一個活生生的流程、流程定義是定義了這一類的流程是如何的，而流程實例就是真正的業務流程。一切操作的基礎都基於流程實例

　　　　2. 啟動流程實例：

/** 啟動流程實例 */
    @Test
    public void startProcessInstance(){
        String processDefinitionKey = "psocessVariables"; // 使用Key的啟動，默認按照對心版本的流程定義啟動
        ProcessInstance pi = processEngine.getRuntimeService() // 與正在執行的流程實例和執行對象相關的Service
                        .startProcessInstanceByKey(processDefinitionKey); // 使用流程定義的Key啟動流程實例，key對應helloworld.bpmn文件中的流程名稱
        
        System.out.println("流程實例Id"+pi.getId()); // 流程實例Id：57501
        System.out.println("流程定義Id"+pi.getProcessDefinitionId()); // 流程定義Id：psocessVariables:1:55004
    }

　　4. 流程變量：

　　　　1. 流程變量就是對應一個流程下來全局或者局部的變量，可以每個節點都不一樣，也可以設置為全局的，這些都通過數據庫進行傳遞

　　5. 任務相關：

　　　　1. 任務，流程里面對應很多個任務，通過你畫出來的流程圖來自動生成任務。　

　　6. 整體圖：

　　　　

　　　　相關API描述：

　　　　

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();
HistoryService historyService = processEngine.getHistoryService();
FormService formService = processEngine.getFormService();

上述所有的都是通過processEngine，所以其實真正想把它用到項目上也是很容易的，只要配置好數據源、數據庫表建立好、工作流引擎交由Spring管理，不會影響原先的功能只需要在對應的地方調用API即可。

5. 數據庫表說明：

　　其實總共就是23張表、所以使用單元測試進行練習，了解流程原理，入門還是挺容易的。

#部署對象和流程定義相關表
#當key值相同的時候版本升級，id未key+版本+隨機生成的值
SELECT * FROM `act_re_deployment`; #部署對象表

SELECT * FROM `act_re_procdef`; #流程定義表`fsop`

SELECT * FROM `act_ge_bytearray`; #資源文件表（一個存儲xml，一個存儲圖片）

SELECT * FROM `act_ge_property`; #逐漸生成策略表（與Id相關）

#####################################################
#流程實例，執行對象，任務
SELECT * FROM `act_ru_execution`; #正在執行的執行對象表（正在執行的流程實例）

SELECT * FROM `act_hi_procinst` WHERE `END_TIME_` IS NULL; #流程實例的歷史表（一個流程實例）

SELECT * FROM `act_ru_task`; #正在執行的任務表（只有節點是UserTask的才有數據）

SELECT * FROM `act_hi_taskinst`; #任務歷史表（只有節點是UserTask的時候該表存在數據）

SELECT * FROM `act_hi_actinst`; #所有活動節點的歷史表（其中包括任務也不包括任務）
#####################################################
#流程變量
SELECT * FROM `act_ru_variable`;#正在執行的流程變量表

SELECT * FROM `act_hi_varinst`; #歷史流程變量表

##################################################################
SELECT * FROM `act_ru_identitylink` #任務表（個人任務、組任務）

SELECT * FROM `act_hi_identitylink` #任務歷史表

#########################################################
SELECT * FROM `act_id_group` #角色表

SELECT * FROM `act_id_user` #用戶表

SELECT * FROM `act_id_membership` #用戶角色關聯表

 

6. 相關資料

　　由於學習上述的東西，我也是通過別人的視屏來學習，我覺得吧，視屏加手操真的是能夠很快上手的呀。

　　中文文檔Activiti 5.16 中文文檔：http://www.mossle.com/docs/activiti/index.html#chapterApi

　　百度雲：http://pan.baidu.com/s/1gfmdCGj

　　學習使用的代碼：https://git.oschina.net/flyPiglet/ActivitiStudy/      （我的碼雲、使用git方式可以取得代碼）

平時上班比較忙，下次做個完整的，哈哈，加油Hikaru！

微信公眾號：努力編程的小豬

我雖然懶，但是程序員這個職業我還是很喜歡的。