knife4j只用此插件的最简洁开发方式

一、POM添加

在pom文件里添加包

<!--引入knife4j以来--> 
<dependency> 
<groupId>com.github.xiaoymin</groupId> 
<artifactId>knife4j-spring-boot-starter</artifactId> <version>1.9.6</version> 
</dependency>

二、配置添加，相当于<bean>添加

package com.mrliu.undertow.conf;

import com.github.xiaoymin.knife4j.spring.annotations.EnableSwaggerBootstrapUi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * @author liuyang
 */
@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUi
public class Swagger2Config {

    /**
     * 创建连接的包信息
     * <p>
     * 配置统一返回的controller路径RequestHandlerSelectors.basePackage
     *
     * @return 返回创建状况
     */
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .useDefaultResponseMessages(false)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.mrliu.undertow.controller"))
                .paths(PathSelectors.any())
                .build();

    }


    /**
     * 设置文档信息主页的内容说明
     *
     * @return 文档信息
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Project textBook API ")
                .description("服务接口")
                .termsOfServiceUrl("http://localhost:8001/")
                .contact(new Contact("Mr Liu", "http://localhost:8999/", "liuyang@synway.cn"))
                .license("what")
                .version("1.0")
                .build();
    }

}

apiInfo()设置后会改变如图

三、bean实体类添加

/**
 * @author Administrator
 */
@ApiModel("用户对象")
@Data
public class UserVO {

    @ApiModelProperty(required = true, notes = "用户名", example = "blues")
    private String name;

    @ApiModelProperty(required = true, notes = "用户返回消息", example = "hello world")
    private String words;


    public UserVO(String name, String words) {
        this.name = name;
        this.words = words;
    }
}

主要是添加注解

@ApiModel("用户对象") -----实体类注解添加 添加后结果如图所示:

@ApiModelProperty(required = true, notes = "用户名", example = "blues") 字段注解添加 添加后结果如图所示:

四、Controller添加

• 1、GET方式访问
  

  package com.mrliu.undertow.controller;
  
  import com.mrliu.undertow.base.Results;
  import com.mrliu.undertow.pojo.UserVO;
  import io.swagger.annotations.*;
  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.PathVariable;
  import org.springframework.web.bind.annotation.RequestMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  import javax.servlet.http.HttpServletRequest;
  import javax.servlet.http.HttpServletResponse;
  import java.io.IOException;
  
  /**
   * @author Administrator
   */
  @Api(tags = "HELLO CONTROLLER 测试功能接口")
  @RestController
  public class HelloController {
  
  
      @ApiImplicitParams({
              @ApiImplicitParam(name = "name",value = "用户名称",required = true,dataType = "String",paramType = "path",example = "blues")
      })
      @ApiResponses(value = {
              @ApiResponse(code = 200, message = "接口返回成功状态"),
              @ApiResponse(code = 500, message = "接口返回未知错误，请联系开发人员调试")
      })
      @ApiOperation(value = "Hello 测试接口", notes = "访问此接口，返回hello语句，测试接口")
      @GetMapping("hello/{name}")
      public Results<UserVO> hello(@PathVariable String name){
          UserVO userVO = new UserVO(name,"hello " + name);
          Results<UserVO> results = new Results<>(200,"SUCCESS", userVO);
          return results;
      }
  }

   界面生成:

• 2、POST方式访问

@Api(tags = "HELLO CONTROLLER 测试功能接口")
@RestController
public class HelloController {


    @ApiImplicitParams({
            @ApiImplicitParam(name = "name",value = "用户名称",required = true,dataType = "String",paramType = "path",example = "blues")
    })
    @ApiResponses(value = {
            @ApiResponse(code = 200, message = "接口返回成功状态"),
            @ApiResponse(code = 500, message = "接口返回未知错误，请联系开发人员调试")
    })
    @ApiOperation(value = "Hello 测试接口", notes = "访问此接口，返回hello语句，测试接口")
    @PostMapping("hello/{name}")
    public Results<UserVO> hello(@RequestBody UserVO userVO){
        Results<UserVO> results = new Results<>(200,"SUCCESS", userVO);
        return results;
    }
}

五、访问URL

http://localhost:7788/doc.html

六、兼容swagger-ui访问

http://localhost:7788/swagger-ui.html

七、测试

填入参数

对象请求访问

八、API文档复制

复制后可生成markdow文档，使用showdoc，即可翻译成文档，下载html、PDF、word等格式


源码地址:https://github.com/liushaoye/knife4j.git  欢迎点赞,分享,推荐