Spring boot整合Springfox生成restful的在线api文档

< dependency >

< groupId >io.springfox</ groupId >

< artifactId >springfox-swagger2</ artifactId >

< version >2.4.0</ version >

</ dependency >

< dependency >

< groupId >io.springfox</ groupId >

< artifactId >springfox-swagger-ui</ artifactId >

< version >2.4.0</ version >

</ dependency >

@Configuration

@EnableSwagger2

public class SwaggerConfig {

     @Bean

     public Docket demoApi() {

         return new Docket(DocumentationType.SWAGGER_2)

                 .groupName( "demo" )

                 .genericModelSubstitutes(DeferredResult. class )

                 .useDefaultResponseMessages( false )

                 .forCodeGeneration( false )

                 //.pathMapping("/") //根路径

                 .select()

                 .paths(PathSelectors.regex( "/user/.*" )) //筛选展示的接口，使用PathSelectors.any()，展示所有接口

                 .build()

                 .apiInfo(demoApiInfo())

                 ;

     }

     //api信息

     private ApiInfo demoApiInfo() {

         ApiInfo apiInfo = new ApiInfo( "自己平台的api" , //大标题

                 "swagger搭建api平台" , //小标题

                 "1.0" , //版本

                 "NO terms of service" ,

                 "632104866@qq测试数据" , //作者

                 "这是我的技术博客站点" , //链接显示文字

                 "http://HdhCmsTestkailing.pub" //网站链接

         );

         return apiInfo;

     }

}

@RestController

@RequestMapping ( "/user" )

public class SwaggerDemoController {

     @RequestMapping (value = "/demo2" ,method = RequestMethod.POST)

     @ApiOperation (value= "测试接口1" , notes= "测试接口详细描述" )

     @ResponseBody

     ModelMap getDemo( @RequestBody User user) {

         ModelMap map = new ModelMap();

         map.addAttribute( "userId" , 111 );

         map.addAttribute( "userName" , "kl博客" );

         return map;

     }

     @ResponseBody

     @RequestMapping (value = "/demo3" , method = RequestMethod.POST)

     @ApiOperation (value= "测试接口2" , notes= "测试接口详细描述" ,code = 200 ,produces = "application/json" )

     public ModelMap getDemoa( @RequestParam ( "name" ) String demoName, @RequestParam String content) {

         ModelMap map = new ModelMap();

         map.addAttribute( "result" ,demoName + "AAA" );

         return map;

     }

     @ResponseBody

     @ApiIgnore //使用这个注解忽略这个接口

     @RequestMapping (value = "/demo4" , method = RequestMethod.POST)

     public ModelMap getDemob( @RequestParam String content) {

         ModelMap map = new ModelMap();

         map.addAttribute( "result" , new java.util.Date());

         return map;

     }

}