前言

我們?cè)陂_發(fā)一個(gè)Java Web的項(xiàng)目，如果項(xiàng)目整體采用前后端分離的架構(gòu)的方式，我們會(huì)經(jīng)常使用Swagger來(lái)進(jìn)行接口調(diào)試和為前端提供接口文檔，但是Swagger并沒(méi)有實(shí)際上那么方便，比如我們?cè)诎l(fā)送Post請(qǐng)求時(shí)，參數(shù)選填還是非常不友好，那么有沒(méi)有更好的工具呢？

正文

knife4j

knife4j是為Java MVC框架集成Swagger生成Api文檔的增強(qiáng)解決方案,前身是swagger-bootstrap-ui,具有小巧,輕量,并且功能強(qiáng)悍的優(yōu)點(diǎn)。

Knife4j提供兩大核心功能：文檔說(shuō)明 和 在線調(diào)試

文檔說(shuō)明：根據(jù)Swagger的規(guī)范說(shuō)明，詳細(xì)列出接口文檔的說(shuō)明，包括接口地址、類型、請(qǐng)求示例、請(qǐng)求參數(shù)、響應(yīng)示例、響應(yīng)參數(shù)、響應(yīng)碼等信息，使用swagger-bootstrap-ui能根據(jù)該文檔說(shuō)明，對(duì)該接口的使用情況一目了然。

在線調(diào)試：提供在線接口聯(lián)調(diào)的強(qiáng)大功能，自動(dòng)解析當(dāng)前接口參數(shù),同時(shí)包含表單驗(yàn)證，調(diào)用參數(shù)可返回接口響應(yīng)內(nèi)容、headers、Curl請(qǐng)求命令實(shí)例、響應(yīng)時(shí)間、響應(yīng)狀態(tài)碼等信息，幫助開發(fā)者在線調(diào)試，而不必通過(guò)其他測(cè)試工具測(cè)試接口是否正確,簡(jiǎn)潔、強(qiáng)大。

SpringBoot使用knife4j進(jìn)行在線接口調(diào)試

注入依賴

<dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-spring-boot-starter</artifactId> <version>2.0.4</version></dependency>

SwaggerConfig.class :knife4j配置類

@Configuration@EnableSwagger2@EnableKnife4j@Import(BeanValidatorPluginsConfiguration.class)public class SwaggerConfig { /** * 這里配置swagger掃描的包 * @return */ @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select().apis(RequestHandlerSelectors .basePackage('com.luo.producer')).paths(PathSelectors.any()).build(); } /** * 這里配置swagger對(duì)外提供服務(wù)的端口 * @return */ private ApiInfo apiInfo() { return new ApiInfoBuilder().title('發(fā)布模擬boos接口').description('簡(jiǎn)單優(yōu)雅的發(fā)布模擬boos接口restful風(fēng)格接口')// .termsOfServiceUrl('http://127.0.0.1:8080/doc.html').version('1.0').build(); }}

驗(yàn)證

測(cè)試接口

@RestController@Slf4jpublic class UserController { @GetMapping('/helloword') public String hello(String input){ return '你好，'+input; } }

啟動(dòng)項(xiàng)目后：訪問(wèn)http://127.0.0.1:8080/doc.html

訪問(wèn)測(cè)試接口，進(jìn)行測(cè)試：

到此這篇關(guān)于SpringBoot使用knife4j進(jìn)行在線接口調(diào)試的文章就介紹到這了,更多相關(guān)SpringBoot knife4j在線接口調(diào)試內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)！