SpringBoot整合Activiti Modeler可视化流程定制

SpringBoot整合Activiti Modeler可视化流程定制

0. 完整示例代码

1. springboot项目搭建初始化

这里需要lombok的也可以加上,不用也行

2. springboot整合Activiti

2.1 导入依赖

<!--Activiti基础JAR包-->
<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring-boot-starter-basic</artifactId>
    <version>5.22.0</version>
</dependency>

2.2 配置mysql与activiti相关配置

此处我的8080端口被占用了,我改用8000

spring:
  datasource:
    url: jdbc:mysql:///activiti2?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver
  activiti:
    #1.flase：默认值。activiti在启动时，对比数据库表中保存的版本，如果没有表或者版本不匹配，将抛出异常
    #2.true： activiti会对数据库中所有表进行更新操作。如果表不存在，则自动创建
    #3.create_drop： 在activiti启动时创建表，在关闭时删除表（必须手动关闭引擎，才能删除表）
    #4.drop-create： 在activiti启动时删除原来的旧表，然后在创建新表（不需要手动关闭引擎）
    database-schema-update: true
    #检测历史表是否存在 activiti7默认没有开启数据库历史记录 启动数据库历史记录
    db-history-used: true
    #记录历史等级 可配置的历史级别有none, activity, audit, full
    #none：不保存任何的历史数据，因此，在流程执行过程中，这是最高效的。
    #activity：级别高于none，保存流程实例与流程行为，其他数据不保存。
    #audit：除activity级别会保存的数据外，还会保存全部的流程任务及其属性。audit为history的默认值。
    #full：保存历史数据的最高级别，除了会保存audit级别的数据外，还会保存其他全部流程相关的细节数据，包括一些流程参数等。
    history-level: full
    #校验流程文件，默认校验resources下的processes文件夹里的流程文件
    check-process-definitions: false
    #自动部署文件路径后缀
#   process-definition-location-prefix: classpath:/processes/
#   process-definition-location-suffixes:
#      - **.bpmn
#      - **.bpmn20.xml
server:
  port: 8000

2.3 启动时报错SecurityAutoConfiguration

原因:

• spring-boot-starter中默认有一个spring-boot-autoconfigure-2.0.RELEASE.jar中有一个SecurityAutoConfiguration.class,
• activity中activiti-spring-boot-starter-rest-api.jar包也有一个SecurityAutoConfiguration.class,
• 需要将两个包中的 SecurityAutoConfiguration.class 都排除

解决:去除相关自动配置

@SpringBootApplication(exclude = {org.activiti.spring.boot.SecurityAutoConfiguration.class})

2.4 Table 'activiti2.act_ge_property' doesn't exist 报错

解决:在 spring.datasource.url 增加以下配置

&nullCatalogMeansCurrent=true

再次启动成功,同时acticiti相关表也创建成功

3. 整合 Activiti Modeler

注意:Activiti6.0.0及以上版本与activiti-modeler的maven引用有冲突，解决方法参考
Activiti6.0.0及以上版本集成Activiti Modeler

3.1 下载activiti-5.22.0官方Demo及activiti5.22.0源码

我这里已经下好了放在file目录

3.2 前端文件整合

3.2.1 解压activiti-5.22.0.zip官方Demo

如果打不开activiti-explorer,改一下后缀

复制editor-app,diagram-viewer文件夹，以及modele.html到本地项目

3.3 服务端文件整合

复制ModelEditorJsonRestResource.java,ModelSaveRestResource.java,StencilsetRestResource.java到controller层文件夹下

3.4 添加maven引用

导入依赖解除报错

<dependency>
	<groupId>org.activiti</groupId>
	<artifactId>activiti-modeler</artifactId>
	<version>5.22.0</version>
</dependency>

3.5 启动项目,访问modeler页面

http://localhost:8000/modeler.html

3.5.1 修改启动类，屏蔽登录功能

@SpringBootApplication(exclude = {SecurityAutoConfiguration.class, org.activiti.spring.boot.SecurityAutoConfiguration.class})

再次访问modeler页面http://localhost:8000/modeler.html

3.5.2 处理 /activiti-explorer/service/model//json 请求的报错

该请求的控制类为ModelEditorJsonRestResource.java

@RequestMapping(value="/model/{modelId}/json", method = RequestMethod.GET, produces = "application/json")

在/public/editor-app/app-cfg.js文件中修改请求的地址

ACTIVITI.CONFIG = {
	// 'contextRoot' : '/activiti-explorer/service',
	'contextRoot' : '',
};

再次访问modeler页面http://localhost:8000/modeler.html

报错GET http://localhost:8080/model//json 404 ()
这是因为我们没有已经建好的model模型，无法查看

3.5.3 新建model

测试类

package site.zhourui.springboot_activiti_modeler_demo.controller;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import org.activiti.editor.constants.ModelDataJsonConstants;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.repository.Model;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author zr
 * @date 2022/6/13 16:36
 */
@Controller
@RequestMapping("model")
public class ModelTest {

    @RequestMapping("create")
    public void createModel(HttpServletRequest request, HttpServletResponse response){
        try{
            String modelName = "modelName";
            String modelKey = "modelKey";
            String description = "description";

            ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

            RepositoryService repositoryService = processEngine.getRepositoryService();

            ObjectMapper objectMapper = new ObjectMapper();
            ObjectNode editorNode = objectMapper.createObjectNode();
            editorNode.put("id", "canvas");
            editorNode.put("resourceId", "canvas");
            ObjectNode stencilSetNode = objectMapper.createObjectNode();
            stencilSetNode.put("namespace", "http://b3mn.org/stencilset/bpmn2.0#");
            editorNode.put("stencilset", stencilSetNode);
            Model modelData = repositoryService.newModel();

            ObjectNode modelObjectNode = objectMapper.createObjectNode();
            modelObjectNode.put(ModelDataJsonConstants.MODEL_NAME, modelName);
            modelObjectNode.put(ModelDataJsonConstants.MODEL_REVISION, 1);
            modelObjectNode.put(ModelDataJsonConstants.MODEL_DESCRIPTION, description);
            modelData.setMetaInfo(modelObjectNode.toString());
            modelData.setName(modelName);
            modelData.setKey(modelKey);

            //保存模型
            repositoryService.saveModel(modelData);
            repositoryService.addModelEditorSource(modelData.getId(), editorNode.toString().getBytes("utf-8"));
            response.sendRedirect(request.getContextPath() + "/modeler.html?modelId=" + modelData.getId());
        }catch (Exception e){
        }
    }

}

访问http://localhost:8000/model/create

3.5.4 处理http://localhost:8000/editor/stencilset?version=1655109605759请求的报错

在StencilsetRestResource.java中，我们项目中少了stencilset.json

@RestController
public class StencilsetRestResource {

@RequestMapping(value="/editor/stencilset", method = RequestMethod.GET, produces = "application/json;charset=utf-8")
public @ResponseBody String getStencilset() {
//stencilset.json为Model中的工具栏的名称字符，这里在resources下面查找
 InputStream stencilsetStream = this.getClass().getClassLoader().getResourceAsStream("stencilset.json");
 try {
   return IOUtils.toString(stencilsetStream, "utf-8");
 } catch (Exception e) {
   throw new ActivitiException("Error while loading stencil set", e);
 }
}
}

下载stencilset.json，并放置在resources目录下
再次访问localhost:8000/model/create

3.5.5 构建model保存model

3.5.5.1 保存失败http://localhost:8000/model/1/save

修改ModelSaveRestResource.java为

@RestController
public class ModelSaveRestResource implements ModelDataJsonConstants {

protected static final Logger LOGGER = LoggerFactory.getLogger(ModelSaveRestResource.class);

@Autowired
private RepositoryService repositoryService;

@Autowired
private ObjectMapper objectMapper;

@RequestMapping(value="/model/{modelId}/save", method = RequestMethod.PUT)
@ResponseStatus(value = HttpStatus.OK)
public void saveModel(@PathVariable String modelId, String name, String description, String json_xml, String svg_xml) {
 try {

   Model model = repositoryService.getModel(modelId);

   ObjectNode modelJson = (ObjectNode) objectMapper.readTree(model.getMetaInfo());

   modelJson.put(MODEL_NAME, name);
   modelJson.put(MODEL_DESCRIPTION, description);
   model.setMetaInfo(modelJson.toString());
   model.setName(name);

   repositoryService.saveModel(model);

   repositoryService.addModelEditorSource(model.getId(), json_xml.getBytes("utf-8"));

   InputStream svgStream = new ByteArrayInputStream(svg_xml.getBytes("utf-8"));
   TranscoderInput input = new TranscoderInput(svgStream);

   PNGTranscoder transcoder = new PNGTranscoder();
   // Setup output
   ByteArrayOutputStream outStream = new ByteArrayOutputStream();
   TranscoderOutput output = new TranscoderOutput(outStream);

   // Do the transformation
   transcoder.transcode(input, output);
   final byte[] result = outStream.toByteArray();
   repositoryService.addModelEditorSourceExtra(model.getId(), result);
   outStream.close();

 } catch (Exception e) {
   LOGGER.error("Error saving model", e);
   throw new ActivitiException("Error saving model", e);
 }
}
}

再次保存，保存成功。Activiti Modeler集成成功