seaboot-openapi

|-- openapi 扫描程序
    |-- base         ControllerInfo、MethodInfo两个基础工具类
    |-- item         将 request 和 response 合并
    |-- request      请求方式扫描（url、参数等）
    |-- response     数据样例扫描（完成这个设置，postman 上能看到样例数据）
|-- postman 这个包的代码不要改，就是根据 postman 文档抽象出来的对象

/**
 * @author Mr.css
 * @version 2022-10-21 9:52
 */
public class Test {

   public static void main(String[] args) {
      Environment environment = new Environment();
      environment.setOriginalUrl("http://localhost:8081/sea");

      Postman postman = PostmanBuilder.create()
              .setEnvironment(environment)
              .setExclusive("cn.seaboot.admin.*.web.page;org.springframework")
              .searchApi(AppInfoCtrl.class)
              .build();

      System.out.println(FastJsonUtils.toJSONString(postman));
   }
}

import cn.seaboot.web.validate.Update;
import io.swagger.v3.oas.annotations.media.Schema;
import org.hibernate.validator.constraints.Length;

import javax.validation.constraints.NotNull;
import java.io.Serializable;
import java.time.LocalDateTime;

/**
 * POJO
 * App信息表 [t_sys_app_info]
 * <p>
 *
 * @author Mr.css on 2018/6/20.
 */
@Schema(description = "App信息表 [t_sys_app_info] 实体类")
public class SysAppInfo implements Serializable {
   @java.io.Serial
   private static final long serialVersionUID = 7202050212014606841L;

   /**
    * ID
    */
   @NotNull(groups = Update.class)
   @Schema(description = "ID")
   private Long id;
   /**
    * 应用名称
    */
   @Length(max = 64)
   @Schema(description = "应用名称")
   private String appName;
   /**
    * 版本号
    */
   @Length(max = 10)
   @Schema(description = "版本号")
   private String version;
   /**
    * 创建日期
    */
   @Schema(description = "创建日期")
   private LocalDateTime gmtCreate;
   /**
    * 更新日期
    */
   @Schema(description = "更新日期")
   private LocalDateTime gmtModified;

   //下列省略getter/setter
}

/**
 * 系统APP文件 [t_sys_app_info] - Controller
 * <p>
 *
 * @author Mr.css on 2018/6/20.
 * @version 1.0.0
 */
@Controller
@RequestMapping("sys/app")
@Tag(name = "系统APP文件 [t_sys_app_info] 管理")
public class AppInfoCtrl {

    @Resource
    AppInfoService appInfoService;

    @Resource
    UploadConstant uploadConstant;

    /**
     * 增
     *
     * @param pojo pojo
     * @return affected rows
     */
    @ResponseBody
    @Operation(description = "系统APP文件 [t_sys_app_info] 增")
    @RequestMapping(value = "info", method = RequestMethod.POST)
    public int saveInfo(@RequestParam @Validated SysAppInfo pojo,
                        @RequestParam(required = false) MultipartFile file) throws IOException {
        String path = UploadFactory.writer(uploadConstant.getApp()).write(file);
        pojo.setAppPath(path);
        return appInfoService.insert(pojo);
    }

    /**
     * 删
     *
     * @param id id
     * @return affected rows
     */
    @ResponseBody
    @Operation(description = "系统APP文件 [t_sys_app_info] 删")
    @RequestMapping(value = "info", method = RequestMethod.DELETE)
    public int deleteInfo(@Params Long id) {
        return appInfoService.deleteById(id);
    }

    /**
     * 查
     *
     * @param id id
     * @return pojo
     */
    @ResponseBody
    @Operation(description = "系统APP文件 [t_sys_app_info] 查")
    @RequestMapping(value = "info", method = RequestMethod.GET)
    public SysAppInfo queryById(@Params long id) {
        return appInfoService.queryById(id);
    }

    /**
     * 改
     *
     * @param pojo pojo
     * @return affected rows
     */
    @ResponseBody
    @Operation(description = "系统APP文件 [t_sys_app_info] 改")
    @RequestMapping(value = "info", method = RequestMethod.PUT)
    public int updateInfo(@RequestParam @Validated(Update.class) SysAppInfo pojo,
                          @RequestParam(required = false) MultipartFile file) throws IOException {
        SysAppInfo old = appInfoService.queryById(pojo.getId());
        String path = UploadFactory.writer(uploadConstant.getApp()).overwrite(old.getAppPath(), file);
        pojo.setAppPath(path);
        return appInfoService.updateById(pojo);
    }

    /**
     * 查列表
     *
     * @param page   页
     * @param limit  行
     * @param params 参数
     * @return PageInfo
     */
    @ResponseBody
    @Operation(description = "系统APP文件 [t_sys_app_info] 列表查询",
        parameters = {
            @Parameter(name = "page", description = "页号"),
            @Parameter(name = "limit", description = "行数")
        })
    @RequestMapping(value = "page", method = RequestMethod.GET)
    public PageInfo<Map<String, Object>> queryPage(
        @Params(value = "page", defaultValue = AppConstant.PAGE) Integer page,
        @Params(value = "limit", defaultValue = AppConstant.LIMIT) Integer limit,
        @RequestParam Map<String, Object> params) {
        PageHelper.startPage(page, limit);
        List<Map<String, Object>> l = appInfoService.queryList(params);
        return new PageInfo<>(l);
    }
}