Activiti工作流-入门

Activiti概述

工作流概念

工作流（Workflow），指“业务过程的部分或整体在计算机应用环境下的自动化”。是对工作流程及其各操作步骤之间业务规则的抽象、概括描述。
通俗的说，流程（过程）就是多个人在一起合作完成某件事情的步骤，把步骤编程计算机能理解的形式，就是工作流。
工作流是研究一个群体如何在计算机的帮助下实现协同工作的，其主要解决的问题是：为了实现某个业务目标，利用计算机在多个参与者（Actor）之间按某种预定规则自动传递文档、信息或者任务（Task）。

【不使用工作流技术：】
从头开始开发这个订购流程的业务逻辑，我们需要：
- 每个活动点都需要开发交互页面和后台处理程序
- 每个活动的流转都需要硬性判断下一步活动节点及其操作人
- 每次操作都需要维护业务数据和流程的相关数据

使用好处：
- 使用专门的流程数据系统，维护所有涉及流程流转的数据。
- 提供“流程设计”工具，帮助用户定义订货流程的模型，而且一般都提供了可视化的界面。
- 所有的流程都依靠流程引擎来处理，避免了需求更改与硬编码之间矛盾的产生。
- 工作流引擎还提供了众多的API，可以很方便的将工作流的管理和业务操作完美结合。

工作流技术的优势

• 降低开发风险
  通过使用诸如活动、流转、状态、行为这样的术语，使得业务分析师和开发人员使用同一种语言交谈成为可能。优秀的流程设计建模工具，甚至能使开发人员不必将用户需求转化成详细设计文档。
• 流程实现的集中统一
  应对业务流程经常变化的情况，使用工作流技术的最大好处是使业务流程的实现代码，不再散落在各式各样的业务系统中。
• 加速开发
  开发者不用再关注流程的参与者、活动节点的衔接、流转控制……因为这些工作很多被工作流框架接管了。因而开发者开发起来更快、代码出错更少、系统更加容易维护。
• 提升对迭代开发的支持
  如果系统中业务流程部分被硬编码，就不容易更改，需求分析师就会花费很大的精力在开发前的业务分析中，并且希望一次成功。但可悲的是，在任何软件项目开发中，这都很少能实现。工作流管理系统使得业务流程很容易部署和重新编排，业务流程相关的应用开发可以以一种“迭代／渐进”的方式推进，也就是说工作流技术在某种程度上支持“需求分析不必一次完全成功”。

工作流的技术特点

工作流只管理流程，是不能完成业务操作的。换句话说，工作流是相对独立的、通用的，与业务管理无直接关系。
比如费用报销流程，工作流管理的是报销的流程（谁申请，谁审批），费用报销的业务（使用费用的原因，使用费用的时间，，）
工作流虽然与业务无直接关系，但是，在开发的时候，需要考虑和业务整合。

常见的工作流框架

Activiti、JBPM、OSWorkflow、ActiveBPEL、YAWL等。

Activiti的起源

Activiti是一套业务流程管理(BPM)框架，它覆盖了业务流管理、工作流、服务协助等领域，它是一个开源的（Apache许可2.0）、灵活的、易扩展的可执行流程语言框架。
Activiti是Alfresco软件在2010年5月17日宣布启动的一个开源项目，其创始人和首席架构师由业务流程管理BPM的专家 Tom Baeyens担任。Tom Baeyens是JBoss jBPM的项目架构师。
提示：Jbpm4版本之后，该作者才做的Activiti，所以，Activiti很像jbpm4，理念又有点像hibernate。但是，jbpm5与4版本的差距比较大。

它是一项新的基于Apache许可的开源BPM平台，从基础开始构建，提供支持新的BPMN 2.0标准。（直观的认识就是XML）
Activiti提供了流程设计器，开发人员可以直接通过流程设计器直接画出业务流程图。
Activiti的持久层使用的Mybatis。（api将dao封装了，无需会mybatis）

Activiti环境搭建

One minute version（官方Demo演示）

第一步：用管理员进去定制流程。
第二步：部署和启动流程。
第三步：使用流程。

使用工作流系统需要三步：
1．画流程图（流程文档xml定义）—管理员
2．部署到工作流的系统中—管理员
3．启动流程，开始执行任务，直到任务结束。–用户

新建Maven项目

Maven坐标（工作流引擎activiti-engine，日志实现slf4j-log4j12，数据库驱动oracle，测试junit）：

    <properties>        <activiti.version>5.19.0.2</activiti.version>        <slf4j.version>1.7.5</slf4j.version>        <oracle.version>10.2.0.4.0</oracle.version>        <c3p0.version>0.9.1.2</c3p0.version>        <junit.version>4.11</junit.version>    </properties>  <dependencies>    <dependency>        <groupId>org.activiti</groupId>        <artifactId>activiti-engine</artifactId>        <version>${activiti.version}</version>    </dependency>    <dependency>        <groupId>org.slf4j</groupId>        <artifactId>slf4j-log4j12</artifactId>        <version>${slf4j.version}</version>    </dependency>    <dependency>        <groupId>com.oracle</groupId>        <artifactId>ojdbc14</artifactId>        <version>${oracle.version}</version>        <scope>runtime</scope>    </dependency>    <dependency>        <groupId>junit</groupId>        <artifactId>junit</artifactId>        <version>${junit.version}</version>        <scope>test</scope>    </dependency>  </dependencies>

初始化Activiti数据库

新建一个测试类：

        /**         * Activiti测试类         */        @RunWith(SpringJUnit4ClassRunner.class)        @ContextConfiguration(locations="classpath:applicationContext.xml")        public class ActivitiTest {            //创建表：通过创建工厂（流程引擎：用来生成其他的服务api来具体操作）            @Test            public void testCreateTable(){                //1.得到引擎的配置对象:单服务器使用                ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();                //2.在引擎配置对象上设置相应的数据库连接参数                processEngineConfiguration.setJdbcDriver("oracle.jdbc.driver.OracleDriver");                processEngineConfiguration.setJdbcUrl("jdbc:oracle:thin:@localhost:1521:xe");                processEngineConfiguration.setJdbcUsername("bos");                processEngineConfiguration.setJdbcPassword("bos");                //设置自动建表                //三种参数值：                //false:只是检查表结构，但不创建也不更新。适合已经有表的时候用                //create-drop：启动的时候检查和创建表，引擎关闭的是的删除                //true:检查表结构，如果表存在，则创建，如果表结构不一致，则更新。---常用                processEngineConfiguration.setDatabaseSchemaUpdate(processEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);                //获取工作流引擎对象(单例)                ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine();                System.out.println("====="+processEngine);            }        }

Activiti的核心

• ACT_RE_*: ‘RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。
• ACT_RU_*: ‘RU’表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
• ACT_ID_*: ‘ID’表示identity。 这些表包含身份信息，比如用户，组等等。
• ACT_HI_*: ‘HI’表示history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。
• ACT_GE_*: ‘GE’表示general。通用数据， 用于不同场景下，如存放资源文件。
• ACT_EVT_LOG：事件日志

ProcessEngine：流程引擎接口，是最核心的API类，其他的API类都由他而来。它是其他API产生的基础！ProcessEngine对象，这是Activiti工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。

• RepositoryService 流程定义管理 操作 ACT_RE_* 数据表
• RuntimeService 流程实例管理 操作 ACT_RU_* 数据表
• TaskService 任务管理 操作 ACT_RU_TASK 数据表
• IdentitiService 认证管理 操作 ACT_ID_* 数据表
• HistoryService 历史记录管理 操作 ACT_HI_* 数据表
• ManagementService 定时任务管理，创建job，ACT_RU_JOB 数据表
• FormService 表单管理，生成动态任务表单页面，某个字段存的数据

maven坐标

    <dependency>        <groupId>org.activiti</groupId>        <artifactId>activiti-engine</artifactId>        <version>${activiti.version}</version>    </dependency>    <dependency>        <groupId>org.slf4j</groupId>        <artifactId>slf4j-log4j12</artifactId>        <version>${slf4j.version}</version>    </dependency>

ApplicationContext.xml:

    <!-- 流程引擎配置对象 -->    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">        <!-- 注入数据源 -->        <property name="dataSource" ref="dataSource"/>        <!-- 自动建表 -->        <property name="databaseSchemaUpdate" value="true"/>    </bean>    <!-- 流程引擎对象 -->    <bean id="processEngine" factory-bean="processEngineConfiguration" factory-method="buildProcessEngine"/>

流程文档定义—画流程图

流程id（非常重要-将来程序里面叫key—流程定义的唯一标识），必须英文.
添加办理人：

Bpmn文件解读：

流程定义管理

核心API

关于工作流的api，有个规律：要获取某对象，都是createXxx；
如果是CreateXxx，获取的就是xxx对象，该对象主要用来增删改对应的表。
如果是CreateXxxQuery，获取的是xxxQuery对象，该对象主要用来查询的。

加载流程文档的时候，可以单独加载文档bpmn，工作流会自动生成一张图片存在数据库。
但也可以两个都加载，那么工作流就不会自动生成图片，而使用你上传的图片。

        @RunWith(SpringJUnit4ClassRunner.class)        @ContextConfiguration(                locations="classpath:applicationContext.xml")        public class ActivitiTest {            //注入仓库Service            @Autowired            private RepositoryService repositoryService;            //发布流程:只发布流程图，自动生成图片            @Test            public void deployment1(){                Deployment deployment = repositoryService.createDeployment()//获取发布对象                .addClasspathResource("diagrams/Leave.bpmn")//添加流程文件                .name("请假流程1")//发布的名字                .deploy();//发布                System.out.println("发布的编号："+deployment.getId());                System.out.println("发布的名称："+deployment.getName());                System.out.println("发布的时间："+deployment.getDeploymentTime());            }            //发布流程:发布流程图和图片--第一种方法            @Test            public void deployment21(){                Deployment deployment = repositoryService.createDeployment()//获取发布对象                        .addClasspathResource("diagrams/Leave.bpmn")//添加流程文件                        .addClasspathResource("diagrams/Leave.png")//添加流程图片                        .name("请假流程21")//发布的名字                        .deploy();//发布                System.out.println("发布的编号："+deployment.getId());                System.out.println("发布的名称："+deployment.getName());                System.out.println("发布的时间："+deployment.getDeploymentTime());            }            //发布流程:发布流程图和图片--第二种方法            @Test            public void deployment22() throws FileNotFoundException{                Deployment deployment = repositoryService.createDeployment()//获取发布对象                        .addZipInputStream(new ZipInputStream(this.getClass().getClassLoader().getResourceAsStream("diagrams/Leave.zip")))                        .name("请假流程22")//发布的名字                        .deploy();//发布                System.out.println("发布的编号："+deployment.getId());                System.out.println("发布的名称："+deployment.getName());                System.out.println("发布的时间："+deployment.getDeploymentTime());            }        }

ApplicationContext.xml:

    <!-- 流程控制的相关service -->    <!-- 仓库对象 -->    <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService"></bean>

工作流服务端自动生成的图片的乱码问题解决方案:
解决方案1：
在流程引擎配置对象上面设置字体属性：

 <!-- 发布流程生成图片是正常显示中文 -->        <property name="activityFontName" value="宋体"/>        <property name="labelFontName" value="宋体"/>

解决方案2：
流程图的图片在设计器中生成好，上传到服务器，不让服务器自动生成图片。

部署信息查询

        //查询部署表对象数据        @Test        public void queryDeployment(){            List<Deployment> list = repositoryService.createDeploymentQuery()            //条件查询                    .deploymentName("请假的流程部署")                    .deploymentId("1")//根据id                    .singleResult()//查询出一条结果                    .orderByDeploymenTime()//排序                    .listPage(firstResult, maxResults)//分页                    .count()//统计                    .list();

流程定义信息查询

        @Test        //查询流程定义的表的数据        public void queryProceeDefinition(){            List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery()    //      .processDefinitionKey(processDefinitionKey)//根据key来查询            .list();

流程图查看

    //查询流程图    @Test    public void findProcessDefinitionDiagram() throws IOException{        InputStream in = repositoryService.getProcessDiagram("LeaveProcess:1:4");        OutputStream out = new FileOutputStream("z:/Leave.png");        FileUtil.copyStream(in, out);    }

流程定义的删除-流程销毁

        //删除流程定义（通过部署id）        @Test        public void deleteProcessDefinition(){            repositoryService.deleteDeployment("1", true);        }

级联和不级联。
场景：如果流程已经开启了，如果不使用级联，则会抛出异常！（原因：定义表有外键关联它），此时只能用级联。

流程实例管理

流程实例的启动

• 根据流程定义的id来启动：可以启动指定的流程定义。
• 根据流程定义的key来启动：自动选择版本号最高（最新）的流程定义来启动
• 根据消息的名字来启动

    //启动流程实例    @Test    public void startProcessInstance(){        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("LeaveProcess");    }

applicationContext.xml配置:

<!-- 运行时Service --><bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService"/>

流程实例的查询

    //查询流程实例    @Test    public void queryProcessInstance(){        List<ProcessInstance> list = runtimeService.createProcessInstanceQuery()        .list();    }

流程当前节点的坐标

    //查询活动节点坐标    @Test    public void queryActiveNodeZuobiao(){        List<String> activeActivityIds = runtimeService.getActiveActivityIds("10001");        for (String activeActivityId : activeActivityIds) {            GraphicInfo graphicInfo1 = repositoryService.getBpmnModel("LeaveProcess:4:7504")            .getGraphicInfo(activeActivityId);//某活动节点的坐标        }    }

流程实例的删除（强行终止）

        //流程实例的删除        @Test        public void deleteProcessInstance(){            runtimeService.deleteProcessInstance("LeaveProcess:4:7504", "不想请假了");        }

• 删除流程定义：可以级联删除流程定义以及流程实例相关表数据。–管理员
• 删除流程实例：只删除流程实例相关（运行时）表的数据，对流程定义没有影响。-流程启动者

任务管理

个人任务查询（待办任务查询）

    //个人任务查询    @Test    public void queryPersionTask(){        List<Task> list = taskService.createTaskQuery()                .taskAssignee("张三")                .list();    }

个人任务办理

    //个人任务办理    @Test    public void completePersonTask(){        taskService.complete("12504");    }

任务办理完成

当end节点之前的节点办理完成后，会自动完成end节点。当前流程实例都结束了。