一、SpringBoot2進行整合knife4j

1.1 導入依賴

        <dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-spring-boot-starter</artifactId></dependency>

1.2 配置knife4j 配置文件

package com.ds.common.knife4j; //com.atguigu.common.config.knife4j;import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;import java.util.ArrayList;
import java.util.List;/**
* knife4j配置信息
*/
@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfig {@Beanpublic Docket adminApiConfig(){List<Parameter> pars = new ArrayList<>();ParameterBuilder tokenPar = new ParameterBuilder();tokenPar.name("token").description("用戶token").defaultValue("").modelRef(new ModelRef("string")).parameterType("header").required(false).build();pars.add(tokenPar.build());//添加head參數endDocket adminApi = new Docket(DocumentationType.SWAGGER_2).groupName("adminApi").apiInfo(adminApiInfo()).select()//只顯示admin路徑下的頁面.apis(RequestHandlerSelectors.basePackage("com.ds")).paths(PathSelectors.regex("/admin/.*"))  // "/admin/.*".build().globalOperationParameters(pars);return adminApi;}private ApiInfo adminApiInfo(){return new ApiInfoBuilder().title("后臺管理系統-API文檔").description("本文檔描述了后臺管理系統微服務接口定義").version("1.0").contact(new Contact("DS-ERP", "http://DS.com", "DS@qq.com")).build();}}

1.3 可以在接口上配置 注解進行信息的配置

package com.ds.process.controller;import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ds.common.result.Result;
import com.ds.model.vo.process.ProcessQueryVo;
import com.ds.model.vo.process.ProcessVo;
import com.ds.process.service.OaProcessService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;/*** <p>* 審批類型 前端控制器* </p>**/
@Api("審批頁面")
@RestController
@RequestMapping(value = "/admin/process")
public class OaProcessController {@Autowiredprivate OaProcessService processService;//審批管理列表@ApiOperation(value = "獲取分頁列表")@GetMapping("{page}/{limit}")public Result index(@PathVariable Long page,@PathVariable Long limit,ProcessQueryVo processQueryVo) {Page<ProcessVo> pageParam = new Page<>(page,limit);IPage<ProcessVo> pageModel =processService.selectPage(pageParam,processQueryVo);return Result.ok(pageModel);}
}

二、SpringBoot3 整合kinfe4j(openApi)

2.1 導入依賴

<dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId><version>4.1.0</version>
</dependency>
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional>
</dependency>

2.2 yaml配置文件

server:port: 8080
# springdoc-openapi項目配置，訪問地址：http://127.0.0.1:8080/doc.html
springdoc:swagger-ui:path: /swagger-ui.htmltags-sorter: alphaoperations-sorter: alphaapi-docs:path: /v3/api-docsgroup-configs:- group: 'default'paths-to-match: '/**'packages-to-scan: com.hexadecimal.example# knife4j的增強配置，不需要增強可以不配
knife4j:enable: truesetting:language: zh_cn# Logger Config
logging:level:com.hexadecimal: debug

1. springdoc.swagger-ui.path配置UI界面的訪問路徑。
2. knife4j.enable是否開啟增強配置。
3. 配置項目的日志級別為debug。

2.3 swagger初始化配置

@Configuration
public class SwaggerConfig {@Beanpublic OpenAPI springShopOpenAPI() {return new OpenAPI().info(new Info().title("十六進制說").description("十六進制說API文檔").version("v1").license(new License().name("Apache 2.0").url("http://springdoc.org"))).externalDocs(new ExternalDocumentation().description("外部文檔").url("https://springshop.wiki.github.org/docs"));}}

2.4 創建接口

@Tag(name = "用戶管理")
@RestController
@Slf4j
public class UserController {@Operation(summary = "查詢")@GetMapping("query")public UserDO query(@Parameter(name = "name", description = "名稱") String name) {UserDO userDO = new UserDO();userDO.setName(name);return userDO;}@Operation(summary = "列表")@PostMapping("list")public List<UserDO> list() {return new ArrayList<UserDO>();}@Operation(summary ="新增")@PostMapping("add")public UserDO add(UserDO userDO) {return new UserDO();}@Operation(summary ="修改")@PostMapping("update")public UserDO update(UserDO userDO) {return new UserDO();}@Operation(summary ="刪除")@PostMapping("delete")public Boolean delete(Integer id) {return true;}
}