一.简介
对于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.添加用户接口
代码如下：
@Autowired
IdentityService identityService;
@Test
void contextLoads() {
UserEntityImpl user = new UserEntityImpl();
user.setId("javaboy");
user.setDisplayName("江南一点雨");
user.setPassword("123");
user.setFirstName("java");
user.setLastName("boy");
user.setEmail("javaboy@qq.com");
user.setRevision(0);
identityService.saveUser(user);
}
需要注意的是 revision 的值为 0 表示这是一个新添加的用户。
添加之后，我们在数据库的 ACT_ID_USER 表中，就可以看到刚刚加入的数据了：
2.修改用户接口
如果是修改用户密码，可以调用如下方法：
@Test
void test02() {
UserEntityImpl user = new UserEntityImpl();
user.setId("javaboy");
user.setPassword("666");
user.setRevision(1);
identityService.updateUserPassword(user);
}
虽然这个方法名是 updateUserPassword，但是实际上这个也能修改其他属性。
这里有一个点要注意，就是用户用到了乐观锁，所以修改的时候，要自己把 revision 写对了，否则修改会失败，然而我们往往并不记得 revision 是多少，所以最好是先查询，后修改，如下：
@Test
void test03() {
User u = identityService.createUserQuery().userId("javaboy").singleResult();
u.setDisplayName("itboy");
identityService.updateUserPassword(u);
}
如果是强行给一个不匹配的 revision，执行的时候会报如下错误：
当然，修改用户的时候也可以调用 saveUser 方法，这个方法会根据用户 id 查询用户，如果用户已经存在，则直接修改（修改 password 之外的其他属性），否则就添加。
3.删除用户接口
根据用户 id 删除一个用户，代码如下：
@Test
void test05() {
identityService.deleteUser("javaboy");
}
4.查询用户
查询方式比较丰富，通过用户的各个属性都可以查询，例如可以查询所有姓黄的用户，代码如下：
@Test
void test06() {
List<User> list = identityService.createUserQuery().userDisplayNameLike("黄%").orderByUserId().asc().list();
for (User user : list) {
System.out.println("user.getDisplayName() = " + user.getDisplayName());
}
}
查询所有的用户，代码如下：
@Test
void test07() {
List<User> list = identityService.createUserQuery().list();
for (User user : list) {
System.out.println("user.getId() = " + user.getId());
}
}
当然还有其他方法，包括排序、分页等。
如果觉得这些方法调用起来费事，那么也可以直接上 SQL，这个底层数据库操作用的 MyBatisPlus，所以这个 SQL 中参数的写法就按照 MyBatisPlus 里边的来即可，代码如下：
@Test
void test08() {
List<User> list = identityService.createNativeUserQuery().sql("select * from ACT_ID_USER where DISPLAY_NAME_ like #{name}").parameter("name", "李%").list();
for (User user : list) {
System.out.println("user.getId() = " + user.getId());
}
}
有的时候，如果不记得表名，也可以按照如下方式现场根据类名查询该类对应的表名，如下：
@Test
void test08() {
List<User> list = identityService.createNativeUserQuery().sql("select * from "+idmManagementService.getTableName(User.class)+" where DISPLAY_NAME_ like #{name}").parameter("name", "李%").list();
for (User user : list) {
System.out.println("user.getId() = " + user.getId());
}
}
下一篇，继续学习springboot +flowable，处理 flowable 的用户和用户组（二）
