Swagger(JAVA)

最新推荐文章于 2025-04-03 14:35:53 发布

tellmeyesorno

最新推荐文章于 2025-04-03 14:35:53 发布

阅读量446

点赞数

分类专栏： # Java相关文章标签： swagger java

本文链接：https://blog.youkuaiyun.com/u010247166/article/details/89996889

版权

Java相关专栏收录该内容

12 篇文章

订阅专栏

本文详细介绍如何在SpringMVC项目中集成Swagger，包括添加依赖、编写配置文件、请求处理类，以及生成离线文档的具体步骤。通过实例演示，帮助读者快速上手，实现API文档的自动生成。

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

文章目录

1.介绍

2.使用

2.1 springMVC集成

1.添加依赖

      <!--swagger-->
      <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-swagger2</artifactId>
          <version>2.6.1</version>
      </dependency>
      <!-- swagger-ui 为项目提供api展示及测试的界面 -->
      <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-swagger-ui</artifactId>
          <version>2.6.1</version>
      </dependency>
      <!-- 集成 swagger 的时候，缺少这个 jar包是不OK的-->
      <dependency>
          <groupId>com.fasterxml.jackson.core</groupId>
          <artifactId>jackson-databind</artifactId>
          <version>2.8.7</version>
      </dependency>

2.编写配置文件

@Configuration
@EnableSwagger2
@EnableWebMvc
@ComponentScan(basePackages ="com.zy.crud")
public class SwaggerConfig {
    
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("SpringMVC swagger的接口测试")
                .description("这个是接口测试")
                .termsOfServiceUrl("http://blog.youkuaiyun.com/cct")
                .contact(new Contact("欢迎来到我的接口测试", "http://blog.youkuaiyun.com", "www@163.com"))
                .license("")
                .licenseUrl("")
                .version("1.0.0")
                .build();
    }
}

3.编写请求处理类

@Controller
@RequestMapping("/swagger")
public class SwaggerController {

    @ApiOperation(value = "打招呼", notes = "这是个方法")
    @ResponseBody
    @RequestMapping(value = "printHello", method = RequestMethod.GET)
    @ApiImplicitParams(
            @ApiImplicitParam(name = "userName", value = "名字", required = true, paramType = "query")
    )
    public String printHello(String userName) {
        return "hello,"+userName;
    }
    
}

在这里插入图片描述

4.访问 http://localhost:8080/ssm_crud/swagger-ui.html
在这里插入图片描述

2.2 生成离线文档

在这里插入图片描述

2.2.1 添加依赖

      <!--swagger-->
      <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-swagger2</artifactId>
          <version>2.6.1</version>
      </dependency>
      <!-- swagger-ui 为项目提供api展示及测试的界面 -->
      <!--<dependency>-->
          <!--<groupId>io.springfox</groupId>-->
          <!--<artifactId>springfox-swagger-ui</artifactId>-->
          <!--<version>2.6.1</version>-->
      <!--</dependency>-->
      <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>swagger-bootstrap-ui</artifactId>
        <version>1.8.5</version>
      </dependency>

2.2.2 建立swagger配置类

@Configuration
@EnableSwagger2
@EnableWebMvc
@ComponentScan(basePackages ="com.zy.crud.swaggerController")
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("SpringMVC swagger的接口测试")
                .description("这个是接口测试")
                .termsOfServiceUrl("http://blog.youkuaiyun.com/cct")
                .contact(new Contact("欢迎来到我的接口测试", "http://blog.youkuaiyun.com", "www@163.com"))
                .license("")
                .licenseUrl("")
                .version("1.0.0")
                .build();
    }
}

2.2.3 编写业务类

@ApiModel(description = "用户实体类")
public class SwaggerEntity {

    /**
     * 用户标识
     */
    @ApiModelProperty(required = true, value = "用户标识")
    private Integer id;
    /**
     * 用户名
     */
    @ApiModelProperty(required = true, value = "用户名")
    private String username;

@Service
public class SwaggerService {

    public SwaggerEntity getSwaggerEntity(Integer id) {
        SwaggerEntity se  = null;
        if(id == 1){
            se = new SwaggerEntity(1, "小明");
        }else if(id == 2){
            se = new SwaggerEntity(2, "xiaohong");
        }
        return se;
    }

@Controller
@RequestMapping("/swagger")
@Api(value = "用户信息查询", description = "用户基本信息操作API", tags = "UserApi"
        , consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
public class SwaggerController {

    @Autowired(required = false)
    private SwaggerService swaggerService;


    @ResponseBody
    @RequestMapping(value = "printHello", method = RequestMethod.GET)
    @ApiOperation(notes = "第一个方法", httpMethod = "GET", value = "打印helloword")
    @ApiResponses(value = {@ApiResponse(code = 405, message = "invalid input")})
    @ApiImplicitParams(
            @ApiImplicitParam(name = "userName", value = "名字", required = true, paramType = "query")
    )
    public String printHello(String userName) {
        return "hello,"+userName;
    }

    @ResponseBody
    @RequestMapping(value = "findSwaggerEntity", method = RequestMethod.POST)
    @ApiOperation(notes = "第二个方法", httpMethod = "POST", value = "根据ID获取相关实体类")
    @ApiResponses(value = {@ApiResponse(code = 405, message = "invalid input")})
    @ApiImplicitParams({
            @ApiImplicitParam(name = "id", value = "主键", required = true, paramType = "query"),
            @ApiImplicitParam(name = "userName", value = "名字", required = true, paramType = "query")
    })
    public SwaggerEntity findSwaggerEntity(Integer id, String userName) {
        return swaggerService.getSwaggerEntity(id);
    }

}