Dubbo用户指南：入门与高级特性解析

需积分: 9 172 浏览量更新于2024-07-19 收藏 3.17MB PDF 举报

"dubbo用户指南" Dubbo是一个高性能、轻量级的开源Java RPC框架，由阿里巴巴开发并维护。这份用户指南提供了全面的介绍，帮助新手和开发者更好地理解和使用Dubbo。以下是一些核心知识点： 1. **入门**: 开始使用Dubbo前，了解其背景和需求是必要的。Dubbo旨在解决企业应用之间的服务调用问题，通过提供服务发现、负载均衡、容错、监控等机制，提高系统的可扩展性和稳定性。 2. **架构**: Dubbo的核心架构包括服务提供者、服务消费者、注册中心和服务监控。服务提供者暴露服务，服务消费者调用服务，注册中心负责服务的注册与发现，服务监控则用于收集运行数据。 3. **依赖**: Dubbo有必需、缺省和可选依赖。必需依赖如Spring，是使用Dubbo的基础；缺省依赖如Zookeeper，通常作为默认注册中心；可选依赖如Hessian，用于特定协议的支持。 4. **成熟度**: Dubbo的功能和策略成熟度表明了其在不同方面的稳定性和可靠性。功能成熟度包括服务发布、消费、调用等；策略成熟度涉及负载均衡、容错策略等。 5. **配置**: Dubbo支持XML、属性、注解和API四种配置方式，便于在不同场景下灵活配置服务。 6. **示例**: 快速启动示例可以帮助用户快速搭建一个简单的Dubbo应用，了解基本的提供者和消费者工作流程。 7. **服务提供者与消费者**: 提供者负责注册服务，消费者负责调用服务。两者可以通过注册中心进行通信。 8. **集群容错与负载均衡**: 集群容错策略如Failover、Failfast、Failsafe等，保证服务的可用性；负载均衡算法如Random、RoundRobin等，确保请求的均匀分布。 9. **协议与注册中心**: Dubbo支持多种协议（如dubbo、rmi、hessian等）和注册中心（如Multicast、Zookeeper、Redis等），适应不同的网络环境和需求。 10. **API与配置手册**: 提供了详细的手册，包括服务提供者、消费者、协议、注册中心等的配置元素和API使用说明。 11. **监控与管理**: 通过服务容器和配置，可以实现对服务的监控和管理，包括服务的健康状态、调用统计、日志记录等。 12. **服务容器**: 如Spring容器，可以帮助管理和控制服务生命周期。 13. **Maven插件**: Maven插件提供了创建服务、注册服务等功能，简化项目构建过程。 14. **最佳实践**: 文档还包含了服务化的最佳实践，指导用户如何有效地利用Dubbo构建分布式系统。 Dubbo用户指南是学习和使用Dubbo的重要参考资料，涵盖了从基础概念到高级特性的全方位内容，无论是初学者还是经验丰富的开发者都能从中受益。通过深入学习和实践，可以更好地利用Dubbo构建高可用、高性能的服务化系统。

覆盖策略：

JVM启动-D参数优先，这样可以使用户在部署和启动时进行参数重写，比如在启动时需改变协议的端口。

XML次之，如果在XML中有配置，则dubbo.properties中的相应配置项无效。

Properties最后，相当于缺省值，只有XML没有配置时，dubbo.properties的相应配置项才会生效，通常用于共享公共配置，比如应用名。

注解配置注解配置

(+) (#)

2.2.1以上版本支持

服务提供方注解：

import com.alibaba.dubbo.config.annotation.Service;

@Service(version="1.0.0")

public class FooServiceImpl implements FooService {

// ......

}

服务提供方配置：

<dubbo:application name="annotation-provider" />

<dubbo:registry address="127.0.0.1:4548" />

<dubbo:annotation package="com.foo.bar.service" />

服务消费方注解：

import com.alibaba.dubbo.config.annotation.Reference;

import org.springframework.stereotype.Component;

@Component

public class BarAction {

@Reference(version="1.0.0")

private FooService fooService;

}

服务消费方配置：

<dubbo:application name="annotation-consumer" />

<dubbo:registry address="127.0.0.1:4548" />

<dubbo:annotation package="com.foo.bar.action" />

也可以使用：(等价于前面的：<dubbo:annotation package="com.foo.bar.service" />)

<dubbo:annotation />

<context:component-scan base-package="com.foo.bar.service">

<context:include-filter type="annotation" expression="com.alibaba.dubbo.config.annotation.Service" />

</context:component-scan>

Spring2.5及以后版本支持component-scan，如果用的是Spring2.0及以前版本，需配置：

<dubbo:annotation />

API配置配置

(+) (#)

API使用范围使用范围

API仅用于OpenAPI, ESB, Test, Mock等系统集成，普通服务提供方或消费方，请采用配置方式使用Dubbo，请参见：Xml配置 (+)

API属性含义参考属性含义参考

API属性与配置项一对一，各属性含义，请参见：配置参考手册 (+)，

比如：ApplicationConfig.setName("xxx") 对应 <dubbo:application name="xxx" />

(1) 服务提供者：服务提供者：

import com.alibaba.dubbo.rpc.config.ApplicationConfig;

import com.alibaba.dubbo.rpc.config.RegistryConfig;

import com.alibaba.dubbo.rpc.config.ProviderConfig;

import com.alibaba.dubbo.rpc.config.ServiceConfig;

import com.xxx.XxxService;

import com.xxx.XxxServiceImpl;

// 服务实现

XxxService xxxService = new XxxServiceImpl();

// 当前应用配置

ApplicationConfig application = new ApplicationConfig();

application.setName("xxx");

// 连接注册中心配置

RegistryConfig registry = new RegistryConfig();

registry.setAddress("10.20.130.230:9090");

registry.setUsername("aaa");

registry.setPassword("bbb");

// 服务提供者协议配置

ProtocolConfig protocol = new ProtocolConfig();

protocol.setName("dubbo");

protocol.setPort(12345);

protocol.setThreads(200);

// 注意：ServiceConfig为重对象，内部封装了与注册中心的连接，以及开启服务端口

// 服务提供者暴露服务配置

ServiceConfig<XxxService> service = new ServiceConfig<XxxService>(); // 此实例很重，封装了与注册中心的连接，请自行缓存，

否则可能造成内存和连接泄漏

service.setApplication(application);

service.setRegistry(registry); // 多个注册中心可以用setRegistries()

service.setProtocol(protocol); // 多个协议可以用setProtocols()

service.setInterface(XxxService.class);

service.setRef(xxxService);

service.setVersion("1.0.0");

// 暴露及注册服务

service.export();

(2) 服务消费者：服务消费者：

import com.alibaba.dubbo.rpc.config.ApplicationConfig;
import com.alibaba.dubbo.rpc.config.RegistryConfig;
import com.alibaba.dubbo.rpc.config.ConsumerConfig;
import com.alibaba.dubbo.rpc.config.ReferenceConfig;
import com.xxx.XxxService;
 
// 当前应用配置
ApplicationConfig application = new ApplicationConfig();
application.setName("yyy");
 
// 连接注册中心配置
RegistryConfig registry = new RegistryConfig();
registry.setAddress("10.20.130.230:9090");
registry.setUsername("aaa");
registry.setPassword("bbb");
 
// 注意：ReferenceConfig为重对象，内部封装了与注册中心的连接，以及与服务提供方的连接
 
// 引用远程服务
ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例很重，封装了与注册中心的连接以及与提
供者的连接，请自行缓存，否则可能造成内存和连接泄漏
reference.setApplication(application);
reference.setRegistry(registry); // 多个注册中心可以用setRegistries()
reference.setInterface(XxxService.class);
reference.setVersion("1.0.0");
 
// 和本地bean一样使用xxxService
XxxService xxxService = reference.get(); // 注意：此代理对象内部封装了所有通讯细节，对象较重，请缓存复用
(3) 特殊场景特殊场景
注：下面只列出不同的地方，其它参见上面的写法
(3.1) 方法级设置：方法级设置：
...
 
// 方法级配置
List<MethodConfig> methods = new ArrayList<MethodConfig>();
MethodConfig method = new MethodConfig();
method.setName("createXxx");
method.setTimeout(10000);
method.setRetries(0);
methods.add(method);
 
// 引用远程服务
ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例很重，封装了与注册中心的连接以及与提
供者的连接，请自行缓存，否则可能造成内存和连接泄漏
...
reference.setMethods(methods); // 设置方法级配置
 
...
(3.2) 点对点直连：点对点直连：
...
 
ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例很重，封装了与注册中心的连接以及与提
供者的连接，请自行缓存，否则可能造成内存和连接泄漏
// 如果点对点直连，可以用reference.setUrl()指定目标地址，设置url后将绕过注册中心，
// 其中，协议对应provider.setProtocol()的值，端口对应provider.setPort()的值，
// 路径对应service.setPath()的值，如果未设置path，缺省path为接口名
reference.setUrl("dubbo://10.20.130.230:20880/com.xxx.XxxService");
 
...
示例示例
(+) (#)
想完整的运行起来，请参见：快速启动 (+)，这里只列出各种场景的配置方式
以下示例全部使用基于Spring的Xml配置 (+)作为参考，如果不想使用Spring，而希望通过API的方式进行调用，请参见：API配置 (+)
启动时检查启动时检查
(+) (#)

Dubbo缺省会在启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止Spring初始化完成，以便上线时，能及早发现问题，默认che

ck=true。

如果你的Spring容器是懒加载的，或者通过API编程延迟引用服务，请关闭check，否则服务临时不可用时，会抛出异常，拿到null引用，如

果check=false，总是会返回引用，当服务恢复时，能自动连上。

可以通过check="false"关闭检查，比如，测试时，有些服务不关心，或者出现了循环依赖，必须有一方先启动。

关闭某个服务的启动时检查：(没有提供者时报错)

<dubbo:reference interface="com.foo.BarService" check="false" />

关闭所有服务的启动时检查：(没有提供者时报错)

<dubbo:consumer check="false" />

关闭注册中心启动时检查：(注册订阅失败时报错)

<dubbo:registry check="false" />

也可以用dubbo.properties配置：

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，强制改变所有reference的check值，就算配置中有声明，也会被覆盖。

dubbo.consumer.check=false，是设置check的缺省值，如果配置中有显式的声明，如：<dubbo:reference check="true"/>，不会受

影响。

dubbo.registry.check=false，前面两个都是指订阅成功，但提供者列表是否为空是否报错，如果注册订阅失败时，也允许启动，需

使用此选项，将在后台定时重试。

引用缺省是延迟初始化的，只有引用被注入到其它Bean，或被getBean()获取，才会初始化。

如果需要饥饿加载，即没有人引用也立即生成动态代理，可以配置：

<dubbo:reference interface="com.foo.BarService" init="true" />

集群容错集群容错

(+) (#)

在集群调用失败时，Dubbo提供了多种容错方案，缺省为failover重试。

各节点关系：

这里的Invoker是Provider的一个可调用Service的抽象，Invoker封装了Provider地址及Service接口信息。

Directory代表多个Invoker，可以把它看成List<Invoker>，但与List不同的是，它的值可能是动态变化的，比如注册中心推送变更。

Cluster将Directory中的多个Invoker伪装成一个Invoker，对上层透明，伪装过程包含了容错逻辑，调用失败后，重试另一个。

剩余92页未读，继续阅读

sinat_36821635

粉丝: 1
资源: 1

Dubbo用户指南：入门与高级特性解析

Dubbo用户指南：高清完整版

Dubbo用户指南：服务消费与配置详解

Dubbo用户指南：全面解析与实战配置

dubbo使用指南

Dubbo用户指南

Dubbo 用户 指南

dubbo用户指南.pdf

Dubbo用户指南.pdf

【pdf】Dubbo用户指南

dubbo用户指南(高清版)

最新资源

Dubbo 用户指南