swagger-dubbo支持dubbo以swagger方式展示文档和rest风格的HTTP模拟测试,主要应用场景有以下几点:
通过dubbo与swagger的集成,提供接口文档的阅读
开发人员可以用它来自测服务接口,也可以用它来模拟别人的服务接口返回值
测试可以用它来验证接口的正确性,基于HTTP进行接口测试
swagger-dubbo从某些方面提高了内部开发测试的效率,注意的是,rest服务不适合对外(前端)提供,务必在服务端或者测试内部使用。
Maven<dependency> <groupId>com.deepoove</groupId> <artifactId>swagger-dubbo</artifactId> <version>2.0.1</version></dependency>两步集成一.使用注解 @EnableDubboSwagger开启dubbo的swagger文档。
package com.deepoove.swagger.dubbo.example;import org.springframework.context.annotation.Configuration;import com.deepoove.swagger.dubbo.annotations.EnableDubboSwagger;@Configuration@EnableDubboSwaggerpublic class SwaggerDubboConfig {}二.在spring的*-servlet.xml配置中,开启属性占位符的配置,开启Configuration注解,声明SwaggerDubboConfig。
<context:annotation-config /><bean class="com.deepoove.swagger.dubbo.example.SwaggerDubboConfig" /><context:property-placeholder />集成已经完毕,启动web容器,浏览器访问 https://ip:port/context/swagger-dubbo/api-docs查看文档。
SpringBoot集成Swagger-dubboSpringBoot对配置做了简化,集成swagger-dubbo只需要使用注解 @EnableDubboSwagger开启dubbo的swagger文档即可。
评论