springboot +flowable，处理 flowable 的用户和用户组（二）

一.简介

对于flowable是什么以及关于此框架的具体信息可以参看此项目的官方文档：https://www.flowable.org/docs/userguide/index.html

Flowable is a light-weight business process engine written in Java.这是官网文档对此框架的完美解释：Flowable是一个用java语言写的轻量级工作流引擎。

在实际开发中，很少会直接用到 flowable 中的用户体系，但是毕竟官方设计了这个东西，而存在就必然有其合理性。写个 Spring Boot 的demo，学习怎么去添加、删除、修改一个用户或者组。

二.springboot整合flowable

1.使用版本

springBoot版本：2.3.2.RELEASE
flowable版本：6.5.0

2.创建项目

创建一个 SpringBoot 项目，引入 Web、和 MySQL 驱动两个依赖，截图如下：
在这里插入图片描述

3.项目依赖pom.xml

springboot 版本

        <parent>
           <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-parent</artifactId>
          <version>2.3.0.RELEASE</version>
         <relativePath/> <!-- lookup parent from repository -->
      </parent>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-engine</artifactId>
            <scope>compile</scope>
            <version>6.5.0</version>
            <exclusions>
                <exclusion>
                    <groupId>org.mybatis</groupId>
                    <artifactId>mybatis</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter-basic</artifactId>
            <version>6.5.0</version>
        </dependency>
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-bpmn-layout</artifactId>
            <version>6.5.0</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

4.项目配置application.yml

数据库和flowable的配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/flowable?useSSL=false&characterEncoding=UTF-8&serverTimezone=GMT%2B8
    driver-class-name: com.mysql.jdbc.Driver
    username: root
    password: 123456

flowable:
  database-schema-update: true
   # flase：       默认值。activiti在启动时，会对比数据库表中保存的版本，如果没有表或者版本不匹配，将抛出异常。（生产环境常用）
   # true：        activiti会对数据库中所有表进行更新操作。如果表不存在，则自动创建。（开发时常用）
   # create_drop： 在activiti启动时创建表，在关闭时删除表（必须手动关闭引擎，才能删除表）。（单元测试常用）
   # drop-create： 在activiti启动时删除原来的旧表，然后在创建新表（不需要手动关闭引擎）。
  process:
    definition-cache-limit: -1
  activity-font-name: 宋体
  label-font-name: 宋体
  annotation-font-name: 宋体

flowable的配置，再默认情况下，位于 resources/processes 的流程都会被自动部署。
配置完成后，就可以启动项目了。项目启动成功之后，flowable 数据库中就会自动创建如下这些表，会自动初始化数据库，将来流程引擎运行时候的数据会被自动持久化到数据库中。。数据库表的截图如下：
在这里插入图片描述

三.用户组操作

在 Spring Boot 中，flowable 默认已经给我们配置好了 IdentityService 对象，我们只需要将之注入到项目中就可以使用了。

1.添加用户组接口

用户组的属性相对来说少一些，添加方式和 user 比较像，代码如下：

@Autowired
IdentityService identityService;
@Test
void test09() {
    GroupEntityImpl g = new GroupEntityImpl();
    g.setName("组长");
    g.setId("leader");
    g.setRevision(0);
    identityService.saveGroup(g);
}

添加之后，组的信息保存在 ACT_ID_GROUP 表中，如下图：
在这里插入图片描述
用户组创建好之后，接下来还要给用户组添加用户，添加方式如下：

identityService.createMembership("zhangsan", "leader");
identityService.createMembership("lisi", "leader");

这就是设置 zhangsan 和 lisi 是组长（注意用户和组的关联关系表中有外键，所以需要确保两个参数都是真实存在的）。
添加了关联关系之后，我们再去查看 ACT_ID_MEMBERSHIP 表，如下：
在这里插入图片描述
调用如下方法可以删除关联关系：

identityService.deleteMembership("zhangsan","leader");

2.修改用户组接口

将 id 为 leader 的组名更新为主管，代码如下：

Group g = identityService.createGroupQuery().groupId("leader").singleResult();
g.setName("主管");
identityService.saveGroup(g);

3.删除用户组接口

代码如下：

identityService.deleteGroup("leader");

删除组的同时，也会删除掉组和用户之间的关联关系，不过不用担心用户被删除。

4.查询用户组接口

可以根据 id 或者 name 或者组员信息等去查询用户组，代码如下：

//根据 id 查询组信息
Group g1 = identityService.createGroupQuery().groupId("leader").singleResult();
System.out.println("g1.getName() = " + g1.getName());
//根据 name 查询组信息
Group g2 = identityService.createGroupQuery().groupName("组长").singleResult();
System.out.println("g2.getId() = " + g2.getId());
//根据用户查询组信息（组里包含该用户）
List<Group> list = identityService.createGroupQuery().groupMember("zhangsan").list();
for (Group group : list) {
    System.out.println("group.getName() = " + group.getName());
}

5.查看表详情

如果需要查看表详情，可通过如下代码查看：

@Test
void test15() {
    //获取系统信息，实际上是读取 ACT_ID_PROPERTY 表的信息
    Map<String, String> properties = idmManagementService.getProperties();
    System.out.println("properties = " + properties);
    //获取表的详细信息
    TableMetaData tableMetaData = idmManagementService.getTableMetaData(idmManagementService.getTableName(User.class));
    //获取表名
    System.out.println("tableMetaData.getTableName() = " + tableMetaData.getTableName());
    //获取列名
    System.out.println("tableMetaData.getColumnNames() = " + tableMetaData.getColumnNames());
    //获取列的类型
    System.out.println("tableMetaData.getColumnTypes() = " + tableMetaData.getColumnTypes());
}