1.maven引入jar包
<dependency> <groupid>org.springdoc</groupid> <artifactid>springdoc-openapi-ui</artifactid> <version>1.6.14</version> </dependency>
2.新建openapiconfig文件,代码如下
package com.elane.project.ztt.config; import io.swagger.v3.oas.annotations.enums.securityschemein; import io.swagger.v3.oas.annotations.enums.securityschemetype; import io.swagger.v3.oas.annotations.security.securityscheme; import io.swagger.v3.oas.models.openapi; import io.swagger.v3.oas.models.info.info; import io.swagger.v3.oas.models.security.securityrequirement; import org.springframework.context.annotation.bean; import org.springframework.context.annotation.configuration; //swagger显示authorization //@securityscheme( // name = "bearerauth", // 安全方案的唯一名称 // type = securityschemetype.http, // scheme = "bearer", // bearerformat = "jwt" // 可选,表明 token 格式为 jwt //) //将未登录header中的authorization替换为sid @securityscheme( name = "sid", type = securityschemetype.apikey, in = securityschemein.header, paramname = "sid" ) @configuration public class openapiconfig { @bean public openapi customopenapi() { return new openapi() .info(new info() .title("api文档") .version("1.0") .description("api文档描述")) .addsecurityitem(new securityrequirement().addlist("sid")); } }
3.application.yml文件增加如下配置
springdoc: api-docs: path: /v3/api-docs # 更改 api 文档路径 swagger-ui: path: /swagger-ui.html # 更改 swagger ui 路径 disable-swagger-default-url: true # 禁用默认 url 加载 operations-sort-parameter: alpha # 按字母顺序排序 api
4.注意
如果在项目中使用过springfox,需要将springfox的依赖全部移除
到此这篇关于springdoc如何集成到springboot的文章就介绍到这了,更多相关springdoc集成springboot内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论