SpringBoot集成Swagger3.0.0生成RestFulAPI + 配置header

最新推荐文章于 2025-06-17 11:45:40 发布

原创

最新推荐文章于 2025-06-17 11:45:40 发布 · 3.2k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#java #swagger2 #restful #spring boot

本文介绍了如何在SpringBoot项目中集成Swagger3.0.0，创建RESTful API，并详细阐述了添加依赖、配置Docket、启用@EnableOpenApi注解、Controller注解使用、参数及返回Bean的配置过程。同时，补充说明了如何配置header以实现更完整的API文档功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.添加swagger3.0.0依赖

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

2.添加配置文件

/**
 * Swagger2配置类
 *
 * @author liangxq
 * @date 2021/1/21$ 10:06$
 */
@Configuration
public class SwaggerConfig {
   
   

    @Bean
    public Docket docket() {
   
   
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo()