swagger 英文本意是 昂首阔步;神气十足; 大摇大摆;
什么是Swagger
Swagger是一个功能强大且易于使用的API开发人员工具套件,适用于团队和个人,支持从整个API生命周期(从设计和文档到测试和部署)的开发。
Swagger由开源,免费和商用工具组成,允许任何人,从技术工程师到街头智能产品经理,构建API。
Swagger由SmartBear Software构建,SmartBear Software是团队软件质量工具的领导者。SmartBear是软件领域的一些大牌,包括Swagger,SoapUI和QAComplete。
主要用于页面联调时编写接口,由代码生成接口文档;特别是前后端分离的工程项目,省时高效;
dms-uc中 依赖 2.9.2 版本
导出Swagger测试数据
添加配置类:
@EnableSwagger2
@Configuration
public class Swagger2Config {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
//为当前包路径
.apis(RequestHandlerSelectors.any())
.paths(PathSelectors.any())
.build();
}
//构建 api文档的详细信息函数
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
//页面标题
.title("功能测试")
//创建人
.contact(new Contact(
"",
"https://www.jianshu.com/p/72ec06c1cac8",
""))
//版本号
.version("1.0")
//描述
.description("API for car owner")
.build();
}
}
在controller代码、bean代码中配置好注解后,启动项目;
访问{ip地址}:{端口号}/swagger-ui.html
页面如下