swagger 英文本意是 昂首闊步;神氣十足; 大搖大擺;
什么是Swagger
Swagger是一個(gè)功能強(qiáng)大且易于使用的API開發(fā)人員工具套件吴藻,適用于團(tuán)隊(duì)和個(gè)人瞒爬,支持從整個(gè)API生命周期(從設(shè)計(jì)和文檔到測試和部署)的開發(fā)。
Swagger由開源,免費(fèi)和商用工具組成侧但,允許任何人矢空,從技術(shù)工程師到街頭智能產(chǎn)品經(jīng)理,構(gòu)建API禀横。
Swagger由SmartBear Software構(gòu)建屁药,SmartBear Software是團(tuán)隊(duì)軟件質(zhì)量工具的領(lǐng)導(dǎo)者。SmartBear是軟件領(lǐng)域的一些大牌柏锄,包括Swagger酿箭,SoapUI和QAComplete。
主要用于頁面聯(lián)調(diào)時(shí)編寫接口趾娃,由代碼生成接口文檔缭嫡;特別是前后端分離的工程項(xiàng)目,省時(shí)高效抬闷;
dms-uc中 依賴 2.9.2 版本
導(dǎo)出Swagger測試數(shù)據(jù)
添加配置類:
@EnableSwagger2
@Configuration
public class Swagger2Config {
@Bean
? ? public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
//為當(dāng)前包路徑
? ? ? ? ? ? ? ? .apis(RequestHandlerSelectors.any())
.paths(PathSelectors.any())
.build();
}
//構(gòu)建 api文檔的詳細(xì)信息函數(shù)
? ? private ApiInfo apiInfo() {
return new ApiInfoBuilder()
//頁面標(biāo)題
? ? ? ? ? ? ? ? .title("功能測試")
//創(chuàng)建人
? ? ? ? ? ? ? ? .contact(new Contact(
"",
"http://www.reibang.com/p/72ec06c1cac8",
""))
//版本號
? ? ? ? ? ? ? ? .version("1.0")
//描述
? ? ? ? ? ? ? ? .description("API for car owner")
.build();
}
}
在controller代碼妇蛀、bean代碼中配置好注解后,啟動(dòng)項(xiàng)目笤成;
訪問{ip地址}:{端口號}/swagger-ui.html
頁面如下