1.创建项目(引入两个依赖就可以了)
2.没啥用的删掉
3.导入依赖包
<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>
4.启动项目
默认的/error方法
5.写个controller测试,访问test方法
6.创建Swagger配置文件
7.打开http://localhost:8080/swagger-ui.html(jar包里面的页面),发现有个默认的errorController,还有自己编写的testController
8.修改页面上的信息(配置swagger的bean实例Docket)
8.1是否启用swagger
这里控制只能在dev环境使用swagger
8.2配置swagger信息
@Configuration //配置
@EnableSwagger2 //使用Swagger2
public class swaggerConfig {
//修改页面上的信息(配置swagger的bean实例Docket)
@Bean
public Docket docket() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo());
}
private ApiInfo apiInfo() {
return new ApiInfo(
"Swagger文档",//标题
"搭建swagger",//描述
"v1.0",//版本
"https://blog.csdn.net/weixin_4269/1149",//团队服务地址
new Contact("夜一", "https://blog.csdn.net/weixin_42691149", "349944299@qq.com"),//作者信息
"Apache 2.0",//来源版本号
"http:www.apache.org/license/LICENSE-2.0",//开源版本地址
new ArrayList()
);
}
}
8.3控制页面上controller的显示
8.4配置分组.groupName
8.5 pojo类的显示
只要返回的对象是pojo,那么就会显示
9.注释