swagger部署和dubbo集成（一）dubbo swagger接入

参考文档

swagger ui 源码地址 https://github.com/swagger-api/swagger-ui ，swagger ui由nodejs开发，可以根据项目要求让前端人员进行二次开发

swagger dubbo集成参考文档：https://github.com/Sayi/swagger-dubbo

swagger dubbo引入mock 参考文档：https://blog.csdn.net/gloomy_114/article/details/73500818

Swagger围绕着OpenAPI规范，提供了一套设计、构建、文档化rest api的开源工具。

swagger-dubbo主要作用是swagger式的文档化+rest风格的HTTP模拟测试。

通过swagger阅读接口文档
开发人员可以用它来自测服务接口，也可以用它来模拟别人的服务接口返回值
测试可以用它来验证接口的正确性，基于HTTP进行接口测试

swagger-dubbo从某些方面提高了内部开发测试的效率，注意的是，rest服务不适合对外(前端)提供，务必在服务端或者测试内部使用

Maven

<dependency>

<groupId>com.deepoove</groupId>

<artifactId>swagger-dubbo</artifactId>

<version>2.0.1</version>

</dependency>

swagger集成

一. 使用注解 @EnableDubboSwagger开启dubbo的swagger文档。

package com.deepoove.swagger.dubbo.example;

import org.springframework.context.annotation.Configuration;

import com.deepoove.swagger.dubbo.annotations.EnableDubboSwagger;

@Configuration

@EnableDubboSwagger

public class SwaggerDubboConfig {

}

二. 在spring的*-servlet.xml配置中，开启属性占位符的配置，开启Configuration注解，声明SwaggerDubboConfig。

<mvc:annotation-driven/><context:annotation-config />
<bean class="com.wt.swagger.dubbo.config.SwaggerDubboConfig" />
<context:property-placeholder />
 
三.配置跨域支持
<!-- 跨域支持，Spring4.3.10+，低版本请设置拦截器开启跨域 --><mvc:cors>
  <mvc:mapping path="/swagger-dubbo/**" allowed-origins="*" />
</mvc:cors>
 
四.配置项修改
swagger-dubbo默认无需任何配置，但是也提供了一些可选项。我们这里强制大家都需要把配置给添加进去。
如果是没有接入apollo配置中心，则在新增文件swagger-dubbo.properties，加载配置文件，并且在antx配置文件中添加相应的配置项。
 <context:property-placeholder location="classpath*:swagger-dubbo.properties" />

配置项说明：

#http请求地址，默认为http://ip:port/h/com.XXX.XxService/methodswagger.dubbo.http=h
 
#dubbo 服务版本号
swagger.dubbo.application.version = 1.0
#dubbo服务groupId
swagger.dubbo.application.groupId = com.wt
#dubbo服务artifactId
swagger.dubbo.application.artifactId = payment-service
 
#rpc zk调用 or 本地调用
swagger.dubbo.cluster = rpc
 
#是否启用swagger-dubbo，默认为true,如果是生产环境就设置为false
swagger.dubbo.enable = true
 
五.备注
以上配置步骤，都是基于项目中已经引入了springmvc相关依赖为前提，如果项目中没有则需要自行加入。
集成已经完毕，启动web容器，浏览器访问 http://ip:port/context/swagger-dubbo/api-docs查看文档。
这里已payment为例：http://120.26.205.32:9023/payment/swagger-dubbo/api-docs
swagger-ui查看文档swagger-ui访问地址如下：http://101.37.117.177:8080/static/#/