服务器之家:专注于服务器技术及软件下载分享
分类导航

PHP教程|ASP.NET教程|Java教程|ASP教程|编程技术|正则表达式|C/C++|IOS|C#|Swift|Android|VB|R语言|JavaScript|易语言|vb.net|

服务器之家 - 编程语言 - Java教程 - Java Swagger技术使用指南

Java Swagger技术使用指南

2022-01-25 00:50四季人06 Java教程

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同

Swagger的作用与概念

Swagger官网,点此进入

在前后端分离时代,我们需要实时自动更新接口信息,和测试接口,实现前后端分离式开发,swagger因此产生

 

在项目中使用swagger

以下以3.0.0依赖为例

<!--swagger 相关组件-->
      <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-swagger2</artifactId>
          <version>3.0.0</version>
      </dependency>
      <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-swagger-ui</artifactId>
          <version>3.0.0</version>
      </dependency>
        <dependency>
         <groupId>io.springfox</groupId>
         <artifactId>springfox-boot-starter</artifactId>
         <version>3.0.0</version>
      </dependency>
@RestController
public class HelloController {

  @RequestMapping(value = "/hello")
  public String hello(){
       return "hello";
  }
}
@Configuration
@EnableSwagger2 //开启swagger2
public class SwaggerConfig {

}

然后访问http://localhost:8080/swagger-ui/index.html
你就能看到如下界面,为swagger文档

Java Swagger技术使用指南

 

配置swagger

先来看看底层的代码,了解一下

Java Swagger技术使用指南

Java Swagger技术使用指南

 

ApiInfo 配置

@Configuration
@EnableSwagger2 //开启swagger2
public class SwaggerConfig {

  @Bean
  public Docket docket(){

      return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());
  }

  //配置swagger信息apiInfo
  private ApiInfo apiInfo(){
      //作者信息
      Contact contact = new Contact("宋先慧", "https://blog.csdn.net/sxh06", "xianhuisong@yeah.net");
      return new ApiInfo(
              "宋先慧的Api Documentation",
              "学习swagger没有尽头",
              "1.0",
              "urn:tos",
              contact,
              "Apache 2.0",
              "http://www.apache.org/licenses/LICENSE-2.0",
              new ArrayList());
  }

}

 

swagger配置扫描接口

@Configuration
@EnableSwagger2 //开启swagger2
public class SwaggerConfig {

//    @Bean
//    public Docket docket1(){
//        return new Docket(DocumentationType.SWAGGER_2).groupName("分组二");
//    }
  @Bean
  public Docket docket(Environment environment){


      Profiles profiles=Profiles.of("dev");
      //获取项目的环境
       boolean flag=environment.acceptsProfiles(profiles);

      return new Docket(DocumentationType.SWAGGER_2)
              .apiInfo(apiInfo())
              .groupName("宋先慧")  //分组
              .enable(flag)  //enable 配置是否启动swagger  flase则不能在浏览器访问
              .select()
              //RequestHandlerSelectors实现类  配置扫描方式
              // basePackage指定要扫描的包
              // any()全部
              // none()都不扫描
              //withClassAnnotation()  扫描类上的注解  参数是一个注解的反射对象
              //withMethodAnnotation   扫描方法上的注解
              .apis(RequestHandlerSelectors.basePackage("com.sxh.swagger.controller"))
              //.apis(RequestHandlerSelectors.withMethodAnnotation(GetMapping.class))
              //过滤什么路劲  过滤请求
              //.paths(PathSelectors.ant("/sxh/**"))
              .build();
  }

  //配置swagger信息apiInfo
  private ApiInfo apiInfo(){
      //作者信息
      Contact contact = new Contact("宋先慧", "https://blog.csdn.net/sxh06", "xianhuisong@yeah.net");
      return new ApiInfo(
              "宋先慧的Api Documentation",
              "学习swagger没有尽头",
              "1.0",
              "urn:tos",
              contact,
              "Apache 2.0",
              "http://www.apache.org/licenses/LICENSE-2.0",
              new ArrayList());
  }

}

如果我只希望在生成环境使用swagger,在正式环境不使用swagger怎么解决?(enable=false|true)

 

配置api文档分组

Java Swagger技术使用指南

多个分组

配置多个Docket 实例即可

@Bean
  public Docket docket1(){
      return new Docket(DocumentationType.SWAGGER_2).groupName("分组一");
  }

@Bean
  public Docket docket2(){
      return new Docket(DocumentationType.SWAGGER_2).groupName("分组二");
  }`

 

实体类配置

Java Swagger技术使用指南

Java Swagger技术使用指南

Java Swagger技术使用指南

Java Swagger技术使用指南

Java Swagger技术使用指南

到此这篇关于Java Swagger技术使用指南的文章就介绍到这了,更多相关Java Swagger内容请搜索服务器之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持服务器之家!

原文链接:https://blog.csdn.net/sxh06/article/details/120345596

延伸 · 阅读

精彩推荐
  • Java教程Jedis对redis的五大类型操作代码详解

    Jedis对redis的五大类型操作代码详解

    这篇文章主要介绍了Jedis对redis的五大操作代码详解,分别是字符串、列表、散列、集合、有序集合,具有一定参考价值,需要的朋友可以了解下。...

    朱小厮5162021-02-06
  • Java教程SpringBoot+SpringSecurity处理Ajax登录请求问题(推荐)

    SpringBoot+SpringSecurity处理Ajax登录请求问题(推荐)

    这篇文章主要介绍了SpringBoot+SpringSecurity处理Ajax登录请求问题,本文给大家介绍的非常不错,具有参考借鉴价值,需要的朋友可以参考下...

    独孤求败5072021-03-08
  • Java教程使用@RequestParam 绑定List参数

    使用@RequestParam 绑定List参数

    这篇文章主要介绍了使用@RequestParam 绑定List参数的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...

    天糊十三幺8002021-11-23
  • Java教程springboot+RabbitMQ+InfluxDB+Grafara监控实践

    springboot+RabbitMQ+InfluxDB+Grafara监控实践

    这篇文章主要介绍了springboot+RabbitMQ+InfluxDB+Grafara监控实践,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧...

    zygfengyuwuzu9702021-05-20
  • Java教程最值得Java开发者收藏的网站

    最值得Java开发者收藏的网站

    这篇文章主要为大家分享了最值得Java开发者收藏的11个网站,帮助Java开发者提升编程能力 ...

    Java团长2492020-07-02
  • Java教程Java性能优化技巧汇总

    Java性能优化技巧汇总

    这篇文章主要介绍了Java性能优化技巧,汇总了提升java程序性能的常用技巧,非常具有实用价值,需要的朋友可以参考下 ...

    司青2152019-12-16
  • Java教程Netty粘包拆包问题解决方案

    Netty粘包拆包问题解决方案

    这篇文章主要介绍了Netty粘包拆包问题解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...

    猿天地4372020-08-13
  • Java教程java实现字符串反转

    java实现字符串反转

    这篇文章主要为大家详细介绍了java实现字符串反转,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...

    wanlifeipeng5102020-09-28