一看就懂之Swagger神器(Java版)


前言

提示:这里可以添加本文要记录的大概内容:

例如:随着人工智能的不断发展,机器学习这门技术也越来越重要,很多人都开启了学习机器学习,本文就介绍了机器学习的基础内容。


一、Swagger是什么?

Swagger 是一个规范且完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。

  • 支持 API 自动生成同步的在线文档:使用 Swagger 后可以直接通过代码生成文档,不再需要自己手动编写接口文档了,对程序员来说非常方便,可以节约写文档的时间去学习新技术。
  • 2.提供 Web 页面在线测试 API:光有文档还不够,Swagger 生成的文档还支持在线测试。参数和格式都定好了,直接在界面上输入参数对应的值即可在线测试接口。

二、使用步骤

1.引入swagger依赖

<!--swagger依赖-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>

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

2.编写代码

代码如下(示例):

新建3个配置文件,目的是:如果指定开发环境,即可以访问swagger-ui界面,当指定生产环境,无法访问swagger-ui界面

application.properties

spring.profiles.active=pro

application-dev.properties(开发环境)

## 开发环境
server.port=8081

application-pro.properties(生产环境)

## 生产环境
server.port=8082

User类

@ApiModel("用户实体类")
@NoArgsConstructor
@AllArgsConstructor
public class User {

    @ApiModelProperty("用户名")
    public String userName;

    @ApiModelProperty("密码")
    public String passWord;
}

Controller类

@RestController
@RequestMapping("/user")
@Api(tags = "用户模块控制器类",description = "此处放一些描述信息...")
public class UserController {

    @GetMapping("/get")
    //get 无参
    public User getUser(){
        return  new User();
    }

    @GetMapping("/get2")
    //get 有参
    public User getUser2(String userName,String password){
        User user = new User();
        user.userName = userName;
        user.passWord = password;
        return  user;
    }

    @ApiOperation("post测试类")
    @PostMapping("/post")
    //post 有参
    public User postUser(@RequestBody @ApiParam("用户") User user){
        return  user;
    }
}

swagger配置类

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket docket(Environment environment) {
        Profiles profiles = Profiles.of("pro");
        //判断是否是在设定环境
        boolean flag = environment.acceptsProfiles(profiles);
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                //决定swagger展示与否,生产环境不能展示
                .enable(flag)
                .groupName("用户模块")
                .select()
                //指定包名 basePackage
                .apis(RequestHandlerSelectors.basePackage("com.tao.swagger.controller"))
                //再次过滤(根据接口过滤)
                .paths(PathSelectors.ant("/user/**"))
                .build();
    }

    @Bean
    public Docket docket02(Environment environment) {
        Profiles profiles = Profiles.of("pro");
        //判断是否是在设定环境
        boolean flag = environment.acceptsProfiles(profiles);
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("支付模块")
                //决定swagger展示与否,生产环境不能展示
                .enable(flag)
                ;
    }

    @Bean
    public Docket docket03(Environment environment) {
        Profiles profiles = Profiles.of("pro");
        //判断是否是在设定环境
        boolean flag = environment.acceptsProfiles(profiles);
        //判断是否是在设定环境
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("订单模块")
                //决定swagger展示与否,生产环境不能展示
                .enable(flag)
                ;
    }

    private ApiInfo apiInfo() {
        //contact 维护接口人信息
        Contact contact = new Contact("匿名", "https://www.bilibili.com/video/BV1Y441197Lw?p=2", "tao3348197787@163.com");
        return new ApiInfo(
                //标题
                "飞星写java",
                //描述
                "增加注释,实时更新,在线测试",
                //版本
                "v1.0",
                //服务条款网址
                "urn:tos",
                //维护人信息
                contact,
                //许可
                "Apache 2.0",
                //许可链接
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
        //如果不想用那么多参数,可以用下边这种自定义参数
        //        new ApiInfoBuilder().contact().title().description().version().build();
    }
}

马上来查看效果吧:
访问地址:

http://localhost:8082/swagger-ui.html

效果展示
在这里插入图片描述

这就是首页的样子,右上角是模块,上边是一些信息,下班是各个接口


在这里插入图片描述
这个即是针对某个接口的在线测试,输入参数,返回响应结果。

总结

总的来说,swagger已经成为程序员必不可缺的调试工具,如果想要详细源码或者不懂的地方关注公众号,我来帮你解答~

在这里插入图片描述

有惊喜哟~
在这里插入图片描述


版权声明:本文为qq_42429369原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。