knife4j制作api文档

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

import io.swagger.annotations.ApiOperation;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
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.EnableSwagger2WebMvc;

@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfig {
    // 创建Docket存入容器，Docket代表一个接口文档
    @Bean
    public Docket webApiConfig(){
        return new Docket(DocumentationType.SWAGGER_2)
                // 创建接口文档的具体信息
                .apiInfo(webApiInfo())
                // 创建选择器，控制哪些接口被加入文档
                .select()
                // 指定@ApiOperation标注的接口被加入文档
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .build();
    }

    // 创建接口文档的具体信息，会显示在接口文档页面中
    private ApiInfo webApiInfo(){
        return new ApiInfoBuilder()
                // 文档标题
                .title("标题：系统接口文档")
                // 文档描述
                .description("描述：本文档描述了系统的接口定义")
                // 版本
                .version("1.0")
                // 联系人信息
                .contact(new Contact("龙场悟道中", "https://L5501.run", "L55011225@gmail.com"))
                // 版权
                .license("龙场悟道中")
                // 版权地址
                .licenseUrl("https://L5501.run")
                .build();
    }

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

@Data
@ApiModel("手机实体类")
public class Phone {

    @ApiModelProperty("id")
    private String id;

    @ApiModelProperty("手机名称")
    private String name;

    @ApiModelProperty("手机价格")
    private Double price;
}

import com.ll.knife4j_demo.entity.Phone;
import com.ll.knife4j_demo.entity.User;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("controller1")
@Api(tags = "这是一个应用")
public class TestController {

    @GetMapping("api1/{id}")
    @ApiOperation("api1")
    public void api1(@PathVariable("id") @ApiParam("用户id") String id){
        // 伪代码
    }

    @PostMapping("api2")
    @ApiOperation("api2")
    // 如果这里没有引入User类，则不会在文档中出现User
    public void api2(@RequestBody User user) {
        // 伪代码
    }
}