介紹

簡化springdoc的使用（可以搭配knife4j-openapi3-jakarta-spring-boot-starter一起使用）

maven引用

<dependency><groupId>io.github.xiaoyudeguang</groupId><artifactId>easy-springdoc</artifactId><version>1.0.0</version>
</dependency>
<dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId><version>${knife4j-openapi3.version}</version>
</dependency>

在yml中添加配置

springdoc:api-docs:enabled: trueinfo:title: easy-springdoc 示例項目description: easy-springdocb 示例項目version: ${project.version}contact:name: 趙光email: 1316851612@qq.comlicense:name: Apache 2.0url: https://www.apache.org/licenses/LICENSE-2.0.htmlgroups:enabled: truegroup-configs:- group: demopaths-to-match: /user/**display-name: "用戶接口"paths-to-exclude: /internal/**oauth2:client-id: oauth-client-idclient-secret: oauth-client-secretcache:disabled: falsewriter-with-default-pretty-printer: truewriter-with-order-by-keys: true

接口添加文檔注解

框架內置寫法

import com.example.model.SysUser;
import com.example.service.UserService;
import com.xiaoyudeguang.annotations.RequestMapping;
import com.xiaoyudeguang.annotations.RestController;
import io.swagger.v3.oas.annotations.Parameter;
import org.springframework.web.bind.annotation.RequestParam;@RestController(value = "/user", tags = "用戶接口", author = "趙光")
public class UserController {@Autowiredprivate SysUserService sysUserService;@RequestMapping(value = "/getUserByUserNo", summary = "根據用戶編碼查詢用戶")public BaseResult<SysUser> getUserByUserNo(@RequestParam(value = "userNo") @Parameter(description = "用戶編碼") String userNo) {return BaseResult.ok(sysUserService.getOne(SysUser::getUserNo, userNo));}
}

原生寫法

import com.example.model.SysUser;
import com.example.service.UserService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@Tag(name = "用戶接口")
@RestController
@RequestMapping(value = "/user")
public class UserController {@Autowiredprivate SysUserService sysUserService;@Operation(summary = "根據用戶編碼查詢用戶")@RequestMapping(value = "/getUserByUserNo")public BaseResult<SysUser> getUserByUserNo(@RequestParam(value = "userNo") @Parameter(description = "用戶編碼") String userNo) {return BaseResult.ok(sysUserService.getOne(SysUser::getUserNo, userNo));}
}

訪問鏈接：http://127.0.0.1:8080/doc.html