Spring Boot 项目中使用Swagger2的示例

发布时间：2020-12-14 20:03:11 所属栏目：Java 来源：网络整理

导读：本文介绍了Spring Boot 项目中使用Swagger2的示例，分享给大家，具体如下：添加Swagger2依赖在pom.xml中加入Swagger2的依赖 dependency groupIdio.springfox/groupId artifactIdspringfox-swagger2/artifactId version2.2.2/version/dependencydependency

本文介绍了Spring Boot 项目中使用Swagger2的示例，分享给大家，具体如下：

添加Swagger2依赖

在pom.xml中加入Swagger2的依赖

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.2.2</version>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency>

创建Swagger2配置类

在Application.java同级创建Swagger2的配置类Swagger2。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2 {
  @Bean
  public Docket createRestApi() {
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .select()
        .apis(RequestHandlerSelectors.basePackage("你自己的外部接口包名称"))
        .paths(PathSelectors.any())
        .build();
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder()
        .title("词网Neo4j RESTful APIs")
        .description("The Neo4j RESTful APIs description/")
        .termsOfServiceUrl("")
        .contact("李庆海")
        .version("5.0")
        .build();
  }
}

添加文档内容

在完成了上述配置后，其实已经可以生产文档内容，但是这样的文档主要针对请求本身，而描述主要来源于函数等命名产生，对用户并不友好，我们通常需要自己增加一些说明来丰富文档内容。

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
/**
 * 系统用户Controller
 * 
 * @author 李庆海
 *
 */
@Api(value = "系统用户接口",tags = "系统管理")
@RestController
@RequestMapping("/v3/edu/users")
public class UserController {

  @Autowired
  private UserService userService;

  /**
   * 添加用户，注册
   * 
   * @param loginName
   *      登录账号
   * @param userName
   *      用户名称
   * @param password
   *      登录密码
   * @param roleId
   *      用户角色
   * @return
   * @throws ResourceExistsException
   */
  @ApiOperation(value = "添加用户")
  @PostMapping("/")
  public JsonResult create(
      @ApiParam(name = "loginName",value = "登录账号",required = true) @RequestParam(required = true) @RequestBody String loginName,@ApiParam(name = "userName",value = "用户名称",required = true) @RequestParam(required = true) @RequestBody String userName,@ApiParam(name = "password",value = "登录密码",required = true) @RequestParam(required = true) @RequestBody String password,@ApiParam(name = "roleId",value = "用户角色编号",required = true) @RequestParam(required = true) @RequestBody String roleId)
      throws ResourceExistsException {
    boolean exists = this.userService.exists(loginName);
    if (exists) {
      throw new ResourceExistsException(loginName);
    }
    User user = userService.create(loginName,password,userName,roleId);
    return new JsonResult(user);
  }
}

查看API

启动Spring Boot程序，访问：http://localhost:8080/swagger-ui.html

API文档访问与调试

Swagger除了查看接口功能外，还提供了调试测试功能，我们可以点击上图中右侧的Model Schema（黄色区域：它指明了数据结构），此时Value中就有了user对象的模板，我们只需要稍适修改，点击下方Try it out！按钮，即可完成了一次请求调用！可以通过几个GET请求来验证之前的POST请求是否正确。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持编程小技巧。

您可能感兴趣的文章:

详解如何在SpringBoot里使用SwaggerUI
Spring Boot集成Swagger2项目实战
Springboot中集成Swagger2框架的方法
SpringBoot集成swagger的实例代码
SpringBoot集成Swagger2实现Restful(类型转换错误解决办法)
springboot + swagger 实例代码
spring-boot 禁用swagger的方法

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!