Dubbo | Dubbo快速上手筆記 - 環境與配置

目錄

• 前言
• 1. Dubbo相關概念
  • 1.1 自動服務發現工作原理
• 2. 啟動檔案
  • 2.1 zookeeper-3.4.11\bin\zkServer.cmd
  • 2.2 zookeeper-3.4.11\bin\zkCli.cmd
  • 2.3 java -jar dubbo-admin-0.0.1-SNAPSHOT.jar
  • 2.4 dubbo-monitor-simple-2.0.0\assembly.bin\start.bat
• 3. 修改專案檔案
  • 3.1 在pom.xml檔案裡匯入相關依賴
  • 3.2 在application.properties檔案 / src/main/resources/provider.xml檔案中配置dubbo
  • 3.2.1 提供者
  • 3.2.2 消費者
  • 3.3 使用註解開啟功能
• 4. 配置檔案
  • 4.1 配置檔案的優先順序
  • 4.2 不同粒度配置的覆蓋關係
  • 4.3 關閉啟動檢查check
  • 4.4 超時timeout
  • 4.5 重試次數retries
  • 4.6 多版本version
  • 4.7 本地存根stub
  • 4.8 SpringBoot與Dubbo整合的三種方式
• 最後

---

前言

比較基礎的dubbo學習筆記，一些參考資料如下：

尚矽谷Dubbo教程(dubbo經典之作)

Dubbo官網

Dubbo 2.x文件

---

1. Dubbo相關概念

1.1 自動服務發現工作原理

2. 啟動檔案

這裡指使用zookeeper作為註冊中心；並啟動相關dubbo監控；

2.1 zookeeper-3.4.11\bin\zkServer.cmd

可以在zookeeper-3.4.11\conf路徑下配置zookeeper客戶端的埠號以及data資料：

在zookeeper-3.4.11\bin目錄下執行cmd啟動zookeeper服務：

2.2 zookeeper-3.4.11\bin\zkCli.cmd

在zookeeper-3.4.11\bin目錄下執行cmd啟動zookeeper客戶端：

2.3 java -jar dubbo-admin-0.0.1-SNAPSHOT.jar

可以在incubator-dubbo-ops-master\dubbo-admin\src\main\resources路徑下修改application.properties檔案中修改DubboWeb介面的埠：

在專案根路徑下開啟命令列，執行mvn clean package將專案打成jar包，再執行java -jar dubbo-admin-0.0.1-SNAPSHOT.jar命令執行Dubbo；

2.4 dubbo-monitor-simple-2.0.0\assembly.bin\start.bat

可以在dubbo-monitor-simple-2.0.0\conf路徑下的dubbo.properties檔案配置監控頁埠：

在dubbo-monitor-simple-2.0.0\assembly.bin路徑下雙擊執行start.bat檔案：

3. 修改專案檔案

需要對專案檔案做些修改；以開啟dubbo相關功能；

3.1 在pom.xml檔案裡匯入相關依賴

<!-- 引入dubbo -->
<!-- https://mvnrepository.com/artifact/com.alibaba/dubbo -->
<dependency>
	<groupId>com.alibaba</groupId>
	<artifactId>dubbo</artifactId>
	<version>2.6.2</version>
</dependency>
<!-- 註冊中心使用的是zookeeper，引入操作zookeeper的客戶端端 -->
<dependency>
	<groupId>org.apache.curator</groupId>
	<artifactId>curator-framework</artifactId>
	<version>2.12.0</version>
</dependency>

3.2 在application.properties檔案 / src/main/resources/provider.xml檔案中配置dubbo

3.2.1 提供者

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd
		http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

	<!-- 1、指定當前服務/應用的名字（同樣的服務名字相同，不要和別的服務同名） -->
	<dubbo:application name="user-service-provider"></dubbo:application>
	
	<!-- 2、指定註冊中心的位置 -->
	<!-- <dubbo:registry address="zookeeper://127.0.0.1:2181"></dubbo:registry> -->
	<dubbo:registry protocol="zookeeper" address="127.0.0.1:2181"></dubbo:registry>
	
	<!-- 3、指定通訊規則（name指定通訊協議？通訊埠） -->
	<dubbo:protocol name="dubbo" port="20882"></dubbo:protocol>
	
	<!-- 4、暴露服務   ref：指向服務的真正的實現物件 -->
	<dubbo:service interface="com.atguigu.gmall.service.UserService" 
		ref="userServiceImpl01" timeout="1000" version="1.0.0">
		<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
	</dubbo:service>
	
	<!--統一設定服務提供方的規則  -->
	<dubbo:provider timeout="1000"></dubbo:provider>
	
	
	<!-- 服務的實現 -->
	<bean id="userServiceImpl01" class="com.atguigu.gmall.service.impl.UserServiceImpl"></bean>
	
	
	<dubbo:service interface="com.atguigu.gmall.service.UserService" 
		ref="userServiceImpl02" timeout="1000" version="2.0.0">
		<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
	</dubbo:service>
	<bean id="userServiceImpl02" class="com.atguigu.gmall.service.impl.UserServiceImpl2"></bean>
	
	<!-- 連線監控中心 -->
	<dubbo:monitor protocol="registry"></dubbo:monitor>
	
</beans>

3.2.2 消費者

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd
		http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd
		http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
    <!--啟用包掃描-->
	<context:component-scan base-package="com.atguigu.gmall.service.impl"></context:component-scan>


	<dubbo:application name="order-service-consumer"></dubbo:application>
	
	<dubbo:registry address="zookeeper://127.0.0.1:2181"></dubbo:registry>
	
	<!--  配置本地存根-->
	
	<!--宣告需要呼叫的遠端服務的介面；生成遠端服務代理  -->
	<!-- 
		1）、精確優先 (方法級優先，介面級次之，全域性配置再次之)
		2）、消費者設定優先(如果級別一樣，則消費方優先，提供方次之)
	-->
	<!-- timeout="0" 預設是1000ms-->
	<!-- retries="":重試次數，不包含第一次呼叫，0代表不重試-->
	<!-- 冪等（設定重試次數）【查詢、刪除、修改】、非冪等（不能設定重試次數）【新增】 -->
	<dubbo:reference interface="com.atguigu.gmall.service.UserService" 
		id="userService" timeout="5000" retries="3" version="*">
		<!-- <dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method> -->
	</dubbo:reference>
		
	<!-- 配置當前消費者的統一規則：所有的服務都不檢查 -->
	<dubbo:consumer check="false" timeout="5000"></dubbo:consumer>

	<dubbo:monitor protocol="registry"></dubbo:monitor>
	<!-- <dubbo:monitor address="127.0.0.1:7070"></dubbo:monitor> -->
	
</beans>

在進行SpringBoot整合Dubbo時，以上資訊可以配置進application.properties檔案裡；詳情請見《4.8 SpringBoot與Dubbo整合的三種方式》

3.3 使用註解開啟功能

註解	位置	功能
@EnableDubbo	開啟dubbo相關功能	主啟動類
@Service	暴露服務	服務提供者provider
@Reference	遠端呼叫	服務消費者consumer

4. 配置檔案

Dubbo 的 XML Schema 配置參考手冊

dubbo:consumer 配置

4.1 配置檔案的優先順序

• JVM 啟動 -D 引數優先；
• XML 次之；
• Properties 最後，相當於預設值；

4.2 不同粒度配置的覆蓋關係

• 越上面優先順序越高；
• 精確優先 (方法級優先，介面級次之，全域性配置再次之)；
• 消費者設定優先(如果級別一樣，則消費方優先，提供方次之)；

4.3 關閉啟動檢查check

提供者有三種關閉啟動檢查註冊中心的配置：

• Spring配置檔案

<!-- 關閉某個服務的啟動時檢查 (沒有提供者時報錯) -->
<dubbo:reference interface="com.foo.BarService" check="false" />
	
<!-- 關閉所有服務的啟動時檢查 (沒有提供者時報錯) -->
<dubbo:consumer check="false" />

<!-- 關閉註冊中心啟動時檢查 (註冊訂閱失敗時報錯) -->
<dubbo:registry check="false" />

• dubbo.properties

dubbo.reference.com.foo.BarService.check=false
dubbo.reference.check=false
dubbo.consumer.check=false
dubbo.registry.check=false

• 通過 -D 引數

java -Ddubbo.reference.com.foo.BarService.check=false
java -Ddubbo.reference.check=false
java -Ddubbo.consumer.check=false 
java -Ddubbo.registry.check=false

消費者有一種關閉啟動檢查服務提供者的配置：

<dubbo:reference check="false"/>

4.4 超時timeout

提供者：

<!-- 配置超時時間 -->
<dubbo:service interface="com.atguigu.gmall.service.UserService" 
	ref="userServiceImpl01" timeout="1000"">
	<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
</dubbo:service>

消費者：

<!-- 配置超時時間 -->
<dubbo:reference interface="com.foo.BarService" 
	id="BarService" timeout="5000">
</dubbo:reference>

<!-- 還可以給具體方法配置超時時間(假設BarService裡有testMethod方法) -->
<dubbo:reference interface="com.foo.BarService" 
	id="BarService" timeout="5000">
	<dubbo:method name="testMethod" timeout="2000"></dubbo:method>
</dubbo:reference>

可以體現：

• 精確優先 (方法級優先，介面級次之，全域性配置再次之)；
• 消費者設定優先(如果級別一樣，則消費方優先，提供方次之)；

4.5 重試次數retries

消費者：

<!-- retries="":重試次數，不包含第一次呼叫，0代表不重試-->
<!-- 冪等（設定重試次數）【查詢、刪除、修改】、非冪等（不能設定重試次數）【新增】 -->
<dubbo:reference interface="com.foo.BarService" 
	id="BarService" timeout="5000" retries="3" >
</dubbo:reference>

4.6 多版本version

提供者：

<!-- 1.0.0版本-->
<dubbo:service interface="com.atguigu.gmall.service.UserService" 
	ref="userServiceImpl01" timeout="1000" version="1.0.0">
	<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
</dubbo:service>
<!-- 服務的實現 -->
<bean id="userServiceImpl01" class="com.atguigu.gmall.service.impl.UserServiceImpl"></bean>

<!-- 2.0.0版本-->
<dubbo:service interface="com.atguigu.gmall.service.UserService" 
	ref="userServiceImpl02" timeout="1000" version="2.0.0">
	<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
</dubbo:service>
<bean id="userServiceImpl02" class="com.atguigu.gmall.service.impl.UserServiceImpl2"></bean>

消費者：

<!-- version指定用哪個版本，*表示隨機版本-->
<dubbo:reference interface="com.atguigu.gmall.service.UserService" 
	id="userService" timeout="5000" retries="3" version="*">
	<!-- <dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method> -->
</dubbo:reference>

4.7 本地存根stub

提供者：

public class UserServiceStub implements UserService {
	private final UserService userService;
	
	/**
	 * 傳入的是userService遠端的代理物件
	 * @param userService
	 */
	public UserServiceStub(UserService userService) {
		super();
		this.userService = userService;
	}
	
	@Override
	public List<UserAddress> getUserAddressList(String userId) {
		System.out.println("UserServiceStub.....");
		if(!StringUtils.isEmpty(userId)) {
			return userService.getUserAddressList(userId);
		}
		return null;
	}
}

消費者：

<!--  配置本地存根-->
<dubbo:reference interface="com.atguigu.gmall.service.UserService" 
	id="userService" timeout="5000" retries="3" version="*" stub="com.*.UserServiceStub">
</dubbo:reference>

4.8 SpringBoot與Dubbo整合的三種方式

1. 匯入dubbo-starter；在application.properties配置屬性；使用@Service暴露服務；使用@Reference引用服務；
2. 保留dubbo xml配置檔案；匯入dubbo-starter；使用@ImportResource匯入dubbo的配置檔案即可；
   • 在主啟動類上@ImportResource(locations="classpath:provider.xml")；
3. 使用註解API的方式；將每一個元件手動建立到容器中，讓dubbo來掃描其他的元件；使用@Service暴露服務；
   • 主啟動類上：@EnableDubbo(scanBasePackages="com.atguigu.gmall")；
   • 在config包下進行如下配置：

@Configuration
public class MyDubboConfig {
	
	@Bean
	public ApplicationConfig applicationConfig() {
		ApplicationConfig applicationConfig = new ApplicationConfig();
		applicationConfig.setName("boot-user-service-provider");
		return applicationConfig;
	}
	
	//<dubbo:registry protocol="zookeeper" address="127.0.0.1:2181"></dubbo:registry>
	@Bean
	public RegistryConfig registryConfig() {
		RegistryConfig registryConfig = new RegistryConfig();
		registryConfig.setProtocol("zookeeper");
		registryConfig.setAddress("127.0.0.1:2181");
		return registryConfig;
	}
	
	//<dubbo:protocol name="dubbo" port="20882"></dubbo:protocol>
	@Bean
	public ProtocolConfig protocolConfig() {
		ProtocolConfig protocolConfig = new ProtocolConfig();
		protocolConfig.setName("dubbo");
		protocolConfig.setPort(20882);
		return protocolConfig;
	}
	
	/**
	 *<dubbo:service interface="com.atguigu.gmall.service.UserService" 
		ref="userServiceImpl01" timeout="1000" version="1.0.0">
		<dubbo:method name="getUserAddressList" timeout="1000"></dubbo:method>
	</dubbo:service>
	 */
	@Bean
	public ServiceConfig<UserService> userServiceConfig(UserService userService){
		ServiceConfig<UserService> serviceConfig = new ServiceConfig<>();
		serviceConfig.setInterface(UserService.class);
		serviceConfig.setRef(userService);
		serviceConfig.setVersion("1.0.0");
		
		//配置每一個method的資訊
		MethodConfig methodConfig = new MethodConfig();
		methodConfig.setName("getUserAddressList");
		methodConfig.setTimeout(1000);
		
		//將method的設定關聯到service配置中
		List<MethodConfig> methods = new ArrayList<>();
		methods.add(methodConfig);
		serviceConfig.setMethods(methods);
		
		//ProviderConfig
		//MonitorConfig
		return serviceConfig;
	}

}

---

最後

新人制作，如有錯誤，歡迎指出，感激不盡！ 歡迎關注公眾號，會分享一些更日常的東西！ 如需轉載，請標註出處！