当前位置: 代码网 > it编程>编程语言>Java > SpringDoc如何集成到Springboot

SpringDoc如何集成到Springboot

2025年06月21日 Java 我要评论
1.maven引入jar包 <dependency> <groupid>org.springdoc</groupid&g

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内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com