mirror of
				https://gitee.com/hhyykk/ipms-sjy.git
				synced 2025-11-04 12:18:42 +08:00 
			
		
		
		
	refactor: springdoc 替换 springfox
This commit is contained in:
		@@ -27,7 +27,7 @@ import ${basePackage}.module.${table.moduleName}.dal.dataobject.${table.business
 | 
			
		||||
import ${basePackage}.module.${table.moduleName}.convert.${table.businessName}.${table.className}Convert;
 | 
			
		||||
import ${basePackage}.module.${table.moduleName}.service.${table.businessName}.${table.className}Service;
 | 
			
		||||
 | 
			
		||||
@Api(tags = "${sceneEnum.name} - ${table.classComment}")
 | 
			
		||||
@Tag(name = "${sceneEnum.name} - ${table.classComment}")
 | 
			
		||||
@RestController
 | 
			
		||||
##二级的 businessName 暂时不算在 HTTP 路径上,可以根据需要写
 | 
			
		||||
@RequestMapping("/${table.moduleName}/${simpleClassName_strikeCase}")
 | 
			
		||||
@@ -38,7 +38,7 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    private ${table.className}Service ${classNameVar}Service;
 | 
			
		||||
 | 
			
		||||
    @PostMapping("/create")
 | 
			
		||||
    @ApiOperation("创建${table.classComment}")
 | 
			
		||||
    @Operation(summary = "创建${table.classComment}")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:create')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<${primaryColumn.javaType}> create${simpleClassName}(@Valid @RequestBody ${sceneEnum.prefixClass}${table.className}CreateReqVO createReqVO) {
 | 
			
		||||
@@ -46,7 +46,7 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @PutMapping("/update")
 | 
			
		||||
    @ApiOperation("更新${table.classComment}")
 | 
			
		||||
    @Operation(summary = "更新${table.classComment}")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:update')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<Boolean> update${simpleClassName}(@Valid @RequestBody ${sceneEnum.prefixClass}${table.className}UpdateReqVO updateReqVO) {
 | 
			
		||||
@@ -55,8 +55,8 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @DeleteMapping("/delete")
 | 
			
		||||
    @ApiOperation("删除${table.classComment}")
 | 
			
		||||
    @ApiImplicitParam(name = "id", value = "编号", required = true, dataTypeClass = ${primaryColumn.javaType}.class)
 | 
			
		||||
    @Operation(summary = "删除${table.classComment}")
 | 
			
		||||
    @Parameter(name = "id", description = "编号", required = true)
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:delete')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<Boolean> delete${simpleClassName}(@RequestParam("id") ${primaryColumn.javaType} id) {
 | 
			
		||||
@@ -65,8 +65,8 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @GetMapping("/get")
 | 
			
		||||
    @ApiOperation("获得${table.classComment}")
 | 
			
		||||
    @ApiImplicitParam(name = "id", value = "编号", required = true, example = "1024", dataTypeClass = ${primaryColumn.javaType}.class)
 | 
			
		||||
    @Operation(summary = "获得${table.classComment}")
 | 
			
		||||
    @Parameter(name = "id", description = "编号", required = true, example = "1024")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:query')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<${sceneEnum.prefixClass}${table.className}RespVO> get${simpleClassName}(@RequestParam("id") ${primaryColumn.javaType} id) {
 | 
			
		||||
@@ -75,8 +75,8 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @GetMapping("/list")
 | 
			
		||||
    @ApiOperation("获得${table.classComment}列表")
 | 
			
		||||
    @ApiImplicitParam(name = "ids", value = "编号列表", required = true, example = "1024,2048", dataTypeClass = List.class)
 | 
			
		||||
    @Operation(summary = "获得${table.classComment}列表")
 | 
			
		||||
    @Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:query')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<List<${sceneEnum.prefixClass}${table.className}RespVO>> get${simpleClassName}List(@RequestParam("ids") Collection<${primaryColumn.javaType}> ids) {
 | 
			
		||||
@@ -85,7 +85,7 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @GetMapping("/page")
 | 
			
		||||
    @ApiOperation("获得${table.classComment}分页")
 | 
			
		||||
    @Operation(summary = "获得${table.classComment}分页")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:query')")#end
 | 
			
		||||
 | 
			
		||||
    public CommonResult<PageResult<${sceneEnum.prefixClass}${table.className}RespVO>> get${simpleClassName}Page(@Valid ${sceneEnum.prefixClass}${table.className}PageReqVO pageVO) {
 | 
			
		||||
@@ -94,7 +94,7 @@ public class ${sceneEnum.prefixClass}${table.className}Controller {
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    @GetMapping("/export-excel")
 | 
			
		||||
    @ApiOperation("导出${table.classComment} Excel")
 | 
			
		||||
    @Operation(summary = "导出${table.classComment} Excel")
 | 
			
		||||
#if ($sceneEnum.scene == 1)    @PreAuthorize("@ss.hasPermission('${permissionPrefix}:export')")#end
 | 
			
		||||
 | 
			
		||||
    @OperateLog(type = EXPORT)
 | 
			
		||||
 
 | 
			
		||||
@@ -1,5 +1,5 @@
 | 
			
		||||
## 提供给 baseVO、createVO、updateVO 生成字段
 | 
			
		||||
    @ApiModelProperty(value = "${column.columnComment}"#if (!${column.nullable}), required = true#end#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${column.columnComment}"#if (!${column.nullable}), required = true#end#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
#if (!${column.nullable})## 判断 @NotEmpty 和 @NotNull 注解
 | 
			
		||||
#if (${field.fieldType} == 'String')
 | 
			
		||||
    @NotEmpty(message = "${column.columnComment}不能为空")
 | 
			
		||||
 
 | 
			
		||||
@@ -15,7 +15,7 @@ import static ${DateUtilsClassName}.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
 | 
			
		||||
#end
 | 
			
		||||
#end
 | 
			
		||||
 | 
			
		||||
@ApiModel("${sceneEnum.name} - ${table.classComment}创建 Request VO")
 | 
			
		||||
@Schema(title = "${sceneEnum.name} - ${table.classComment}创建 Request VO")
 | 
			
		||||
@Data
 | 
			
		||||
@EqualsAndHashCode(callSuper = true)
 | 
			
		||||
@ToString(callSuper = true)
 | 
			
		||||
 
 | 
			
		||||
@@ -16,18 +16,18 @@ import static ${DateUtilsClassName}.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
 | 
			
		||||
#end
 | 
			
		||||
## 字段模板
 | 
			
		||||
#macro(columnTpl $prefix $prefixStr)
 | 
			
		||||
    @ApiModelProperty(value = "${prefixStr}${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${prefixStr}${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    private ${column.javaType}#if ("$!prefix" != "") ${prefix}${JavaField}#else ${column.javaField}#end;
 | 
			
		||||
#end
 | 
			
		||||
 | 
			
		||||
@ApiModel(value = "${sceneEnum.name} - ${table.classComment} Excel 导出 Request VO", description = "参数和 ${table.className}PageReqVO 是一致的")
 | 
			
		||||
@Schema(title = "${sceneEnum.name} - ${table.classComment} Excel 导出 Request VO", description = "参数和 ${table.className}PageReqVO 是一致的")
 | 
			
		||||
@Data
 | 
			
		||||
public class ${sceneEnum.prefixClass}${table.className}ExportReqVO {
 | 
			
		||||
 | 
			
		||||
#foreach ($column in $columns)
 | 
			
		||||
#if (${column.listOperation})##查询操作
 | 
			
		||||
#if (${column.listOperationCondition} == "BETWEEN")## 情况一,Between 的时候
 | 
			
		||||
    @ApiModelProperty(value = "${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
 | 
			
		||||
    private ${column.javaType}[] ${column.javaField};
 | 
			
		||||
#else##情况二,非 Between 的时间
 | 
			
		||||
 
 | 
			
		||||
@@ -16,11 +16,11 @@ import static ${DateUtilsClassName}.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
 | 
			
		||||
#end
 | 
			
		||||
## 字段模板
 | 
			
		||||
#macro(columnTpl $prefix $prefixStr)
 | 
			
		||||
    @ApiModelProperty(value = "${prefixStr}${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${prefixStr}${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    private ${column.javaType}#if ("$!prefix" != "") ${prefix}${JavaField}#else ${column.javaField}#end;
 | 
			
		||||
#end
 | 
			
		||||
 | 
			
		||||
@ApiModel("${sceneEnum.name} - ${table.classComment}分页 Request VO")
 | 
			
		||||
@Schema(title = "${sceneEnum.name} - ${table.classComment}分页 Request VO")
 | 
			
		||||
@Data
 | 
			
		||||
@EqualsAndHashCode(callSuper = true)
 | 
			
		||||
@ToString(callSuper = true)
 | 
			
		||||
@@ -29,7 +29,7 @@ public class ${sceneEnum.prefixClass}${table.className}PageReqVO extends PagePar
 | 
			
		||||
#foreach ($column in $columns)
 | 
			
		||||
#if (${column.listOperation})##查询操作
 | 
			
		||||
#if (${column.listOperationCondition} == "BETWEEN")## 情况一,Between 的时候
 | 
			
		||||
    @ApiModelProperty(value = "${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${column.columnComment}"#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
 | 
			
		||||
    private ${column.javaType}[] ${column.javaField};
 | 
			
		||||
#else##情况二,非 Between 的时间
 | 
			
		||||
 
 | 
			
		||||
@@ -8,7 +8,7 @@ import java.time.LocalDateTime;
 | 
			
		||||
#end
 | 
			
		||||
import io.swagger.annotations.*;
 | 
			
		||||
 | 
			
		||||
@ApiModel("${sceneEnum.name} - ${table.classComment} Response VO")
 | 
			
		||||
@Schema(title = "${sceneEnum.name} - ${table.classComment} Response VO")
 | 
			
		||||
@Data
 | 
			
		||||
@EqualsAndHashCode(callSuper = true)
 | 
			
		||||
@ToString(callSuper = true)
 | 
			
		||||
@@ -16,7 +16,7 @@ public class ${sceneEnum.prefixClass}${table.className}RespVO extends ${sceneEnu
 | 
			
		||||
 | 
			
		||||
#foreach ($column in $columns)
 | 
			
		||||
#if (${column.listOperationResult} && (!${column.createOperation} || !${column.updateOperation}))##不是通用字段
 | 
			
		||||
    @ApiModelProperty(value = "${column.columnComment}"#if (!${column.nullable}), required = true#end#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    @Schema(title = "${column.columnComment}"#if (!${column.nullable}), required = true#end#if ("$!column.example" != ""), example = "${column.example}"#end)
 | 
			
		||||
    private ${column.javaType} ${column.javaField};
 | 
			
		||||
 | 
			
		||||
#end
 | 
			
		||||
 
 | 
			
		||||
@@ -15,7 +15,7 @@ import static ${DateUtilsClassName}.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
 | 
			
		||||
#end
 | 
			
		||||
#end
 | 
			
		||||
 | 
			
		||||
@ApiModel("${sceneEnum.name} - ${table.classComment}更新 Request VO")
 | 
			
		||||
@Schema(title = "${sceneEnum.name} - ${table.classComment}更新 Request VO")
 | 
			
		||||
@Data
 | 
			
		||||
@EqualsAndHashCode(callSuper = true)
 | 
			
		||||
@ToString(callSuper = true)
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user