Documento de ejemplo de Swagger de integración del proyecto Spring Boot

Pavonearse

Use la documentación de Swagger en proyectos de Spring Boot

Introducción a las anotaciones de lombok

documento de anotación de lombok

 Vista previa de la interfaz del proyecto

 Solicitar dirección

http: // localhost: 8080 / swagger-ui.html #

Agregar dependencia de 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>

 

Configuración de la información del documento 

• Springfox proporciona un objeto Docket que nos permite configurar de forma flexible varias propiedades de Swagger.
• @Configuration Le dice a Spring Boot que esta clase de configuración debe cargarse.
• @EnableSwagger2 Swagger2 está habilitado. Si no lo agrega, no verá el efecto de verificación posterior.

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }
    private ApiInfo apiInfo() {
        return new ApiInfo(
                "Spring Boot 项目集成 Swagger 实例文档",
                "我的博客网站：https://blog.csdn.net/xiangwang2016，欢迎大家访问。",
                "API V1.0",
                "Terms of service",
                new Contact("我的播客", "https://blog.csdn.net/xiangwang2016", "[email protected]"),
                "Apache", "http://www.apache.org/", Collections.emptyList());
    }

}

 

Escribir interfaz de prueba 

@Api(tags = "用户相关接口", description = "提供用户相关的 Rest API")
@RestController
@RequestMapping("/user")
public class UserController {

    @ApiOperation("新增用户接口")
    @PostMapping("/add")
    public boolean addUser(@RequestBody People p) {
        return false;
    }

    @ApiOperation("获取用户接口")
    @GetMapping("/find/{id}")
    public People findById(@PathVariable("id") int id) {
        return new People("jack","北京");
    }

    @ApiOperation("更新用户接口")
    @PutMapping("/update")
    public boolean update(@RequestBody People p) {
        return true;
    }

    @ApiOperation("删除用户接口")
    @DeleteMapping("/delete/{id}")
    public boolean delete(@PathVariable("id") int id) {
        return true;
    }
}

 

 Nueva entidad Bean utilizada

anotaciones de lombok : @Data // getter setter, @NoArgsConstructor // sin construcción de parámetros, @AllArgsConstructor // construcción de parámetros

@Data //getter setter
@NoArgsConstructor //无参构造
@AllArgsConstructor  //有参构造
@ApiModel("用户实体")
public class People implements Serializable {
    private static final long serialVersionUID = 1L;
    @ApiModelProperty(value = "用户name")
    private String name;
    @ApiModelProperty(value = "用户 address")
    private String address;
}

 

Comenzar la clase 

•  @EnableScheduling y @EnableCaching se utilizan para el soporte de redis

@SpringBootApplication
@EnableScheduling
@EnableCaching    // @EnableScheduling 、@EnableCaching 用于redis 支持
public class DemospringbootApplication {

    public static void main(String[] args) { SpringApplication.run(DemospringbootApplication.class, args);
    }
}

 

PD

Configuración de Spring Boot redis