springcloud(五):Swagger2的集成

1、概念

创新互联建站自2013年起,是专业互联网技术服务公司,拥有项目成都网站建设、网站制作网站策划,项目实施与项目整合能力。我们以让每一个梦想脱颖而出为使命,1280元洪江管理区做网站,已为上家服务,为洪江管理区各地企业和个人服务,联系电话:18980820575

   Swagger2 – 服务接口文档,用来前端与后端联系,提高之间的沟通,更有效率的完成项目之间的联调。

2、集成

  2.1 、通过pom文件导入swagger

           

             swagger-springmvc

             swagger-springmvc

            

 2.2、建立swagger模块,编写模块类

         @Configuration

        @EnableWebMvc

        @EnableSwagger

        @ComponentScan(basePackages={"com.sz.xx"})

        public class ApiSwaggerConfig extends WebMvcConfigurerAdapter{

        private SpringSwaggerConfig springSwaggerConfig;

          @Autowired

          public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig)

          {

            this.springSwaggerConfig = springSwaggerConfig;

          }

          @Bean

          public SwaggerSpringMvcPlugin customImplementation()

          {

            return new SwaggerSpringMvcPlugin(this.springSwaggerConfig).apiInfo(apiInfo()).includePatterns(new String[] { "/xx/.*?" })

              .apiVersion("0.0.1")

              .swaggerGroup("api");

          }

          private ApiInfo apiInfo() {

            ApiInfo apiInfo = new ApiInfo("XX API接口文档", "API-DOC", "", "test@163.com", "My License", "My Apps API License URL");

            return apiInfo;

          }

          public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)

          {

            configurer.enable();

          }

          class GtPaths extends SwaggerPathProvider {

            GtPaths() {

            }

            protected String applicationPath() {

              return "/restapi";

            }

            protected String getDocumentationPath()

            {

              return "/restapi";

            }

          }

        }

         }

       

3、代码里面使用swagger

        3.1、UserContoller

        @Api(value="userApi", description="user管理接口", position=1)

        @Controller

        @ApiService

       public class   UserContoller{

         @ApiOperation(notes="新增用户接口", value="新增用户(开发责任人:xx)")

          @ApiServiceOperation("新增用户接口")

            @RequestMapping(value={"/xx/user/add"}, method={RequestMethod.POST})

          @ResponseBody

          public Response createSoftsimBinding(@RequestBody SoftsimBindingCreateReq req)

          {

         }

4、导入swagger相关的ui到项目里面,可以建static文件夹存放swagger的ui文件

5、通过地址http://localhost:8020/swagger/index.html访问


分享标题:springcloud(五):Swagger2的集成
网页链接:http://ybzwz.com/article/pgchip.html