commit：更新样例数据

orange-demo-activiti/orange-demo-activiti-service/.gitignore

@@ -1,4 +1,4 @@
-/target/
+target/
 !.mvn/wrapper/maven-wrapper.jar
 /.mvn/*
 

orange-demo-activiti/orange-demo-activiti-service/README.md

@@ -1,5 +1,7 @@
 ### 服务接口文档
 ---
+- Knife4j
+  - 服务启动后，Knife4j的文档入口地址 [http://localhost:8082/doc.html#/plus](http://localhost:8082/doc.html#/plus)
 - Postman
   - 无需启动服务，即可将当前工程的接口导出成Postman格式。在工程的common/common-tools/模块下，找到ExportApiApp文件，并执行main函数。
 

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/pom.xml

@@ -45,6 +45,11 @@
             <artifactId>common-datafilter</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orangeforms</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
 	</dependencies>
 
 	<build>

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/app/controller/AreaCodeController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.webadmin.app.controller;
 
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.orangeforms.webadmin.app.model.AreaCode;
 import com.orangeforms.webadmin.app.service.AreaCodeService;
@@ -21,6 +22,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "行政区划数据访问接口")
 @RestController
 @RequestMapping("/admin/app/areaCode")
 public class AreaCodeController {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/app/vo/AreaCodeVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,26 +10,31 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("行政区划实体对象")
 @Data
 public class AreaCodeVo {
 
     /**
      * 行政区划主键Id
      */
+    @ApiModelProperty(value = "行政区划主键Id", required = true)
     private Long areaId;
 
     /**
      * 行政区划名称
      */
+    @ApiModelProperty(value = "行政区划名称")
     private String areaName;
 
     /**
      * 行政区划级别 (1: 省级别 2: 市级别 3: 区级别)
      */
+    @ApiModelProperty(value = "行政区划级别")
     private Integer areaLevel;
 
     /**
      * 父级行政区划Id
      */
+    @ApiModelProperty(value = "父级行政区划Id")
     private Long parentId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/LoginController.java

@@ -3,6 +3,10 @@ package com.orangeforms.webadmin.upms.controller;
 import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONObject;
 import com.alibaba.fastjson.serializer.SerializerFeature;
+import com.github.xiaoymin.knife4j.annotations.ApiSupport;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.config.ApplicationConfig;
 import com.orangeforms.webadmin.upms.service.*;
@@ -42,6 +46,8 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiSupport(order = 1)
+@Api(tags = "用户登录接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/login")
@@ -81,6 +87,12 @@ public class LoginController {
      * @param password  密码。
      * @return 应答结果对象，其中包括JWT的Token数据，以及菜单列表。
      */
+    @ApiImplicitParams({
+            // 这里包含密码密文，仅用于方便开发期间的接口测试，集成测试和发布阶段，需要将当前注解去掉。
+            // 如果您重新生成了公钥和私钥，请替换password的缺省值。
+            @ApiImplicitParam(name = "loginName", defaultValue = "admin"),
+            @ApiImplicitParam(name = "password", defaultValue = "IP3ccke3GhH45iGHB5qP9p7iZw6xUyj28Ju10rnBiPKOI35sc%2BjI7%2FdsjOkHWMfUwGYGfz8ik31HC2Ruk%2Fhkd9f6RPULTHj7VpFdNdde2P9M4mQQnFBAiPM7VT9iW3RyCtPlJexQ3nAiA09OqG%2F0sIf1kcyveSrulxembARDbDo%3D")
+    })
     @NoAuthInterface
     @PostMapping("/doLogin")
     public ResponseResult<JSONObject> doLogin(

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/LoginUserController.java

@@ -6,6 +6,7 @@ import com.alibaba.fastjson.JSON;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.RedisKeyUtil;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.redisson.api.RBucket;
 import org.redisson.api.RedissonClient;
@@ -22,6 +23,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线用户接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/loginUser")

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysDataPermController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
@@ -30,6 +32,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据权限管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysDataPerm")
@@ -47,6 +50,11 @@ public class SysDataPermController {
      * @param deptIdListString 数据权限关联的部门Id列表，多个之间逗号分隔。
      * @return 应答结果对象。包含新增数据权限对象的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysDataPermDto.dataPermId",
+            "sysDataPermDto.createTimeStart",
+            "sysDataPermDto.createTimeEnd",
+            "sysDataPermDto.searchString"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysDataPermDto sysDataPermDto, @MyRequestBody String deptIdListString) {
@@ -74,6 +82,10 @@ public class SysDataPermController {
      * @param deptIdListString 数据权限关联的部门Id列表，多个之间逗号分隔。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysDataPermDto.createTimeStart",
+            "sysDataPermDto.createTimeEnd",
+            "sysDataPermDto.searchString"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysDataPermDto sysDataPermDto, @MyRequestBody String deptIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysDeptController.java

@@ -10,6 +10,8 @@ import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.*;
 import com.orangeforms.common.core.constant.*;
 import com.orangeforms.common.core.annotation.MyRequestBody;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.lang3.ObjectUtils;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -24,6 +26,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "部门管理管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysDept")
@@ -40,6 +43,7 @@ public class SysDeptController {
      * @param sysDeptDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysDeptDto.deptId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysDeptDto sysDeptDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysDeptDto, false);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysMenuController.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.controller;
 
 import cn.hutool.core.util.ObjectUtil;
 import com.alibaba.fastjson.TypeReference;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysMenuDto;
 import com.orangeforms.webadmin.upms.vo.SysMenuVo;
@@ -25,6 +27,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "菜单管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysMenu")
@@ -40,6 +43,7 @@ public class SysMenuController {
      * @param permCodeIdListString 与当前菜单Id绑定的权限Id列表，多个权限之间逗号分隔。
      * @return 应答结果对象，包含新增菜单的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysMenuDto.menuId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysMenuDto sysMenuDto, @MyRequestBody String permCodeIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermCodeController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysPermCodeDto;
@@ -24,6 +26,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限字管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPermCode")
@@ -39,6 +42,7 @@ public class SysPermCodeController {
      * @param permIdListString 与当前权限Id绑定的权限资源Id列表，多个权限资源之间逗号分隔。
      * @return 应答结果对象，包含新增权限字的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermCodeDto.permCodeId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysPermCodeDto sysPermCodeDto, @MyRequestBody String permIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
 import lombok.extern.slf4j.Slf4j;
@@ -25,6 +27,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限资源管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPerm")
@@ -39,6 +42,7 @@ public class SysPermController {
      * @param sysPermDto 新增权限资源对象。
      * @return 应答结果对象，包含新增权限资源的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermDto.permId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPermDto sysPermDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPermDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermModuleController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysPermModuleDto;
 import com.orangeforms.webadmin.upms.vo.SysPermModuleVo;
@@ -27,6 +29,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限资源模块管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPermModule")
@@ -41,6 +44,7 @@ public class SysPermModuleController {
      * @param sysPermModuleDto 新增权限资源模块对象。
      * @return 应答结果对象，包含新增权限资源模块的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermModuleDto.moduleId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPermModuleDto sysPermModuleDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPermModuleDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPostController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.github.pagehelper.page.PageMethod;
 import com.orangeforms.common.core.object.*;
@@ -24,6 +26,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "岗位管理操作管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPost")
@@ -38,6 +41,7 @@ public class SysPostController {
      * @param sysPostDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPostDto.postId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPostDto sysPostDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPostDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysRoleController.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.controller;
 
 import cn.jimmyshi.beanquery.BeanQuery;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
@@ -32,6 +34,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "角色管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysRole")
@@ -49,6 +52,7 @@ public class SysRoleController {
      * @param menuIdListString 与当前角色Id绑定的menuId列表，多个menuId之间逗号分隔。
      * @return 应答结果对象，包含新增角色的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysRoleDto.roleId", "sysRoleDto.createTimeStart", "sysRoleDto.createTimeEnd"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysRoleDto sysRoleDto, @MyRequestBody String menuIdListString) {
@@ -76,6 +80,7 @@ public class SysRoleController {
      * @param menuIdListString 与当前角色Id绑定的menuId列表，多个menuId之间逗号分隔。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysRoleDto.createTimeStart", "sysRoleDto.createTimeEnd"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysRoleDto sysRoleDto, @MyRequestBody String menuIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysUserController.java

@@ -11,6 +11,8 @@ import com.orangeforms.common.core.util.*;
 import com.orangeforms.common.core.constant.*;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.webadmin.config.ApplicationConfig;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -24,6 +26,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "用户管理管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysUser")
@@ -45,6 +48,10 @@ public class SysUserController {
      * @param roleIdListString     逗号分隔的角色Id列表。
      * @return 应答结果对象，包含新增用户的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUserDto.userId",
+            "sysUserDto.createTimeStart",
+            "sysUserDto.createTimeEnd"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysUserDto sysUserDto,
@@ -77,6 +84,9 @@ public class SysUserController {
      * @param roleIdListString     逗号分隔的角色Id列表。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUserDto.createTimeStart",
+            "sysUserDto.createTimeEnd"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysUserDto sysUserDto,

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDataPermDeptDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限与部门关联Dto")
 @Data
 public class SysDataPermDeptDto {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id", required = true)
     private Long dataPermId;
 
     /**
      * 关联部门Id。
      */
+    @ApiModelProperty(value = "关联部门Id", required = true)
     private Long deptId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDataPermDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.datafilter.constant.DataPermRuleType;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -14,24 +16,28 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限Dto")
 @Data
 public class SysDataPermDto {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id", required = true)
     @NotNull(message = "数据权限Id不能为空！", groups = {UpdateGroup.class})
     private Long dataPermId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称", required = true)
     @NotBlank(message = "数据权限名称不能为空！")
     private String dataPermName;
 
     /**
      * 数据权限规则类型(0: 全部可见 1: 只看自己 2: 只看本部门 3: 本部门及子部门 4: 多部门及子部门 5: 自定义部门列表)。
      */
+    @ApiModelProperty(value = "数据权限规则类型", required = true)
     @NotNull(message = "数据权限规则类型不能为空！")
     @ConstDictRef(constDictClass = DataPermRuleType.class)
     private Integer ruleType;
@@ -39,10 +45,12 @@ public class SysDataPermDto {
     /**
      * 部门Id列表(逗号分隔)。
      */
+    @ApiModelProperty(hidden = true)
     private String deptIdListString;
 
     /**
      * 搜索字符串。
      */
+    @ApiModelProperty(value = "LIKE 模糊搜索字符串")
     private String searchString;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDeptDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -14,49 +16,58 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysDeptDto对象")
 @Data
 public class SysDeptDto {
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id", required = true)
     @NotNull(message = "数据验证失败，部门Id不能为空！", groups = {UpdateGroup.class})
     private Long deptId;
 
     /**
      * 部门名称。
      */
+    @ApiModelProperty(value = "部门名称", required = true)
     @NotBlank(message = "数据验证失败，部门名称不能为空！")
     private String deptName;
 
     /**
      * 显示顺序。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "数据验证失败，显示顺序不能为空！")
     private Integer showOrder;
 
     /**
      * 父部门Id。
      */
+    @ApiModelProperty(value = "父部门Id")
     private Long parentId;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDeptPostDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -12,30 +14,35 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("部门岗位Dto")
 @Data
 public class SysDeptPostDto {
 
     /**
      * 部门岗位Id。
      */
+    @ApiModelProperty(value = "部门岗位Id", required = true)
     @NotNull(message = "数据验证失败，部门岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long deptPostId;
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id", required = true)
     @NotNull(message = "数据验证失败，部门Id不能为空！", groups = {UpdateGroup.class})
     private Long deptId;
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id", required = true)
     @NotNull(message = "数据验证失败，岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long postId;
 
     /**
      * 部门岗位显示名称。
      */
+    @ApiModelProperty(value = "部门岗位显示名称", required = true)
     @NotBlank(message = "数据验证失败，部门岗位显示名称不能为空！")
     private String postShowName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysMenuDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysMenuType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("菜单Dto")
 @Data
 public class SysMenuDto {
 
     /**
      * 菜单Id。
      */
+    @ApiModelProperty(value = "菜单Id", required = true)
     @NotNull(message = "菜单Id不能为空！", groups = {UpdateGroup.class})
     private Long menuId;
 
     /**
      * 父菜单Id，目录菜单的父菜单为null
      */
+    @ApiModelProperty(value = "父菜单Id")
     private Long parentId;
 
     /**
      * 菜单显示名称。
      */
+    @ApiModelProperty(value = "菜单显示名称", required = true)
     @NotBlank(message = "菜单显示名称不能为空！")
     private String menuName;
 
     /**
      * 菜单类型 (0: 目录 1: 菜单 2: 按钮 3: UI片段)。
      */
+    @ApiModelProperty(value = "菜单类型", required = true)
     @NotNull(message = "菜单类型不能为空！")
     @ConstDictRef(constDictClass = SysMenuType.class, message = "数据验证失败，菜单类型为无效值！")
     private Integer menuType;
@@ -44,26 +51,31 @@ public class SysMenuDto {
     /**
      * 前端表单路由名称，仅用于menu_type为1的菜单类型。
      */
+    @ApiModelProperty(value = "前端表单路由名称")
     private String formRouterName;
 
     /**
      * 在线表单主键Id，仅用于在线表单绑定的菜单。
      */
+    @ApiModelProperty(value = "在线表单主键Id")
     private Long onlineFormId;
 
     /**
      * 仅用于在线表单的流程Id。
      */
+    @ApiModelProperty(value = "仅用于在线表单的流程Id")
     private Long onlineFlowEntryId;
 
     /**
      * 菜单显示顺序 (值越小，排序越靠前)。
      */
+    @ApiModelProperty(value = "菜单显示顺序", required = true)
     @NotNull(message = "菜单显示顺序不能为空！")
     private Integer showOrder;
 
     /**
      * 菜单图标。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private String icon;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermCodeDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysPermCodeType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限字Dto")
 @Data
 public class SysPermCodeDto {
 
     /**
      * 权限字Id。
      */
+    @ApiModelProperty(value = "权限字Id", required = true)
     @NotNull(message = "权限字Id不能为空！", groups = {UpdateGroup.class})
     private Long permCodeId;
 
     /**
      * 权限字标识(一般为有含义的英文字符串)。
      */
+    @ApiModelProperty(value = "权限字标识", required = true)
     @NotBlank(message = "权限字编码不能为空！")
     private String permCode;
 
     /**
      * 上级权限字Id。
      */
+    @ApiModelProperty(value = "上级权限字Id")
     private Long parentId;
 
     /**
      * 权限字类型(0: 表单 1: UI片段 2: 操作)。
      */
+    @ApiModelProperty(value = "权限字类型", required = true)
     @NotNull(message = "权限字类型不能为空！")
     @ConstDictRef(constDictClass = SysPermCodeType.class, message = "数据验证失败，权限类型为无效值！")
     private Integer permCodeType;
@@ -44,12 +51,14 @@ public class SysPermCodeDto {
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称", required = true)
     @NotBlank(message = "权限字显示名称不能为空！")
     private String showName;
 
     /**
      * 显示顺序(数值越小，越靠前)。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限字显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -12,41 +14,48 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源Dto")
 @Data
 public class SysPermDto {
 
     /**
      * 权限资源Id。
      */
+    @ApiModelProperty(value = "权限资源Id", required = true)
     @NotNull(message = "权限Id不能为空！", groups = {UpdateGroup.class})
     private Long permId;
 
     /**
      * 权限资源名称。
      */
+    @ApiModelProperty(value = "权限资源名称", required = true)
     @NotBlank(message = "权限资源名称不能为空！")
     private String permName;
 
     /**
      * shiro格式的权限字，如(upms:sysUser:add)。
      */
+    @ApiModelProperty(value = "权限字")
     private String permCode;
 
     /**
      * 权限所在的权限模块Id。
      */
+    @ApiModelProperty(value = "权限所在的权限模块Id")
     @NotNull(message = "权限模块Id不能为空！")
     private Long moduleId;
 
     /**
      * 关联的URL。
      */
+    @ApiModelProperty(value = "关联的URL", required = true)
     @NotBlank(message = "权限关联的url不能为空！")
     private String url;
 
     /**
      * 权限在当前模块下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermModuleDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysPermModuleType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源模块Dto")
 @Data
 public class SysPermModuleDto {
 
     /**
      * 权限模块Id。
      */
+    @ApiModelProperty(value = "权限模块Id", required = true)
     @NotNull(message = "权限模块Id不能为空！", groups = {UpdateGroup.class})
     private Long moduleId;
 
     /**
      * 权限模块名称。
      */
+    @ApiModelProperty(value = "权限模块名称", required = true)
     @NotBlank(message = "权限模块名称不能为空！")
     private String moduleName;
 
     /**
      * 上级权限模块Id。
      */
+    @ApiModelProperty(value = "上级权限模块Id")
     private Long parentId;
 
     /**
      * 权限模块类型(0: 普通模块 1: Controller模块)。
      */
+    @ApiModelProperty(value = "权限模块类型", required = true)
     @NotNull(message = "模块类型不能为空！")
     @ConstDictRef(constDictClass = SysPermModuleType.class, message = "数据验证失败，权限模块类型为无效值！")
     private Integer moduleType;
@@ -44,6 +51,7 @@ public class SysPermModuleDto {
     /**
      * 权限模块在当前层级下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限模块显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPostDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -12,30 +14,35 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("岗位Dto")
 @Data
 public class SysPostDto {
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id", required = true)
     @NotNull(message = "数据验证失败，岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long postId;
 
     /**
      * 岗位名称。
      */
+    @ApiModelProperty(value = "岗位名称", required = true)
     @NotBlank(message = "数据验证失败，岗位名称不能为空！")
     private String postName;
 
     /**
      * 岗位层级，数值越小级别越高。
      */
+    @ApiModelProperty(value = "岗位层级", required = true)
     @NotNull(message = "数据验证失败，岗位层级不能为空！")
     private Integer level;
 
     /**
      * 是否领导岗位。
      */
+    @ApiModelProperty(value = "是否领导岗位", required = true)
     @NotNull(message = "数据验证失败，领导岗位不能为空！", groups = {UpdateGroup.class})
     private Boolean leaderPost;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysRoleDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -11,18 +13,21 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("角色Dto")
 @Data
 public class SysRoleDto {
 
     /**
      * 角色Id。
      */
+    @ApiModelProperty(value = "角色Id", required = true)
     @NotNull(message = "角色Id不能为空！", groups = {UpdateGroup.class})
     private Long roleId;
 
     /**
      * 角色名称。
      */
+    @ApiModelProperty(value = "角色名称", required = true)
     @NotBlank(message = "角色名称不能为空！")
     private String roleName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysUserDto.java

@@ -6,6 +6,8 @@ import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.webadmin.upms.model.constant.SysUserType;
 import com.orangeforms.webadmin.upms.model.constant.SysUserStatus;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -18,42 +20,49 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysUserDto对象")
 @Data
 public class SysUserDto {
 
     /**
      * 用户Id。
      */
+    @ApiModelProperty(value = "用户Id", required = true)
     @NotNull(message = "数据验证失败，用户Id不能为空！", groups = {UpdateGroup.class})
     private Long userId;
 
     /**
      * 登录用户名。
      */
+    @ApiModelProperty(value = "登录用户名", required = true)
     @NotBlank(message = "数据验证失败，登录用户名不能为空！")
     private String loginName;
 
     /**
      * 用户密码。
      */
+    @ApiModelProperty(value = "用户密码", required = true)
     @NotBlank(message = "数据验证失败，用户密码不能为空！", groups = {AddGroup.class})
     private String password;
 
     /**
      * 用户显示名称。
      */
+    @ApiModelProperty(value = "用户显示名称", required = true)
     @NotBlank(message = "数据验证失败，用户显示名称不能为空！")
     private String showName;
 
     /**
      * 用户部门Id。
      */
+    @ApiModelProperty(value = "用户部门Id", required = true)
     @NotNull(message = "数据验证失败，用户部门Id不能为空！")
     private Long deptId;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)", required = true)
     @NotNull(message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)不能为空！")
     @ConstDictRef(constDictClass = SysUserType.class, message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)为无效值！")
     private Integer userType;
@@ -61,11 +70,13 @@ public class SysUserDto {
     /**
      * 用户头像的Url。
      */
+    @ApiModelProperty(value = "用户头像的Url")
     private String headImageUrl;
 
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)", required = true)
     @NotNull(message = "数据验证失败，用户状态(0: 正常 1: 锁定)不能为空！")
     @ConstDictRef(constDictClass = SysUserStatus.class, message = "数据验证失败，用户状态(0: 正常 1: 锁定)为无效值！")
     private Integer userStatus;
@@ -73,30 +84,36 @@ public class SysUserDto {
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * createTime 范围过滤起始值(>=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤起始值(>=)")
     private String createTimeStart;
 
     /**
      * createTime 范围过滤结束值(<=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤结束值(<=)")
     private String createTimeEnd;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDataPermDeptVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限与部门关联VO")
 @Data
 public class SysDataPermDeptVo {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id")
     private Long dataPermId;
 
     /**
      * 关联部门Id。
      */
+    @ApiModelProperty(value = "关联部门Id")
     private Long deptId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDataPermVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,51 +12,61 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限VO")
 @Data
 public class SysDataPermVo {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id")
     private Long dataPermId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     private String dataPermName;
 
     /**
      * 数据权限规则类型(0: 全部可见 1: 只看自己 2: 只看本部门 3: 本部门及子部门 4: 多部门及子部门 5: 自定义部门列表)。
      */
+    @ApiModelProperty(value = "数据权限规则类型")
     private Integer ruleType;
 
     /**
      * 部门Id列表(逗号分隔)。
      */
+    @ApiModelProperty(value = "部门Id列表")
     private String deptIdListString;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 数据权限与部门关联对象列表。
      */
+    @ApiModelProperty(value = "数据权限与部门关联对象列表")
     private List<Map<String, Object>> dataPermDeptList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDeptPostVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,26 +10,31 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("部门岗位VO")
 @Data
 public class SysDeptPostVo {
 
     /**
      * 部门岗位Id。
      */
+    @ApiModelProperty(value = "部门岗位Id")
     private Long deptPostId;
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id")
     private Long deptId;
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id")
     private Long postId;
 
     /**
      * 部门岗位显示名称。
      */
+    @ApiModelProperty(value = "部门岗位显示名称")
     private String postShowName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDeptVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,46 +12,55 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysDeptVO视图对象")
 @Data
 public class SysDeptVo {
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id")
     private Long deptId;
 
     /**
      * 部门名称。
      */
+    @ApiModelProperty(value = "部门名称")
     private String deptName;
 
     /**
      * 显示顺序。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 父部门Id。
      */
+    @ApiModelProperty(value = "父部门Id")
     private Long parentId;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysMenuVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,81 +12,97 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("菜单VO")
 @Data
 public class SysMenuVo {
 
     /**
      * 菜单Id。
      */
+    @ApiModelProperty(value = "菜单Id")
     private Long menuId;
 
     /**
      * 父菜单Id，目录菜单的父菜单为null
      */
+    @ApiModelProperty(value = "父菜单Id")
     private Long parentId;
 
     /**
      * 菜单显示名称。
      */
+    @ApiModelProperty(value = "菜单显示名称")
     private String menuName;
 
     /**
      * 菜单类型 (0: 目录 1: 菜单 2: 按钮 3: UI片段)。
      */
+    @ApiModelProperty(value = "菜单类型")
     private Integer menuType;
 
     /**
      * 前端表单路由名称，仅用于menu_type为1的菜单类型。
      */
+    @ApiModelProperty(value = "前端表单路由名称")
     private String formRouterName;
 
     /**
      * 在线表单主键Id，仅用于在线表单绑定的菜单。
      */
+    @ApiModelProperty(value = "在线表单主键Id")
     private Long onlineFormId;
 
     /**
      * 在线表单菜单的权限控制类型，具体值可参考SysOnlineMenuPermType常量对象。
      */
+    @ApiModelProperty(value = "在线表单菜单的权限控制类型")
     private Integer onlineMenuPermType;
 
     /**
      * 仅用于在线表单的流程Id。
      */
+    @ApiModelProperty(value = "仅用于在线表单的流程Id")
     private Long onlineFlowEntryId;
 
     /**
      * 菜单显示顺序 (值越小，排序越靠前)。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private Integer showOrder;
 
     /**
      * 菜单图标。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private String icon;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 菜单与权限字关联对象列表。
      */
+    @ApiModelProperty(value = "菜单与权限字关联对象列表")
     private List<Map<String, Object>> sysMenuPermCodeList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermCodeVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,61 +12,73 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限字VO")
 @Data
 public class SysPermCodeVo {
 
     /**
      * 权限字Id。
      */
+    @ApiModelProperty(value = "权限字Id")
     private Long permCodeId;
 
     /**
      * 权限字标识(一般为有含义的英文字符串)。
      */
+    @ApiModelProperty(value = "权限字标识")
     private String permCode;
 
     /**
      * 上级权限字Id。
      */
+    @ApiModelProperty(value = "上级权限字Id")
     private Long parentId;
 
     /**
      * 权限字类型(0: 表单 1: UI片段 2: 操作)。
      */
+    @ApiModelProperty(value = "权限字类型")
     private Integer permCodeType;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     private String showName;
 
     /**
      * 显示顺序(数值越小，越靠前)。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 权限字与权限资源关联对象列表。
      */
+    @ApiModelProperty(value = "权限字与权限资源关联对象列表")
     private List<Map<String, Object>> sysPermCodePermList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermModuleVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,56 +12,67 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源模块VO")
 @Data
 public class SysPermModuleVo {
 
     /**
      * 权限模块Id。
      */
+    @ApiModelProperty(value = "权限模块Id")
     private Long moduleId;
 
     /**
      * 权限模块名称。
      */
+    @ApiModelProperty(value = "权限模块名称")
     private String moduleName;
 
     /**
      * 上级权限模块Id。
      */
+    @ApiModelProperty(value = "上级权限模块Id")
     private Long parentId;
 
     /**
      * 权限模块类型(0: 普通模块 1: Controller模块)。
      */
+    @ApiModelProperty(value = "权限模块类型")
     private Integer moduleType;
 
     /**
      * 权限模块在当前层级下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 权限资源对象列表。
      */
+    @ApiModelProperty(value = "权限资源对象列表")
     private List<SysPermVo> sysPermList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,61 +12,73 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源VO")
 @Data
 public class SysPermVo {
 
     /**
      * 权限资源Id。
      */
+    @ApiModelProperty(value = "权限资源Id")
     private Long permId;
 
     /**
      * 权限资源名称。
      */
+    @ApiModelProperty(value = "权限资源名称")
     private String permName;
 
     /**
      * shiro格式的权限字，如(upms:sysUser:add)。
      */
+    @ApiModelProperty(value = "权限字")
     private String permCode;
 
     /**
      * 权限所在的权限模块Id。
      */
+    @ApiModelProperty(value = "权限所在的权限模块Id")
     private Long moduleId;
 
     /**
      * 关联的URL。
      */
+    @ApiModelProperty(value = "关联的URL")
     private String url;
 
     /**
      * 权限在当前模块下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 模块Id的字典关联数据。
      */
+    @ApiModelProperty(value = "模块Id的字典关联数据")
     private Map<String, Object> moduleIdDictMap;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPostVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,51 +13,61 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("岗位VO")
 @Data
 public class SysPostVo {
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id")
     private Long postId;
 
     /**
      * 岗位名称。
      */
+    @ApiModelProperty(value = "岗位名称")
     private String postName;
 
     /**
      * 岗位层级，数值越小级别越高。
      */
+    @ApiModelProperty(value = "岗位层级，数值越小级别越高")
     private Integer level;
 
     /**
      * 是否领导岗位。
      */
+    @ApiModelProperty(value = "是否领导岗位")
     private Boolean leaderPost;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * postId 的多对多关联表数据对象，数据对应类型为SysDeptPostVo。
      */
+    @ApiModelProperty(value = "postId 的多对多关联表数据对象")
     private Map<String, Object> sysDeptPost;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysRoleVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,41 +12,49 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("角色VO")
 @Data
 public class SysRoleVo {
 
     /**
      * 角色Id。
      */
+    @ApiModelProperty(value = "角色Id")
     private Long roleId;
 
     /**
      * 角色名称。
      */
+    @ApiModelProperty(value = "角色名称")
     private String roleName;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 角色与菜单关联对象列表。
      */
+    @ApiModelProperty(value = "角色与菜单关联对象列表")
     private List<Map<String, Object>> sysRoleMenuList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysUserVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -12,91 +14,109 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysUserVO视图对象")
 @Data
 public class SysUserVo {
 
     /**
      * 用户Id。
      */
+    @ApiModelProperty(value = "用户Id")
     private Long userId;
 
     /**
      * 登录用户名。
      */
+    @ApiModelProperty(value = "登录用户名")
     private String loginName;
 
     /**
      * 用户显示名称。
      */
+    @ApiModelProperty(value = "用户显示名称")
     private String showName;
 
     /**
      * 用户部门Id。
      */
+    @ApiModelProperty(value = "用户部门Id")
     private Long deptId;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)")
     private Integer userType;
 
     /**
      * 用户头像的Url。
      */
+    @ApiModelProperty(value = "用户头像的Url")
     private String headImageUrl;
 
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)")
     private Integer userStatus;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 多对多用户岗位数据集合。
      */
+    @ApiModelProperty(value = "多对多用户岗位数据集合")
     private List<Map<String, Object>> sysUserPostList;
 
     /**
      * 多对多用户角色数据集合。
      */
+    @ApiModelProperty(value = "多对多用户角色数据集合")
     private List<Map<String, Object>> sysUserRoleList;
 
     /**
      * 多对多用户数据权限数据集合。
      */
+    @ApiModelProperty(value = "多对多用户数据权限数据集合")
     private List<Map<String, Object>> sysDataPermUserList;
 
     /**
      * deptId 字典关联数据。
      */
+    @ApiModelProperty(value = "deptId 字典关联数据")
     private Map<String, Object> deptIdDictMap;
 
     /**
      * userType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userType 常量字典关联数据")
     private Map<String, Object> userTypeDictMap;
 
     /**
      * userStatus 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userStatus 常量字典关联数据")
     private Map<String, Object> userStatusDictMap;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/resources/application.yml

@@ -127,6 +127,17 @@ common-flow:
   # 请慎重修改urlPrefix的缺省配置，注意不要以反斜杠(/)结尾。如必须修改其他路径，请同步修改数据库脚本。
   urlPrefix: /admin/flow
 
+swagger:
+  # 当enabled为false的时候，则可禁用swagger。
+  enabled: true
+  # 工程的基础包名。
+  basePackage: com.orangeforms
+  # 工程服务的基础包名。
+  serviceBasePackage: com.orangeforms.webadmin
+  title: 橙单单体服务工程
+  description: 橙单单体服务工程详情
+  version: 1.0
+
 datafilter:
   tenant:
     # 对于单体服务，该值始终为false。
@@ -167,7 +178,7 @@ spring:
     type: com.alibaba.druid.pool.DruidDataSource
     druid:
       main:
-        url: jdbc:mysql://localhost:3306/zzdemo-online-activiti?characterEncoding=utf8&useSSL=true&serverTimezone=Asia/Shanghai
+        url: jdbc:mysql://localhost:3306/zzdemo-online?characterEncoding=utf8&useSSL=true&serverTimezone=Asia/Shanghai
         username: root
         password: 123456
       driver-class-name: com.mysql.cj.jdbc.Driver

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/resources/log4j2.xml

@@ -53,6 +53,9 @@
         <root level="${OUTPUT_LOG_LEVEL}">
             <AppenderRef ref="console"/>
         </root>
+        <Logger name="springfox.documentation" additivity="false" level="error">
+            <AppenderRef ref="console"/>
+        </Logger>
         <AsyncLogger name="com.orangeforms" additivity="false" level="info">
             <AppenderRef ref="console"/>
             <AppenderRef ref="file_log"/>

orange-demo-activiti/orange-demo-activiti-service/common/common-core/src/main/java/com/orangeforms/common/core/util/MyModelUtil.java

@@ -2,12 +2,14 @@ package com.orangeforms.common.core.util;
 
 import cn.hutool.core.bean.BeanUtil;
 import cn.hutool.core.util.ReflectUtil;
+import com.alibaba.fastjson.JSON;
 import com.baomidou.mybatisplus.annotation.*;
 import com.orangeforms.common.core.exception.InvalidDataFieldException;
 import com.orangeforms.common.core.annotation.*;
 import com.orangeforms.common.core.exception.MyRuntimeException;
 import com.orangeforms.common.core.object.TokenData;
 import com.orangeforms.common.core.object.Tuple2;
+import com.orangeforms.common.core.upload.UploadResponseInfo;
 import com.orangeforms.common.core.upload.UploadStoreInfo;
 import com.google.common.base.CaseFormat;
 import lombok.extern.slf4j.Slf4j;
@@ -707,6 +709,46 @@ public class MyModelUtil {
             ReflectUtil.setFieldValue(data, fieldName, defaultValue);
         }
     }
+    
+    /**
+     * 获取当前数据对象中，所有上传文件字段的数据，并将上传后的文件名存到集合中并返回。
+     *
+     * @param data  数据对象。
+     * @param clazz 数据对象的Class类型。
+     * @param <M>   数据对象类型。
+     * @return 当前数据对象中，所有上传文件字段中，文件名属性的集合。
+     */
+    public static <M> Set<String> extractDownloadFileName(M data, Class<M> clazz) {
+        Set<String> resultSet = new HashSet<>();
+        Field[] fields = ReflectUtil.getFields(clazz);
+        for (Field field : fields) {
+            if (field.isAnnotationPresent(UploadFlagColumn.class)) {
+                String v = (String) ReflectUtil.getFieldValue(data, field);
+                List<UploadResponseInfo> fileInfoList = JSON.parseArray(v, UploadResponseInfo.class);
+                if (CollectionUtils.isNotEmpty(fileInfoList)) {
+                    fileInfoList.forEach(fileInfo -> resultSet.add(fileInfo.getFilename()));
+                }
+            }
+        }
+        return resultSet;
+    }
+
+    /**
+     * 获取当前数据对象列表中，所有上传文件字段的数据，并将上传后的文件名存到集合中并返回。
+     *
+     * @param dataList 数据对象。
+     * @param clazz    数据对象的Class类型。
+     * @param <M>      数据对象类型。
+     * @return 当前数据对象中，所有上传文件字段中，文件名属性的集合。
+     */
+    public static <M> Set<String> extractDownloadFileName(List<M> dataList, Class<M> clazz) {
+        if (CollectionUtils.isEmpty(dataList)) {
+            return null;
+        }
+        Set<String> resultSet = new HashSet<>();
+        dataList.forEach(data -> resultSet.addAll(extractDownloadFileName(data, clazz)));
+        return resultSet;
+    }
 
     /**
      * 私有构造函数，明确标识该常量类的作用。

orange-demo-activiti/orange-demo-activiti-service/common/common-datafilter/src/main/java/com/orangeforms/common/datafilter/interceptor/MybatisDataFilterInterceptor.java

@@ -276,10 +276,11 @@ public class MybatisDataFilterInterceptor implements Interceptor {
             return;
         }
         String dataPermSessionKey = RedisKeyUtil.makeSessionDataPermIdKey(tokenData.getSessionId());
-        String dataPermData = redissonClient.getBucket(dataPermSessionKey).get().toString();
-        if (StringUtils.isBlank(dataPermData)) {
+        Object cachedData = redissonClient.getBucket(dataPermSessionKey).get();
+        if (cachedData == null) {
             throw new NoDataPermException("No Related DataPerm found for SQL_ID [ " + sqlId + " ].");
         }
+        String dataPermData = cachedData.toString();
         Map<Integer, String> dataPermMap = new HashMap<>(8);
         for (Map.Entry<String, Object> entry : JSON.parseObject(dataPermData).entrySet()) {
             dataPermMap.put(Integer.valueOf(entry.getKey()), entry.getValue().toString());

orange-demo-activiti/orange-demo-activiti-service/common/common-flow-online/pom.xml

@@ -25,6 +25,11 @@
             <artifactId>common-online</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orangeforms</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
     </dependencies>
 
     <build>

orange-demo-activiti/orange-demo-activiti-service/common/common-flow-online/src/main/java/com/orangeforms/common/flow/online/controller/FlowOnlineOperationController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.flow.online.controller;
 
+import io.swagger.annotations.Api;
 import cn.hutool.core.bean.BeanUtil;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.map.MapUtil;
@@ -8,6 +9,7 @@ import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONArray;
 import com.alibaba.fastjson.JSONObject;
 import com.github.pagehelper.page.PageMethod;
+import com.orangeforms.common.core.annotation.DisableDataFilter;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
 import com.orangeforms.common.core.object.*;
@@ -53,6 +55,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线标案流程操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowOnlineOperation")
@@ -81,6 +84,7 @@ public class FlowOnlineOperationController {
 
     /**
      * 根据指定流程的主版本，发起一个流程实例，同时作为第一个任务节点的执行人，执行第一个用户任务。
+     * 该接口无需数据权限过滤，因此用DisableDataFilter注解标注。如果当前系统没有支持数据权限过滤，该注解不会有任何影响。
      *
      * @param processDefinitionKey 流程定义标识。
      * @param flowTaskCommentDto   审批意见。
@@ -89,6 +93,7 @@ public class FlowOnlineOperationController {
      * @param slaveData            流程审批相关的多个从表数据。
      * @return 应答结果对象。
      */
+    @DisableDataFilter
     @PostMapping("/startAndTakeUserTask/{processDefinitionKey}")
     public ResponseResult<Void> startAndTakeUserTask(
             @PathVariable("processDefinitionKey") String processDefinitionKey,
@@ -156,6 +161,7 @@ public class FlowOnlineOperationController {
 
     /**
      * 提交流程的用户任务。
+     * 该接口无需数据权限过滤，因此用DisableDataFilter注解标注。如果当前系统没有支持数据权限过滤，该注解不会有任何影响。
      *
      * @param processInstanceId  流程实例Id。
      * @param taskId             流程任务Id。
@@ -165,6 +171,7 @@ public class FlowOnlineOperationController {
      * @param slaveData          流程审批相关的多个从表数据。
      * @return 应答结果对象。
      */
+    @DisableDataFilter
     @PostMapping("/submitUserTask")
     public ResponseResult<Void> submitUserTask(
             @MyRequestBody(required = true) String processInstanceId,
@@ -217,11 +224,13 @@ public class FlowOnlineOperationController {
 
     /**
      * 获取当前流程实例的详情数据。包括主表数据、一对一从表数据、一对多从表数据列表等。
+     * 该接口无需数据权限过滤，因此用DisableDataFilter注解标注。如果当前系统没有支持数据权限过滤，该注解不会有任何影响。
      *
      * @param processInstanceId 当前运行时的流程实例Id。
      * @param taskId            流程任务Id。
      * @return 当前流程实例的详情数据。
      */
+    @DisableDataFilter
     @GetMapping("/viewUserTask")
     public ResponseResult<JSONObject> viewUserTask(@RequestParam String processInstanceId, @RequestParam String taskId) {
         String errorMessage;
@@ -254,11 +263,13 @@ public class FlowOnlineOperationController {
 
     /**
      * 获取已经结束的流程实例的详情数据。包括主表数据、一对一从表数据、一对多从表数据列表等。
+     * 该接口无需数据权限过滤，因此用DisableDataFilter注解标注。如果当前系统没有支持数据权限过滤，该注解不会有任何影响。
      *
      * @param processInstanceId 历史流程实例Id。
      * @param taskId            历史任务Id。如果该值为null，仅有发起人可以查看当前流程数据，否则只有任务的指派人才能查看。
      * @return 历史流程实例的详情数据。
      */
+    @DisableDataFilter
     @GetMapping("/viewHistoricProcessInstance")
     public ResponseResult<JSONObject> viewHistoricProcessInstance(
             @RequestParam String processInstanceId, @RequestParam(required = false) String taskId) {
@@ -333,6 +344,8 @@ public class FlowOnlineOperationController {
         List<FlowWorkOrder> flowWorkOrderList = flowWorkOrderService.getFlowWorkOrderList(flowWorkOrderFilter, orderBy);
         MyPageData<FlowWorkOrderVo> resultData =
                 MyPageUtil.makeResponseData(flowWorkOrderList, FlowWorkOrder.INSTANCE);
+        // 工单自身的查询中可以受到数据权限的过滤，但是工单集成业务数据时，则无需再对业务数据进行数据权限过滤了。
+        GlobalThreadLocal.setDataFilter(false);
         ResponseResult<Void> responseResult = this.makeWorkOrderTaskInfo(resultData.getDataList());
         if (!responseResult.isSuccess()) {
             return ResponseResult.errorFrom(responseResult);
@@ -382,6 +395,7 @@ public class FlowOnlineOperationController {
      * 越权访问限制说明：
      * taskId为空，当前用户必须为当前流程的发起人，否则必须为当前任务的指派人或候选人。
      * relationId为空，下载数据为主表字段，否则为关联的从表字段。
+     * 该接口无需数据权限过滤，因此用DisableDataFilter注解标注。如果当前系统没有支持数据权限过滤，该注解不会有任何影响。
      *
      * @param processDefinitionKey 流程引擎流程定义标识。
      * @param processInstanceId    流程实例Id。
@@ -393,6 +407,7 @@ public class FlowOnlineOperationController {
      * @param asImage              是否为图片文件。
      * @param response             Http 应答对象。
      */
+    @DisableDataFilter
     @GetMapping("/download")
     public void download(
             @RequestParam String processDefinitionKey,

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/pom.xml

@@ -30,6 +30,11 @@
             <artifactId>common-log</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orangeforms</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
         <dependency>
             <groupId>org.activiti</groupId>
             <artifactId>activiti-spring-boot-starter</artifactId>

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/controller/FlowCategoryController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.StrUtil;
 import cn.jimmyshi.beanquery.BeanQuery;
@@ -31,6 +33,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "工作流分类操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowCategory")
@@ -47,6 +50,7 @@ public class FlowCategoryController {
      * @param flowCategoryDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"flowCategoryDto.categoryId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody FlowCategoryDto flowCategoryDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(flowCategoryDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/controller/FlowEntryController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.map.MapUtil;
 import cn.hutool.core.util.ObjectUtil;
@@ -39,6 +41,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "工作流操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowEntry")
@@ -59,6 +62,7 @@ public class FlowEntryController {
      * @param flowEntryDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"flowEntryDto.entryId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody FlowEntryDto flowEntryDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(flowEntryDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/controller/FlowEntryVariableController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.github.pagehelper.page.PageMethod;
 import com.orangeforms.common.flow.vo.*;
 import com.orangeforms.common.flow.dto.*;
@@ -23,6 +25,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "工作流变量操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowEntryVariable")
@@ -37,6 +40,7 @@ public class FlowEntryVariableController {
      * @param flowEntryVariableDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"flowEntryVariableDto.variableId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody FlowEntryVariableDto flowEntryVariableDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(flowEntryVariableDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/controller/FlowMessageController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.flow.controller;
 
+import io.swagger.annotations.Api;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.MyPageUtil;
@@ -19,6 +20,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "工作流消息操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowMessage")

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/controller/FlowOperationController.java

@@ -1,11 +1,13 @@
 package com.orangeforms.common.flow.controller;
 
+import io.swagger.annotations.Api;
 import cn.hutool.core.bean.BeanUtil;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.ObjectUtil;
 import cn.hutool.core.util.StrUtil;
 import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONObject;
+import com.orangeforms.common.core.annotation.DisableDataFilter;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
 import com.orangeforms.common.core.object.*;
@@ -46,6 +48,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "通用流程操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-flow.urlPrefix}/flowOperation")
@@ -466,10 +469,14 @@ public class FlowOperationController {
 
     /**
      * 催办工单，只有流程发起人才可以催办工单。
+     * 催办场景必须要取消数据权限过滤，因为流程的指派很可能是跨越部门的。
+     * 既然被指派和催办了，这里就应该禁用工单表的数据权限过滤约束。
+     * 如果您的系统没有支持数据权限过滤，DisableDataFilter不会有任何影响，建议保留。
      *
      * @param workOrderId 工单Id。
      * @return 应答结果。
      */
+    @DisableDataFilter
     @PostMapping("/remindRuntimeTask")
     public ResponseResult<Void> remindRuntimeTask(@MyRequestBody(required = true) Long workOrderId) {
         FlowWorkOrder flowWorkOrder = flowWorkOrderService.getById(workOrderId);
@@ -496,6 +503,7 @@ public class FlowOperationController {
      * @param cancelReason 取消原因。
      * @return 应答结果。
      */
+    @DisableDataFilter
     @PostMapping("/cancelWorkOrder")
     public ResponseResult<Void> cancelWorkOrder(
             @MyRequestBody(required = true) Long workOrderId,
@@ -528,6 +536,7 @@ public class FlowOperationController {
      * @param stopReason        停止原因。
      * @return 执行结果应答。
      */
+    @DisableDataFilter
     @PostMapping("/stopProcessInstance")
     public ResponseResult<Void> stopProcessInstance(
             @MyRequestBody(required = true) String processInstanceId,

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dao/mapper/FlowMessageMapper.xml

@@ -3,9 +3,9 @@
 <mapper namespace="com.orangeforms.common.flow.dao.FlowMessageMapper">
     <resultMap id="BaseResultMap" type="com.orangeforms.common.flow.model.FlowMessage">
         <id column="message_id" jdbcType="BIGINT" property="messageId"/>
-        <id column="message_type" jdbcType="TINYINT" property="messageType"/>
-        <id column="message_content" jdbcType="VARCHAR" property="messageContent"/>
-        <id column="remind_count" jdbcType="INTEGER" property="remindCount"/>
+        <result column="message_type" jdbcType="TINYINT" property="messageType"/>
+        <result column="message_content" jdbcType="VARCHAR" property="messageContent"/>
+        <result column="remind_count" jdbcType="INTEGER" property="remindCount"/>
         <result column="work_order_id" jdbcType="BIGINT" property="workOrderId"/>
         <result column="process_definition_id" jdbcType="VARCHAR" property="processDefinitionId"/>
         <result column="process_definition_key" jdbcType="VARCHAR" property="processDefinitionKey"/>
@@ -18,6 +18,7 @@
         <result column="task_start_time" jdbcType="TIMESTAMP" property="taskStartTime"/>
         <result column="task_assignee" jdbcType="VARCHAR" property="taskAssignee"/>
         <result column="task_finished" jdbcType="BIT" property="taskFinished"/>
+        <result column="business_data_shot" jdbcType="LONGVARCHAR" property="businessDataShot"/>
         <result column="update_time" jdbcType="TIMESTAMP" property="updateTime"/>
         <result column="update_user_id" jdbcType="BIGINT" property="updateUserId"/>
         <result column="create_time" jdbcType="TIMESTAMP" property="createTime"/>

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowCategoryDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import lombok.Data;
 
@@ -12,30 +14,35 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程分类的Dto对象")
 @Data
 public class FlowCategoryDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long categoryId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     @NotBlank(message = "数据验证失败，显示名称不能为空！")
     private String name;
 
     /**
      * 分类编码。
      */
+    @ApiModelProperty(value = "分类编码")
     @NotBlank(message = "数据验证失败，分类编码不能为空！")
     private String code;
 
     /**
      * 实现顺序。
      */
+    @ApiModelProperty(value = "实现顺序")
     @NotNull(message = "数据验证失败，实现顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowEntryDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.flow.model.constant.FlowBindFormType;
@@ -15,47 +17,55 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程的Dto对象")
 @Data
 public class FlowEntryDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键不能为空！", groups = {UpdateGroup.class})
     private Long entryId;
 
     /**
      * 流程名称。
      */
+    @ApiModelProperty(value = "流程名称")
     @NotBlank(message = "数据验证失败，流程名称不能为空！")
     private String processDefinitionName;
 
     /**
      * 流程标识Key。
      */
+    @ApiModelProperty(value = "流程标识Key")
     @NotBlank(message = "数据验证失败，流程标识Key不能为空！")
     private String processDefinitionKey;
 
     /**
      * 流程分类。
      */
+    @ApiModelProperty(value = "流程分类")
     @NotNull(message = "数据验证失败，流程分类不能为空！")
     private Long categoryId;
 
     /**
      * 流程状态。
      */
+    @ApiModelProperty(value = "流程状态")
     @ConstDictRef(constDictClass = FlowEntryStatus.class, message = "数据验证失败，工作流状态为无效值！")
     private Integer status;
 
     /**
      * 流程定义的xml。
      */
+    @ApiModelProperty(value = "流程定义的xml")
     private String bpmnXml;
 
     /**
      * 绑定表单类型。
      */
+    @ApiModelProperty(value = "绑定表单类型")
     @ConstDictRef(constDictClass = FlowBindFormType.class, message = "数据验证失败，工作流绑定表单类型为无效值！")
     @NotNull(message = "数据验证失败，工作流绑定表单类型不能为空！")
     private Integer bindFormType;
@@ -63,15 +73,18 @@ public class FlowEntryDto {
     /**
      * 在线表单的页面Id。
      */
+    @ApiModelProperty(value = "在线表单的页面Id")
     private Long pageId;
 
     /**
      * 在线表单Id。
      */
+    @ApiModelProperty(value = "在线表单Id")
     private Long defaultFormId;
 
     /**
      * 在线表单的缺省路由名称。
      */
+    @ApiModelProperty(value = "在线表单的缺省路由名称")
     private String defaultRouterName;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowEntryVariableDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.flow.model.constant.FlowVariableType;
@@ -13,36 +15,42 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程变量Dto对象")
 @Data
 public class FlowEntryVariableDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long variableId;
 
     /**
      * 流程Id。
      */
+    @ApiModelProperty(value = "流程Id")
     @NotNull(message = "数据验证失败，流程Id不能为空！")
     private Long entryId;
 
     /**
      * 变量名。
      */
+    @ApiModelProperty(value = "变量名")
     @NotBlank(message = "数据验证失败，变量名不能为空！")
     private String variableName;
 
     /**
      * 显示名。
      */
+    @ApiModelProperty(value = "显示名")
     @NotBlank(message = "数据验证失败，显示名不能为空！")
     private String showName;
 
     /**
      * 流程变量类型。
      */
+    @ApiModelProperty(value = "流程变量类型")
     @ConstDictRef(constDictClass = FlowVariableType.class, message = "数据验证失败，流程变量类型为无效值！")
     @NotNull(message = "数据验证失败，流程变量类型不能为空！")
     private Integer variableType;
@@ -50,21 +58,25 @@ public class FlowEntryVariableDto {
     /**
      * 绑定数据源Id。
      */
+    @ApiModelProperty(value = "绑定数据源Id")
     private Long bindDatasourceId;
 
     /**
      * 绑定数据源关联Id。
      */
+    @ApiModelProperty(value = "绑定数据源关联Id")
     private Long bindRelationId;
 
     /**
      * 绑定字段Id。
      */
+    @ApiModelProperty(value = "绑定字段Id")
     private Long bindColumnId;
 
     /**
      * 是否内置。
      */
+    @ApiModelProperty(value = "是否内置")
     @NotNull(message = "数据验证失败，是否内置不能为空！")
     private Boolean builtin;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowMessageDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,36 +10,43 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("工作流通知消息Dto对象")
 @Data
 public class FlowMessageDto {
 
     /**
      * 消息类型。
      */
+    @ApiModelProperty(value = "消息类型")
     private Integer messageType;
 
     /**
      * 工单Id。
      */
+    @ApiModelProperty(value = "工单Id")
     private Long workOrderId;
 
     /**
      * 流程名称。
      */
+    @ApiModelProperty(value = "流程名称")
     private String processDefinitionName;
 
     /**
      * 流程任务名称。
      */
+    @ApiModelProperty(value = "流程任务名称")
     private String taskName;
 
     /**
      * 更新时间范围过滤起始值(>=)。
      */
+    @ApiModelProperty(value = "updateTime 范围过滤起始值")
     private String updateTimeStart;
 
     /**
      * 更新时间范围过滤结束值(<=)。
      */
+    @ApiModelProperty(value = "updateTime 范围过滤结束值")
     private String updateTimeEnd;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowTaskCommentDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -11,23 +13,27 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程任务的批注")
 @Data
 public class FlowTaskCommentDto {
 
     /**
      * 流程任务触发按钮类型，内置值可参考FlowTaskButton。
      */
+    @ApiModelProperty(value = "流程任务触发按钮类型")
     @NotNull(message = "数据验证失败，任务的审批类型不能为空！")
     private String approvalType;
 
     /**
      * 流程任务的批注内容。
      */
+    @ApiModelProperty(value = "流程任务的批注内容")
     @NotBlank(message = "数据验证失败，任务审批内容不能为空！")
     private String comment;
 
     /**
      * 委托指定人，比如加签、转办等。
      */
+    @ApiModelProperty(value = "委托指定人，比如加签、转办等")
     private String delegateAssginee;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/dto/FlowWorkOrderDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,21 +10,25 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("工作流工单Dto对象")
 @Data
 public class FlowWorkOrderDto {
 
     /**
      * 流程状态。参考FlowTaskStatus常量值对象。
      */
+    @ApiModelProperty(value = "流程状态")
     private Integer flowStatus;
 
     /**
      * createTime 范围过滤起始值(>=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤起始值")
     private String createTimeStart;
 
     /**
      * createTime 范围过滤结束值(<=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤结束值")
     private String createTimeEnd;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/model/FlowMessage.java

@@ -117,6 +117,12 @@ public class FlowMessage {
     @TableField(value = "task_finished")
     private Boolean taskFinished;
 
+    /**
+     * 业务数据快照。
+     */
+    @TableField(value = "business_data_shot")
+    private String businessDataShot;
+
     /**
      * 更新时间。
      */

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/service/impl/FlowApiServiceImpl.java

@@ -175,9 +175,9 @@ public class FlowApiServiceImpl implements FlowApiService {
             this.handleMultiInstanceApprovalType(
                     task.getExecutionId(), flowTaskComment.getApprovalType(), taskVariableData);
             taskVariableData.put(FlowConstant.OPERATION_TYPE_VAR, flowTaskComment.getApprovalType());
-            taskService.complete(task.getId(), taskVariableData, true);
             flowTaskComment.fillWith(task);
             flowTaskCommentService.saveNew(flowTaskComment);
+            taskService.complete(task.getId(), taskVariableData, true);
         } else {
             taskService.complete(task.getId(), taskVariableData, true);
         }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowCategoryVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,46 +12,55 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程分类的Vo对象")
 @Data
 public class FlowCategoryVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long categoryId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     private String name;
 
     /**
      * 分类编码。
      */
+    @ApiModelProperty(value = "分类编码")
     private String code;
 
     /**
      * 实现顺序。
      */
+    @ApiModelProperty(value = "实现顺序")
     private Integer showOrder;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowEntryPublishVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,41 +12,49 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程发布信息的Vo对象")
 @Data
 public class FlowEntryPublishVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long entryPublishId;
 
     /**
      * 发布版本。
      */
+    @ApiModelProperty(value = "发布版本")
     private Integer publishVersion;
 
     /**
      * 流程引擎中的流程定义Id。
      */
+    @ApiModelProperty(value = "流程引擎中的流程定义Id")
     private String processDefinitionId;
 
     /**
      * 激活状态。
      */
+    @ApiModelProperty(value = "激活状态")
     private Boolean activeStatus;
 
     /**
      * 是否为主版本。
      */
+    @ApiModelProperty(value = "是否为主版本")
     private Boolean mainVersion;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 发布时间。
      */
+    @ApiModelProperty(value = "发布时间")
     private Date publishTime;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowEntryVariableVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,56 +12,67 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程变量Vo对象")
 @Data
 public class FlowEntryVariableVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long variableId;
 
     /**
      * 流程Id。
      */
+    @ApiModelProperty(value = "流程Id")
     private Long entryId;
 
     /**
      * 变量名。
      */
+    @ApiModelProperty(value = "变量名")
     private String variableName;
 
     /**
      * 显示名。
      */
+    @ApiModelProperty(value = "显示名")
     private String showName;
 
     /**
      * 变量类型。
      */
+    @ApiModelProperty(value = "变量类型")
     private Integer variableType;
 
     /**
      * 绑定数据源Id。
      */
+    @ApiModelProperty(value = "绑定数据源Id")
     private Long bindDatasourceId;
 
     /**
      * 绑定数据源关联Id。
      */
+    @ApiModelProperty(value = "绑定数据源关联Id")
     private Long bindRelationId;
 
     /**
      * 绑定字段Id。
      */
+    @ApiModelProperty(value = "绑定字段Id")
     private Long bindColumnId;
 
     /**
      * 是否内置。
      */
+    @ApiModelProperty(value = "是否内置")
     private Boolean builtin;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowEntryVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -12,101 +14,121 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程的Vo对象")
 @Data
 public class FlowEntryVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long entryId;
 
     /**
      * 流程名称。
      */
+    @ApiModelProperty(value = "流程名称")
     private String processDefinitionName;
 
     /**
      * 流程标识Key。
      */
+    @ApiModelProperty(value = "流程标识Key")
     private String processDefinitionKey;
 
     /**
      * 流程分类。
      */
+    @ApiModelProperty(value = "流程分类")
     private Long categoryId;
 
     /**
      * 工作流部署的发布主版本Id。
      */
+    @ApiModelProperty(value = "工作流部署的发布主版本Id")
     private Long mainEntryPublishId;
 
     /**
      * 最新发布时间。
      */
+    @ApiModelProperty(value = "最新发布时间")
     private Date lastestPublishTime;
 
     /**
      * 流程状态。
      */
+    @ApiModelProperty(value = "流程状态")
     private Integer status;
 
     /**
      * 流程定义的xml。
      */
+    @ApiModelProperty(value = "流程定义的xml")
     private String bpmnXml;
 
     /**
      * 绑定表单类型。
      */
+    @ApiModelProperty(value = "绑定表单类型")
     private Integer bindFormType;
 
     /**
      * 在线表单的页面Id。
      */
+    @ApiModelProperty(value = "在线表单的页面Id")
     private Long pageId;
 
     /**
      * 在线表单Id。
      */
+    @ApiModelProperty(value = "在线表单Id")
     private Long defaultFormId;
 
     /**
      * 在线表单的缺省路由名称。
      */
+    @ApiModelProperty(value = "在线表单的缺省路由名称")
     private String defaultRouterName;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * categoryId 的一对一关联数据对象，数据对应类型为FlowCategoryVo。
      */
+    @ApiModelProperty(value = "categoryId 的一对一关联数据对象")
     private Map<String, Object> flowCategory;
 
     /**
      * mainEntryPublishId 的一对一关联数据对象，数据对应类型为FlowEntryPublishVo。
      */
+    @ApiModelProperty(value = "mainEntryPublishId 的一对一关联数据对象")
     private Map<String, Object> mainFlowEntryPublish;
 
     /**
      * 关联的在线表单列表。
      */
+    @ApiModelProperty(value = "关联的在线表单列表")
     private List<Map<String, Object>> formList;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowMessageVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,101 +12,127 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("工作流通知消息Vo对象")
 @Data
 public class FlowMessageVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long messageId;
 
     /**
      * 消息类型。
      */
+    @ApiModelProperty(value = "消息类型")
     private Integer messageType;
 
     /**
      * 消息内容。
      */
+    @ApiModelProperty(value = "消息内容")
     private String messageContent;
 
     /**
      * 催办次数。
      */
+    @ApiModelProperty(value = "催办次数")
     private Integer remindCount;
 
     /**
      * 工单Id。
      */
+    @ApiModelProperty(value = "工单Id")
     private Long workOrderId;
 
     /**
      * 流程定义Id。
      */
+    @ApiModelProperty(value = "流程定义Id")
     private String processDefinitionId;
 
     /**
      * 流程定义标识。
      */
+    @ApiModelProperty(value = "流程定义标识")
     private String processDefinitionKey;
 
     /**
      * 流程名称。
      */
+    @ApiModelProperty(value = "流程名称")
     private String processDefinitionName;
 
     /**
      * 流程实例Id。
      */
+    @ApiModelProperty(value = "流程实例Id")
     private String processInstanceId;
 
     /**
      * 流程实例发起者。
      */
+    @ApiModelProperty(value = "流程实例发起者")
     private String processInstanceInitiator;
 
     /**
      * 流程任务Id。
      */
+    @ApiModelProperty(value = "流程任务Id")
     private String taskId;
 
     /**
      * 流程任务定义标识。
      */
+    @ApiModelProperty(value = "流程任务定义标识")
     private String taskDefinitionKey;
 
     /**
      * 流程任务名称。
      */
+    @ApiModelProperty(value = "流程任务名称")
     private String taskName;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date taskStartTime;
 
+    /**
+     * 业务数据快照。
+     */
+    @ApiModelProperty(value = "业务数据快照")
+    private String businessDataShot;
+
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建者显示名。
      */
+    @ApiModelProperty(value = "创建者显示名")
     private String createUsername;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowTaskCommentVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,61 +12,73 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("FlowTaskCommentVO对象")
 @Data
 public class FlowTaskCommentVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long id;
 
     /**
      * 流程实例Id。
      */
+    @ApiModelProperty(value = "流程实例Id")
     private String processInstanceId;
 
     /**
      * 任务Id。
      */
+    @ApiModelProperty(value = "任务Id")
     private String taskId;
 
     /**
      * 任务标识。
      */
+    @ApiModelProperty(value = "任务标识")
     private String taskKey;
 
     /**
      * 任务名称。
      */
+    @ApiModelProperty(value = "任务名称")
     private String taskName;
 
     /**
      * 审批类型。
      */
+    @ApiModelProperty(value = "审批类型")
     private String approvalType;
 
     /**
      * 批注内容。
      */
+    @ApiModelProperty(value = "批注内容")
     private String comment;
 
     /**
      * 委托指定人，比如加签、转办等。
      */
+    @ApiModelProperty(value = "委托指定人，比如加签、转办等")
     private String delegateAssginee;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建者显示名。
      */
+    @ApiModelProperty(value = "创建者显示名")
     private String createUsername;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowTaskVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,71 +12,85 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程任务Vo对象")
 @Data
 public class FlowTaskVo {
 
     /**
      * 流程任务Id。
      */
+    @ApiModelProperty(value = "流程任务Id")
     private String taskId;
 
     /**
      * 流程任务名称。
      */
+    @ApiModelProperty(value = "流程任务名称")
     private String taskName;
 
     /**
      * 流程任务标识。
      */
+    @ApiModelProperty(value = "流程任务标识")
     private String taskKey;
 
     /**
      * 任务的表单信息。
      */
+    @ApiModelProperty(value = "任务的表单信息")
     private String taskFormKey;
 
     /**
      * 流程Id。
      */
+    @ApiModelProperty(value = "流程Id")
     private Long entryId;
 
     /**
      * 流程定义Id。
      */
+    @ApiModelProperty(value = "流程定义Id")
     private String processDefinitionId;
 
     /**
      * 流程定义名称。
      */
+    @ApiModelProperty(value = "流程定义名称")
     private String processDefinitionName;
 
     /**
      * 流程定义标识。
      */
+    @ApiModelProperty(value = "流程定义标识")
     private String processDefinitionKey;
 
     /**
      * 流程定义版本。
      */
+    @ApiModelProperty(value = "流程定义版本")
     private Integer processDefinitionVersion;
 
     /**
      * 流程实例Id。
      */
+    @ApiModelProperty(value = "流程实例Id")
     private String processInstanceId;
 
     /**
      * 流程实例发起人。
      */
+    @ApiModelProperty(value = "流程实例发起人")
     private String processInstanceInitiator;
 
     /**
      * 流程实例创建时间。
      */
+    @ApiModelProperty(value = "流程实例创建时间")
     private Date processInstanceStartTime;
 
     /**
      * 流程实例主表业务数据主键。
      */
+    @ApiModelProperty(value = "流程实例主表业务数据主键")
     private String businessKey;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/FlowWorkOrderVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import com.alibaba.fastjson.JSONArray;
 import lombok.Data;
 
@@ -12,97 +14,116 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("工作流工单Vo对象")
 @Data
 public class FlowWorkOrderVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long workOrderId;
 
     /**
      * 流程定义标识。
      */
+    @ApiModelProperty(value = "流程定义标识")
     private String processDefinitionKey;
 
     /**
      * 流程名称。
      */
+    @ApiModelProperty(value = "流程名称")
     private String processDefinitionName;
 
     /**
      * 流程引擎的定义Id。
      */
+    @ApiModelProperty(value = "流程引擎的定义Id")
     private String processDefinitionId;
 
     /**
      * 流程实例Id。
      */
+    @ApiModelProperty(value = "流程实例Id")
     private String processInstanceId;
 
     /**
      * 在线表单的主表Id。
      */
+    @ApiModelProperty(value = "在线表单的主表Id")
     private Long onlineTableId;
 
     /**
      * 业务主键值。
      */
+    @ApiModelProperty(value = "业务主键值")
     private String businessKey;
 
     /**
      * 流程状态。参考FlowTaskStatus常量值对象。
      */
+    @ApiModelProperty(value = "流程状态")
     private Integer flowStatus;
 
     /**
      * 提交用户登录名称。
      */
+    @ApiModelProperty(value = "提交用户登录名称")
     private String submitUsername;
 
     /**
      * 提交用户所在部门Id。
      */
+    @ApiModelProperty(value = "提交用户所在部门Id")
     private Long deptId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * flowStatus 常量字典关联数据。
      */
+    @ApiModelProperty(value = "flowStatus 常量字典关联数据")
     private Map<String, Object> flowStatusDictMap;
 
     /**
      * FlowEntryPublish对象中的同名字段。
      */
+    @ApiModelProperty(value = "FlowEntryPublish对象中的同名字段")
     private String initTaskInfo;
 
     /**
      * 当前实例的运行时任务列表。
      * 正常情况下只有一个，在并行网关下可能存在多个。
      */
+    @ApiModelProperty(value = "实例的运行时任务列表")
     private JSONArray runtimeTaskInfoList;
 
     /**
      * 业务主表数据。
      */
+    @ApiModelProperty(value = "业务主表数据")
     private Map<String, Object> masterData;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-flow/src/main/java/com/orangeforms/common/flow/vo/TaskInfoVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.flow.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import com.alibaba.fastjson.JSONObject;
 import lombok.Data;
 
@@ -11,57 +13,68 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("流程任务信息Vo对象")
 @Data
 public class TaskInfoVo {
 
     /**
      * 流程节点任务类型。具体值可参考FlowTaskType常量值。
      */
+    @ApiModelProperty(value = "流程节点任务类型")
     private Integer taskType;
 
     /**
      * 指定人。
      */
+    @ApiModelProperty(value = "指定人")
     private String assignee;
 
     /**
      * 任务标识。
      */
+    @ApiModelProperty(value = "任务标识")
     private String taskKey;
 
     /**
      * 是否分配给当前登录用户的标记。
      * 当该值为true时，登录用户启动流程时，就自动完成了第一个用户任务。
      */
+    @ApiModelProperty(value = "是否分配给当前登录用户的标记")
     private Boolean assignedMe;
 
     /**
      * 动态表单Id。
      */
+    @ApiModelProperty(value = "动态表单Id")
     private Long formId;
 
     /**
      * 静态表单路由。
      */
+    @ApiModelProperty(value = "静态表单路由")
     private String routerName;
 
     /**
      * 候选组类型。
      */
+    @ApiModelProperty(value = "候选组类型")
     private String groupType;
 
     /**
      * 只读标记。
      */
+    @ApiModelProperty(value = "只读标记")
     private Boolean readOnly;
 
     /**
      * 前端所需的操作列表。
      */
+    @ApiModelProperty(value = "前端所需的操作列表")
     List<JSONObject> operationList;
 
     /**
      * 任务节点的自定义变量列表。
      */
+    @ApiModelProperty(value = "任务节点的自定义变量列表")
     List<JSONObject> variableList;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-log/src/main/java/com/orangeforms/common/log/aop/OperationLogAspect.java

@@ -116,6 +116,10 @@ public class OperationLogAspect {
             if (saveOperationLog) {
                 this.operationLogPostProcess(operationLogAnnotation, respData, operationLog, result);
             }
+            if (elapse > properties.getSlowLogMs()) {
+                log.warn("耗时较长的请求完成警告, url={}，elapse={}ms reqData={} respData={}",
+                        request.getRequestURI(), elapse, params, respData);
+            }
             log.info("请求完成, url={}，elapse={}ms, respData={}", request.getRequestURI(), elapse, respData);
         } catch (Exception e) {
             if (saveOperationLog) {

orange-demo-activiti/orange-demo-activiti-service/common/common-log/src/main/java/com/orangeforms/common/log/config/OperationLogProperties.java

@@ -17,4 +17,8 @@ public class OperationLogProperties {
      * 是否采集操作日志。
      */
     private boolean enabled = true;
+    /**
+     * 接口调用的毫秒数大于该值后，将输出慢日志警告。
+     */
+    private long slowLogMs = 50000;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/pom.xml

@@ -20,6 +20,11 @@
             <artifactId>common-online</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orangeforms</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
     </dependencies>
 
     <build>

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineColumnController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.online.api.controller;
 
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.orangeforms.common.core.annotation.MyRequestBody;
@@ -35,6 +36,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "字段数据操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineColumn")

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineDatasourceController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
@@ -30,6 +32,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据模型操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineDatasource")
@@ -53,6 +56,7 @@ public class OnlineDatasourceController {
      * @param pageId              关联的页面Id。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineDatasourceDto.datasourceId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody OnlineDatasourceDto onlineDatasourceDto,

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineDatasourceRelationController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
@@ -29,6 +31,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据源关联操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineDatasourceRelation")
@@ -51,6 +54,7 @@ public class OnlineDatasourceRelationController {
      * @param onlineDatasourceRelationDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineDatasourceRelationDto.relationId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlineDatasourceRelationDto onlineDatasourceRelationDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineDblinkController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.online.api.controller;
 
+import io.swagger.annotations.Api;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
 import com.orangeforms.common.core.object.MyOrderParam;
@@ -27,6 +28,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据库链接操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineDblink")

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineDictController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
 import com.orangeforms.common.core.object.*;
@@ -25,6 +27,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线表单字典操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineDict")
@@ -39,6 +42,7 @@ public class OnlineDictController {
      * @param onlineDictDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineDictDto.dictId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlineDictDto onlineDictDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(onlineDictDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineFormController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.json.JSONObject;
 import com.orangeforms.common.core.annotation.MyRequestBody;
@@ -30,6 +32,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线表单操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineForm")
@@ -58,6 +61,7 @@ public class OnlineFormController {
      * @param onlineFormDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineFormDto.formId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlineFormDto onlineFormDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(onlineFormDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlinePageController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.JSONObject;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
@@ -37,6 +39,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线表单页面操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlinePage")
@@ -55,6 +58,7 @@ public class OnlinePageController {
      * @param onlinePageDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlinePageDto.pageId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlinePageDto onlinePageDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(onlinePageDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineRuleController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
 import com.orangeforms.common.core.object.*;
@@ -25,6 +27,7 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "验证规则操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineRule")
@@ -39,6 +42,7 @@ public class OnlineRuleController {
      * @param onlineRuleDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineRuleDto.ruleId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlineRuleDto onlineRuleDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(onlineRuleDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineTableController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.online.api.controller;
 
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.constant.ErrorCodeEnum;
@@ -27,6 +28,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据表操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineTable")

orange-demo-activiti/orange-demo-activiti-service/common/common-online-api/src/main/java/com/orangeforms/common/online/api/controller/OnlineVirtualColumnController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.api.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.github.pagehelper.page.PageMethod;
 import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.*;
@@ -24,6 +26,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "虚拟字段操作接口")
 @Slf4j
 @RestController
 @RequestMapping("${common-online-api.urlPrefix}/onlineVirtualColumn")
@@ -38,6 +41,7 @@ public class OnlineVirtualColumnController {
      * @param onlineVirtualColumnDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"onlineVirtualColumnDto.virtualColumnId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody OnlineVirtualColumnDto onlineVirtualColumnDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(onlineVirtualColumnDto);

orange-demo-activiti/orange-demo-activiti-service/common/common-online/pom.xml

@@ -40,6 +40,11 @@
             <artifactId>common-log</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orangeforms</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
     </dependencies>
 
     <build>

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/controller/OnlineOperationController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.common.online.controller;
 
+import io.swagger.annotations.Api;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.CharUtil;
 import cn.hutool.core.util.StrUtil;
@@ -36,6 +37,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线操作接口接口")
 @Slf4j
 @RestController
 @ConditionalOnProperty(name = "common-online.operationEnabled", havingValue = "true")

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineColumnDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.FieldFilterType;
 import com.orangeforms.common.online.model.constant.FieldKind;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -15,88 +17,103 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表字段Dto对象")
 @Data
 public class OnlineColumnDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long columnId;
 
     /**
      * 字段名。
      */
+    @ApiModelProperty(value = "字段名")
     @NotBlank(message = "数据验证失败，字段名不能为空！")
     private String columnName;
 
     /**
      * 数据表Id。
      */
+    @ApiModelProperty(value = "数据表Id")
     @NotNull(message = "数据验证失败，数据表Id不能为空！")
     private Long tableId;
 
     /**
      * 数据表中的字段类型。
      */
+    @ApiModelProperty(value = "数据表中的字段类型")
     @NotBlank(message = "数据验证失败，数据表中的字段类型不能为空！")
     private String columnType;
 
     /**
      * 数据表中的完整字段类型(包括了精度和刻度)。
      */
+    @ApiModelProperty(value = "数据表中的完整字段类型")
     @NotBlank(message = "数据验证失败，数据表中的完整字段类型(包括了精度和刻度)不能为空！")
     private String fullColumnType;
 
     /**
      * 是否为主键。
      */
+    @ApiModelProperty(value = "是否为主键")
     @NotNull(message = "数据验证失败，是否为主键不能为空！")
     private Boolean primaryKey;
 
     /**
      * 是否是自增主键(0: 不是 1: 是)。
      */
+    @ApiModelProperty(value = "是否是自增主键")
     @NotNull(message = "数据验证失败，是否是自增主键(0: 不是 1: 是)不能为空！")
     private Boolean autoIncrement;
 
     /**
      * 是否可以为空 (0: 不可以为空 1: 可以为空)。
      */
+    @ApiModelProperty(value = "是否可以为空")
     @NotNull(message = "数据验证失败，是否可以为空 (0: 不可以为空 1: 可以为空)不能为空！")
     private Boolean nullable;
 
     /**
      * 缺省值。
      */
+    @ApiModelProperty(value = "缺省值")
     private String columnDefault;
 
     /**
      * 字段在数据表中的显示位置。
      */
+    @ApiModelProperty(value = "字段在数据表中的显示位置")
     @NotNull(message = "数据验证失败，字段在数据表中的显示位置不能为空！")
     private Integer columnShowOrder;
 
     /**
      * 数据表中的字段注释。
      */
+    @ApiModelProperty(value = "数据表中的字段注释")
     private String columnComment;
 
     /**
      * 对象映射字段名称。
      */
+    @ApiModelProperty(value = "对象映射字段名称")
     @NotBlank(message = "数据验证失败，对象映射字段名称不能为空！")
     private String objectFieldName;
 
     /**
      * 对象映射字段类型。
      */
+    @ApiModelProperty(value = "对象映射字段类型")
     @NotBlank(message = "数据验证失败，对象映射字段类型不能为空！")
     private String objectFieldType;
 
     /**
      * 过滤类型字段。
      */
+    @ApiModelProperty(value = "过滤类型字段")
     @NotNull(message = "数据验证失败，过滤类型字段不能为空！", groups = {UpdateGroup.class})
     @ConstDictRef(constDictClass = FieldFilterType.class, message = "数据验证失败，过滤类型字段为无效值！")
     private Integer filterType;
@@ -104,34 +121,40 @@ public class OnlineColumnDto {
     /**
      * 是否是主键的父Id。
      */
+    @ApiModelProperty(value = "是否是主键的父Id")
     @NotNull(message = "数据验证失败，是否是主键的父Id不能为空！")
     private Boolean parentKey;
 
     /**
      * 是否部门过滤字段。
      */
+    @ApiModelProperty(value = "是否部门过滤字段")
     @NotNull(message = "数据验证失败，是否部门过滤字段标记不能为空！")
     private Boolean deptFilter;
 
     /**
      * 是否用户过滤字段。
      */
+    @ApiModelProperty(value = "是否用户过滤字段")
     @NotNull(message = "数据验证失败，是否用户过滤字段标记不能为空！")
     private Boolean userFilter;
 
     /**
      * 字段类别。
      */
+    @ApiModelProperty(value = "字段类别")
     @ConstDictRef(constDictClass = FieldKind.class, message = "数据验证失败，字段类别为无效值！")
     private Integer fieldKind;
 
     /**
      * 包含的文件文件数量，0表示无限制。
      */
+    @ApiModelProperty(value = "包含的文件文件数量，0表示无限制")
     private Integer maxFileCount;
 
     /**
      * 字典Id。
      */
+    @ApiModelProperty(value = "字典Id")
     private Long dictId;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineColumnRuleDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotNull;
@@ -11,23 +13,27 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表字段规则和字段多对多关联Dto对象")
 @Data
 public class OnlineColumnRuleDto {
 
     /**
      * 字段Id。
      */
+    @ApiModelProperty(value = "字段Id")
     @NotNull(message = "数据验证失败，字段Id不能为空！", groups = {UpdateGroup.class})
     private Long columnId;
 
     /**
      * 规则Id。
      */
+    @ApiModelProperty(value = "规则Id")
     @NotNull(message = "数据验证失败，规则Id不能为空！", groups = {UpdateGroup.class})
     private Long ruleId;
 
     /**
      * 规则属性数据。
      */
+    @ApiModelProperty(value = "规则属性数据")
     private String propDataJson;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineDatasourceDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.core.validator.AddGroup;
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -13,42 +15,49 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单的数据源Dto对象")
 @Data
 public class OnlineDatasourceDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long datasourceId;
 
     /**
      * 数据源名称。
      */
+    @ApiModelProperty(value = "数据源名称")
     @NotBlank(message = "数据验证失败，数据源名称不能为空！")
     private String datasourceName;
 
     /**
      * 数据源变量名，会成为数据访问url的一部分。
      */
+    @ApiModelProperty(value = "数据源变量名，会成为数据访问url的一部分")
     @NotBlank(message = "数据验证失败，数据源变量名不能为空！")
     private String variableName;
 
     /**
      * 主表所在的数据库链接Id。
      */
+    @ApiModelProperty(value = "主表所在的数据库链接Id")
     @NotNull(message = "数据验证失败，数据库链接Id不能为空！")
     private Long dblinkId;
 
     /**
      * 主表Id。
      */
+    @ApiModelProperty(value = "主表Id")
     @NotNull(message = "数据验证失败，主表Id不能为空！", groups = {UpdateGroup.class})
     private Long masterTableId;
 
     /**
      * 主表表名。
      */
+    @ApiModelProperty(value = "主表表名")
     @NotBlank(message = "数据验证失败，主表名不能为空！", groups = {AddGroup.class})
     private String masterTableName;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineDatasourceRelationDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.AddGroup;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.RelationType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -15,36 +17,42 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单的数据源关联Dto对象")
 @Data
 public class OnlineDatasourceRelationDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long relationId;
 
     /**
      * 关联名称。
      */
+    @ApiModelProperty(value = "关联名称")
     @NotBlank(message = "数据验证失败，关联名称不能为空！")
     private String relationName;
 
     /**
      * 变量名。
      */
+    @ApiModelProperty(value = "变量名")
     @NotBlank(message = "数据验证失败，变量名不能为空！")
     private String variableName;
 
     /**
      * 主数据源Id。
      */
+    @ApiModelProperty(value = "主数据源Id")
     @NotNull(message = "数据验证失败，主数据源Id不能为空！")
     private Long datasourceId;
 
     /**
      * 关联类型。
      */
+    @ApiModelProperty(value = "关联类型")
     @NotNull(message = "数据验证失败，关联类型不能为空！")
     @ConstDictRef(constDictClass = RelationType.class, message = "数据验证失败，关联类型为无效值！")
     private Integer relationType;
@@ -52,42 +60,49 @@ public class OnlineDatasourceRelationDto {
     /**
      * 主表关联字段Id。
      */
+    @ApiModelProperty(value = "主表关联字段Id")
     @NotNull(message = "数据验证失败，主表关联字段Id不能为空！")
     private Long masterColumnId;
 
     /**
      * 从表Id。
      */
+    @ApiModelProperty(value = "从表Id")
     @NotNull(message = "数据验证失败，从表Id不能为空！", groups = {UpdateGroup.class})
     private Long slaveTableId;
 
     /**
      * 从表名。
      */
+    @ApiModelProperty(value = "从表名")
     @NotBlank(message = "数据验证失败，从表名不能为空！", groups = {AddGroup.class})
     private String slaveTableName;
 
     /**
      * 从表关联字段Id。
      */
+    @ApiModelProperty(value = "从表关联字段Id")
     @NotNull(message = "数据验证失败，从表关联字段Id不能为空！", groups = {UpdateGroup.class})
     private Long slaveColumnId;
 
     /**
      * 从表字段名。
      */
+    @ApiModelProperty(value = "从表字段名")
     @NotBlank(message = "数据验证失败，从表字段名不能为空！", groups = {AddGroup.class})
     private String slaveColumnName;
 
     /**
      * 是否级联删除标记。
      */
+    @ApiModelProperty(value = "是否级联删除标记")
     @NotNull(message = "数据验证失败，是否级联删除标记不能为空！")
     private Boolean cascadeDelete;
 
     /**
      * 是否左连接标记。
      */
+    @ApiModelProperty(value = "是否左连接标记")
     @NotNull(message = "数据验证失败，是否左连接标记不能为空！")
     private Boolean leftJoin;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineDblinkDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -12,35 +14,41 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表所在数据库链接Dto对象")
 @Data
 public class OnlineDblinkDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long dblinkId;
 
     /**
      * 链接中文名称。
      */
+    @ApiModelProperty(value = "链接中文名称")
     @NotBlank(message = "数据验证失败，链接中文名称不能为空！")
     private String dblinkName;
 
     /**
      * 链接英文名称。
      */
+    @ApiModelProperty(value = "链接英文名称")
     @NotBlank(message = "数据验证失败，链接英文名称不能为空！")
     private String variableName;
 
     /**
      * 链接描述。
      */
+    @ApiModelProperty(value = "链接描述")
     private String dblinkDesc;
 
     /**
      * 数据源配置常量。
      */
+    @ApiModelProperty(value = "数据源配置常量")
     @NotNull(message = "数据验证失败，数据源配置常量不能为空！")
     private Integer dblinkConfigConstant;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineDictDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.common.online.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.DictType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,24 +16,28 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单关联的字典Dto对象")
 @Data
 public class OnlineDictDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long dictId;
 
     /**
      * 字典名称。
      */
+    @ApiModelProperty(value = "字典名称")
     @NotBlank(message = "数据验证失败，字典名称不能为空！")
     private String dictName;
 
     /**
      * 字典类型。
      */
+    @ApiModelProperty(value = "字典类型")
     @NotNull(message = "数据验证失败，字典类型不能为空！")
     @ConstDictRef(constDictClass = DictType.class, message = "数据验证失败，字典类型为无效值！")
     private Integer dictType;
@@ -39,66 +45,79 @@ public class OnlineDictDto {
     /**
      * 数据库链接Id。
      */
+    @ApiModelProperty(value = "数据库链接Id")
     private Long dblinkId;
 
     /**
      * 字典表名称。
      */
+    @ApiModelProperty(value = "字典表名称")
     private String tableName;
 
     /**
      * 字典表键字段名称。
      */
+    @ApiModelProperty(value = "字典表键字段名称")
     private String keyColumnName;
 
     /**
      * 字典表父键字段名称。
      */
+    @ApiModelProperty(value = "字典表父键字段名称")
     private String parentKeyColumnName;
 
     /**
      * 字典值字段名称。
      */
+    @ApiModelProperty(value = "字典值字段名称")
     private String valueColumnName;
 
     /**
      * 逻辑删除字段。
      */
+    @ApiModelProperty(value = "逻辑删除字段")
     private String deletedColumnName;
 
     /**
      * 用户过滤滤字段名称。
      */
+    @ApiModelProperty(value = "用户过滤滤字段名称")
     private String userFilterColumnName;
 
     /**
      * 部门过滤字段名称。
      */
+    @ApiModelProperty(value = "部门过滤字段名称")
     private String deptFilterColumnName;
 
     /**
      * 租户过滤字段名称。
      */
+    @ApiModelProperty(value = "租户过滤字段名称")
     private String tenantFilterColumnName;
 
     /**
      * 是否树形标记。
      */
+    @ApiModelProperty(value = "是否树形标记")
     @NotNull(message = "数据验证失败，是否树形标记不能为空！")
     private Boolean treeFlag;
 
     /**
      * 获取字典数据的url。
      */
+    @ApiModelProperty(value = "获取字典数据的url")
     private String dictListUrl;
 
     /**
      * 根据主键id批量获取字典数据的url。
      */
+    @ApiModelProperty(value = "根据主键id批量获取字典数据的url")
     private String dictIdsUrl;
 
     /**
      * 字典的JSON数据。
      */
+    @ApiModelProperty(value = "字典的JSON数据")
     private String dictDataJson;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineFilterDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.online.model.constant.FieldFilterType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Set;
@@ -11,41 +13,49 @@ import java.util.Set;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据过滤参数对象")
 @Data
 public class OnlineFilterDto {
 
     /**
      * 表名。
      */
+    @ApiModelProperty(value = "表名")
     private String tableName;
 
     /**
      * 过滤字段名。
      */
+    @ApiModelProperty(value = "过滤字段名")
     private String columnName;
 
     /**
      * 过滤值。
      */
+    @ApiModelProperty(value = "过滤值")
     private Object columnValue;
 
     /**
      * 范围比较的最小值。
      */
+    @ApiModelProperty(value = "范围比较的最小值")
     private Object columnValueStart;
 
     /**
      * 范围比较的最大值。
      */
+    @ApiModelProperty(value = "范围比较的最大值")
     private Object columnValueEnd;
 
     /**
      * 仅当操作符为IN的时候使用。
      */
+    @ApiModelProperty(value = "仅当操作符为IN的时候使用")
     private Set<Object> columnValueList;
 
     /**
      * 过滤类型，参考FieldFilterType常量对象。缺省值就是等于过滤了。
      */
+    @ApiModelProperty(value = "过滤类型")
     private Integer filterType = FieldFilterType.EQUAL_FILTER;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineFormDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.FormKind;
 import com.orangeforms.common.online.model.constant.FormType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -16,35 +18,41 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单Dto对象")
 @Data
 public class OnlineFormDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long formId;
 
     /**
      * 页面id。
      */
+    @ApiModelProperty(value = "页面id")
     @NotNull(message = "数据验证失败，页面id不能为空！")
     private Long pageId;
 
     /**
      * 表单编码。
      */
+    @ApiModelProperty(value = "表单编码")
     private String formCode;
 
     /**
      * 表单名称。
      */
+    @ApiModelProperty(value = "表单名称")
     @NotBlank(message = "数据验证失败，表单名称不能为空！")
     private String formName;
 
     /**
      * 表单类别。
      */
+    @ApiModelProperty(value = "表单类别")
     @NotNull(message = "数据验证失败，表单类别不能为空！")
     @ConstDictRef(constDictClass = FormKind.class, message = "数据验证失败，表单类别为无效值！")
     private Integer formKind;
@@ -52,6 +60,7 @@ public class OnlineFormDto {
     /**
      * 表单类型。
      */
+    @ApiModelProperty(value = "表单类型")
     @NotNull(message = "数据验证失败，表单类型不能为空！")
     @ConstDictRef(constDictClass = FormType.class, message = "数据验证失败，表单类型为无效值！")
     private Integer formType;
@@ -59,21 +68,25 @@ public class OnlineFormDto {
     /**
      * 表单主表id。
      */
+    @ApiModelProperty(value = "表单主表id")
     @NotNull(message = "数据验证失败，表单主表id不能为空！")
     private Long masterTableId;
 
     /**
      * 当前表单关联的数据源Id集合。
      */
+    @ApiModelProperty(value = "当前表单关联的数据源Id集合")
     private List<Long> datasourceIdList;
 
     /**
      * 表单组件JSON。
      */
+    @ApiModelProperty(value = "表单组件JSON")
     private String widgetJson;
 
     /**
      * 表单参数JSON。
      */
+    @ApiModelProperty(value = "表单参数JSON")
     private String paramsJson;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlinePageDatasourceDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotNull;
@@ -11,24 +13,28 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单页面和数据源多对多关联Dto对象")
 @Data
 public class OnlinePageDatasourceDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long id;
 
     /**
      * 页面主键Id。
      */
+    @ApiModelProperty(value = "页面主键Id")
     @NotNull(message = "数据验证失败，页面主键Id不能为空！")
     private Long pageId;
 
     /**
      * 数据源主键Id。
      */
+    @ApiModelProperty(value = "数据源主键Id")
     @NotNull(message = "数据验证失败，数据源主键Id不能为空！")
     private Long datasourceId;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlinePageDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.PageStatus;
 import com.orangeforms.common.online.model.constant.PageType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -15,29 +17,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单所在页面Dto对象")
 @Data
 public class OnlinePageDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long pageId;
 
     /**
      * 页面编码。
      */
+    @ApiModelProperty(value = "页面编码")
     private String pageCode;
 
     /**
      * 页面名称。
      */
+    @ApiModelProperty(value = "页面名称")
     @NotBlank(message = "数据验证失败，页面名称不能为空！")
     private String pageName;
 
     /**
      * 页面类型。
      */
+    @ApiModelProperty(value = "页面类型")
     @NotNull(message = "数据验证失败，页面类型不能为空！")
     @ConstDictRef(constDictClass = PageType.class, message = "数据验证失败，页面类型为无效值！")
     private Integer pageType;
@@ -45,6 +52,7 @@ public class OnlinePageDto {
     /**
      * 页面编辑状态。
      */
+    @ApiModelProperty(value = "页面编辑状态")
     @NotNull(message = "数据验证失败，状态不能为空！")
     @ConstDictRef(constDictClass = PageStatus.class, message = "数据验证失败，状态为无效值！")
     private Integer status;

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineRuleDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.common.online.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.online.model.constant.RuleType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,24 +16,28 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表字段验证规则Dto对象")
 @Data
 public class OnlineRuleDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long ruleId;
 
     /**
      * 规则名称。
      */
+    @ApiModelProperty(value = "规则名称")
     @NotBlank(message = "数据验证失败，规则名称不能为空！")
     private String ruleName;
 
     /**
      * 规则类型。
      */
+    @ApiModelProperty(value = "规则类型")
     @NotNull(message = "数据验证失败，规则类型不能为空！")
     @ConstDictRef(constDictClass = RuleType.class, message = "数据验证失败，规则类型为无效值！")
     private Integer ruleType;
@@ -39,11 +45,13 @@ public class OnlineRuleDto {
     /**
      * 内置规则标记。
      */
+    @ApiModelProperty(value = "内置规则标记")
     @NotNull(message = "数据验证失败，内置规则标记不能为空！")
     private Boolean builtin;
 
     /**
      * 自定义规则的正则表达式。
      */
+    @ApiModelProperty(value = "自定义规则的正则表达式")
     private String pattern;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineTableDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.common.online.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -12,30 +14,35 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单的数据表Dto对象")
 @Data
 public class OnlineTableDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long tableId;
 
     /**
      * 表名称。
      */
+    @ApiModelProperty(value = "表名称")
     @NotBlank(message = "数据验证失败，表名称不能为空！")
     private String tableName;
 
     /**
      * 实体名称。
      */
+    @ApiModelProperty(value = "实体名称")
     @NotBlank(message = "数据验证失败，实体名称不能为空！")
     private String modelName;
 
     /**
      * 数据库链接Id。
      */
+    @ApiModelProperty(value = "数据库链接Id")
     @NotNull(message = "数据验证失败，数据库链接Id不能为空！")
     private Long dblinkId;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/dto/OnlineVirtualColumnDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.common.online.dto;
 import com.orangeforms.common.core.constant.AggregationType;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 
 import com.orangeforms.common.online.model.constant.VirtualType;
 import lombok.Data;
@@ -15,41 +17,48 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线数据表虚拟字段Dto对象")
 @Data
 public class OnlineVirtualColumnDto {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     private Long virtualColumnId;
 
     /**
      * 所在表Id。
      */
+    @ApiModelProperty(value = "所在表Id")
     private Long tableId;
 
     /**
      * 字段名称。
      */
+    @ApiModelProperty(value = "字段名称")
     @NotBlank(message = "数据验证失败，字段名称不能为空！")
     private String objectFieldName;
 
     /**
      * 属性类型。
      */
+    @ApiModelProperty(value = "属性类型")
     @NotBlank(message = "数据验证失败，属性类型不能为空！")
     private String objectFieldType;
 
     /**
      * 字段提示名。
      */
+    @ApiModelProperty(value = "字段提示名")
     @NotBlank(message = "数据验证失败，字段提示名不能为空！")
     private String columnPrompt;
 
     /**
      * 虚拟字段类型(0: 聚合)。
      */
+    @ApiModelProperty(value = "虚拟字段类型(0: 聚合)")
     @ConstDictRef(constDictClass = VirtualType.class, message = "数据验证失败，虚拟字段类型为无效值！")
     @NotNull(message = "数据验证失败，虚拟字段类型(0: 聚合)不能为空！")
     private Integer virtualType;
@@ -57,32 +66,38 @@ public class OnlineVirtualColumnDto {
     /**
      * 关联数据源Id。
      */
+    @ApiModelProperty(value = "关联数据源Id")
     @NotNull(message = "数据验证失败，关联数据源Id不能为空！")
     private Long datasourceId;
 
     /**
      * 关联Id。
      */
+    @ApiModelProperty(value = "关联Id")
     private Long relationId;
 
     /**
      * 聚合字段所在关联表Id。
      */
+    @ApiModelProperty(value = "聚合字段所在关联表Id")
     private Long aggregationTableId;
 
     /**
      * 关联表聚合字段Id。
      */
+    @ApiModelProperty(value = "关联表聚合字段Id")
     private Long aggregationColumnId;
 
     /**
      * 聚合类型(0: sum 1: count 2: avg 3: min 4: max)。
      */
+    @ApiModelProperty(value = "聚合类型(0: sum 1: count 2: avg 3: min 4: max)")
     @ConstDictRef(constDictClass = AggregationType.class, message = "数据验证失败，虚拟字段聚合计算类型为无效值！")
     private Integer aggregationType;
 
     /**
      * 存储过滤条件的json。
      */
+    @ApiModelProperty(value = "存储过滤条件的json")
     private String whereClauseJson;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/vo/OnlineColumnRuleVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,21 +10,25 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表字段规则和字段多对多关联VO对象")
 @Data
 public class OnlineColumnRuleVo {
 
     /**
      * 字段Id。
      */
+    @ApiModelProperty(value = "字段Id")
     private Long columnId;
 
     /**
      * 规则Id。
      */
+    @ApiModelProperty(value = "规则Id")
     private Long ruleId;
 
     /**
      * 规则属性数据。
      */
+    @ApiModelProperty(value = "规则属性数据")
     private String propDataJson;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/vo/OnlineColumnVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,126 +13,151 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单数据表字段规则和字段多对多关联VO对象")
 @Data
 public class OnlineColumnVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long columnId;
 
     /**
      * 字段名。
      */
+    @ApiModelProperty(value = "字段名")
     private String columnName;
 
     /**
      * 数据表Id。
      */
+    @ApiModelProperty(value = "数据表Id")
     private Long tableId;
 
     /**
      * 数据表中的字段类型。
      */
+    @ApiModelProperty(value = "数据表中的字段类型")
     private String columnType;
 
     /**
      * 数据表中的完整字段类型(包括了精度和刻度)。
      */
+    @ApiModelProperty(value = "数据表中的完整字段类型")
     private String fullColumnType;
 
     /**
      * 是否为主键。
      */
+    @ApiModelProperty(value = "是否为主键")
     private Boolean primaryKey;
 
     /**
      * 是否是自增主键(0: 不是 1: 是)。
      */
+    @ApiModelProperty(value = "是否是自增主键")
     private Boolean autoIncrement;
 
     /**
      * 是否可以为空 (0: 不可以为空 1: 可以为空)。
      */
+    @ApiModelProperty(value = "是否可以为空")
     private Boolean nullable;
 
     /**
      * 缺省值。
      */
+    @ApiModelProperty(value = "缺省值")
     private String columnDefault;
 
     /**
      * 字段在数据表中的显示位置。
      */
+    @ApiModelProperty(value = "字段在数据表中的显示位置")
     private Integer columnShowOrder;
 
     /**
      * 数据表中的字段注释。
      */
+    @ApiModelProperty(value = "数据表中的字段注释")
     private String columnComment;
 
     /**
      * 对象映射字段名称。
      */
+    @ApiModelProperty(value = "对象映射字段名称")
     private String objectFieldName;
 
     /**
      * 对象映射字段类型。
      */
+    @ApiModelProperty(value = "对象映射字段类型")
     private String objectFieldType;
 
     /**
      * 过滤类型。
      */
+    @ApiModelProperty(value = "过滤类型")
     private Integer filterType;
 
     /**
      * 是否是主键的父Id。
      */
+    @ApiModelProperty(value = "是否是主键的父Id")
     private Boolean parentKey;
 
     /**
      * 是否部门过滤字段。
      */
+    @ApiModelProperty(value = "是否部门过滤字段")
     private Boolean deptFilter;
 
     /**
      * 是否用户过滤字段。
      */
+    @ApiModelProperty(value = "是否用户过滤字段")
     private Boolean userFilter;
 
     /**
      * 字段类别。
      */
+    @ApiModelProperty(value = "字段类别")
     private Integer fieldKind;
 
     /**
      * 包含的文件文件数量，0表示无限制。
      */
+    @ApiModelProperty(value = "包含的文件文件数量，0表示无限制")
     private Integer maxFileCount;
 
     /**
      * 字典Id。
      */
+    @ApiModelProperty(value = "字典Id")
     private Long dictId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * fieldKind 常量字典关联数据。
      */
+    @ApiModelProperty(value = "常量字典关联数据")
     private Map<String, Object> fieldKindDictMap;
 
     /**
      * dictId 的一对一关联。
      */
+    @ApiModelProperty(value = "dictId 的一对一关联")
     private Map<String, Object> dictInfo;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/vo/OnlineDatasourceRelationVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,101 +13,121 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单的数据源关联VO对象")
 @Data
 public class OnlineDatasourceRelationVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long relationId;
 
     /**
      * 关联名称。
      */
+    @ApiModelProperty(value = "关联名称")
     private String relationName;
 
     /**
      * 变量名。
      */
+    @ApiModelProperty(value = "变量名")
     private String variableName;
 
     /**
      * 主数据源Id。
      */
+    @ApiModelProperty(value = "主数据源Id")
     private Long datasourceId;
 
     /**
      * 关联类型。
      */
+    @ApiModelProperty(value = "关联类型")
     private Integer relationType;
 
     /**
      * 主表关联字段Id。
      */
+    @ApiModelProperty(value = "主表关联字段Id")
     private Long masterColumnId;
 
     /**
      * 从表Id。
      */
+    @ApiModelProperty(value = "从表Id")
     private Long slaveTableId;
 
     /**
      * 从表关联字段Id。
      */
+    @ApiModelProperty(value = "从表关联字段Id")
     private Long slaveColumnId;
 
     /**
      * 删除主表的时候是否级联删除一对一和一对多的从表数据，多对多只是删除关联，不受到这个标记的影响。。
      */
+    @ApiModelProperty(value = "一对多从表级联删除标记")
     private Boolean cascadeDelete;
 
     /**
      * 是否左连接。
      */
+    @ApiModelProperty(value = "是否左连接")
     private Boolean leftJoin;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * masterColumnId 的一对一关联数据对象，数据对应类型为OnlineColumnVo。
      */
+    @ApiModelProperty(value = "masterColumnId字段的一对一关联数据对象")
     private Map<String, Object> masterColumn;
 
     /**
      * slaveTableId 的一对一关联数据对象，数据对应类型为OnlineTableVo。
      */
+    @ApiModelProperty(value = "slaveTableId字段的一对一关联数据对象")
     private Map<String, Object> slaveTable;
 
     /**
      * slaveColumnId 的一对一关联数据对象，数据对应类型为OnlineColumnVo。
      */
+    @ApiModelProperty(value = "slaveColumnId字段的一对一关联数据对象")
     private Map<String, Object> slaveColumn;
 
     /**
      * masterColumnId 字典关联数据。
      */
+    @ApiModelProperty(value = "masterColumnId的字典关联数据")
     private Map<String, Object> masterColumnIdDictMap;
 
     /**
      * slaveTableId 字典关联数据。
      */
+    @ApiModelProperty(value = "slaveTableId的字典关联数据")
     private Map<String, Object> slaveTableIdDictMap;
 
     /**
      * slaveColumnId 字典关联数据。
      */
+    @ApiModelProperty(value = "slaveColumnId的字典关联数据")
     private Map<String, Object> slaveColumnIdDictMap;
 
     /**
      * relationType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "常量字典关联数据")
     private Map<String, Object> relationTypeDictMap;
 }

orange-demo-activiti/orange-demo-activiti-service/common/common-online/src/main/java/com/orangeforms/common/online/vo/OnlineDatasourceVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.common.online.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -12,56 +14,67 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("在线表单的数据源VO对象")
 @Data
 public class OnlineDatasourceVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long datasourceId;
 
     /**
      * 数据源名称。
      */
+    @ApiModelProperty(value = "数据源名称")
     private String datasourceName;
 
     /**
      * 数据源变量名，会成为数据访问url的一部分。
      */
+    @ApiModelProperty(value = "数据源变量名")
     private String variableName;
 
     /**
      * 数据库链接Id。
      */
+    @ApiModelProperty(value = "数据库链接Id")
     private Long dblinkId;
 
     /**
      * 主表Id。
      */
+    @ApiModelProperty(value = "主表Id")
     private Long masterTableId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * datasourceId 的多对多关联表数据对象，数据对应类型为OnlinePageDatasourceVo。
      */
+    @ApiModelProperty(value = "datasourceId 的多对多关联表数据对象")
     private Map<String, Object> onlinePageDatasource;
 
     /**
      * masterTableId 字典关联数据。
      */
+    @ApiModelProperty(value = "masterTableId 字典关联数据")
     private Map<String, Object> masterTableIdDictMap;
 
     /**
      * 当前数据源及其关联，引用的数据表对象列表。
      */
+    @ApiModelProperty(value = "当前数据源及其关联，引用的数据表对象列表")
     private List<OnlineTableVo> tableList;
 }