Dubbo Gateway是一個基于Java語言的Dubbo網關實現。基于Dubbo注冊中心的元數據，通過將HTTP請求轉換為Dubbo協議，泛化調用的方式返回請求結果。它具有如下的特性：

1. 使用簡單，開箱即用，非常適用于一些接口測試場景；
2. 靈活可拓展。通過Interceptor的實現，可非常方便實現熔斷、限流、路由、定制響應、用戶授權等功能。系統也內置了部分Interceptor實現；
3. 支持僅調用聲明為對外開放的Dubbo服務，安全保證。（基于Feature：apache/dubbo#7660?）；
4. 文檔自動化生成。基于Javadoc標準的dubbo對外接口生成系統，API寫好即可生成文檔，同時集成了阿里云OSS，全程僅需幾步參數配置，即可可視化預覽文檔。

Requirements

服務提供者Dubbo 版本：Dubbo 2.7.14+ 或 Dubbo 3.x

Java 版本：1.8+

Guides

以Springboot項目方式，啟動Dubbo Gateway網關：

1、添加依賴

新建Springboot工程，添加Dubbo Gateway的核心依賴：

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

當然，還需要添加Dubbo的注冊中心依賴，以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、參數配置

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、啟動服務

@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、訪問目標服務

系統內置了PATH路由與MIX路由，也同時支持自定義路由實現。下面演示如何通過不同的路由規則訪問對應的服務。

• PATH路由（推薦）

  PATH路由是系統內置默認的路由，也是系統推薦的路由規則，其擁有較多適用性（既可正常調用，也可以滿足一些第三方系統的調用要求，比如支付消息回調等），路由規則如下

  HTTP URL:

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

  HTTP Body?(payload or form-data)：

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

• MIX路由

  考慮到有些參數相對于固定不變，且暴露在URL中不盡友善，系統內置了一種MIX的路由規則，將部分路由參數以Header的參數形式進行傳遞。

  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路由專為一些對PATH路由與MIX路由都不滿意的開發者準備，只需要繼承AbstractRouteHandlerInterceptor?類，即可輕松實現自定義的路由規則。

Param Transmission

用戶端通用參數（諸如請求UA/Referer/IP等）以及Token用戶信息等，需要傳遞到服務提供方。Dubbo Gateway與服務提供者之間內置的參數傳遞走Dubbo的RpcContext。

Dubbo網關內置了gatewayConsumerFilter與gatewayProviderFilter，可作為Dubbo服務提供者的默認Filter實現，通過該Filter可獲取用戶端請求的一些參數以及自定義攔截器封裝的參數。當然，開發者也可自行在服務提供方讀取RpcContext中的傳遞參數。

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

Attention

Dubbo Gateway對Dubbo服務提供者提供的對外服務有一條要求：只能有一個服務入參，且為對象類型（非普通Java數據類型）。