升级到BladeX4

TIP

新项目请直接使用私服项目blade-workflow或blade-workflow-boot中的bladex4分支

工作流插件升级到BladeX4主要有5点。

升级flowable7.x
修改User、Dept系统等包名
修改BeanUtil.copy
修改swagger注解

DANGER

全局替换均指的是在plugin/workflow(Boot)目录下或在blade-plugin/blade-workflow(Cloud)项目下全局替换
替换时请勾选替换选项框的Match case和Words选项。中文状态下为区分大小写和单词选项。
复制请直接指向需要复制的内容，点击右侧复制按钮(Copy Code)进行复制。自己拖动选择容易误复制空格回车等选项。

升级flowable7.x

1、修改pom.xml中flowable的版本（截止到2024-04-01，flowable最新发布版为7.0.1）

xml

<dependency>
    <groupId>org.flowable</groupId>
    <artifactId>flowable-spring-boot-starter</artifactId>
    <version>7.0.1</version>
</dependency>

2、确保application.yaml中的flowable.database-schema-update为true

TIP

启动项目后flowable会自动执行升级sql。
若不执行请参考flowable升级sql，或自行百度解决。

修改User、Dept等包名

Cloud

在blade-plugin/blade-workflow项目下全局替换

BladeX3BladeX4

java

import org.springblade.system.entity.User;

java

import org.springblade.system.pojo.entity.User;

BladeX3BladeX4

java

import org.springblade.system.entity.Dept;

java

import org.springblade.system.pojo.entity.Dept;

Boot

在plugin/workflow目录下全局替换

BladeX-Boot3BladeX-Boot4

java

import org.springblade.modules.system.entity.User;

java

import org.springblade.modules.system.pojo.entity.User;

BladeX-Boot3BladeX-Boot4

java

import org.springblade.modules.system.entity.Dept;

java

import org.springblade.modules.system.pojo.entity.Dept;

修改BeanUtil.copy为BeanUtil.copyProperties

在plugin/workflow(Boot)目录下或在blade-plugin/blade-workflow(Cloud)项目下全局替换

java

BeanUtil.copy

替换为

java

BeanUtil.copyProperties

修改swagger注解

swagger2升级swagger3注解类基本上全部需要修改，以下需要在plugin/workflow(Boot)目录下或在blade-plugin/blade-workflow(Cloud)项目下全局替换29次。

TIP

若觉得太繁琐或者看的眼花，可自己参考以下表格替换。

swagger2	swagger3	注解位置
@Api	@Tag(name = “接口类描述”)	Controller 类
@ApiOperation	@Operation(summary =“接口方法描述”)	Controller 方法
@ApiImplicitParams	@Parameters	Controller 方法
@ApiImplicitParam	@Parameter(description=“参数描述”)	Controller 方法的 @Parameters 里
@ApiParam	@Parameter(description=“参数描述”)	Controller 方法的参数上
@ApiIgnore	@Parameter(hidden = true)	-
@ApiModel	@Schema	DTO类上
@ApiModelProperty	@Schema	DTO属性上

1、

swagger2swagger3

java

import io.swagger.annotations.Api;

java

import io.swagger.v3.oas.annotations.tags.Tag;

2、

swagger2swagger3

java

import io.swagger.annotations.*;

java

import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;

3、

swagger2swagger3

java

@Api(value =

java

@Tag(name =

4、

swagger2swagger3

java

@Api(tags =

java

@Tag(name =

5、

swagger2swagger3

java

@Api("

java

@Tag(name = "

6、

swagger2swagger3

java

tags =

java

description =

7、

swagger2swagger3

java

import io.swagger.annotations.ApiOperation;

java

import io.swagger.v3.oas.annotations.Operation;

8、

swagger2swagger3

java

@ApiOperation

java

@Operation

9、

swagger2swagger3

java

@Operation("

java

@Operation(summary = "

10、

swagger2swagger3

java

@Operation(value =

java

@Operation(summary =

11、

swagger2swagger3

java

, notes =

java

, description =

12、

swagger2swagger3

java

import io.swagger.annotations.ApiImplicitParams;

java

import io.swagger.v3.oas.annotations.Parameters;

13、

swagger2swagger3

java

@ApiImplicitParams

java

@Parameters

14、

swagger2swagger3

java

import io.swagger.annotations.ApiImplicitParam;

java

import io.swagger.v3.oas.annotations.Parameter;

15、

swagger2swagger3

java

import io.swagger.annotations.ApiParam;

java

import io.swagger.v3.oas.annotations.Parameter;

16、

swagger2swagger3

java

@ApiImplicitParam

java

@Parameter

17、

swagger2swagger3

java

@ApiParam(value =

java

@Parameter(name =

18、

swagger2swagger3

java

, value =

java

, description =

19、

swagger2swagger3

java


import springfox.documentation.annotations.ApiIgnore;

java

TIP

空行也需要原样复制，空表示替换删除

20、

swagger2swagger3

java

@ApiIgnore

java

@Parameter(hidden = true)

21、

swagger2swagger3

java

import io.swagger.annotations.ApiModel;

java

import io.swagger.v3.oas.annotations.media.Schema;

22、

swagger2swagger3

java

import io.swagger.annotations.ApiModelProperty;

java

import io.swagger.v3.oas.annotations.media.Schema;

23、

swagger2swagger3

java

@ApiModel

java

@Schema

24、

swagger2swagger3

java

@ApiModelProperty(value =

java

@Schema(description =

25、

swagger2swagger3

java

@ApiModelProperty("

java

@Schema(description = "

26、

swagger2swagger3

java

@Schema(value =

java

@Schema(name =

27、

swagger2swagger3

java


import javax.validation.Valid;

java

TIP

空行也需要原样复制，空表示替换删除

28、

swagger2swagger3

java



import javax.validation.Valid;

java

TIP

空行也需要原样复制，空表示替换删除

29、

swagger2swagger3

java

@Valid

java

TIP

空行也需要原样复制，空表示替换删除

升级到BladeX4 ​

升级flowable7.x ​

修改User、Dept等包名 ​

Cloud ​

Boot ​

修改BeanUtil.copy为BeanUtil.copyProperties ​

修改swagger注解 ​

1、 ​

2、 ​

3、 ​

4、 ​

5、 ​

6、 ​

7、 ​

8、 ​

9、 ​

10、 ​

11、 ​

12、 ​

13、 ​

14、 ​

15、 ​

16、 ​

17、 ​

18、 ​

19、 ​

20、 ​

21、 ​

22、 ​

23、 ​

24、 ​

25、 ​

26、 ​

27、 ​

28、 ​

29、 ​

升级到BladeX4

升级flowable7.x

修改User、Dept等包名

Cloud

Boot

修改BeanUtil.copy为BeanUtil.copyProperties

修改swagger注解

1、

2、

3、

4、

5、

6、

7、

8、

9、

10、

11、

12、

13、

14、

15、

16、

17、

18、

19、

20、

21、

22、

23、

24、

25、

26、

27、

28、

29、