前后端API文档 knife4j

文档地址
ip:端口号/资源路径/doc.html

swagger 版本 3.0.3 2.0.8 ，springboot 版本选择2.7 以下不然会有空指针异常

		org.springframework.boot
		spring-boot-starter-parent
		2.3.5.RELEASE
		 
	
	com.example
	swagger
	0.0.1-SNAPSHOT
	swagger
	swagger
	
		1.8
		3.0.3
	
	

		
			org.springframework.boot
			spring-boot-devtools
			runtime
		
		
			org.springframework.boot
			spring-boot-starter-web
		

		
			org.springframework.boot
			spring-boot-starter-test
			test
		
		
		
			com.github.xiaoymin
			knife4j-spring-boot-starter
			
			${swagger.version}
		
		
			org.projectlombok
			lombok
		
	

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                // 控制层包名，会自动扫描包里的所有接口
                .apis(RequestHandlerSelectors.basePackage("com.example.swagger.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        // 展示在主页的信息
        return new ApiInfoBuilder()
                // 文档标题
                .title("swagger测试")
                // 文档描述
                .description("swagger测试示例文档")
                // 你的联系方式
                .contact(new Contact("AllenIverrui", "test", "3037256239@qq.com"))
                // 文档版本
                .version("1.0")
                .build();
    }
}

@Data
@AllArgsConstructor
@NoArgsConstructor
public class HelloDTO {
    @ApiModelProperty("文本")
    String text;
}

@RestController
@Api(tags = "heloo 控制模块")
@RequestMapping("/HelloController")
public class HelloController {

    @ApiOperation("test1")
    @GetMapping("/test1")
    public HelloDTO  Test1(){
        return new HelloDTO("test123");
    }
}