Swagger的使用和介绍

较真的菜鸟

已于 2023-11-15 16:31:56 修改

阅读量1.4k

点赞数 1

分类专栏：开发工具文章标签： java spring boot restful

于 2021-05-04 10:38:10 首次发布

本文链接： https://blog.csdn.net/weixin_43790613/article/details/116394660

版权

开发工具专栏收录该内容

3 篇文章 0 订阅

订阅专栏

文章目录

问题
- 使用@Profile({"dev", "test"})不生效

spring-boot集成swagger

需要的依赖

<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
	<version>2.7.0</version>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-ui</artifactId>
	<version>2.7.0</version>
</dependency>
<!--开启账号密码需要此注解-->
<dependency>
	<groupId>com.github.xiaoymin</groupId>
	<artifactId>swagger-bootstrap-ui</artifactId>
	<version>1.9.6</version>
</dependency>

开启账号密码需要的配置

swagger:
  production: false
  basic:
    enable: true
    username: 账号
    password: 密码

配置类

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

import java.util.ArrayList;
@Configuration
@EnableSwagger2 // 开启swagger
@EnableSwaggerBootstrapUI // 开启UI配置功能 ，如果设置需要账号密码登录才能访问则需要此注解
public class SwaggerConfig {

    @Bean
    public Docket docket(Environment environment){
        // 设置要显示的swagger的环境
        Profiles profiles = Profiles.of("dev");// 设置测试环境可访问
        boolean flag = environment.acceptsProfiles(profiles);
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("分组名称")
                .enable(flag) // 设置swagger是否可用
                .select()
                // 有基于包扫描的，有扫描所有的，和不扫描的，点进RequestHandlerSelectors即可看有几种情况
                .apis(RequestHandlerSelectors.basePackage("com.swagger.controller"))
                // 过滤的路径，只有满足这个路径下的才会被扫描，这个路径是在controller里面配置的路径
                // 此处可以配置any方法，扫描所有路径
                .paths(PathSelectors.ant("/controller/hello"))
                .build(); // 配置swagger页面信息

    }

    // 配置swagger信息
    private ApiInfo apiInfo(){
        // 开发者信息
        Contact DEFAULT_CONTACT = new Contact("开发者名字", "组织信息-可以是博客", "开发者邮箱");
        return new ApiInfo(
                "swagger大标题",
                "swagger描述信息",
                "1.0",
                "urn:tos", DEFAULT_CONTACT,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
    }
}

默认访问路径：http://localhost:8080/swagger-ui.html
2.9.2版本是有实体类信息的，2.7.0是没有的

配置swagger

实体类

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

@ApiModel("用户实体类") // 注解的作用
public class User {
    @ApiModelProperty("用户名")
    private String userName;
    @ApiModelProperty("密码")
    private String password;
}

controller类

mport io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/controller")
public class HelloController {

    @ApiOperation("hello的方法")
    @RequestMapping("/hello")
    public String hello(@ApiParam("参数的注解") String name) {
        return "hello";
    }

    @RequestMapping("/hello2")
    public String hello2() {
        return "hello";
    }
}