springfox

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

http://localhost:8080/demo/v2/api-docs

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;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
    public Docket customDocket() {
        //Docket docket = new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());
        //docket.select().
        
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
                .select()  // 选择那些路径和api会生成document
                //RequestHandlerSelectors.any()
                .apis(RequestHandlerSelectors.basePackage("com.example.swaggerapi")) // 对所有api进行监控
                //.paths(PathSelectors.regex("/testapi")) // 对所有路径进行监控
                .build().enable(true);
        //return docket;
    }

    private ApiInfo apiInfo() {
        Contact contact = new Contact("蜗牛组织", "http://www.snaill", "673684605.com");
        return new ApiInfoBuilder()
                .title("前台API接口")
                .description("前台API接口描述")
                .contact(contact)
                .version("1.1.0")
                .build();
    }

}

@Controller
@Api(value = "测试接口",tags = {"测试接口描述"})
public class TestApi {
    
    
    @RequestMapping(value = "/selectAllUser",method = RequestMethod.POST)
    @ResponseBody
    @ApiOperation(value = "查询用户",notes = "提示")
    public User queryUsers(@ApiParam("主键")String id,User user){
        return new User();
    }

}