Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务

通过前面的学习,我们了解到activiti是通过 activiti.cfg.xml获取到 ProcessEnigneConfiguration对象,这个对象负责管理流程引擎的配置相关信息,通过这个配置管理对象,我们可以创建出ProcessEnigne流程引擎对象。通过流程引擎对象我们可以得到各种服务对象,如:

  1. repositoryService(流程存储服务)
  2. runtimeService(管理运行时)
  3. TaskService(管理流程中的任务)
  4. IdentityService(管理权限)
  5. FormService(管理表单),
  6. Historyservice(运行结束的查询功能)
  7. ManagementService(流程引擎基础管理)
  8. DynamicBpmService(动态管理流程-6.0新增的服务)   

1、RepositoryService

流程存储服务RepositoryService主要的功能如下:

  1. 管理流程定义文件xml和静态资源的服务
  2. 对特定流程的暂停和激活
  3. 流程定义启动权限管理
  4. 部署文件构造器DeploymentBuilder
  5. 部署文件查询器DeploymentQuery
  6. 流程定义查询对象ProcessDefinition
  7. 流程定义的java格式BpmnModel

1.1 创建新的module

在idea中通过前面的acitivi脚手架创一个新的module

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第1张图片

创建完成后如下图所示:

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第2张图片

1.2 创建一个RepositoryService的测试类

接着我们在test目录下创建一个测试类

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第3张图片

先建立一下这个类的雏形

package com.study.activiti.coreapi;

import org.activiti.engine.RepositoryService;
import org.activiti.engine.test.ActivitiRule;
import org.junit.Rule;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Describe:
 *
 * @author cwqsolo
 * @date 2020/01/31
 */
public class RerostoryServiceTest {

    private static final Logger logger = LoggerFactory.getLogger(RerostoryServiceTest.class);

    @Rule
    public ActivitiRule  activitiRule = new ActivitiRule();

    @Test
    public void  test(){
        RepositoryService repositoryService = activitiRule.getRepositoryService();
    }


}

我们可以通过ctrl+repositoryService来查看一下这个核心api提供的接口,如下图,这些接口就是提供了前面说的主要功能。

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第4张图片

1.3 完善测试代码

下面对于一次部署多个流程定义文件进行测试代码的补充

@Test
public void  test(){
    RepositoryService repositoryService = activitiRule.getRepositoryService();

    //创建一个流程部署对象,并部署两个流程定义文件
    DeploymentBuilder deployment = repositoryService.createDeployment();
    deployment.name("测试部署资源")
            .addClasspathResource("comm2Level.bpmn20.xml")
            .addClasspathResource("my-process.bpmn20.xml");

    //创建部署对象
    Deployment deploy = deployment.deploy();
    logger.info("deploy ={}", deploy);

    //创建一个部署查询对象
    DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery();
    //因为是一次部署,所以可以用 singleResult
    Deployment deployment1 = deploymentQuery.deploymentId(deploy.getId()).singleResult();

    logger.info("deploy ={}", deployment1);

    //查询流程定义
    List processDefinitions = repositoryService.createProcessDefinitionQuery()
            .deploymentId(deploy.getId())
            .listPage(0, 100);

    for (ProcessDefinition processDefinition: processDefinitions) {
        logger.info("processDefinition = {}, version = {}, key={}, id={}",  processDefinition,
                processDefinition.getVersion(),
                processDefinition.getKey(),
                processDefinition.getId());
    }


}

在上述代码中,通过一次部署两个流程定义文件,然后将流程定义内容打印出来,执行情况如下:

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第5张图片

1.4 流程的挂起和重新启动

存储服务提供了流程的挂起和重新启动的接口代码如下:

@Test
@org.activiti.engine.test.Deployment(resources = {"my-process.bpmn20.xml"})
public void testSuspend() {
    RepositoryService repositoryService = activitiRule.getRepositoryService();
    ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().singleResult();
    logger.info("processDefinition.id={}", processDefinition.getId());

    //将流程定义挂起,这个时候如果去启动会报告异常
    repositoryService.suspendProcessDefinitionById(processDefinition.getId());

    try {
        logger.info("开始启动");
        activitiRule.getRuntimeService().startProcessInstanceById(processDefinition.getId());
        logger.info("启动成功");
    } catch (Exception e) {
        logger.info("启动失败");
        logger.info(e.getMessage(),e);
    }
    //重新激活,并启动,这个时候可以启动成功
    repositoryService.activateProcessDefinitionById(processDefinition.getId());
    try {
        logger.info("重新激活,并开始启动");
        activitiRule.getRuntimeService().startProcessInstanceById(processDefinition.getId());
        logger.info("启动成功");
    } catch (Exception e) {
        logger.info("启动失败");
        logger.info(e.getMessage(),e);
    }


}

执行日志如下:

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第6张图片

1.5 多次部署的情况

接着我们可以对两个流程定义文件,进行多次部署,代码如下:

@Test
public void test() {
    RepositoryService repositoryService = activitiRule.getRepositoryService();

    //创建一个流程部署对象,并部署两个流程定义文件
    DeploymentBuilder deployment = repositoryService.createDeployment();
    deployment.name("测试部署资源")
            .addClasspathResource("comm2Level.bpmn20.xml")
            .addClasspathResource("my-process.bpmn20.xml");
    //创建部署对象
    Deployment deploy = deployment.deploy();
    logger.info("deploy ={}", deploy);

    //创建第二个流程部署对象,并部署两个流程定义文件
    DeploymentBuilder deployment2 = repositoryService.createDeployment();
    deployment2.name("测试部署资源2")
            .addClasspathResource("comm2Level.bpmn20.xml")
            .addClasspathResource("my-process.bpmn20.xml");
    //创建部署对象
    Deployment deploy2 = deployment2.deploy();
    logger.info("deploy ={}", deploy2);

    //创建一个部署查询对象
    DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery();
    //因为是一次部署,所以可以用 singleResult
    //Deployment deployment1 = deploymentQuery.deploymentId(deploy.getId()).singleResult();
    //因为部署了两次,所以代码上要做相应变化,返回list
    List deployments = deploymentQuery.orderByDeploymenTime().asc().listPage(0, 100);

    //遍历deployments-- 用iter方式
    for (Deployment deployment1 : deployments) {
        logger.info("deployment = {}", deployment1);
    }

    logger.info("deploymentlist size = {}", deployments.size());


    //查询流程定义
    List processDefinitions = repositoryService.createProcessDefinitionQuery()
            //.deploymentId(deploy.getId())
            .orderByProcessDefinitionKey().asc()
            .listPage(0, 100);

    for (ProcessDefinition processDefinition : processDefinitions) {
        logger.info("processDefinition = {}, version = {}, key={}, id={}", processDefinition,
                processDefinition.getVersion(),
                processDefinition.getKey(),
                processDefinition.getId());
    }


}

 

执行日志如下:

Activiti6.0学习实践(6)-核心api:RepositoryService 存储服务_第7张图片

 

1.6 指定流程执行的用户和用户组

存储服务提供了指定流程的执行用户和用户组的接口

下面是测试代码中的相关测试函数

//

@Test
@org.activiti.engine.test.Deployment(resources = {"my-process.bpmn20.xml"})
public void testCandiateStarter() {
    RepositoryService repositoryService = activitiRule.getRepositoryService();
    ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().singleResult();
    logger.info("processDefinition.id={}", processDefinition.getId());

    //创建流程和用户,用户组关系
    repositoryService.addCandidateStarterUser(processDefinition.getId(), "user");
    repositoryService.addCandidateStarterGroup(processDefinition.getId(), "groupadmin");

    //获取用户组关系信息
    List identityLinksForProcessDefinition
            = repositoryService.getIdentityLinksForProcessDefinition(processDefinition.getId());

    for (IdentityLink identityLink : identityLinksForProcessDefinition) {
        logger.info("identityLink = {}", identityLink);

    }

    //删除流程和用户组关系
    repositoryService.deleteCandidateStarterGroup(processDefinition.getId(), "groupadmin");
    repositoryService.deleteCandidateStarterUser(processDefinition.getId(), "user");


}

试指定用户组来启动

执行的情况如下

你可能感兴趣的:(工作流,流程引擎,activiti)