首先遵循SpringBoot的三板斧
第一步添加依赖
```pom
io.springfox
springfox-swagger2
{version}
io.springfox
springfox-swagger-ui
{version}
```
第二步添加注解
```java
@EnableSwagger2 //启动SwaggerUI,在启动类或Swagger配置类上添加该注解
```
第三步写配置
```java
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
/*
//可以添加多个header或参数
ParameterBuilder aParameterBuilder = new ParameterBuilder();
aParameterBuilder
//参数类型支持header, cookie, body, query etc
.parameterType("header")
//参数名
.name("user-token")
//默认值
.defaultValue("t122222")
.description("用户登录凭证")
//指定参数值的类型
.modelRef(new ModelRef("string"))
//非必需,这里是全局配置
.required(false).build();
List
aParameters = new ArrayList<>();
aParameters.add(aParameterBuilder.build());
*/
return new Docket(DocumentationType.SWAGGER_2)
// return new Docket(DocumentationType.SPRING_WEB)
.apiInfo(apiInfo())
.pathMapping("/")
.select()// 选择那些路径和api会生成document
.apis(RequestHandlerSelectors.any())// 对所有api进行监控
// 不显示错误的接口地址
.paths(Predicates.not(PathSelectors.regex("/error.*")))// 错误error路径不监控
.paths(Predicates.not(PathSelectors.regex("/actuator.*")))// 错误error路径不监控
.paths(PathSelectors.regex("/.*"))// 对根下所有路径进行监控
.paths(PathSelectors.any()) // 对所有路径进行监控
// 自行修改为自己的包路径
// .apis(RequestHandlerSelectors.basePackage("com.happyloves.zc.service.account.api"))
.build()
// .globalOperationParameters(aParameters)
.enable(true);
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("API接口")
.description("API接口文档")
//服务条款网址
// .termsOfServiceUrl("https://www.google.com")
.version("1.0")
// .contact(new Contact("啦啦啦", "url", "email"))
.build();
}
}
```
扩展:swagger-bootstrap-ui是springfox-swagger的增强UI实现,为Java开发者在使用Swagger的时候,能拥有一份简洁、强大的接口文档体验
**项目地址**
码云:https://gitee.com/xiaoym/swagger-bootstrap-ui
GitHub:https://github.com/xiaoymin/Swagger-Bootstrap-UI
在线体验:http://swagger-bootstrap-ui.xiaominfo.com/doc.html
项目文档:http://www.xiaominfo.com/swagger-bootstrap-ui/
**代码集成示例**
SpringBoot在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo
Spring Mvc在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo/tree/master/swagger-bootstrap-ui-demo-mvc
添加依赖
```pom
com.github.xiaoymin
swagger-bootstrap-ui
1.9.6
```
[赵小胖个人博客](https://zc.happyloves.cn:4443/wordpress/)
原文地址:https://www.cnblogs.com/Sky0914/p/11647321.html
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。