Dubbo Gateway是一個(gè)基于Java語(yǔ)言的Dubbo網(wǎng)關(guān)實(shí)現(xiàn)。基于Dubbo注冊(cè)中心的元數(shù)據(jù)，通過(guò)將HTTP請(qǐng)求轉(zhuǎn)換為Dubbo協(xié)議，泛化調(diào)用的方式返回請(qǐng)求結(jié)果。它具有如下的特性：

1. 使用簡(jiǎn)單，開(kāi)箱即用，非常適用于一些接口測(cè)試場(chǎng)景；
2. 靈活可拓展。通過(guò)Interceptor的實(shí)現(xiàn)，可非常方便實(shí)現(xiàn)熔斷、限流、路由、定制響應(yīng)、用戶(hù)授權(quán)等功能。系統(tǒng)也內(nèi)置了部分Interceptor實(shí)現(xiàn)；
3. 支持僅調(diào)用聲明為對(duì)外開(kāi)放的Dubbo服務(wù)，安全保證。（基于Feature：apache/dubbo#7660?）；
4. 文檔自動(dòng)化生成。基于Javadoc標(biāo)準(zhǔn)的dubbo對(duì)外接口生成系統(tǒng)，API寫(xiě)好即可生成文檔，同時(shí)集成了阿里云OSS，全程僅需幾步參數(shù)配置，即可可視化預(yù)覽文檔。

Requirements

服務(wù)提供者Dubbo 版本：Dubbo 2.7.14+ 或 Dubbo 3.x

Java 版本：1.8+

Guides

以Springboot項(xiàng)目方式，啟動(dòng)Dubbo Gateway網(wǎng)關(guān)：

1、添加依賴(lài)

新建Springboot工程，添加Dubbo Gateway的核心依賴(lài)：

<dependency>
	<groupId>com.kalman03groupId>
	<artifactId>gateway-coreartifactId>
	<version>1.2.0version>
dependency>

當(dāng)然，還需要添加Dubbo的注冊(cè)中心依賴(lài)，以Zookeeper為例：

<dependency>
	<groupId>org.apache.zookeepergroupId>
	<artifactId>zookeeperartifactId>
	<version>${zookeeper_version}version>
	<exclusions>
		<exclusion>
			<groupId>log4jgroupId>
			<artifactId>log4jartifactId>
		exclusion>
		<exclusion>
			<groupId>org.slf4jgroupId>
			<artifactId>slf4j-log4j12artifactId>
		exclusion>
	exclusions>
dependency>
<dependency>
	<groupId>org.apache.curatorgroupId>
	<artifactId>curator-frameworkartifactId>
	<version>${curator_version}version>
dependency>
<dependency>
	<groupId>org.apache.curatorgroupId>
	<artifactId>curator-recipesartifactId>
	<version>${curator_version}version>
dependency>

2、參數(shù)配置

gateway.netty.server.port=80
gateway.netty.server.host=127.0.0.1
gateway.netty.server.connect-timeout=3000
gateway.netty.business.thread-count=50
gateway.dubbo.registry.address=zookeeper://127.0.0.1:2181
gateway.dubbo.openservice=true

3、啟動(dòng)服務(wù)

@SpringBootApplication
@EnableAutoConfiguration
public class DubboGatewayTest {

	public static void main(String[] args) {
		try {
			SpringApplication.run(DubboGatewayTest.class, args);
		} catch (Throwable e) {
			e.printStackTrace();
		}
	}

    //可選自定義攔截器
	@Component
	@Order(100)
	@InterceptorRule(routeRuleType = RouteRuleType.PATH, excludePatterns = { "/api/**" })
	class CustomInterceptor implements HandlerInterceptor {
		@Override
		public boolean preHandle(GatewayHttpRequest request, GatewayHttpResponse response) throws Exception {
			System.out.println("preHandle");
			return true;
		}
		@Override
		public void afterCompletion(GatewayHttpRequest request, GatewayHttpResponse response, Exception ex)
				throws Exception {
			System.out.println("afterCompletion");
		}
	}
}

4、訪問(wèn)目標(biāo)服務(wù)

系統(tǒng)內(nèi)置了PATH路由與MIX路由，也同時(shí)支持自定義路由實(shí)現(xiàn)。下面演示如何通過(guò)不同的路由規(guī)則訪問(wèn)對(duì)應(yīng)的服務(wù)。

• PATH路由（推薦）

  PATH路由是系統(tǒng)內(nèi)置默認(rèn)的路由，也是系統(tǒng)推薦的路由規(guī)則，其擁有較多適用性（既可正常調(diào)用，也可以滿足一些第三方系統(tǒng)的調(diào)用要求，比如支付消息回調(diào)等），路由規(guī)則如下

  HTTP URL:

  http(s)://{domain}:{port}/{appName}/{interfaceName}/{method}/{group}/{version}
  

  HTTP Body?(payload or form-data)：

  {
    "id": 23,
    "username": "testUser"
  }
  

• MIX路由

  考慮到有些參數(shù)相對(duì)于固定不變，且暴露在URL中不盡友善，系統(tǒng)內(nèi)置了一種MIX的路由規(guī)則，將部分路由參數(shù)以Header的參數(shù)形式進(jìn)行傳遞。

  HTTP URL:

  http(s)://{domain}:{port}/{interfaceName}/{method}
  

  HTTP Header:

  x-app-name={appName}
  x-group={group}
  x-version={version}
  x-route-rule=mix
  

  HTTP Body?(payload or form-data)：

  {
    "id": 23,
    "username": "testUser"
  }
  

• CUSTOM自定義路由

  CUSTOM路由專(zhuān)為一些對(duì)PATH路由與MIX路由都不滿意的開(kāi)發(fā)者準(zhǔn)備，只需要繼承AbstractRouteHandlerInterceptor?類(lèi)，即可輕松實(shí)現(xiàn)自定義的路由規(guī)則。

Param Transmission

用戶(hù)端通用參數(shù)（諸如請(qǐng)求UA/Referer/IP等）以及Token用戶(hù)信息等，需要傳遞到服務(wù)提供方。Dubbo Gateway與服務(wù)提供者之間內(nèi)置的參數(shù)傳遞走Dubbo的RpcContext。

Dubbo網(wǎng)關(guān)內(nèi)置了gatewayConsumerFilter與gatewayProviderFilter，可作為Dubbo服務(wù)提供者的默認(rèn)Filter實(shí)現(xiàn)，通過(guò)該Filter可獲取用戶(hù)端請(qǐng)求的一些參數(shù)以及自定義攔截器封裝的參數(shù)。當(dāng)然，開(kāi)發(fā)者也可自行在服務(wù)提供方讀取RpcContext中的傳遞參數(shù)。

更多使用方式，參考：gateway-samples?與?gateway-samples-provider

Attention

Dubbo Gateway對(duì)Dubbo服務(wù)提供者提供的對(duì)外服務(wù)有一條要求：只能有一個(gè)服務(wù)入?yún)ⅲ覟閷?duì)象類(lèi)型（非普通Java數(shù)據(jù)類(lèi)型）。