From d9e54388e7fde2462e8b7e0165c5e7da3f202593 Mon Sep 17 00:00:00 2001 From: 疯狂的狮子li <15040126243@163.com> Date: 星期四, 07 七月 2022 19:07:59 +0800 Subject: [PATCH] add 整合 springdoc-openapi-javadoc 基于代码注释生成文档 --- ruoyi-demo/src/main/java/com/ruoyi/demo/controller/Swagger3DemoController.java | 36 +++++++++++++++++------------------- 1 files changed, 17 insertions(+), 19 deletions(-) diff --git a/ruoyi-demo/src/main/java/com/ruoyi/demo/controller/Swagger3DemoController.java b/ruoyi-demo/src/main/java/com/ruoyi/demo/controller/Swagger3DemoController.java index a8efb64..af0e104 100644 --- a/ruoyi-demo/src/main/java/com/ruoyi/demo/controller/Swagger3DemoController.java +++ b/ruoyi-demo/src/main/java/com/ruoyi/demo/controller/Swagger3DemoController.java @@ -1,10 +1,10 @@ package com.ruoyi.demo.controller; -import com.ruoyi.common.core.domain.AjaxResult; -import io.swagger.annotations.Api; -import io.swagger.annotations.ApiImplicitParam; -import io.swagger.annotations.ApiImplicitParams; -import io.swagger.annotations.ApiOperation; +import com.ruoyi.common.core.domain.R; +import io.swagger.v3.oas.annotations.Parameter; +import io.swagger.v3.oas.annotations.Parameters; +import io.swagger.v3.oas.annotations.enums.ParameterIn; +import io.swagger.v3.oas.annotations.tags.Tag; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestPart; @@ -16,23 +16,21 @@ * * @author Lion Li */ -@Api(value = "婕旂ずswagger3鎺у埗鍣�", tags = {"婕旂ずswagger3鎺ュ彛"}) +@Tag(name ="婕旂ずswagger3鎺у埗鍣�", description = "婕旂ずswagger3鎺ュ彛") @RestController @RequestMapping("/swagger/demo") public class Swagger3DemoController { - /** - * 涓婁紶璇锋眰 - * 蹇呴』浣跨敤 @RequestPart 娉ㄨВ鏍囨敞涓烘枃浠� - * dataType 蹇呴』涓� "java.io.File" - */ - @ApiOperation(value = "閫氱敤涓婁紶璇锋眰") - @ApiImplicitParams({ - @ApiImplicitParam(name = "file", value = "鏂囦欢", dataType = "java.io.File", required = true), - }) - @PostMapping(value = "/upload") - public AjaxResult<String> upload(@RequestPart("file") MultipartFile file) { - return AjaxResult.success("鎿嶄綔鎴愬姛", file.getOriginalFilename()); - } + /** + * 涓婁紶璇锋眰 + * 蹇呴』浣跨敤 @RequestPart 娉ㄨВ鏍囨敞涓烘枃浠� + */ + @Parameters({ + @Parameter(name = "file", description = "鏂囦欢", in = ParameterIn.QUERY, required = true) + }) + @PostMapping(value = "/upload") + public R<String> upload(@RequestPart("file") MultipartFile file) { + return R.ok("鎿嶄綔鎴愬姛", file.getOriginalFilename()); + } } -- Gitblit v1.9.3