springcloud整合Swagger2如何构建RESTful服务的APIs

这篇文章主要介绍了spring cloud整合Swagger2如何构建RESTful服务的APIs，具有一定借鉴价值，感兴趣的朋友可以参考下，希望大家阅读完这篇文章之后大有收获，下面让小编带着大家一起了解一下。

公司主营业务：网站设计、网站制作、移动网站开发等业务。帮助企业客户真正实现互联网宣传，提高企业的竞争能力。创新互联公司是一支青春激扬、勤奋敬业、活力青春激扬、勤奋敬业、活力澎湃、和谐高效的团队。公司秉承以“开放、自由、严谨、自律”为核心的企业文化，感谢他们对我们的高要求，感谢他们从不同领域给我们带来的挑战，让我们激情的团队有机会用头脑与智慧不断的给客户带来惊喜。创新互联公司推出环江免费做网站回馈大家。

一、引入Swagger2依赖的jar包

 
     
      io.springfox 
      springfox-swagger2 
      2.2.2 
     
     
      io.springfox 
      springfox-swagger-ui 
      2.2.2

二、初始化Swagger2的配置

@Configuration 
@EnableSwagger2 // 启用Swagger2 
public class Swagger2 { 
 
  @Bean 
  public Docket createRestApi() {// 创建API基本信息 
    return new Docket(DocumentationType.SWAGGER_2) 
        .apiInfo(apiInfo()) 
        .select() 
        .apis(RequestHandlerSelectors.basePackage("com.chhliu.jpa"))// 扫描该包下的所有需要在Swagger中展示的API，@ApiIgnore注解标注的除外 
        .paths(PathSelectors.any()) 
        .build(); 
  } 
 
  private ApiInfo apiInfo() {// 创建API的基本信息，这些信息会在Swagger UI中进行显示 
    return new ApiInfoBuilder() 
        .title("Spring Boot中使用Swagger2构建RESTful APIs")// API 标题 
        .description("rdcloud-jpa提供的RESTful APIs")// API描述 
        .contact("chhliu@")// 联系人 
        .version("1.0")// 版本号 
        .build(); 
  } 
 
}

注：该配置类需要在Application同级目录下创建，在项目启动的时候，就初始化该配置类

三、完善API文档信息

public interface SonarControllerI { 
  @ApiOperation(value="获取项目组Sonar对应的Url信息", notes="根据id获取项目组Sonar对应的Url信息")// 使用该注解描述接口方法信息 
  @ApiImplicitParams({ 
      @ApiImplicitParam(name = "id", value = "SonarUrl表ID", required = true, dataType = "Long", paramType="path") 
  })// 使用该注解描述方法参数信息，此处需要注意的是paramType参数，需要配置成path，否则在UI中访问接口方法时，会报错 
  @GetMapping("/get/{id}") 
  SonarUrl get(@PathVariable Long id); 
   
  @ApiOperation(value="获取项目组Sonar对应的所有Url信息") 
  @GetMapping("/get/all") 
  List getAll(); 
}

注：paramType表示参数的类型，可选的值为"path","body","query","header","form"

四、完善返回类型信息

@Entity(name = "SONAR_URL") 
public class SonarUrl implements Serializable { 
 
  /** 
   * 
   */ 
  private static final long serialVersionUID = 1L; 
  @ApiModelProperty(value="主键", hidden=false, notes="主键，隐藏", required=true, dataType="Long")// 使用该注解描述属性信息,当hidden=true时，该属性不会在api中显示 
  @Id 
  @GeneratedValue(strategy = GenerationType.AUTO) 
  private Long id; 
   
  @ApiModelProperty(value="URL链接地址") 
  @Column(name="URL") 
  private String url; 
   
  @ApiModelProperty(value="项目组") 
  @Column(name="TEAM") 
  private String team; 
 
  @ApiModelProperty(value="部门") 
  @Column(name="DEPARTMENT") 
  private String department; 
    ……省略getter，setter方法…… 
 }

五、启动应用

1、在浏览器中输入：http://localhost:7622/swagger-ui.html

2、结果如下：

spring cloud整合Swagger2如何构建RESTful服务的APIs