
一、前言knife4j是為Java MVC框架集成Swagger生成Api文檔的增強(qiáng)解決方案在非Java項(xiàng)目中也提供了前端UI的增強(qiáng)解決方案前身是swagger-bootstrap-ui,取名knife4j是希望她能像一把匕首一樣小巧,輕量,并且功能強(qiáng)悍!二、快速使用2.1 依賴引入老版本引用dependencygroupIdcom.github.xiaoymin/groupIdartifactIdswagger-bootstrap-ui/artifactIdversion1.9.6/version/dependency新版本引用dependencygroupIdcom.github.xiaoymin/groupIdartifactIdknife4j-spring-boot-starter/artifactIdversion3.0.2/version/dependency2.2 application.yml配置這里我們?yōu)閗nife4j訪問(wèn)增加密碼knife4j:basic:enable:trueusername:adminpassword:1234562.3 創(chuàng)建Swagger配置依賴ConfigurationpublicclassKnife4jConfiguration{Bean(valuedefaultApi2)publicDocketdefaultApi2(){DocketdocketnewDocket(DocumentationType.SWAGGER_2).apiInfo(newApiInfoBuilder()//.title(swagger-bootstrap-ui-demo RESTful APIs).description(# swagger-bootstrap-ui-demo RESTful APIs).termsOfServiceUrl(http://www.wno704.com/).contact(newContact(wno704,http://www.wno704.com,wno704126.com)).version(1.0).build())//分組名稱.groupName(2.X版本).select()//這里指定Controller掃描包路徑.apis(RequestHandlerSelectors.basePackage(com.springboot.boot.controller)).paths(PathSelectors.any()).build();returndocket;}}2.4 編寫(xiě)測(cè)試類Api(tags測(cè)試模塊)RestControllerpublicclassKnife4jController{ApiImplicitParam(namename,value姓名,requiredtrue)ApiOperation(value向客人問(wèn)好)GetMapping(/sayHi)publicResponseEntityStringsayHi(RequestParam(valuename)Stringname){returnResponseEntity.ok(Hi:name);}}2.5 測(cè)試訪問(wèn) http://127.0.0.1:8080/doc.html, 如下輸入上面application.yml配置的密碼后如下圖