再探motan

前言：上周使用motan是通過group遠程調用超級土豆的服務，但是因為我需要寫一些服務，不得不在本地啟動服務，於是就詳細的自己配置了一次motan。

上一篇博客也說到了，motan主要有3部分組成：registry，server和client。其中我們的registry用的是consul。下麵就這3個部分一個一個的說明：

1、pom.xml 添加motan依賴：

    一般來說，在公共模塊的pom文件里添加依賴就可以了，比如在server、client、dao和common的SNA編程模型下，只要在common的pom文件中添加依賴即可

 1 <dependency>
 2      <groupId>com.weibo</groupId>
 3      <artifactId>motan-core</artifactId>
 4      <version>RELEASE</version>
 5  </dependency>
 6  <dependency>
 7      <groupId>com.weibo</groupId>
 8      <artifactId>motan-transport-netty</artifactId>
 9      <version>RELEASE</version>
10  </dependency>
11  
12  <!-- only needed for spring-based features -->
13  <dependency>
14      <groupId>com.weibo</groupId>
15      <artifactId>motan-springsupport</artifactId>
16      <version>RELEASE</version>
17  </dependency>
18  <dependency>
19      <groupId>org.springframework</groupId>
20      <artifactId>spring-context</artifactId>
21      <version>4.2.4.RELEASE</version>
22  </dependency>

2、配置motan

Motan框架中將功能模塊抽象為四個可配置的元素，分別為：

• protocol：服務通信協議。服務提供方與消費方進行遠程調用的協議，預設為Motan協議，使用hessian2進行序列化，netty作為Endpoint以及使用Motan自定義的協議編碼方式。

• registry：註冊中心。服務提供方將服務信息（包含ip、埠、服務策略等信息）註冊到註冊中心，服務消費方通過註冊中心發現服務。當服務發生變更，註冊中心負責通知各個消費方。

• service：服務提供方提供的服務。使用方將核心業務抽取出來,作為獨立的服務。通過暴露服務並將服務註冊至註冊中心,從而使調用方調用。

• referer：服務消費方對服務的引用，即服務調用方。

       一般來說，在server端需要配置registry、protocol和service；在client端需要配置registry、protocol和referer。

Motan推薦使用spring配置rpc服務，目前Motan擴展了6個自定義Spring xml標簽：

• motan:protocol
• motan:registry
• motan:basicService
• motan:service
• motan:basicReferer
• motan:referer

詳細配置：

<motan:registry/>

　　註冊中心配置。用於配置註冊中心的註冊協議、地址埠、超時時間等。motan:registry包含以下常用屬性：

• • name：標識配置名稱
  • regProtocol：標識註冊中心協議
  • address：標識註冊中心地址

　　Motan支持使用多種Registry模塊，使用不同註冊中心需要依賴對應jar包。

　　以consul為註冊中心舉例：

<motan:registry  regProtocol="consul" 
　　　　　　　　　　name="my_consul" 
　　　　　　　　　　address="${my.consul.address}"/>

　　下表是registry的所有屬性說明：

<motan:service/> 和 <motan:basicService/>

protocol、basic service、extConfig、service中定義相同屬性時，優先順序為service > extConfig > basic service > protocol

　　<motan:service .../>

　　motan:service包含以下常用屬性：

• • interface：標識服務的介面類名
  • ref：標識服務的實現類，引用具體的spring業務實現對象
  • export：標識服務的暴露方式，格式為“protocolId:port”（使用的協議及對外提供的埠號），其中protocolId：應與motan:protocol中的id一致
  • group：標識服務的分組
  • module：標識模塊信息
  • basicService：標識使用的基本配置，引用motan:basicService對象

　　Motan在註冊中心的服務是以group的形式保存的，一般推薦一個分組以機房＋業務線進行命名，如yf-user-rpc。一個分組中包含若幹的Service，一個Service即是java中的一個介面類名，每個Service下有一組能夠提供對應服務的Server。

<motan:basicService .../>

　　rpc服務的通用配置，用於配置所有服務介面的公共配置，減少配置冗餘。basicService包含以下常用屬性：

• • id：標識配置項
  • export：標識服務的暴露方式，格式為“protocolId:port”（使用的協議及對外提供的埠號），其中protocolId：應與motan:protocol中的id一致
  • group：標識服務的分組
  • module：標識模塊信息
  • registry：標識service使用的註冊中心，與motan:registry中的name對應

　　motan:service可以通過以下方式引用基本配置。

<!-- 通用配置，多個rpc服務使用相同的基礎配置. group和module定義具體的服務池。export格式為“protocol id:提供服務的埠” -->
<motan:basicService id="serviceBasicConfig" export="demoMotan:8002" group="motan-demo-rpc" module="motan-demo-rpc" registry="registry"/>
<!-- 通用配置，多個rpc服務使用相同的基礎配置. group和module定義具體的服務池。export格式為“protocol id:提供服務的埠” -->
<motan:service interface="com.weibo.motan.demo.service.MotanDemoService" ref="demoServiceImpl" basicService="serviceBasicConfig"/>

motan:service中的basicService屬性用來標識引用哪個motan:basicService對象，對於basicService中已定義的內容，service不必重覆配置。

下表是service的所有屬性說明：

<motan:referer/>和<motan:basicReferer/>

protocol、basic referer、extConfig、referer中定義相同屬性時，優先順序為referer > extConfig > basic referer > protocol

<motan:referer/>

調用方對象，motan:referer包含以下常用屬性：

• id：標識配置項
• group：標識服務的分組
• module：標識模塊信息
• protocol：標識referer使用的協議，與motan:protocol中的name對應，預設為Motan協議
• registry：標識referer使用的註冊中心，與motan:registry中的name對應
• basicReferer：標識使用的基本配置，引用motan:basicReferer對象

Client端訂閱Service後，會從Registry中得到能夠提供對應Service的一組Server，Client把這一組Server看作一個提供服務的cluster。當cluster中的Server發生變更時，Client端的register模塊會通知Client進行更新。

<motan:basicReferer/>

調用方基礎配置。用於配置所有服務代理的公共屬性。

• id：標識配置項
• group：標識服務的分組
• module：標識模塊信息
• protocol：標識referer使用的協議，與motan:protocol中的name對應，預設為Motan協議
• registry：標識referer使用的註冊中心，與motan:registry中的name對應

motan:referer可以通過以下方式引用基本配置。

<!-- 通用referer基礎配置 -->
<motan:basicReferer id="clientBasicConfig" group="motan-demo-rpc" module="motan-demo-rpc"  registry="registry" protocol="motan"/>

<!-- 具體referer配置。使用方通過beanid使用服務介面類 -->
<motan:referer id="demoReferer" interface="com.weibo.motan.demo.service.MotanDemoService"  basicReferer="clientBasicConfig"/>

motan:referer中的basicService屬性用來標識引用哪個motan:basicReferer對象，對於basicReferer中已定義的內容，service不必重覆配置。

下表是referer的所有屬性說明：