Documento de exemplo Swagger de integração do projeto Spring Boot

Arrogância

Use a documentação do Swagger em projetos Spring Boot

Introdução às anotações lombok

documento de anotação lombok

 Visualização da interface do projeto

 Solicitar endereço

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

Adicionar dependência 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>

 

Configuração da informação do documento 

• Springfox fornece um objeto Docket que nos permite configurar com flexibilidade várias propriedades do Swagger.
• @Configuration Diz ao Spring Boot que esta classe de configuração precisa ser carregada.
• @EnableSwagger2 O Swagger2 está ativado. Se você não adicioná-lo, não verá o efeito de verificação subsequente.

@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());
    }

}

 

Interface de teste de escrita 

@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;
    }
}

 

 Nova entidade Bean usada

anotações lombok : @Data // getter setter, @NoArgsConstructor // sem construção de parâmetro, @AllArgsConstructor // construção de parâmetro

@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;
}

 

Começar a aula 

•  @EnableScheduling e @EnableCaching são usados ​​para suporte a redis

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

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

 

PS

Configuração do Spring Boot redis