springboot项目整合Swagger2

JavaEdge

发布于 2021-02-23 15:25:01

3950

发布于 2021-02-23 15:25:01

文章被收录于专栏：JavaEdgeJavaEdge

项目整合 swagger

在聚合工程中的父 pom 工程的 pom 文件中添加依赖

<dependency>
	<groupId>io.springfoxgroupId>
	<artifactId>springfox-swagger2artifactId>
	<version>2.4.0version>
dependency>
<dependency>
	<groupId>io.springfoxgroupId>
	<artifactId>springfox-swagger-uiartifactId>
	<version>2.4.0version>
dependency>
<dependency>
	<groupId>com.github.xiaoymingroupId>
	<artifactId>swagger-bootstrap-uiartifactId>
	<version>1.6version>
dependency>

指定API类型为swagger2.0
定义API文档汇总信息
指定controller包
所有controller

源码解析

package springfox.documentation.spi;

import org.springframework.http.MediaType;
import org.springframework.plugin.metadata.SimplePluginMetadata;

public class DocumentationType extends SimplePluginMetadata {
  public static final DocumentationType SWAGGER_12 = 
  	new DocumentationType("swagger", "1.2");
  public static final DocumentationType SWAGGER_2 = 
  	new DocumentationType("swagger", "2.0");
  public static final DocumentationType SPRING_WEB = 
  	new DocumentationType("spring-web", "1.0");
  private final MediaType mediaType;

  /**
   * Creates a new instance of {@code SimplePluginMetadata}.
   */
  public DocumentationType(String name, String version, MediaType mediaType) {
    super(name, version);
    this.mediaType = mediaType;
  }

  public DocumentationType(String name, String version) {
    this(name, version, MediaType.APPLICATION_JSON);
  }

  public MediaType getMediaType() {
    return mediaType;
  }

  @Override
  public boolean equals(Object o) {
    if (this == o) {
      return true;
    }
    if (!(o instanceof DocumentationType)) {
      return false;
    }
    if (!super.equals(o)) {
      return false;
    }

    DocumentationType that = (DocumentationType) o;

    return super.equals(that) && mediaType.equals(that.mediaType);

  }

  @Override
  public int hashCode() {
    int result = super.hashCode();
    result = 31 * result + mediaType.hashCode();
    return result;
  }
}