SpringBoot 整合 Activiti7

àì夳堔傛蜴生んèń 2023-10-04 23:18 28阅读 0赞

### 一.pom依赖引入 ###

通过该 pom.xml 文件所导入的坐标，我们就可以实现 activiti7 与 Springboot 整合

<parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.1.0.RELEASE</version>
            <relativePath/> 
        </parent>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
            <java.version>1.8</java.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-jdbc</artifactId>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</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.activiti</groupId>
                <artifactId>activiti-spring-boot-starter</artifactId>
                <version>7.0.0.Beta2</version>
            </dependency>
    
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.4.5</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>5.1.27</version>
            </dependency>
    
    
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>

### 二.配置文件编写 ###

为了能够实现 Activiti7 生成的表放到 Mysql 数据库中，需要在 springboot 的配置文件 application.yml 中添加相关的配置

spring:
      datasource:
        url: jdbc:mysql://localhost:3306/activiti?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT
        username : root
        password : root
        driver-class-name: com.mysql.jdbc.Driver
      activiti:
        db-history-used: true  #进行相关activiti操作时，要生成history相关的表
        history-level: full  #history相关表中的历史记录都要被记录

说明：正常如果在配置文件中不加入activiti的配置，是不会生成相关历史记录表的，所以必须加上上面的activiti配置才能在数据库中生成对应的历史记录表

### 三.添加 SpringSecurity 安全框 架整合配置 ###

因为 Activiti7 与 SpringBoot 整合后，默认情况下，集成了 SpringSecurity 安全框架，这样我们就要去 准备 SpringSecurity 整合进来的相关用户权限配置信息。

#### 1.添加 SecurityUtil工具类 ####

package com.itheima.activiti;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.security.core.Authentication;
    import org.springframework.security.core.GrantedAuthority;
    import org.springframework.security.core.context.SecurityContextHolder;
    import org.springframework.security.core.context.SecurityContextImpl;
    import org.springframework.security.core.userdetails.UserDetails;
    import org.springframework.security.core.userdetails.UserDetailsService;
    import org.springframework.stereotype.Component;
    
    import java.util.Collection;
    
    @Component
    public class SecurityUtil {
    
        @Autowired
        private UserDetailsService userDetailsService;
    
        public void logInAs(String username) {
    
            UserDetails user = userDetailsService.loadUserByUsername(username);
            if (user == null) {
                throw new IllegalStateException("User " + username + " doesn't exist, please provide a valid user");
            }
    
            SecurityContextHolder.setContext(new SecurityContextImpl(new Authentication() {
                @Override
                public Collection<? extends GrantedAuthority> getAuthorities() {
                    return user.getAuthorities();
                }
    
                @Override
                public Object getCredentials() {
                    return user.getPassword();
                }
    
                @Override
                public Object getDetails() {
                    return user;
                }
    
                @Override
                public Object getPrincipal() {
                    return user;
                }
    
                @Override
                public boolean isAuthenticated() {
                    return true;
                }
    
                @Override
                public void setAuthenticated(boolean isAuthenticated) throws IllegalArgumentException {
    
                }
    
                @Override
                public String getName() {
                    return user.getUsername();
                }
            }));
            org.activiti.engine.impl.identity.Authentication.setAuthenticatedUserId(username);
        }
    }

#### 2.添加 DemoApplicationConfig 类 ####

在 Activiti7 官方下载的 Example 中找到 DemoApplicationConfig 类，它的作用是为了实现 SpringSecurity 框架的用户权限的配置，这样我们就可以在系统中使用用户权限信息。本次项目中基 本是在文件中定义出来的用户信息，当然也可以是数据库中查询的用户权限信息。

/*
     * Copyright 2018 Alfresco, Inc. and/or its affiliates.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *       http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    
    package com.itheima.activiti;
    
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
    import org.springframework.security.config.annotation.web.builders.HttpSecurity;
    import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
    import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
    import org.springframework.security.core.authority.SimpleGrantedAuthority;
    import org.springframework.security.core.userdetails.User;
    import org.springframework.security.core.userdetails.UserDetailsService;
    import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
    import org.springframework.security.crypto.password.PasswordEncoder;
    import org.springframework.security.provisioning.InMemoryUserDetailsManager;
    
    import java.util.Arrays;
    import java.util.List;
    import java.util.stream.Collectors;
    
    @Configuration
    @EnableWebSecurity
    public class DemoApplicationConfiguration extends WebSecurityConfigurerAdapter {
    
        private Logger logger = LoggerFactory.getLogger(DemoApplicationConfiguration.class);
    
        @Override
        @Autowired
        public void configure(AuthenticationManagerBuilder auth) throws Exception {
            auth.userDetailsService(myUserDetailsService());
        }
    
        @Bean
        public UserDetailsService myUserDetailsService() {
    
            InMemoryUserDetailsManager inMemoryUserDetailsManager = new InMemoryUserDetailsManager();
    
            String[][] usersGroupsAndRoles = {
                    {"salaboy", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
                    {"ryandawsonuk", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
                    {"erdemedeiros", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
                    {"other", "password", "ROLE_ACTIVITI_USER", "GROUP_otherTeam"},
                    {"admin", "password", "ROLE_ACTIVITI_ADMIN"},
            };
    
            for (String[] user : usersGroupsAndRoles) {
                List<String> authoritiesStrings = Arrays.asList(Arrays.copyOfRange(user, 2, user.length));
                logger.info("> Registering new user: " + user[0] + " with the following Authorities[" + authoritiesStrings + "]");
                inMemoryUserDetailsManager.createUser(new User(user[0], passwordEncoder().encode(user[1]),
                        authoritiesStrings.stream().map(s -> new SimpleGrantedAuthority(s)).collect(Collectors.toList())));
            }
    
    
            return inMemoryUserDetailsManager;
        }
    
    
        @Override
        protected void configure(HttpSecurity http) throws Exception {
            http
                    .csrf().disable()
                    .authorizeRequests()
                    .anyRequest()
                    .authenticated()
                    .and()
                    .httpBasic();
    
    
        }
    
        @Bean
        public PasswordEncoder passwordEncoder() {
            return new BCryptPasswordEncoder();
        }
    }

### 四.设置流程（构建bpmn文件） ###

### ![1abc8edeedd546b996564d6b9ebdc842.png][] ###

### 五.使用 SpringBoot 整合 Junit 方式测试 ###

package com.itheima.activiti;
    
    import org.activiti.api.process.model.ProcessDefinition;
    import org.activiti.api.process.model.ProcessInstance;
    import org.activiti.api.process.model.builders.ProcessPayloadBuilder;
    import org.activiti.api.process.runtime.ProcessRuntime;
    import org.activiti.api.runtime.shared.query.Page;
    import org.activiti.api.runtime.shared.query.Pageable;
    import org.activiti.api.task.model.Task;
    import org.activiti.api.task.model.builders.TaskPayloadBuilder;
    import org.activiti.api.task.runtime.TaskRuntime;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    
    /**
     * @DESCRIPTION:
     * @USER: tangbingbing
     * @DATE: 2023/3/11 11:46
     */
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class ActivitiTest {
    
        @Autowired
        private ProcessRuntime processRuntime; //流程定义相关
    
        @Autowired
        private TaskRuntime taskRuntime;  //任务操作相关
    
        @Autowired
        private SecurityUtil securityUtil; //springsecurity相关的工具类
    
        //流程定义信息查看
        @Test
        public void testDefinition(){
            securityUtil.logInAs("salaboy"); //需要先认证
            Page<ProcessDefinition> page = processRuntime.processDefinitions(Pageable.of(0, 10));
            System.out.println(page.getTotalItems());// 查看已部署的流程
            //page.getContent()查看当前每一个部署的信息
            for (ProcessDefinition processDefinition : page.getContent()) {
                System.out.println(processDefinition);
            }
        }
    
        //启动流程实例
        @Test
        public void testStartInstance(){
            securityUtil.logInAs("salaboy");
            ProcessInstance processInstance = processRuntime.start(ProcessPayloadBuilder
                    .start()
                    .withProcessDefinitionKey("myProcess_1")
                    .build());
            System.out.println("流程实例id：" + processInstance.getId()); //流程实例id
        }
    
        //查询任务，并完成任务
        @Test
        public void testTask(){
            securityUtil.logInAs("ryandawsonuk");
            Page<Task> tasks = taskRuntime.tasks(Pageable.of(0, 10));
            if (tasks.getTotalItems() > 0) {
                for (Task task : tasks.getContent()) {
                    System.out.println("任务1：" + task);
                    //拾取任务
                    taskRuntime.claim(TaskPayloadBuilder.claim().withTaskId(task.getId()).build());
                    //执行任务
                    taskRuntime.complete(TaskPayloadBuilder.complete().withTaskId(task.getId()).build());
                }
            }
            //再次查看任务
            tasks = taskRuntime.tasks(Pageable.of(0, 10));
            if (tasks.getTotalItems() > 0) {
                for (Task task : tasks.getContent()) {
                    System.out.println("任务2：" + task);
                }
            }
    
        }
    
        //查询任务，并完成任务
        @Test
        public void testTaskAll(){
            securityUtil.logInAs("erdemedeiros");
            Page<Task> tasks = taskRuntime.tasks(Pageable.of(0, 10));
            if (tasks.getTotalItems() > 0) {
                for (Task task : tasks.getContent()) {
                    System.out.println("任务1：" + task);
                    //拾取任务
                    taskRuntime.claim(TaskPayloadBuilder.claim().withTaskId(task.getId()).build());
                    //执行任务
                    taskRuntime.complete(TaskPayloadBuilder.complete().withTaskId(task.getId()).build());
                }
            }
            //再次查看任务
            tasks = taskRuntime.tasks(Pageable.of(0, 10));
            if (tasks.getTotalItems() > 0) {
                for (Task task : tasks.getContent()) {
                    System.out.println("任务2：" + task);
                }
            }
    
        }
    
    }

### 六.整合SpringMVC ###

代码与测试类中相似

[1abc8edeedd546b996564d6b9ebdc842.png]: https://img-blog.csdnimg.cn/1abc8edeedd546b996564d6b9ebdc842.png