1.1配置类
先导一个配置类,配置类的配置如下
@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfiguration {
@Bean(value = "defaultApi2")
public Docket defaultApi2() {
Docket docket = new Docket(DocumentationType.SWAGGER_2)
.apiInfo(new ApiInfoBuilder()
.title("测试==demo")
.description("# swagger-bootstrap-ui-demo RESTful APIs")
.termsOfServiceUrl("http://www.xx.com/")
.contact(new Contact("玉面小白龙", "", "123@qq.com"))
.version("1.0")
.build())
//分组名称
.groupName("2.X版本")
.select()
//这里指定文档Controller层扫描包路径
.apis(RequestHandlerSelectors.basePackage("com.**.controller"))
.paths(PathSelectors.any())
.build();
return docket;
}
}
1.2依赖导入
配置文件好了后,我们导入3个依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
3个依赖,导入完后再去配置文件里配置一下mvc版本的问题,防止底下启动报错
3.spring-mvc
核心是mvc那一块,我是手敲了一个,配置文件不能出问题,出了问题启动报错
我是新创了一个项目弄得,事实证明可以用,启动后ip:端口/doc.html
就有了
如果加了拦截器,拦截器需要放行