feat: 修改剩余部分 swagger 注解
parent
6f3e026f4c
commit
8986299fea
|
@ -1,54 +1,54 @@
|
|||
package cn.iocoder.yudao.gateway.swagger;
|
||||
|
||||
|
||||
import org.springframework.beans.factory.annotation.Autowired;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.GetMapping;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
import reactor.core.publisher.Mono;
|
||||
import springfox.documentation.swagger.web.*;
|
||||
|
||||
import javax.annotation.Resource;
|
||||
import java.util.List;
|
||||
import java.util.Optional;
|
||||
|
||||
/**
|
||||
* Swagger Controller
|
||||
*
|
||||
* @author zxliu
|
||||
* @date 2022-10-25 11:24
|
||||
*/
|
||||
@RestController
|
||||
@RequestMapping("/swagger-resources")
|
||||
public class SwaggerHandler {
|
||||
|
||||
@Resource
|
||||
private SwaggerResourcesProvider swaggerResources;
|
||||
|
||||
@SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection") // 只有 @Autowired 可以实现可选注入
|
||||
@Autowired(required = false)
|
||||
private SecurityConfiguration securityConfiguration;
|
||||
@SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection") // 只有 @Autowired 可以实现可选注入
|
||||
@Autowired(required = false)
|
||||
private UiConfiguration uiConfiguration;
|
||||
|
||||
@GetMapping("")
|
||||
public Mono<ResponseEntity<List<SwaggerResource>>> swaggerResources() {
|
||||
return Mono.just((new ResponseEntity<>(swaggerResources.get(), HttpStatus.OK)));
|
||||
}
|
||||
|
||||
@GetMapping("/configuration/security")
|
||||
public Mono<ResponseEntity<SecurityConfiguration>> securityConfiguration() {
|
||||
return Mono.just(new ResponseEntity<>(Optional.ofNullable(securityConfiguration)
|
||||
.orElse(SecurityConfigurationBuilder.builder().build()), HttpStatus.OK));
|
||||
}
|
||||
|
||||
@GetMapping("/configuration/ui")
|
||||
public Mono<ResponseEntity<UiConfiguration>> uiConfiguration() {
|
||||
return Mono.just(new ResponseEntity<>(Optional.ofNullable(uiConfiguration)
|
||||
.orElse(UiConfigurationBuilder.builder().build()), HttpStatus.OK));
|
||||
}
|
||||
|
||||
}
|
||||
//package cn.iocoder.yudao.gateway.swagger;
|
||||
//
|
||||
//
|
||||
//import org.springframework.beans.factory.annotation.Autowired;
|
||||
//import org.springframework.http.HttpStatus;
|
||||
//import org.springframework.http.ResponseEntity;
|
||||
//import org.springframework.web.bind.annotation.GetMapping;
|
||||
//import org.springframework.web.bind.annotation.RequestMapping;
|
||||
//import org.springframework.web.bind.annotation.RestController;
|
||||
//import reactor.core.publisher.Mono;
|
||||
//import springfox.documentation.swagger.web.*;
|
||||
//
|
||||
//import javax.annotation.Resource;
|
||||
//import java.util.List;
|
||||
//import java.util.Optional;
|
||||
//
|
||||
///**
|
||||
// * Swagger Controller
|
||||
// *
|
||||
// * @author zxliu
|
||||
// * @date 2022-10-25 11:24
|
||||
// */
|
||||
//@RestController
|
||||
//@RequestMapping("/swagger-resources")
|
||||
//public class SwaggerHandler {
|
||||
//
|
||||
// @Resource
|
||||
// private SwaggerResourcesProvider swaggerResources;
|
||||
//
|
||||
// @SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection") // 只有 @Autowired 可以实现可选注入
|
||||
// @Autowired(required = false)
|
||||
// private SecurityConfiguration securityConfiguration;
|
||||
// @SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection") // 只有 @Autowired 可以实现可选注入
|
||||
// @Autowired(required = false)
|
||||
// private UiConfiguration uiConfiguration;
|
||||
//
|
||||
// @GetMapping("")
|
||||
// public Mono<ResponseEntity<List<SwaggerResource>>> swaggerResources() {
|
||||
// return Mono.just((new ResponseEntity<>(swaggerResources.get(), HttpStatus.OK)));
|
||||
// }
|
||||
//
|
||||
// @GetMapping("/configuration/security")
|
||||
// public Mono<ResponseEntity<SecurityConfiguration>> securityConfiguration() {
|
||||
// return Mono.just(new ResponseEntity<>(Optional.ofNullable(securityConfiguration)
|
||||
// .orElse(SecurityConfigurationBuilder.builder().build()), HttpStatus.OK));
|
||||
// }
|
||||
//
|
||||
// @GetMapping("/configuration/ui")
|
||||
// public Mono<ResponseEntity<UiConfiguration>> uiConfiguration() {
|
||||
// return Mono.just(new ResponseEntity<>(Optional.ofNullable(uiConfiguration)
|
||||
// .orElse(UiConfigurationBuilder.builder().build()), HttpStatus.OK));
|
||||
// }
|
||||
//
|
||||
//}
|
||||
|
|
|
@ -1,102 +1,102 @@
|
|||
package cn.iocoder.yudao.gateway.swagger;
|
||||
|
||||
import cn.hutool.core.collection.CollUtil;
|
||||
import cn.hutool.core.util.StrUtil;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.cloud.gateway.config.GatewayProperties;
|
||||
import org.springframework.cloud.gateway.handler.predicate.PredicateDefinition;
|
||||
import org.springframework.cloud.gateway.route.RouteDefinition;
|
||||
import org.springframework.cloud.gateway.support.NameUtils;
|
||||
import org.springframework.context.annotation.Primary;
|
||||
import org.springframework.stereotype.Component;
|
||||
import springfox.documentation.swagger.web.SwaggerResource;
|
||||
import springfox.documentation.swagger.web.SwaggerResourcesProvider;
|
||||
|
||||
import javax.annotation.Resource;
|
||||
import java.util.ArrayList;
|
||||
import java.util.HashSet;
|
||||
import java.util.List;
|
||||
import java.util.Set;
|
||||
|
||||
/**
|
||||
* Swagger 资源的 Provider 实现类
|
||||
*
|
||||
* @author zxliu
|
||||
* @date 2022-10-25 11:23
|
||||
*/
|
||||
@Component
|
||||
@Primary
|
||||
@Slf4j
|
||||
public class SwaggerProvider implements SwaggerResourcesProvider {
|
||||
|
||||
@Resource
|
||||
private GatewayProperties gatewayProperties;
|
||||
|
||||
/**
|
||||
* 获得 SwaggerResource 列表
|
||||
*
|
||||
* @return SwaggerResource 列表
|
||||
*/
|
||||
@Override
|
||||
public List<SwaggerResource> get() {
|
||||
// 将 RouteDefinition 转换成 SwaggerResource
|
||||
List<SwaggerResource> resources = new ArrayList<>();
|
||||
Set<String> serviceNames = new HashSet<>(); // 已处理的服务名,避免重复
|
||||
gatewayProperties.getRoutes().forEach(route -> {
|
||||
// 已存在的服务,直接忽略
|
||||
String serviceName = route.getUri().getHost();
|
||||
if (StrUtil.isEmpty(serviceName)) {
|
||||
return;
|
||||
}
|
||||
if (!serviceNames.add(serviceName)) {
|
||||
return;
|
||||
}
|
||||
|
||||
// 获得 Path PredicateDefinition
|
||||
String path = getRoutePath(route);
|
||||
if (path == null) {
|
||||
return;
|
||||
}
|
||||
|
||||
// 重要:构建最终的 SwaggerResource 对象
|
||||
resources.add(buildSwaggerResource(serviceName, path));
|
||||
});
|
||||
return resources;
|
||||
}
|
||||
|
||||
private SwaggerResource buildSwaggerResource(String name, String location) {
|
||||
SwaggerResource swaggerResource = new SwaggerResource();
|
||||
swaggerResource.setName(name);
|
||||
swaggerResource.setLocation(location);
|
||||
swaggerResource.setSwaggerVersion("2.0");
|
||||
return swaggerResource;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获得路由的 Path
|
||||
*
|
||||
* ① 输入:
|
||||
* predicates:
|
||||
* - Path=/admin-api/system/**
|
||||
* ② 输出:
|
||||
* /admin-api/system/v2/api-docs
|
||||
*
|
||||
* @param route 路由
|
||||
* @return 路由
|
||||
*/
|
||||
private String getRoutePath(RouteDefinition route) {
|
||||
PredicateDefinition pathDefinition = CollUtil.findOne(route.getPredicates(),
|
||||
predicateDefinition -> "Path".equals(predicateDefinition.getName()));
|
||||
if (pathDefinition == null) {
|
||||
log.info("[get][Route({}) 没有 Path 条件,忽略接口文档]", route.getId());
|
||||
return null;
|
||||
}
|
||||
String path = pathDefinition.getArgs().get(NameUtils.GENERATED_NAME_PREFIX + "0");
|
||||
if (StrUtil.isEmpty(path)) {
|
||||
log.info("[get][Route({}) Path 的值为空,忽略接口文档]", route.getId());
|
||||
return null;
|
||||
}
|
||||
return path.replace("/**", "/v2/api-docs");
|
||||
}
|
||||
|
||||
}
|
||||
//package cn.iocoder.yudao.gateway.swagger;
|
||||
//
|
||||
//import cn.hutool.core.collection.CollUtil;
|
||||
//import cn.hutool.core.util.StrUtil;
|
||||
//import lombok.extern.slf4j.Slf4j;
|
||||
//import org.springframework.cloud.gateway.config.GatewayProperties;
|
||||
//import org.springframework.cloud.gateway.handler.predicate.PredicateDefinition;
|
||||
//import org.springframework.cloud.gateway.route.RouteDefinition;
|
||||
//import org.springframework.cloud.gateway.support.NameUtils;
|
||||
//import org.springframework.context.annotation.Primary;
|
||||
//import org.springframework.stereotype.Component;
|
||||
//import springfox.documentation.swagger.web.SwaggerResource;
|
||||
//import springfox.documentation.swagger.web.SwaggerResourcesProvider;
|
||||
//
|
||||
//import javax.annotation.Resource;
|
||||
//import java.util.ArrayList;
|
||||
//import java.util.HashSet;
|
||||
//import java.util.List;
|
||||
//import java.util.Set;
|
||||
//
|
||||
///**
|
||||
// * Swagger 资源的 Provider 实现类
|
||||
// *
|
||||
// * @author zxliu
|
||||
// * @date 2022-10-25 11:23
|
||||
// */
|
||||
//@Component
|
||||
//@Primary
|
||||
//@Slf4j
|
||||
//public class SwaggerProvider implements SwaggerResourcesProvider {
|
||||
//
|
||||
// @Resource
|
||||
// private GatewayProperties gatewayProperties;
|
||||
//
|
||||
// /**
|
||||
// * 获得 SwaggerResource 列表
|
||||
// *
|
||||
// * @return SwaggerResource 列表
|
||||
// */
|
||||
// @Override
|
||||
// public List<SwaggerResource> get() {
|
||||
// // 将 RouteDefinition 转换成 SwaggerResource
|
||||
// List<SwaggerResource> resources = new ArrayList<>();
|
||||
// Set<String> serviceNames = new HashSet<>(); // 已处理的服务名,避免重复
|
||||
// gatewayProperties.getRoutes().forEach(route -> {
|
||||
// // 已存在的服务,直接忽略
|
||||
// String serviceName = route.getUri().getHost();
|
||||
// if (StrUtil.isEmpty(serviceName)) {
|
||||
// return;
|
||||
// }
|
||||
// if (!serviceNames.add(serviceName)) {
|
||||
// return;
|
||||
// }
|
||||
//
|
||||
// // 获得 Path PredicateDefinition
|
||||
// String path = getRoutePath(route);
|
||||
// if (path == null) {
|
||||
// return;
|
||||
// }
|
||||
//
|
||||
// // 重要:构建最终的 SwaggerResource 对象
|
||||
// resources.add(buildSwaggerResource(serviceName, path));
|
||||
// });
|
||||
// return resources;
|
||||
// }
|
||||
//
|
||||
// private SwaggerResource buildSwaggerResource(String name, String location) {
|
||||
// SwaggerResource swaggerResource = new SwaggerResource();
|
||||
// swaggerResource.setName(name);
|
||||
// swaggerResource.setLocation(location);
|
||||
// swaggerResource.setSwaggerVersion("2.0");
|
||||
// return swaggerResource;
|
||||
// }
|
||||
//
|
||||
// /**
|
||||
// * 获得路由的 Path
|
||||
// *
|
||||
// * ① 输入:
|
||||
// * predicates:
|
||||
// * - Path=/admin-api/system/**
|
||||
// * ② 输出:
|
||||
// * /admin-api/system/v2/api-docs
|
||||
// *
|
||||
// * @param route 路由
|
||||
// * @return 路由
|
||||
// */
|
||||
// private String getRoutePath(RouteDefinition route) {
|
||||
// PredicateDefinition pathDefinition = CollUtil.findOne(route.getPredicates(),
|
||||
// predicateDefinition -> "Path".equals(predicateDefinition.getName()));
|
||||
// if (pathDefinition == null) {
|
||||
// log.info("[get][Route({}) 没有 Path 条件,忽略接口文档]", route.getId());
|
||||
// return null;
|
||||
// }
|
||||
// String path = pathDefinition.getArgs().get(NameUtils.GENERATED_NAME_PREFIX + "0");
|
||||
// if (StrUtil.isEmpty(path)) {
|
||||
// log.info("[get][Route({}) Path 的值为空,忽略接口文档]", route.getId());
|
||||
// return null;
|
||||
// }
|
||||
// return path.replace("/**", "/v2/api-docs");
|
||||
// }
|
||||
//
|
||||
//}
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.form;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
/**
|
||||
|
@ -15,7 +15,7 @@ public class BpmFormBaseVO {
|
|||
@NotNull(message = "表单名称不能为空")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "表单状态", required = true, notes = "参见 CommonStatusEnum 枚举", example = "1")
|
||||
@Schema(description = "表单状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "表单状态不能为空")
|
||||
private Integer status;
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.form;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
import javax.validation.constraints.NotNull;
|
||||
import java.util.List;
|
||||
|
@ -12,11 +12,11 @@ import java.util.List;
|
|||
@ToString(callSuper = true)
|
||||
public class BpmFormCreateReqVO extends BpmFormBaseVO {
|
||||
|
||||
@Schema(description = "表单的配置", required = true, notes = "JSON 字符串")
|
||||
@Schema(description = "表单的配置,JSON 字符串", required = true)
|
||||
@NotNull(message = "表单的配置不能为空")
|
||||
private String conf;
|
||||
|
||||
@Schema(description = "表单项的数组", required = true, notes = "JSON 字符串的数组")
|
||||
@Schema(description = "表单项的数组,JSON 字符串的数组", required = true)
|
||||
@NotNull(message = "表单项的数组不能为空")
|
||||
private List<String> fields;
|
||||
|
||||
|
|
|
@ -19,11 +19,11 @@ public class BpmFormRespVO extends BpmFormBaseVO {
|
|||
@Schema(description = "表单编号", required = true, example = "1024")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "表单的配置", required = true, notes = "JSON 字符串")
|
||||
@Schema(description = "表单的配置,JSON 字符串", required = true)
|
||||
@NotNull(message = "表单的配置不能为空")
|
||||
private String conf;
|
||||
|
||||
@Schema(description = "表单项的数组", required = true, notes = "JSON 字符串的数组")
|
||||
@Schema(description = "表单项的数组,JSON 字符串的数组", required = true)
|
||||
@NotNull(message = "表单项的数组不能为空")
|
||||
private List<String> fields;
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.form;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
import java.util.List;
|
||||
|
||||
|
@ -15,11 +15,11 @@ public class BpmFormUpdateReqVO extends BpmFormBaseVO {
|
|||
@NotNull(message = "表单编号不能为空")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "表单的配置", required = true, notes = "JSON 字符串")
|
||||
@Schema(description = "表单的配置,JSON 字符串", required = true)
|
||||
@NotNull(message = "表单的配置不能为空")
|
||||
private String conf;
|
||||
|
||||
@Schema(description = "表单项的数组", required = true, notes = "JSON 字符串的数组")
|
||||
@Schema(description = "表单项的数组,JSON 字符串的数组", required = true)
|
||||
@NotNull(message = "表单项的数组不能为空")
|
||||
private List<String> fields;
|
||||
|
||||
|
|
|
@ -1,8 +1,8 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.group;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
/**
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.group;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
@Schema(description = "管理后台 - 用户组创建 Request VO")
|
||||
@Data
|
||||
|
|
|
@ -1,10 +1,9 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.group;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
@Schema(description = "管理后台 - 用户组 Response VO")
|
||||
@Data
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.definition.vo.group;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
@Schema(description = "管理后台 - 用户组更新 Request VO")
|
||||
|
|
|
@ -9,7 +9,7 @@ import org.springframework.web.multipart.MultipartFile;
|
|||
|
||||
import javax.validation.constraints.NotNull;
|
||||
|
||||
@Schema(description = value = "管理后台 - 流程模型的导入 Request VO", description = "相比流程模型的新建来说,只是多了一个 bpmnFile 文件")
|
||||
@Schema(description = "管理后台 - 流程模型的导入 Request VO,相比流程模型的新建来说,只是多了一个 bpmnFile 文件")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@ToString(callSuper = true)
|
||||
|
|
|
@ -23,19 +23,17 @@ public class BpmModelBaseVO {
|
|||
@Schema(description = "流程描述", example = "我是描述")
|
||||
private String description;
|
||||
|
||||
@Schema(description = "流程分类", notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", example = "1")
|
||||
@NotEmpty(message = "流程分类不能为空")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "表单类型", notes = "参见 bpm_model_form_type 数据字典", example = "1")
|
||||
@Schema(description = "表单类型,参见 bpm_model_form_type 数据字典", example = "1")
|
||||
private Integer formType;
|
||||
@Schema(description = "表单编号", example = "1024", notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单编号,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "1024")
|
||||
private Long formId;
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/create",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/create")
|
||||
private String formCustomCreatePath;
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/view",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/view" )
|
||||
private String formCustomViewPath;
|
||||
|
||||
}
|
|
@ -41,7 +41,7 @@ public class BpmModelPageItemRespVO extends BpmModelBaseVO {
|
|||
@Schema(description = "部署时间", required = true)
|
||||
private LocalDateTime deploymentTime;
|
||||
|
||||
@Schema(description = "中断状态", required = true, example = "1", notes = "参见 SuspensionState 枚举")
|
||||
@Schema(description = "中断状态,参见 SuspensionState 枚举", required = true, example = "1")
|
||||
private Integer suspensionState;
|
||||
|
||||
}
|
||||
|
|
|
@ -14,13 +14,13 @@ import lombok.ToString;
|
|||
@ToString(callSuper = true)
|
||||
public class BpmModelPageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "标识", example = "process1641042089407", notes = "精准匹配")
|
||||
@Schema(description = "标识,精准匹配", example = "process1641042089407")
|
||||
private String key;
|
||||
|
||||
@Schema(description = "名字", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "名字,精准匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "流程分类", notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", example = "1")
|
||||
private String category;
|
||||
|
||||
}
|
|
@ -20,21 +20,19 @@ public class BpmModelUpdateReqVO {
|
|||
@Schema(description = "流程描述", example = "我是描述")
|
||||
private String description;
|
||||
|
||||
@Schema(description = "流程分类", notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", example = "1")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "BPMN XML", required = true)
|
||||
private String bpmnXml;
|
||||
|
||||
@Schema(description = "表单类型", notes = "参见 bpm_model_form_type 数据字典", example = "1")
|
||||
@Schema(description = "表单类型,参见 bpm_model_form_type 数据字典", example = "1")
|
||||
private Integer formType;
|
||||
@Schema(description = "表单编号", example = "1024", notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单编号,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "1024")
|
||||
private Long formId;
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/create",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/create")
|
||||
private String formCustomCreatePath;
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/view",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/view" )
|
||||
private String formCustomViewPath;
|
||||
|
||||
}
|
|
@ -14,7 +14,7 @@ public class BpmModelUpdateStateReqVO {
|
|||
@NotNull(message = "编号不能为空")
|
||||
private String id;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "见 SuspensionState 枚举")
|
||||
@Schema(description = "状态,见 SuspensionState 枚举", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
private Integer state;
|
||||
|
||||
|
|
|
@ -13,7 +13,7 @@ import lombok.ToString;
|
|||
@EqualsAndHashCode(callSuper = true)
|
||||
public class BpmProcessDefinitionListReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "中断状态", example = "1", notes = "参见 SuspensionState 枚举")
|
||||
@Schema(description = "中断状态,参见 SuspensionState 枚举", example = "1")
|
||||
private Integer suspensionState;
|
||||
|
||||
}
|
|
@ -13,7 +13,7 @@ import lombok.ToString;
|
|||
@EqualsAndHashCode(callSuper = true)
|
||||
public class BpmProcessDefinitionPageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "标识", example = "process1641042089407", notes = "精准匹配")
|
||||
@Schema(description = "标识,精准匹配", example = "process1641042089407")
|
||||
private String key;
|
||||
|
||||
}
|
|
@ -25,28 +25,24 @@ public class BpmProcessDefinitionRespVO {
|
|||
@Schema(description = "流程描述", example = "我是描述")
|
||||
private String description;
|
||||
|
||||
@Schema(description = "流程分类", notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", example = "1")
|
||||
@NotEmpty(message = "流程分类不能为空")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "表单类型", notes = "参见 bpm_model_form_type 数据字典", example = "1")
|
||||
@Schema(description = "表单类型,参见 bpm_model_form_type 数据字典", example = "1")
|
||||
private Integer formType;
|
||||
@Schema(description = "表单编号", example = "1024", notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单编号,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "1024")
|
||||
private Long formId;
|
||||
@Schema(description = "表单的配置", required = true,
|
||||
notes = "JSON 字符串。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单的配置,JSON 字符串。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", required = true )
|
||||
private String formConf;
|
||||
@Schema(description = "表单项的数组", required = true,
|
||||
notes = "JSON 字符串的数组。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单项的数组,JSON 字符串的数组。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", required = true )
|
||||
private List<String> formFields;
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/create",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/create" )
|
||||
private String formCustomCreatePath;
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/view",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/view")
|
||||
private String formCustomViewPath;
|
||||
|
||||
@Schema(description = "中断状态", required = true, example = "1", notes = "参见 SuspensionState 枚举")
|
||||
@Schema(description = "中断状态,参见 SuspensionState 枚举", required = true, example = "1")
|
||||
private Integer suspensionState;
|
||||
|
||||
}
|
|
@ -25,7 +25,7 @@ public class BpmOALeaveBaseVO {
|
|||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
private LocalDateTime endTime;
|
||||
|
||||
@Schema(description = "请假类型", required = true, example = "1", notes = "参见 bpm_oa_type 枚举")
|
||||
@Schema(description = "请假类型,参见 bpm_oa_type 枚举", required = true, example = "1")
|
||||
private Integer type;
|
||||
|
||||
@Schema(description = "原因", required = true, example = "阅读芋道源码")
|
||||
|
|
|
@ -1,13 +1,13 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.oa.vo;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.ToString;
|
||||
|
||||
import javax.validation.constraints.AssertTrue;
|
||||
|
||||
@ApiModel("管理后台 - 请假申请创建 Request VO")
|
||||
@Schema(description = "管理后台 - 请假申请创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@ToString(callSuper = true)
|
||||
|
|
|
@ -1,8 +1,8 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.oa.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import cn.iocoder.yudao.framework.common.pojo.PageParam;
|
||||
import org.springframework.format.annotation.DateTimeFormat;
|
||||
|
||||
|
@ -14,13 +14,13 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@ToString(callSuper = true)
|
||||
public class BpmOALeavePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "状态", example = "1", notes = "参见 bpm_process_instance_result 枚举")
|
||||
@Schema(description = "状态,参见 bpm_process_instance_result 枚举", example = "1")
|
||||
private Integer result;
|
||||
|
||||
@Schema(description = "请假类型", example = "1", notes = "参见 bpm_oa_type")
|
||||
@Schema(description = "请假类型,参见 bpm_oa_type", example = "1")
|
||||
private Integer type;
|
||||
|
||||
@Schema(description = "原因", example = "阅读芋道源码", notes = "模糊匹配")
|
||||
@Schema(description = "原因,模糊匹配", example = "阅读芋道源码")
|
||||
private String reason;
|
||||
|
||||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.bpm.controller.admin.oa.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import org.springframework.format.annotation.DateTimeFormat;
|
||||
|
||||
import javax.validation.constraints.NotNull;
|
||||
|
@ -18,7 +18,7 @@ public class BpmOALeaveRespVO extends BpmOALeaveBaseVO {
|
|||
@Schema(description = "请假表单主键", required = true, example = "1024")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 bpm_process_instance_result 枚举")
|
||||
@Schema(description = "状态,参见 bpm_process_instance_result 枚举", required = true, example = "1")
|
||||
private Integer result;
|
||||
|
||||
@Schema(description = "申请时间", required = true)
|
||||
|
|
|
@ -28,8 +28,7 @@ public class BpmActivityController {
|
|||
private BpmActivityService activityService;
|
||||
|
||||
@GetMapping("/list")
|
||||
@Operation(summary = "生成指定流程实例的高亮流程图",
|
||||
notes = "只高亮进行中的任务。不过要注意,该接口暂时没用,通过前端的 ProcessViewer.vue 界面的 highlightDiagram 方法生成")
|
||||
@Operation(summary = "生成指定流程实例的高亮流程图,只高亮进行中的任务。不过要注意,该接口暂时没用,通过前端的 ProcessViewer.vue 界面的 highlightDiagram 方法生成")
|
||||
@Parameter(name = "processInstanceId", description = "流程实例的编号", required = true)
|
||||
@PreAuthorize("@ss.hasPermission('bpm:task:query')")
|
||||
public CommonResult<List<BpmActivityRespVO>> getActivityList(
|
||||
|
|
|
@ -20,7 +20,7 @@ public class BpmActivityRespVO {
|
|||
@Schema(description = "流程活动的结束时间", required = true)
|
||||
private LocalDateTime endTime;
|
||||
|
||||
@Schema(description = "关联的流程任务的编号", example = "2048", notes = "关联的流程任务,只有 UserTask 等类型才有")
|
||||
@Schema(description = "关联的流程任务的编号,关联的流程任务,只有 UserTask 等类型才有", example = "2048")
|
||||
private String taskId;
|
||||
|
||||
}
|
|
@ -24,13 +24,13 @@ public class BpmProcessInstanceMyPageReqVO extends PageParam {
|
|||
@Schema(description = "流程定义的编号", example = "2048")
|
||||
private String processDefinitionId;
|
||||
|
||||
@Schema(description = "流程实例的状态", notes = "参见 bpm_process_instance_status", example = "1")
|
||||
@Schema(description = "流程实例的状态,参见 bpm_process_instance_status", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "流程实例的结果", notes = "参见 bpm_process_instance_result", example = "2")
|
||||
@Schema(description = "流程实例的结果,参见 bpm_process_instance_result", example = "2")
|
||||
private Integer result;
|
||||
|
||||
@Schema(description = "流程分类", notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", example = "1")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "创建时间")
|
||||
|
|
|
@ -20,13 +20,13 @@ public class BpmProcessInstancePageItemRespVO {
|
|||
@Schema(description = "流程定义的编号", required = true, example = "2048")
|
||||
private String processDefinitionId;
|
||||
|
||||
@Schema(description = "流程分类", required = true, notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", required = true, example = "1")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "流程实例的状态", required = true, notes = "参见 bpm_process_instance_status", example = "1")
|
||||
@Schema(description = "流程实例的状态,参见 bpm_process_instance_status", required = true, example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "流程实例的结果", required = true, notes = "参见 bpm_process_instance_result", example = "2")
|
||||
@Schema(description = "流程实例的结果,参见 bpm_process_instance_result", required = true, example = "2")
|
||||
private Integer result;
|
||||
|
||||
@Schema(description = "提交时间", required = true)
|
||||
|
|
|
@ -18,13 +18,13 @@ public class BpmProcessInstanceRespVO {
|
|||
@Schema(description = "流程名称", required = true, example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "流程分类", required = true, notes = "参见 bpm_model_category 数据字典", example = "1")
|
||||
@Schema(description = "流程分类,参见 bpm_model_category 数据字典", required = true, example = "1")
|
||||
private String category;
|
||||
|
||||
@Schema(description = "流程实例的状态", required = true, notes = "参见 bpm_process_instance_status", example = "1")
|
||||
@Schema(description = "流程实例的状态,参见 bpm_process_instance_status", required = true, example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "流程实例的结果", required = true, notes = "参见 bpm_process_instance_result", example = "2")
|
||||
@Schema(description = "流程实例的结果,参见 bpm_process_instance_result", required = true, example = "2")
|
||||
private Integer result;
|
||||
|
||||
@Schema(description = "提交时间", required = true)
|
||||
|
@ -36,7 +36,7 @@ public class BpmProcessInstanceRespVO {
|
|||
@Schema(description = "提交的表单值", required = true)
|
||||
private Map<String, Object> formVariables;
|
||||
|
||||
@Schema(description = "业务的唯一标识", example = "1", notes = "例如说,请假申请的编号")
|
||||
@Schema(description = "业务的唯一标识,例如说,请假申请的编号", example = "1")
|
||||
private String businessKey;
|
||||
|
||||
/**
|
||||
|
@ -72,21 +72,17 @@ public class BpmProcessInstanceRespVO {
|
|||
@Schema(description = "编号", required = true, example = "1024")
|
||||
private String id;
|
||||
|
||||
@Schema(description = "表单类型", notes = "参见 bpm_model_form_type 数据字典", example = "1")
|
||||
@Schema(description = "表单类型,参见 bpm_model_form_type 数据字典", example = "1")
|
||||
private Integer formType;
|
||||
@Schema(description = "表单编号", example = "1024", notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单编号,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "1024")
|
||||
private Long formId;
|
||||
@Schema(description = "表单的配置", required = true,
|
||||
notes = "JSON 字符串。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单的配置,JSON 字符串。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", required = true)
|
||||
private String formConf;
|
||||
@Schema(description = "表单项的数组", required = true,
|
||||
notes = "JSON 字符串的数组。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "表单项的数组,JSON 字符串的数组。在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", required = true)
|
||||
private List<String> formFields;
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/create",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的提交路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/create")
|
||||
private String formCustomCreatePath;
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址", example = "/bpm/oa/leave/view",
|
||||
notes = "在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空")
|
||||
@Schema(description = "自定义表单的查看路径,使用 Vue 的路由地址,在表单类型为 {@link BpmModelFormTypeEnum#CUSTOM} 时,必须非空", example = "/bpm/oa/leave/view")
|
||||
private String formCustomViewPath;
|
||||
|
||||
@Schema(description = "BPMN XML", required = true)
|
||||
|
|
|
@ -19,7 +19,7 @@ public class BpmTaskDonePageItemRespVO extends BpmTaskTodoPageItemRespVO {
|
|||
@Schema(description = "持续时间", required = true, example = "1000")
|
||||
private Long durationInMillis;
|
||||
|
||||
@Schema(description = "任务结果", required = true, notes = "参见 bpm_process_instance_result", example = "2")
|
||||
@Schema(description = "任务结果,参见 bpm_process_instance_result", required = true, example = "2")
|
||||
private Integer result;
|
||||
@Schema(description = "审批建议", required = true, example = "不请假了!")
|
||||
private String reason;
|
||||
|
|
|
@ -22,7 +22,7 @@ public class BpmTaskTodoPageItemRespVO {
|
|||
@Schema(description = "创建时间", required = true)
|
||||
private LocalDateTime createTime;
|
||||
|
||||
@Schema(description = "激活状态", required = true, example = "1", notes = "参见 SuspensionState 枚举")
|
||||
@Schema(description = "激活状态,参见 SuspensionState 枚举", required = true, example = "1")
|
||||
private Integer suspensionState;
|
||||
|
||||
/**
|
||||
|
|
|
@ -12,10 +12,10 @@ import java.util.List;
|
|||
@Data
|
||||
public class CodegenDetailRespVO {
|
||||
|
||||
@ApiModelProperty("表定义")
|
||||
@Schema(description = "表定义")
|
||||
private CodegenTableRespVO table;
|
||||
|
||||
@ApiModelProperty("字段定义")
|
||||
@Schema(description = "字段定义")
|
||||
private List<CodegenColumnRespVO> columns;
|
||||
|
||||
}
|
|
@ -4,7 +4,7 @@ import io.swagger.v3.oas.annotations.media.Schema;
|
|||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
|
||||
@Schema(description = value = "管理后台 - 代码生成预览 Response VO", description ="注意,每个文件都是一个该对象")
|
||||
@Schema(description = "管理后台 - 代码生成预览 Response VO,注意,每个文件都是一个该对象")
|
||||
@Data
|
||||
public class CodegenPreviewRespVO {
|
||||
|
||||
|
|
|
@ -70,7 +70,7 @@ public class CodegenColumnBaseVO {
|
|||
@NotNull(message = "是否为 List 查询操作的字段不能为空")
|
||||
private Boolean listOperation;
|
||||
|
||||
@Schema(description = "List 查询操作的条件类型", required = true, example = "LIKE", notes = "参见 CodegenColumnListConditionEnum 枚举")
|
||||
@Schema(description = "List 查询操作的条件类型,参见 CodegenColumnListConditionEnum 枚举", required = true, example = "LIKE")
|
||||
@NotNull(message = "List 查询操作的条件类型不能为空")
|
||||
private String listOperationCondition;
|
||||
|
||||
|
|
|
@ -12,7 +12,7 @@ import javax.validation.constraints.NotNull;
|
|||
@Data
|
||||
public class CodegenTableBaseVO {
|
||||
|
||||
@Schema(description = "生成场景", required = true, example = "1", notes = "参见 CodegenSceneEnum 枚举")
|
||||
@Schema(description = "生成场景,参见 CodegenSceneEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "导入类型不能为空")
|
||||
private Integer scene;
|
||||
|
||||
|
@ -47,7 +47,7 @@ public class CodegenTableBaseVO {
|
|||
@NotNull(message = "作者不能为空")
|
||||
private String author;
|
||||
|
||||
@Schema(description = "模板类型", required = true, example = "1", notes = "参见 CodegenTemplateTypeEnum 枚举")
|
||||
@Schema(description = "模板类型,参见 CodegenTemplateTypeEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "模板类型不能为空")
|
||||
private Integer templateType;
|
||||
|
||||
|
|
|
@ -18,10 +18,10 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@ToString(callSuper = true)
|
||||
public class CodegenTablePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "表名称", example = "yudao", notes = "模糊匹配")
|
||||
@Schema(description = "表名称,模糊匹配", example = "yudao")
|
||||
private String tableName;
|
||||
|
||||
@Schema(description = "表描述", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "表描述,模糊匹配", example = "芋道")
|
||||
private String tableComment;
|
||||
|
||||
@Schema(description = "创建时间", example = "[2022-07-01 00:00:00, 2022-07-01 23:59:59]")
|
||||
|
|
|
@ -16,10 +16,10 @@ public class ConfigExportReqVO {
|
|||
@Schema(description = "参数名称", example = "模糊匹配")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "参数键名", example = "yunai.db.username", notes = "模糊匹配")
|
||||
@Schema(description = "参数键名,模糊匹配", example = "yunai.db.username")
|
||||
private String key;
|
||||
|
||||
@Schema(description = "参数类型", example = "1", notes = "参见 SysConfigTypeEnum 枚举")
|
||||
@Schema(description = "参数类型,参见 SysConfigTypeEnum 枚举", example = "1")
|
||||
private Integer type;
|
||||
|
||||
@Schema(description = "创建时间", example = "[2022-07-01 00:00:00,2022-07-01 23:59:59]")
|
||||
|
|
|
@ -21,10 +21,10 @@ public class ConfigPageReqVO extends PageParam {
|
|||
@Schema(description = "数据源名称", example = "模糊匹配")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "参数键名", example = "yunai.db.username", notes = "模糊匹配")
|
||||
@Schema(description = "参数键名,模糊匹配", example = "yunai.db.username")
|
||||
private String key;
|
||||
|
||||
@Schema(description = "参数类型", example = "1", notes = "参见 SysConfigTypeEnum 枚举")
|
||||
@Schema(description = "参数类型,参见 SysConfigTypeEnum 枚举", example = "1")
|
||||
private Integer type;
|
||||
|
||||
@Schema(description = "创建时间", example = "[2022-07-01 00:00:00,2022-07-01 23:59:59]")
|
||||
|
|
|
@ -22,7 +22,7 @@ public class ConfigRespVO extends ConfigBaseVO {
|
|||
@Size(max = 100, message = "参数键名长度不能超过100个字符")
|
||||
private String key;
|
||||
|
||||
@Schema(description = "参数类型", required = true, example = "1", notes = "参见 SysConfigTypeEnum 枚举")
|
||||
@Schema(description = "参数类型,参见 SysConfigTypeEnum 枚举", required = true, example = "1")
|
||||
private Integer type;
|
||||
|
||||
@Schema(description = "创建时间", required = true, example = "时间戳格式")
|
||||
|
|
|
@ -43,8 +43,7 @@ public class DatabaseDocController {
|
|||
|
||||
@GetMapping("/export-html")
|
||||
@Operation(summary = "导出 html 格式的数据文档")
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true",
|
||||
dataTypeClass = Boolean.class)
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true")
|
||||
public void exportHtml(@RequestParam(defaultValue = "true") Boolean deleteFile,
|
||||
HttpServletResponse response) throws IOException {
|
||||
doExportFile(EngineFileType.HTML, deleteFile, response);
|
||||
|
@ -52,8 +51,7 @@ public class DatabaseDocController {
|
|||
|
||||
@GetMapping("/export-word")
|
||||
@Operation(summary = "导出 word 格式的数据文档")
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true",
|
||||
dataTypeClass = Boolean.class)
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true")
|
||||
public void exportWord(@RequestParam(defaultValue = "true") Boolean deleteFile,
|
||||
HttpServletResponse response) throws IOException {
|
||||
doExportFile(EngineFileType.WORD, deleteFile, response);
|
||||
|
@ -61,8 +59,7 @@ public class DatabaseDocController {
|
|||
|
||||
@GetMapping("/export-markdown")
|
||||
@Operation(summary = "导出 markdown 格式的数据文档")
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true",
|
||||
dataTypeClass = Boolean.class)
|
||||
@Parameter(name = "deleteFile", description = "是否删除在服务器本地生成的数据库文档", example = "true")
|
||||
public void exportMarkdown(@RequestParam(defaultValue = "true") Boolean deleteFile,
|
||||
HttpServletResponse response) throws IOException {
|
||||
doExportFile(EngineFileType.MD, deleteFile, response);
|
||||
|
|
|
@ -1,8 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.db.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
/**
|
||||
|
|
|
@ -1,8 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.db.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
@Schema(description = "管理后台 - 数据源配置创建 Request VO")
|
||||
|
|
|
@ -1,10 +1,9 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.db.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
@Schema(description = "管理后台 - 数据源配置 Response VO")
|
||||
@Data
|
||||
|
|
|
@ -1,8 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.db.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
@Schema(description = "管理后台 - 数据源配置更新 Request VO")
|
||||
|
|
|
@ -15,11 +15,11 @@ import java.util.Map;
|
|||
@ToString(callSuper = true)
|
||||
public class FileConfigCreateReqVO extends FileConfigBaseVO {
|
||||
|
||||
@Schema(description = "存储器", required = true, example = "1", notes = "参见 FileStorageEnum 枚举类")
|
||||
@Schema(description = "存储器,参见 FileStorageEnum 枚举类", required = true, example = "1")
|
||||
@NotNull(message = "存储器不能为空")
|
||||
private Integer storage;
|
||||
|
||||
@Schema(description = "存储配置", required = true, notes = "配置是动态参数,所以使用 Map 接收")
|
||||
@Schema(description = "存储配置,配置是动态参数,所以使用 Map 接收", required = true)
|
||||
@NotNull(message = "存储配置不能为空")
|
||||
private Map<String, Object> config;
|
||||
|
||||
|
|
|
@ -19,7 +19,7 @@ public class FileConfigRespVO extends FileConfigBaseVO {
|
|||
@Schema(description = "编号", required = true, example = "1")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "存储器", required = true, example = "1", notes = "参见 FileStorageEnum 枚举类")
|
||||
@Schema(description = "存储器,参见 FileStorageEnum 枚举类", required = true, example = "1")
|
||||
@NotNull(message = "存储器不能为空")
|
||||
private Integer storage;
|
||||
|
||||
|
|
|
@ -19,7 +19,7 @@ public class FileConfigUpdateReqVO extends FileConfigBaseVO {
|
|||
@NotNull(message = "编号不能为空")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "存储配置", required = true, notes = "配置是动态参数,所以使用 Map 接收")
|
||||
@Schema(description = "存储配置,配置是动态参数,所以使用 Map 接收", required = true)
|
||||
@NotNull(message = "存储配置不能为空")
|
||||
private Map<String, Object> config;
|
||||
|
||||
|
|
|
@ -18,10 +18,10 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@ToString(callSuper = true)
|
||||
public class FilePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "文件路径", example = "yudao", notes = "模糊匹配")
|
||||
@Schema(description = "文件路径,模糊匹配", example = "yudao")
|
||||
private String path;
|
||||
|
||||
@Schema(description = "文件类型", example = "jpg", notes = "模糊匹配")
|
||||
@Schema(description = "文件类型,模糊匹配", example = "jpg")
|
||||
private String type;
|
||||
|
||||
@Schema(description = "创建时间", example = "[2022-07-01 00:00:00, 2022-07-01 23:59:59]")
|
||||
|
|
|
@ -6,7 +6,7 @@ import lombok.Data;
|
|||
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
@Schema(description = value = "管理后台 - 文件 Response VO", description = "不返回 content 字段,太大")
|
||||
@Schema(description = "管理后台 - 文件 Response VO,不返回 content 字段,太大" )
|
||||
@Data
|
||||
public class FileRespVO {
|
||||
|
||||
|
|
|
@ -7,7 +7,7 @@ import org.springframework.web.multipart.MultipartFile;
|
|||
|
||||
import javax.validation.constraints.NotNull;
|
||||
|
||||
@Schema(description = value = "管理后台 - 上传文件 Request VO")
|
||||
@Schema(description = "管理后台 - 上传文件 Request VO")
|
||||
@Data
|
||||
public class FileUploadReqVO {
|
||||
|
||||
|
|
|
@ -24,7 +24,7 @@ public class ApiAccessLogBaseVO {
|
|||
@NotNull(message = "用户编号不能为空")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", required = true, example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", required = true, example = "2")
|
||||
@NotNull(message = "用户类型不能为空")
|
||||
private Integer userType;
|
||||
|
||||
|
|
|
@ -9,7 +9,7 @@ import java.time.LocalDateTime;
|
|||
|
||||
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
|
||||
|
||||
@Schema(description = value = "管理后台 - API 访问日志 Excel 导出 Request VO", description = "参数和 ApiAccessLogPageReqVO 是一致的")
|
||||
@Schema(description = "管理后台 - API 访问日志 Excel 导出 Request VO,参数和 ApiAccessLogPageReqVO 是一致的")
|
||||
@Data
|
||||
public class ApiAccessLogExportReqVO {
|
||||
|
||||
|
@ -22,14 +22,14 @@ public class ApiAccessLogExportReqVO {
|
|||
@Schema(description = "应用名", example = "dashboard")
|
||||
private String applicationName;
|
||||
|
||||
@Schema(description = "请求地址", example = "/xxx/yyy", notes = "模糊匹配")
|
||||
@Schema(description = "请求地址,模糊匹配", example = "/xxx/yyy")
|
||||
private String requestUrl;
|
||||
|
||||
@Schema(description = "开始时间", example = "[2022-07-01 00:00:00, 2022-07-01 23:59:59]")
|
||||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
private LocalDateTime[] beginTime;
|
||||
|
||||
@Schema(description = "执行时长", example = "100", notes = "大于等于,单位:毫秒")
|
||||
@Schema(description = "执行时长,大于等于,单位:毫秒", example = "100")
|
||||
private Integer duration;
|
||||
|
||||
@Schema(description = "结果码", example = "0")
|
||||
|
|
|
@ -27,14 +27,14 @@ public class ApiAccessLogPageReqVO extends PageParam {
|
|||
@Schema(description = "应用名", example = "dashboard")
|
||||
private String applicationName;
|
||||
|
||||
@Schema(description = "请求地址", example = "/xxx/yyy", notes = "模糊匹配")
|
||||
@Schema(description = "请求地址,模糊匹配", example = "/xxx/yyy")
|
||||
private String requestUrl;
|
||||
|
||||
@Schema(description = "开始时间", example = "[2022-07-01 00:00:00, 2022-07-01 23:59:59]")
|
||||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
private LocalDateTime[] beginTime;
|
||||
|
||||
@Schema(description = "执行时长", example = "100", notes = "大于等于,单位:毫秒")
|
||||
@Schema(description = "执行时长,大于等于,单位:毫秒", example = "100")
|
||||
private Integer duration;
|
||||
|
||||
@Schema(description = "结果码", example = "0")
|
||||
|
|
|
@ -9,7 +9,7 @@ import java.time.LocalDateTime;
|
|||
|
||||
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
|
||||
|
||||
@Schema(description = value = "管理后台 - API 错误日志 Excel 导出 Request VO", description = "参数和 ApiErrorLogPageReqVO 是一致的")
|
||||
@Schema(description = "管理后台 - API 错误日志 Excel 导出 Request VO,参数和 ApiErrorLogPageReqVO 是一致的")
|
||||
@Data
|
||||
public class ApiErrorLogExportReqVO {
|
||||
|
||||
|
|
|
@ -13,7 +13,7 @@ public class RedisKeyValueRespVO {
|
|||
@Schema(description = "c5f6990767804a928f4bb96ca249febf", required = true, example = "String")
|
||||
private String key;
|
||||
|
||||
@ApiModelProperty(required = true, example = "String")
|
||||
@Schema(required = true, example = "String")
|
||||
private String value;
|
||||
|
||||
}
|
|
@ -15,7 +15,7 @@ import java.util.Properties;
|
|||
@AllArgsConstructor
|
||||
public class RedisMonitorRespVO {
|
||||
|
||||
@Schema(description = "Redis info 指令结果", required = true, notes = "具体字段,查看 Redis 文档")
|
||||
@Schema(description = "Redis info 指令结果,具体字段,查看 Redis 文档", required = true)
|
||||
private Properties info;
|
||||
|
||||
@Schema(description = "Redis key 数量", required = true, example = "1024")
|
||||
|
|
|
@ -69,7 +69,7 @@ public class TestDemoController {
|
|||
|
||||
@GetMapping("/list")
|
||||
@Operation(summary = "获得字典类型列表")
|
||||
@Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048", dataTypeClass = List.class)
|
||||
@Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048")
|
||||
@PreAuthorize("@ss.hasPermission('infra:test-demo:query')")
|
||||
public CommonResult<List<TestDemoRespVO>> getTestDemoList(@RequestParam("ids") Collection<Long> ids) {
|
||||
List<TestDemoDO> list = testDemoService.getTestDemoList(ids);
|
||||
|
|
|
@ -1,8 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.test.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
/**
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.test.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
@Schema(description = "管理后台 - 字典类型创建 Request VO")
|
||||
@Data
|
||||
|
|
|
@ -3,8 +3,6 @@ package cn.iocoder.yudao.module.infra.controller.admin.test.vo;
|
|||
import lombok.*;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
import com.alibaba.excel.annotation.ExcelProperty;
|
||||
|
||||
|
|
|
@ -9,7 +9,7 @@ import java.time.LocalDateTime;
|
|||
|
||||
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
|
||||
|
||||
@Schema(description = value = "管理后台 - 字典类型 Excel 导出 Request VO", description = "参数和 TestDemoPageReqVO 是一致的")
|
||||
@Schema(description = "管理后台 - 字典类型 Excel 导出 Request VO,参数和 TestDemoPageReqVO 是一致的")
|
||||
@Data
|
||||
public class TestDemoExportReqVO {
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.infra.controller.admin.test.vo;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import javax.validation.constraints.*;
|
||||
|
||||
@Schema(description = "管理后台 - 字典类型更新 Request VO")
|
||||
|
|
|
@ -25,13 +25,13 @@ public class AuthMenuRespVO {
|
|||
@Schema(description = "菜单名称", required = true, example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "路由地址", example = "post", notes = "仅菜单类型为菜单或者目录时,才需要传")
|
||||
@Schema(description = "路由地址,仅菜单类型为菜单或者目录时,才需要传", example = "post")
|
||||
private String path;
|
||||
|
||||
@Schema(description = "组件路径", example = "system/post/index", notes = "仅菜单类型为菜单时,才需要传")
|
||||
@Schema(description = "组件路径,仅菜单类型为菜单时,才需要传", example = "system/post/index")
|
||||
private String component;
|
||||
|
||||
@Schema(description = "菜单图标", example = "/menu/list", notes = "仅菜单类型为菜单或者目录时,才需要传")
|
||||
@Schema(description = "菜单图标,仅菜单类型为菜单或者目录时,才需要传", example = "/menu/list")
|
||||
private String icon;
|
||||
|
||||
@Schema(description = "是否可见", required = true, example = "false")
|
||||
|
|
|
@ -8,10 +8,10 @@ import lombok.Data;
|
|||
@Data
|
||||
public class DeptListReqVO {
|
||||
|
||||
@Schema(description = "部门名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "部门名称,模糊匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
}
|
|
@ -15,7 +15,7 @@ public class DeptRespVO extends DeptBaseVO {
|
|||
@Schema(description = "部门编号", required = true, example = "1024")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", required = true, example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "创建时间", required = true, example = "时间戳格式")
|
||||
|
|
|
@ -35,12 +35,12 @@ public class DictDataBaseVO {
|
|||
@Size(max = 100, message = "字典类型长度不能超过100个字符")
|
||||
private String dictType;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,见 CommonStatusEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
// @InEnum(value = CommonStatusEnum.class, message = "修改状态必须是 {value}")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "颜色类型", example = "default", notes = "default、primary、success、info、warning、danger")
|
||||
@Schema(description = "颜色类型,default、primary、success、info、warning、danger", example = "default")
|
||||
private String colorType;
|
||||
@Schema(description = "css 样式", example = "btn-visible")
|
||||
private String cssClass;
|
||||
|
|
|
@ -19,7 +19,7 @@ public class DictTypeBaseVO {
|
|||
@Size(max = 100, message = "字典类型名称长度不能超过100个字符")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
private Integer status;
|
||||
|
||||
|
|
|
@ -13,13 +13,13 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@Data
|
||||
public class DictTypeExportReqVO {
|
||||
|
||||
@Schema(description = "字典类型名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "字典类型名称,模糊匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "字典类型", example = "sys_common_sex", notes = "模糊匹配")
|
||||
@Schema(description = "字典类型,模糊匹配", example = "sys_common_sex")
|
||||
private String type;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
|
|
|
@ -17,14 +17,14 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@EqualsAndHashCode(callSuper = true)
|
||||
public class DictTypePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "字典类型名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "字典类型名称,模糊匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "字典类型", example = "sys_common_sex", notes = "模糊匹配")
|
||||
@Schema(description = "字典类型,模糊匹配", example = "sys_common_sex")
|
||||
@Size(max = 100, message = "字典类型类型长度不能超过100个字符")
|
||||
private String type;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
|
||||
|
|
|
@ -1,11 +1,11 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.mail.vo.account;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.ToString;
|
||||
|
||||
@ApiModel("管理后台 - 邮箱账号创建 Request VO")
|
||||
@Schema(description = "管理后台 - 邮箱账号创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@ToString(callSuper = true)
|
||||
|
|
|
@ -20,7 +20,7 @@ public class MailLogBaseVO {
|
|||
@Schema(description = "用户编号", example = "30883")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", example = "2" )
|
||||
private Byte userType;
|
||||
|
||||
@Schema(description = "接收邮箱地址", required = true, example = "76854@qq.com")
|
||||
|
@ -58,7 +58,7 @@ public class MailLogBaseVO {
|
|||
@NotNull(message = "邮件参数不能为空")
|
||||
private Map<String, Object> templateParams;
|
||||
|
||||
@Schema(description = "发送状态", required = true, example = "1", notes = "参见 MailSendStatusEnum 枚举")
|
||||
@Schema(description = "发送状态,参见 MailSendStatusEnum 枚举", required = true, example = "1" )
|
||||
@NotNull(message = "发送状态不能为空")
|
||||
private Byte sendStatus;
|
||||
|
||||
|
|
|
@ -21,10 +21,10 @@ public class MailLogPageReqVO extends PageParam {
|
|||
@Schema(description = "用户编号", example = "30883")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", example = "2" )
|
||||
private Integer userType;
|
||||
|
||||
@Schema(description = "接收邮箱地址", example = "76854@qq.com", notes = "模糊匹配")
|
||||
@Schema(description = "接收邮箱地址,模糊匹配", example = "76854@qq.com" )
|
||||
private String toMail;
|
||||
|
||||
@Schema(description = "邮箱账号编号", example = "18107")
|
||||
|
@ -33,7 +33,7 @@ public class MailLogPageReqVO extends PageParam {
|
|||
@Schema(description = "模板编号", example = "5678")
|
||||
private Long templateId;
|
||||
|
||||
@Schema(description = "发送状态", example = "1", notes = "参见 MailSendStatusEnum 枚举")
|
||||
@Schema(description = "发送状态,参见 MailSendStatusEnum 枚举", example = "1" )
|
||||
private Integer sendStatus;
|
||||
|
||||
@Schema(description = "发送时间")
|
||||
|
|
|
@ -36,7 +36,7 @@ public class MailTemplateBaseVO {
|
|||
@NotEmpty(message = "内容不能为空")
|
||||
private String content;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1" )
|
||||
@NotNull(message = "状态不能为空")
|
||||
private Integer status;
|
||||
|
||||
|
|
|
@ -1,11 +1,11 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.mail.vo.template;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.ToString;
|
||||
|
||||
@ApiModel("管理后台 - 邮件模版创建 Request VO")
|
||||
@Schema(description = "管理后台 - 邮件模版创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@ToString(callSuper = true)
|
||||
|
|
|
@ -18,13 +18,13 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@ToString(callSuper = true)
|
||||
public class MailTemplatePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "状态", example = "1", notes = "参见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "标识", example = "code_1024", notes = "模糊匹配")
|
||||
@Schema(description = "标识,模糊匹配", example = "code_1024")
|
||||
private String code;
|
||||
|
||||
@Schema(description = "名称", example = "芋头", notes = "模糊匹配")
|
||||
@Schema(description = "名称,模糊匹配", example = "芋头")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "账号编号", example = "2048")
|
||||
|
|
|
@ -26,7 +26,7 @@ public class NoticeBaseVO {
|
|||
@Schema(description = "公告内容", required = true, example = "半生编码")
|
||||
private String content;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", required = true, example = "1")
|
||||
private Integer status;
|
||||
|
||||
}
|
|
@ -1,10 +1,10 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.notice.vo;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
|
||||
@ApiModel("管理后台 - 通知公告创建 Request VO")
|
||||
@Schema(description = "管理后台 - 通知公告创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
public class NoticeCreateReqVO extends NoticeBaseVO {
|
||||
|
|
|
@ -11,10 +11,10 @@ import lombok.EqualsAndHashCode;
|
|||
@EqualsAndHashCode(callSuper = true)
|
||||
public class NoticePageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "通知公告名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "通知公告名称,模糊匹配", example = "芋道")
|
||||
private String title;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
}
|
|
@ -63,7 +63,7 @@ public class NotifyMessageController {
|
|||
|
||||
@PutMapping("/update-read")
|
||||
@Operation(summary = "标记站内信为已读")
|
||||
@Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048", dataTypeClass = List.class)
|
||||
@Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048")
|
||||
public CommonResult<Boolean> updateNotifyMessageRead(@RequestParam("ids") List<Long> ids) {
|
||||
notifyMessageService.updateNotifyMessageRead(ids, getLoginUserId(), UserTypeEnum.ADMIN.getValue());
|
||||
return success(Boolean.TRUE);
|
||||
|
@ -78,7 +78,7 @@ public class NotifyMessageController {
|
|||
|
||||
@GetMapping("/get-unread-list")
|
||||
@Operation(summary = "获取当前用户的最新站内信列表,默认 10 条")
|
||||
@Parameter(name = "size", description = "10", defaultValue = "10")
|
||||
@Parameter(name = "size", description = "10")
|
||||
public CommonResult<List<NotifyMessageRespVO>> getUnreadNotifyMessageList(
|
||||
@RequestParam(name = "size", defaultValue = "10") Integer size) {
|
||||
List<NotifyMessageDO> list = notifyMessageService.getUnreadNotifyMessageList(
|
||||
|
|
|
@ -21,7 +21,7 @@ public class NotifyMessageBaseVO {
|
|||
@NotNull(message = "用户编号不能为空")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", required = true, example = "1", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "用户类型不能为空")
|
||||
private Byte userType;
|
||||
|
||||
|
|
|
@ -23,7 +23,7 @@ public class NotifyTemplateBaseVO {
|
|||
@NotNull(message = "模版编码不能为空")
|
||||
private String code;
|
||||
|
||||
@Schema(description = "模版类型", required = true, example = "1", notes = "对应 system_notify_template_type 字典")
|
||||
@Schema(description = "模版类型,对应 system_notify_template_type 字典", required = true, example = "1")
|
||||
@NotNull(message = "模版类型不能为空")
|
||||
private Integer type;
|
||||
|
||||
|
@ -35,7 +35,7 @@ public class NotifyTemplateBaseVO {
|
|||
@NotEmpty(message = "模版内容不能为空")
|
||||
private String content;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
@InEnum(value = CommonStatusEnum.class, message = "状态必须是 {value}")
|
||||
private Integer status;
|
||||
|
|
|
@ -1,11 +1,11 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.notify.vo.template;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.ToString;
|
||||
|
||||
@ApiModel("管理后台 - 站内信模版创建 Request VO")
|
||||
@Schema(description = "管理后台 - 站内信模版创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@ToString(callSuper = true)
|
||||
|
|
|
@ -24,7 +24,7 @@ public class NotifyTemplatePageReqVO extends PageParam {
|
|||
@Schema(description = "模版名称", example = "我是名称")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "创建时间")
|
||||
|
|
|
@ -213,7 +213,7 @@ public class OAuth2OpenController {
|
|||
@Parameter(name = "client_id", required = true, description = "客户端编号", example = "tudou"),
|
||||
@Parameter(name = "scope", description = "授权范围", example = "userinfo.read"), // 使用 Map<String, Boolean> 格式,Spring MVC 暂时不支持这么接收参数
|
||||
@Parameter(name = "redirect_uri", required = true, description = "重定向 URI", example = "https://www.iocoder.cn"),
|
||||
@Parameter(name = "auto_approve", required = true, description = "用户是否接受", example = "true", dataTypeClass = Boolean.class),
|
||||
@Parameter(name = "auto_approve", required = true, description = "用户是否接受", example = "true"),
|
||||
@Parameter(name = "state", example = "1")
|
||||
})
|
||||
@OperateLog(enable = false) // 避免 Post 请求被记录操作日志
|
||||
|
|
|
@ -38,7 +38,7 @@ public class OAuth2ClientBaseVO {
|
|||
@Schema(description = "应用描述", example = "我是一个应用")
|
||||
private String description;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
private Integer status;
|
||||
|
||||
|
@ -55,7 +55,7 @@ public class OAuth2ClientBaseVO {
|
|||
private List<@NotEmpty(message = "重定向的 URI 不能为空")
|
||||
@URL(message = "重定向的 URI 格式不正确") String> redirectUris;
|
||||
|
||||
@Schema(description = "授权类型", required = true, example = "password", notes = "参见 OAuth2GrantTypeEnum 枚举")
|
||||
@Schema(description = "授权类型,参见 OAuth2GrantTypeEnum 枚举", required = true, example = "password")
|
||||
@NotNull(message = "授权类型不能为空")
|
||||
private List<String> authorizedGrantTypes;
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.oauth2.vo.client;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
|
||||
@Schema(description = "管理后台 - OAuth2 客户端创建 Request VO")
|
||||
@Data
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.oauth2.vo.client;
|
||||
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
import io.swagger.annotations.*;
|
||||
import cn.iocoder.yudao.framework.common.pojo.PageParam;
|
||||
|
||||
@Schema(description = "管理后台 - OAuth2 客户端分页 Request VO")
|
||||
|
@ -10,10 +10,10 @@ import cn.iocoder.yudao.framework.common.pojo.PageParam;
|
|||
@ToString(callSuper = true)
|
||||
public class OAuth2ClientPageReqVO extends PageParam {
|
||||
|
||||
@Schema(description = "应用名", example = "土豆", notes = "模糊匹配")
|
||||
@Schema(description = "应用名,模糊匹配", example = "土豆")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "状态", example = "1", notes = "参见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举", example = "1")
|
||||
private Integer status;
|
||||
|
||||
}
|
|
@ -25,11 +25,11 @@ public class OAuth2OpenAccessTokenRespVO {
|
|||
@JsonProperty("token_type")
|
||||
private String tokenType;
|
||||
|
||||
@Schema(description = "过期时间", required = true, example = "42430", notes = "单位:秒")
|
||||
@Schema(description = "过期时间,单位:秒", required = true, example = "42430")
|
||||
@JsonProperty("expires_in")
|
||||
private Long expiresIn;
|
||||
|
||||
@Schema(description = "授权范围", example = "user_info", notes = "如果多个授权范围,使用空格分隔")
|
||||
@Schema(description = "授权范围,如果多个授权范围,使用空格分隔", example = "user_info")
|
||||
private String scope;
|
||||
|
||||
}
|
|
@ -20,7 +20,7 @@ public class OAuth2OpenAuthorizeInfoRespVO {
|
|||
*/
|
||||
private Client client;
|
||||
|
||||
@Schema(description = "scope 的选中信息", required = true, notes = "使用 List 保证有序性,Key 是 scope,Value 为是否选中")
|
||||
@Schema(description = "scope 的选中信息,使用 List 保证有序性,Key 是 scope,Value 为是否选中", required = true)
|
||||
private List<KeyValue<String, Boolean>> scopes;
|
||||
|
||||
@Data
|
||||
|
|
|
@ -18,7 +18,7 @@ public class OAuth2OpenCheckTokenRespVO {
|
|||
@Schema(description = "用户编号", required = true, example = "666")
|
||||
@JsonProperty("user_id")
|
||||
private Long userId;
|
||||
@Schema(description = "用户类型", required = true, example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", required = true, example = "2")
|
||||
@JsonProperty("user_type")
|
||||
private Integer userType;
|
||||
@Schema(description = "租户编号", required = true, example = "1024")
|
||||
|
@ -34,7 +34,7 @@ public class OAuth2OpenCheckTokenRespVO {
|
|||
@JsonProperty("access_token")
|
||||
private String accessToken;
|
||||
|
||||
@Schema(description = "过期时间", required = true, example = "1593092157", notes = "时间戳 / 1000,即单位:秒")
|
||||
@Schema(description = "过期时间,时间戳 / 1000,即单位:秒", required = true, example = "1593092157")
|
||||
private Long exp;
|
||||
|
||||
}
|
|
@ -14,7 +14,7 @@ public class OAuth2AccessTokenPageReqVO extends PageParam {
|
|||
@Schema(description = "用户编号", required = true, example = "666")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", required = true, example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", required = true, example = "2")
|
||||
private Integer userType;
|
||||
|
||||
@Schema(description = "客户端编号", required = true, example = "2")
|
||||
|
|
|
@ -26,7 +26,7 @@ public class OAuth2AccessTokenRespVO {
|
|||
@Schema(description = "用户编号", required = true, example = "666")
|
||||
private Long userId;
|
||||
|
||||
@Schema(description = "用户类型", required = true, example = "2", notes = "参见 UserTypeEnum 枚举")
|
||||
@Schema(description = "用户类型,参见 UserTypeEnum 枚举", required = true, example = "2")
|
||||
private Integer userType;
|
||||
|
||||
@Schema(description = "客户端编号", required = true, example = "2")
|
||||
|
|
|
@ -28,7 +28,7 @@ public class OAuth2UserInfoRespVO {
|
|||
@Schema(description = "手机号码", example = "15601691300")
|
||||
private String mobile;
|
||||
|
||||
@Schema(description = "用户性别", example = "1", notes = "参见 SexEnum 枚举类")
|
||||
@Schema(description = "用户性别,参见 SexEnum 枚举类", example = "1")
|
||||
private Integer sex;
|
||||
|
||||
@Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
|
||||
|
|
|
@ -29,7 +29,7 @@ public class OAuth2UserUpdateReqVO {
|
|||
@Length(min = 11, max = 11, message = "手机号长度必须 11 位")
|
||||
private String mobile;
|
||||
|
||||
@Schema(description = "用户性别", example = "1", notes = "参见 SexEnum 枚举类")
|
||||
@Schema(description = "用户性别,参见 SexEnum 枚举类", example = "1")
|
||||
private Integer sex;
|
||||
|
||||
}
|
|
@ -19,11 +19,11 @@ public class MenuBaseVO {
|
|||
@Size(max = 50, message = "菜单名称长度不能超过50个字符")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "权限标识", example = "sys:menu:add", notes = "仅菜单类型为按钮时,才需要传递")
|
||||
@Schema(description = "权限标识,仅菜单类型为按钮时,才需要传递", example = "sys:menu:add")
|
||||
@Size(max = 100)
|
||||
private String permission;
|
||||
|
||||
@Schema(description = "类型", required = true, example = "1", notes = "参见 MenuTypeEnum 枚举类")
|
||||
@Schema(description = "类型,参见 MenuTypeEnum 枚举类", required = true, example = "1")
|
||||
@NotNull(message = "菜单类型不能为空")
|
||||
private Integer type;
|
||||
|
||||
|
@ -35,18 +35,18 @@ public class MenuBaseVO {
|
|||
@NotNull(message = "父菜单 ID 不能为空")
|
||||
private Long parentId;
|
||||
|
||||
@Schema(description = "路由地址", example = "post", notes = "仅菜单类型为菜单或者目录时,才需要传")
|
||||
@Schema(description = "路由地址,仅菜单类型为菜单或者目录时,才需要传", example = "post")
|
||||
@Size(max = 200, message = "路由地址不能超过200个字符")
|
||||
private String path;
|
||||
|
||||
@Schema(description = "菜单图标", example = "/menu/list", notes = "仅菜单类型为菜单或者目录时,才需要传")
|
||||
@Schema(description = "菜单图标,仅菜单类型为菜单或者目录时,才需要传", example = "/menu/list")
|
||||
private String icon;
|
||||
|
||||
@Schema(description = "组件路径", example = "system/post/index", notes = "仅菜单类型为菜单时,才需要传")
|
||||
@Schema(description = "组件路径,仅菜单类型为菜单时,才需要传", example = "system/post/index")
|
||||
@Size(max = 200, message = "组件路径不能超过255个字符")
|
||||
private String component;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "见 CommonStatusEnum 枚举")
|
||||
@Schema(description = "状态,见 CommonStatusEnum 枚举", required = true, example = "1")
|
||||
@NotNull(message = "状态不能为空")
|
||||
private Integer status;
|
||||
|
||||
|
|
|
@ -1,9 +1,9 @@
|
|||
package cn.iocoder.yudao.module.system.controller.admin.permission.vo.menu;
|
||||
|
||||
import io.swagger.annotations.ApiModel;
|
||||
import io.swagger.v3.oas.annotations.media.Schema;
|
||||
import lombok.*;
|
||||
|
||||
@ApiModel("管理后台 - 菜单创建 Request VO")
|
||||
@Schema(description = "管理后台 - 菜单创建 Request VO")
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
public class MenuCreateReqVO extends MenuBaseVO {
|
||||
|
|
|
@ -8,10 +8,10 @@ import lombok.Data;
|
|||
@Data
|
||||
public class MenuListReqVO {
|
||||
|
||||
@Schema(description = "菜单名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "菜单名称,模糊匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
}
|
|
@ -19,7 +19,7 @@ public class MenuRespVO extends MenuBaseVO {
|
|||
@Schema(description = "菜单编号", required = true, example = "1024")
|
||||
private Long id;
|
||||
|
||||
@Schema(description = "状态", required = true, example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", required = true, example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "创建时间", required = true, example = "时间戳格式")
|
||||
|
|
|
@ -23,7 +23,7 @@ public class MenuSimpleRespVO {
|
|||
@Schema(description = "父菜单 ID", required = true, example = "1024")
|
||||
private Long parentId;
|
||||
|
||||
@Schema(description = "类型", required = true, example = "1", notes = "参见 MenuTypeEnum 枚举类")
|
||||
@Schema(description = "类型,参见 MenuTypeEnum 枚举类", required = true, example = "1")
|
||||
private Integer type;
|
||||
|
||||
}
|
|
@ -16,12 +16,12 @@ public class PermissionAssignRoleDataScopeReqVO {
|
|||
@NotNull(message = "角色编号不能为空")
|
||||
private Long roleId;
|
||||
|
||||
@Schema(description = "数据范围", required = true, example = "1", notes = "参见 DataScopeEnum 枚举类")
|
||||
@Schema(description = "数据范围,参见 DataScopeEnum 枚举类", required = true, example = "1")
|
||||
@NotNull(message = "数据范围不能为空")
|
||||
// TODO 这里要多一个枚举校验
|
||||
private Integer dataScope;
|
||||
|
||||
@Schema(description = "部门编号列表", example = "1,3,5", notes = "只有范围类型为 DEPT_CUSTOM 时,该字段才需要")
|
||||
@Schema(description = "部门编号列表,只有范围类型为 DEPT_CUSTOM 时,该字段才需要", example = "1,3,5")
|
||||
private Set<Long> dataScopeDeptIds = Collections.emptySet(); // 兜底
|
||||
|
||||
}
|
|
@ -13,13 +13,13 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
|
|||
@Data
|
||||
public class RoleExportReqVO {
|
||||
|
||||
@Schema(description = "角色名称", example = "芋道", notes = "模糊匹配")
|
||||
@Schema(description = "角色名称,模糊匹配", example = "芋道")
|
||||
private String name;
|
||||
|
||||
@Schema(description = "角色标识", example = "yudao", notes = "模糊匹配")
|
||||
@Schema(description = "角色标识,模糊匹配", example = "yudao")
|
||||
private String code;
|
||||
|
||||
@Schema(description = "展示状态", example = "1", notes = "参见 CommonStatusEnum 枚举类")
|
||||
@Schema(description = "展示状态,参见 CommonStatusEnum 枚举类", example = "1")
|
||||
private Integer status;
|
||||
|
||||
@Schema(description = "开始时间", example = "[2022-07-01 00:00:00,2022-07-01 23:59:59]")
|
||||
|
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue