Activiti6+SpringBoot+在线设计器集成整合案例

谁践踏了优雅 2024-04-17 15:53 55阅读 0赞

### 一、引入依赖 ###

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.zhq</groupId>
        <artifactId>activiti-springboot</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>1.5.10.RELEASE</version>
            <relativePath /> 
        </parent>
    
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </dependency>
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
            </dependency>
    
           
    
            
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>2.7.0</version>
            </dependency>
    
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>2.7.0</version>
            </dependency>
    
            
            <dependency>
                <groupId>org.activiti</groupId>
                <artifactId>activiti-spring-boot-starter-basic</artifactId>
                <version>6.0.0</version>
            </dependency>
    
            <dependency>
                <groupId>org.activiti</groupId>
                <artifactId>activiti-spring-boot-starter-rest-api</artifactId>
                <version>6.0.0</version>
            </dependency>
    
            <dependency>
                <groupId>org.activiti</groupId>
                <artifactId>activiti-spring-boot-starter-actuator</artifactId>
                <version>6.0.0</version>
            </dependency>
    
            <dependency>
                <groupId>org.activiti</groupId>
                <artifactId>activiti-explorer</artifactId>
                <version>5.22.0</version>
                <exclusions>
                    <exclusion>
                        <groupId>org.slf4j</groupId>
                        <artifactId>slf4j-log4j12</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
    
            <dependency>
                <groupId>org.apache.xmlgraphics</groupId>
                <artifactId>batik-codec</artifactId>
                <version>1.7</version>
            </dependency>
    
            <dependency>
                <groupId>org.apache.xmlgraphics</groupId>
                <artifactId>batik-css</artifactId>
                <version>1.7</version>
            </dependency>
    
            <dependency>
                <groupId>org.apache.xmlgraphics</groupId>
                <artifactId>batik-svg-dom</artifactId>
                <version>1.7</version>
            </dependency>
    
            <dependency>
                <groupId>org.apache.xmlgraphics</groupId>
                <artifactId>batik-svggen</artifactId>
                <version>1.7</version>
            </dependency>
    
    
    
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>1.8</source>
                        <target>1.8</target>
                    </configuration>
                </plugin>
            </plugins>
            <defaultGoal>compile</defaultGoal>
        </build>
    
    
    </project>

### 二、SpringBoot配置 ###

# application 基本属性配置
    server.port=8080
    server.context-path=/activitiService
    spring.application.name=HQZheng-apaas-activitiService
    spring.jmx.enabled=false
    entitymanager.packagesToScan=com
    spring.aop.auto=true
    
    # 工作流相关配置
    spring.activiti.rest-api-enabled=true
    spring.activiti.rest-api-servlet-name=activiti swagger文档
    
    #jdbc配置
    spring.datasource.url=jdbc:mysql://localhost:3306/activiti
    spring.datasource.username=root
    spring.datasource.password=root
    spring.datasource.driver-class-name=com.mysql.jdbc.Driver
    
    #activiti配置
    #数据库策略false（默认） true create-drop drop-create
    spring.activiti.database-schema-update=true
    #工作流日志级别
    spring.activiti.history-level=activity
    #自动部署验证设置：true-开启（默认）
    spring.activiti.check-process-definitions=false

### 三、编写启动类 ###

/**
     * @program: activitispringboot
     * @description: 工作流启动类
     * @author: hq.zheng
     * @create: 2019-08-27 21:03
     */
    @SpringBootApplication
    @EnableSwagger2
    @EnableAutoConfiguration(exclude = {
    org.springframework.boot.autoconfigure.security.SecurityAutoConfiguration.class,
    org.activiti.spring.boot.SecurityAutoConfiguration.class,
    org.springframework.boot.actuate.autoconfigure.ManagementWebSecurityAutoConfiguration.class
    })
    public class ActivitiApplication {
        public static void main(String[] args) {
            SpringApplication.run(ActivitiApplication.class,args);
        }
    }

### 四、整合在线设计器（activiti modeler 组件） ###

1）、拉取源码到本地

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70][]

2）、提取activiti-webapp-explorer2项目中的diagram-viewer，editor-app，modeler.html，stencilset.json 放置到  resource/static 中。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 1][]

3）、提取activiti-modeler项目中的StencilsetRestResource.java，ModelEditorJsonRestResource.java，ModelSaveRestResource.java 放置到项目中，也可以根据需要自己定义。

ModelEditorJsonRestResource.java

/**
     * 模板编辑
     * @author HQ Zheng
     */
    @RestController
    @RequestMapping(value = "/service")
    public class ModelEditorJsonRestResource implements ModelDataJsonConstants {
      
      protected static final Logger LOGGER = LoggerFactory.getLogger(ModelEditorJsonRestResource.class);
      
      @Autowired
      private RepositoryService repositoryService;
      
      @Autowired
      private ObjectMapper objectMapper;
    
      /**
       * 获取模板编辑信息
       * @param modelId
       * @return
       */
      @RequestMapping(value="/model/{modelId}/json", method = RequestMethod.GET, produces = "application/json")
      public ObjectNode getEditorJson(@PathVariable String modelId) {
        ObjectNode modelNode = null;
        
        Model model = repositoryService.getModel(modelId);
          
        if (model != null) {
          try {
            if (StringUtils.isNotEmpty(model.getMetaInfo())) {
              modelNode = (ObjectNode) objectMapper.readTree(model.getMetaInfo());
            } else {
              modelNode = objectMapper.createObjectNode();
              modelNode.put(MODEL_NAME, model.getName());
            }
            modelNode.put(MODEL_ID, model.getId());
            ObjectNode editorJsonNode = (ObjectNode) objectMapper.readTree(
                new String(repositoryService.getModelEditorSource(model.getId()), "utf-8"));
            modelNode.put("model", editorJsonNode);
            
          } catch (Exception e) {
            LOGGER.error("Error creating model JSON", e);
            throw new ActivitiException("Error creating model JSON", e);
          }
        }
        return modelNode;
      }
    }

ModelSaveRestResource.java

/**模型保存
     * @author HQ Zheng
     */
    @RestController
    @RequestMapping(value = "/service")
    public class ModelSaveRestResource implements ModelDataJsonConstants {
      
      protected static final Logger LOGGER = LoggerFactory.getLogger(ModelSaveRestResource.class);
    
      @Autowired
      private RepositoryService repositoryService;
      
      @Autowired
      private ObjectMapper objectMapper;
    
      /**
       * 保存模型
       * @param modelId
       * @param json_xml
       * @param svg_xml
       * @param name
       * @param description
       */
      @RequestMapping(value = "/model/{modelId}/save", method = RequestMethod.PUT)
      public void saveModel(@PathVariable String modelId, @RequestParam String json_xml,
                            @RequestParam  String svg_xml,@RequestParam String name, @RequestParam String description) {
        try {
    
          // 获取模型信息并更新模型信息
          ObjectMapper objectMapper = new ObjectMapper();
          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();
          ByteArrayOutputStream outStream = new ByteArrayOutputStream();
          TranscoderOutput output = new TranscoderOutput(outStream);
          transcoder.transcode(input, output);
          final byte[] result = outStream.toByteArray();
          repositoryService.addModelEditorSourceExtra(model.getId(), result);
          outStream.close();
          Model modelData = repositoryService.getModel(modelId);
          ObjectNode modelNode = (ObjectNode) objectMapper.readTree(repositoryService.getModelEditorSource(modelData.getId()));
          byte[] bpmnBytes = null;
          BpmnModel model2 = new BpmnJsonConverter().convertToBpmnModel(modelNode);
          bpmnBytes = new BpmnXMLConverter().convertToXML(model2);
          String processName = modelData.getName() + ".bpmn";
          Deployment deployment = repositoryService.createDeployment()
                  .name(modelData.getName())
                  .addString(processName, StringUtils.toEncodedString(bpmnBytes, Charset.forName("UTF-8")))
                  .deploy();
        } catch (Exception e) {
          LOGGER.error("模型保存失败", e);
          throw new ActivitiException("模型保存失败", e);
        }
    
      }
    }

StencilsetRestResource.java

/**加载模板集
     * @author HQ Zheng
     */
    @RestController
    @RequestMapping(value = "/service")
    public class StencilsetRestResource {
      
      @RequestMapping(value="/editor/stencilset", method = RequestMethod.GET, produces = "application/json;charset=utf-8")
      public @ResponseBody String getStencilset() {
        InputStream stencilsetStream = this.getClass().getClassLoader().getResourceAsStream("static/stencilset.json");
        try {
          return IOUtils.toString(stencilsetStream, "utf-8");
        } catch (Exception e) {
          throw new ActivitiException("Error while loading stencil set", e);
        }
      }
    }

4）、修改app-cfg.js

ACTIVITI.CONFIG = {
        'contextRoot' : '/activitiService/service',
    };

5）、如果需要中文的编辑器，可以自己下载一个stencilset.json中文的

### 五、验证是否整合成功 ###

1）、访问：[http://127.0.0.1:8080/activitiService/activiti-ui.html][http_127.0.0.1_8080_activitiService_activiti-ui.html] 验证设计器是否整合成功

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 2][]

2）、访问：[http://127.0.0.1:8080/activitiService/swagger-ui.html][http_127.0.0.1_8080_activitiService_swagger-ui.html] 验证Activiti Rest和Swagger

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 3][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/e791cf9cd3c64890a5ceeeb3ce62be84.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/ff215f90388f435899fb61a4c3d99038.png
[http_127.0.0.1_8080_activitiService_activiti-ui.html]: http://127.0.0.1:8095/activitiService/activiti-ui.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/0d66120d6a5b4781853ad1cd92003704.png
[http_127.0.0.1_8080_activitiService_swagger-ui.html]: http://127.0.0.1:8095/activitiService/swagger-ui.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3htMzkzMzkyNjI1_size_16_color_FFFFFF_t_70 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/460d86eed9124e20b51254b090a7b2ae.png