2018 最新 spring boot 整合 swagger2 (swagger2 版本 2.8.0)
2018-02-28 10:31
591 查看
pom.xml 包引入
以下为代码配置:
package net.ainio.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
// 自行修改为自己的包路径
.apis(RequestHandlerSelectors.basePackage("net.ainio.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("api文档")
.description("restfun 风格接口")
//服务条款网址
//.termsOfServiceUrl("http://blog.csdn.net/forezp")
.version("1.0")
//.contact(new Contact("帅呆了", "url", "email"))
.build();
}
}
测试controller
注意下这两个的区别哦, 不然前台会返回 404 错误@RestController
启动后访问 http://localhost:8099/swagger-ui.html
<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.8.0</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.8.0</version> </dependency>先检查Maven中包是否导入, 以下以idea为列. 看是否有 swagger-ui 这个包
以下为代码配置:
package net.ainio.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
// 自行修改为自己的包路径
.apis(RequestHandlerSelectors.basePackage("net.ainio.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("api文档")
.description("restfun 风格接口")
//服务条款网址
//.termsOfServiceUrl("http://blog.csdn.net/forezp")
.version("1.0")
//.contact(new Contact("帅呆了", "url", "email"))
.build();
}
}
测试controller
注意下这两个的区别哦, 不然前台会返回 404 错误@RestController
@Controller
package net.ainio.controller; import io.swagger.annotations.Api; import io.swagger.annotations.ApiImplicitParam; import io.swagger.annotations.ApiOperation; import org.apache.catalina.User; import org.springframework.web.bind.annotation.*; @Api(value="/test", tags="测试接口模块") @RestController @RequestMapping("/test") public class TestSwaggerController { @ApiOperation(value="展示首页信息", notes = "展示首页信息") @GetMapping("/show") public Object showInfo(){ return "hello world"; } @ApiOperation(value="添加用户信息", notes = "添加用户信息") @ApiImplicitParam(name="user", value="User", required = true, dataType = "User") @PostMapping("/addUser") public Object addUser(@RequestBody User user){ return "success"; } }
启动后访问 http://localhost:8099/swagger-ui.html
相关文章推荐
- 最新版本Spring、Hibernate、Struts框架整合
- 最新版本Spring、Hibernate、Struts框架整合
- Swagger(一) SpringBoot整合Swagger2简单的例子
- Spring Boot整合Swagger2的完整步骤详解
- spring boot最新教程(三):Spring Boot整合JdbcTemplate以及事务管理
- spring boot 整合Swagger2
- 最新spring boot搭建,整合jsp页面以及打war包配置
- Spring Boot整合ElasticSearch实现多版本兼容的方法详解
- SpringBoot整合Dubbo2.5.10,使用官方最新spring-boot-starter
- 【备忘】2017年最新 项目实战 Spring Boot视频教程 微服务整合Mybatis
- 最新版本Spring、Hibernate、Struts框架整合
- SpringBoot整合ElasticSearch实现多版本的兼容
- SpringBoot(七):SpringBoot整合Swagger2
- 最新版本Spring、Hibernate、Struts框架整合
- spring boot整合Swagger2
- 被版本更新坑到哭系列:SpringBoot整合Kafka
- SpringBoot整合系列-整合Swagger2
- spring boot整合Swagger2的示例代码
- 最新版本Spring、Hibernate、Struts框架整合
- Swagger(一) SpringBoot整合Swagger2简单的例子