【知识积累】（三）、使用Dubbo

一、直连

1、释义

在开发和测试环境下，经常需要绕过注册中心，只测试指定服务提供者，这时候可能需要点对点直连。

点对点直连方式，将以服务接口为单位，忽略注册中心的提供者列表，A接口配置点对点，不影响B接口从注册中心获取列表。

2、配置方式

a、XML配置（常用）

在dubbo:reference标签下配置url，url指向提供者，将绕过注册中心，多个地址使用分号分隔。

b、-D参数指定

java -Dcom.darren.his.facade.HisFacade=dubbo://127.0.0.1:20880

c、文件映射

当服务比较多时，可使用文件映射。-Ddubbo.resolve.file指定文件路径，优先级比XML配置dubbo:reference标签高。

java -Ddubbo.resolve.file=dubbo-resolve.properties

定义dubbo-resolve.properties：

com.darren.his.facade.HisFacade=dubbo://127.0.0.1:20880

二、使用zookeeper注册中心

http://blog.csdn.net/axin1240101543/article/details/79435685

三、读取zookeeper节点配置

http://blog.csdn.net/axin1240101543/article/details/79368271

四、公共配置

<dubbo:registry>：注册中心的配置。 对应的类是org.apache.dubbo.config.RegistryConfig。 如果您有多个不同的注册表，则可以声明多个<dubbo：registry>标记，然后在<dubbo：service>或<dubbo：reference>标记中引用具有注册表属性的指定注册表。

<dubbo:application>：应用信息配置，对应的配置类：com.alibaba.dubbo.config.ApplicationConfig

 

属性	对应URL参数	类型	是否必填	缺省值	作用	描述	兼容性
name	application	string	必填		服务治理	当前应用名称， 用于注册中心计算应用间的依赖， 注意：提供者和消费者应用名 不要一样，此参数不是匹配条件， 当前项目叫什么就配置什么， 和提供者消费者角色无关。	1.0.16以上
version	application.version	string			服务治理	当前应用的版本	2.2.0以上
owner	owner	string			服务治理	应用负责人， 填写负责人公司邮箱前缀	2.0.5以上
organization	organization	string			服务治理	组织名称（BU或部门）， 用于注册中心区分服务来源， 此配置建议不要使用autoconfig， 直接写死在配置中。	2.0.0以上
architecture	architecture	string			服务治理	用于服务分层对应的架构	2.0.7以上
environment	environment	string			服务治理	应用环境，Develop、Test、 Product， 不同环境使用不同的缺省值， 以及作为只用于开发测试功能 的限制条件。	2.0.0以上
compiler	compiler	string		javassist	性能优化	java字节码编译器， 用于动态类的生成， 可选JDK或Javassist	2.1.0以上
logger	logger	string		slf4j	性能优化	日志输出方式， 可选：slf4j、jcl、log4j、jdk	2.2.0以上

五、提供者配置

1、<dubbo:protocol>：服务提供者协议配置，对应的配置类：com.alibaba.dubbo.config.ProtocolConfig。同时，如果需要支持多协议，可以声明多个<dubbo:protocol>标签，并在<dubbo:service>中通过protocol属性指定使用的协议。

dubbo协议端口缺省值：20880

rmi协议端口缺省值：1099

http和hessian协议端口缺省值：80

-1或者没有配置port，则会分配一个没有被占用的端口；

dubbo2.4.0+，分配的端口在协议缺省端口的基础上增长，确保端口段可控。

2、<dubbo:provider>：服务提供者缺省值配置，对应的配置类：com.alibaba.dubbo.config.ProviderConfig。

同时该标签为<dubbo:service>和<dubbo:protocol>标签的缺省值设置。

 

属性	对应URL参数	类型	是否必填	缺省值	作用	描述	兼容性
id		string		dubbo	配置关联	可以在<dubbo:service provider=""> 中引用此id	1.0.16以上
protocol	<protocol>	string		dubbo	性能调优	协议名称	1.0.16以上
host	<host>	string		自动查找 本地ip	服务发现	服务主机名，多网卡选择或指定 VIP及域名时使用，为空则自动 查找本机ip，建议不要配置，让 dubbo自动获取本机ip	1.0.16以上
threads	threads	int		100	性能调优	服务线程池大小（固定大小）	1.0.16以上
payload	payload	int		8838 8608 （=8M）	性能调优	请求以及响应数据包大小限制 单位：字节	2.0.0以上
path	<path>	string			服务发现	提供者上下文路径， 为服务path的前缀	2.0.0以上
server	server	string		dubbo协议 缺省为netty， http协议缺省 为servlet	性能调优	协议的服务端实现类型，比如： dubbo协议的mina、netty等， http协议的jetty、servlet等。	2.0.0以上
client	client	string		dubbo协议 缺省为netty	性能调优	协议的客户端实现类型，比如： dubbo协议的mina、netty等	2.0.0以上
codec	codec	string		dubbo	性能调优	协议编码方式	2.0.5以上
serializable	serializable	string		dubbo协议 缺省为hessian2， rmi协议 缺省为 java， http协议 缺省为 json。	性能调优	协议序列化方式，当协议支持 多种序列化方式时使用，比如： dubbo协议的dubbo、hessian2 、java、compactedjava， http协议的json、xml等。	2.0.5以上
default		boolean		false	配置关联	是否为默认协议 ，用于多协议	1.0.16以上
filter	service.filter	string			性能调优	服务提供方远程调用 过程拦截器名称， 多个名称用逗号分隔	2.0.5以上
listener	exporter.listener	string			性能调优	服务提供方导出服务监听器 名称，多个名称用逗号分隔	2.0.5以上
threadpool	threadpool	string		fixed	性能调优	线程池类型， 可选：fixed、cached	2.0.5以上
accepts	accepts	int		0	性能调优	服务提供者最大 可接受的连接数	2.0.5以上
version	version	string		0.0.0	服务发现	服务版本，建议使用两位数字 版本，如：1.0，通常在接口 不兼容时版本号才需要升级。	2.0.5以上
group	group	string			服务发现	服务分组，当一个接口 有多个实现,可以用分组区分	2.0.5以上
delay	delay	int		0	性能调优	延迟注册服务的时间 （毫秒）,设为-1时， 表示延迟到Spring容器 初始化完成时暴露服务	2.0.5以上
timeout	default.timeout	int		1000	性能调优	远程服务调用超时时间 （毫秒）	2.0.5以上
retries	default.retries	int		2	性能调优	远程服务调用 重试次数，不包括 第一次调用， 不需要重试请设为0	2.0.5以上
connections	default.connections	int		0	性能调优	对每个提供者的最大连接数， rmi、http、hessian等 短连接协议表示限制连接数， dubbo等长连接协表示 建立的长连接个数	2.0.5以上
loadbalance	default.loadbalance	string		random	性能调优	负载均衡策略， 可选值：random, roundrobin,leastactive， 分别表示：随机， 轮循，最少活跃调用	2.0.5以上
async	default.async	boolean		false	性能调优	是否缺省异步执行， 不可靠异步， 只是忽略返回值， 不阻塞执行线程	2.0.5以上
stub	stub	boolean		false	服务治理	设为true， 表示使用缺省代理类名， 即：接口名 + Local后缀。	2.0.5以上
mock	mock	boolean		false	服务治理	设为true， 表示使用缺省Mock类名， 即：接口名 + Mock后缀。	2.0.5以上
token	token	boolean		false	服务治理	令牌验证， 为空表示不开启， 如果为true， 表示随机生成动态令牌	2.0.5以上
registry	registry	string		缺省向所有 registry注册	配置关联	向指定注册中心注册，在多个 注册中心时使用，值为 <dubbo:registry>的id属性， 多个注册中心使用逗号分隔， 如果不想将服务注册到任何 registry，可设置为N/A	2.0.5以上
dynamic	dynamic	boolean		true	服务治理	服务是否动态注册，如果设 为false，注册后将显示disable 状态，需人工启用，并且服务 提供者停止时，也不会自动 取消注册，需人工禁用。	2.0.5以上
accesslog	accesslog	string/boolean		false	服务治理	设为true，将向logger中输出 访问日志，也可填写访问日志 文件路径，直接把访问日志输出 到指定文件。	2.0.5以上
owner	owner	string			服务治理	服务负责人，用于服务治理， 请填写负责人公司邮箱后缀。	2.0.5以上
document	document	string			服务治理	服务文档URL	2.0.5以上
weight	weight	int			性能调优	服务权重	2.0.5以上
executes	executes	int		0	性能调优	服务提供者每服务每方法最大 可并行执行请求数	2.0.5以上
actives	default.actives	int		0	性能调优	每服务消费者每服务每方法最大 并发调用数	2.0.5以上
proxy	proxy	string		javassist	性能调优	生成动态代理的方式， 可选：djk，javassist	2.0.5以上
cluster	default.cluster	string		failover	性能调优	集群方式，可选： failover，failfast，failsafe， failback，forking	2.0.5以上
deprecated	deprecated	boolean		false	服务治理	服务是否过时，如果设为true， 消费方引用将打印服务过时 警告error日志	2.0.5以上
queues	queues	int		0	性能调优	线程池队列大小， 当线程池满时，排队等待 执行的队列大小，建议不要 设置，当线程池满时， 应立即失败,重试其他服务器， 而不是排队，除非有特殊情况。	2.0.5以上
charset	charset	string		UTF-8	性能调优	序列化编码	2.0.5以上
buffer	buffer	int		8192	性能调优	网络读取缓冲区大小	2.0.5以上
iothreads	iothreads	int		CPU+1	性能调优	IO线程池，接受网络读取 中断，以及序列化和反序列化， 不处理业务，业务线程池参见 threads配置，此线程池和CPU 相关，不建议配置。	2.0.5以上
telnet	telnet	string			服务治理	所支持的telnet命令， 多个命令用逗号分隔	2.0.5以上
<dubbo:service>	contextpath	contextpath		可选	缺省为空串	服务治理	2.0.6以上
layer	layer	string			服务治理	服务提供者所在的层。 如：biz，dao，intl:web， china:action	2.0.7以上

3、<dubbo:monitor>：监控中心配置，对应的配置类：com.alibaba.dubbo.config.MonitorConfig。

 

 

属性	对应的URL参数	类型	是否必填	缺省值	作用	描述	兼容性
protocol	protocol	string		dubbo	服务治理	监控中心协议， 如果为protocol="registry"， 表示从注册中心发现 监控中心地址， 否则直连监控中心	2.0.9以上
address	<url>	string		N/A	服务治理	直连监控中心服务器地址， address="10.20.130.230:12080"	1.0.16以上

4、dubbo:service服务提供者暴露服务配置，对应的配置类：com.alibaba.dubbo.config.ServiceConfig

属性	对应的URL参数	类型	是否必填	缺省值	作用	描述	兼容性
interface		class	必填		服务发现	服务接口名	1.0.0以上
ref		object	必填		服务发现	服务对象实现引用	1.0.0以上
version	version	string		0.0.0	服务发现	服务版本，建议使用 两位数字版本,如：1.0 通常在接口不兼容时 版本号才需要升级	1.0.0以上
group	group	string			服务发现	服务分组，当一个接口 有多个实现，可以用 分组区分	1.0.7以上
path	<path>	string		缺省为接口名	服务发现	服务路径 (注意：1.0 不支持自定义路径， 总是使用接口名， 如果有1.0调2.0， 配置服务路径可能 不兼容)	1.0.12以上
delay	delay	int		0	性能调优	延迟注册服务时间 (毫秒) ，设为-1时， 表示延迟到Spring 容器初始化完成时 暴露服务	1.0.14以上
timeout	timeout	int		1000	性能调优	远程服务调用超时 时间(毫秒)	2.0.0以上
retries	retries	int		2	性能调优	远程服务调用重试 次数，不包括第一 次调用，不需要重试 请设为0	2.0.0以上
connections	connections	int		100	性能调优	对每个提供者的最大 连接数，rmi、http、 hessian等短连接协议 表示限制连接数，dubbo 等长连接协表示建立 的长连接个数	2.0.0以上
loadbalance	loadbalance	string		random	性能调优	负载均衡策略，可选值： random,roundrobin,leastactive， 分别表示：随机，轮循， 最少活跃调用	2.0.0以上
async	async	boolean		false	性能调优	是否缺省异步执行， 不可靠异步，只是忽略 返回值，不阻塞执行线程	2.0.0以上
stub	stub	class/boolean		false	服务治理	设为true，表示使用缺省 代理类名，即：接口名 +  Local后缀，服务接口 客户端本地代理类名， 用于在客户端执行本地 逻辑，如本地缓存等， 该本地代理类的构造函 数必须允许传入远程 代理对象，构造函数 如：public XxxService Local(XxxService xxxService)	2.0.0以上
mock	mock	class/boolean		false	服务治理	设为true，表示使用缺省 Mock类名，即：接口名 +  Mock后缀，服务接口调用 失败Mock实现类，该Mock 类必须有一个无参构造函数， 与Local的区别在于，Local 总是被执行，而Mock只在 出现非业务异常(比如超时， 网络异常等)时执行，Local 在远程调用之前执行，Mock 在远程调用后执行。	2.0.0以上
token	token	string/boolean		false	服务治理	令牌验证，为空表示不开启， 如果为true，表示随机生成动 态令牌，否则使用静态令牌， 令牌的作用是防止消费者绕 过注册中心直接访问，保证 注册中心的授权功能有效， 如果使用点对点调用，需关闭 令牌功能	2.0.0以上
registry		string		缺省向所有 registry注册	配置关联	向指定注册中心注册，在多个 注册中心时使用，值为<dubbo: registry>的id属性，多个注册中 心ID用逗号分隔，如果不想将 该服务注册到任何registry， 可将值设为N/A	2.0.0以上
provider		string		缺省使用第 一个provider 配置	配置关联	指定provider，值为<dubbo: provider>的id属性	2.0.0以上
deprecated	deprecated	boolean		false	服务治理	服务是否过时，如果设为true， 消费方引用时将打印服务过 时警告error日志	2.0.5以上
dynamic	dynamic	boolean		true	服务治理	服务是否动态注册，如果 设为false，注册后将显示 后disable状态，需人工启 用，并且服务提供者停止 时，也不会自动取消注册， 需人工禁用。	2.0.5以上
accesslog	accesslog	string/boolean		false	服务治理	设为true，将向logger中 输出访问日志，也可填写 访问日志文件路径，直接把 访问日志输出到指定文件	2.0.5以上
owner	owner	string			服务治理	服务负责人，用于服务治理， 请填写负责人公司邮箱前缀	2.0.5以上
document	document	string			服务治理	服务文档URL	2.0.5以上
weight	weight	int			性能调优	服务权重	2.0.5以上
executes	executes	int		0		服务提供者每服务每方法 最大可并行执行请求数	2.0.5以上
proxy	proxy	string		javassist	性能调优	生成动态代理方式，可选：jdk/javassist	2.0.5以上
cluster	cluster	string		failover	性能调优	集群方式，可选：failover/failfast/ failsafe/failback/forking	2.0.5以上
filter	reference.filter	string		default	性能调优	服务消费方远程调用过程拦截器 名称，多个名称用逗号分隔	2.0.5以上
listener	invoker.listener	string		default	性能调优	服务消费方引用服务监听器 名称，多个名称用逗号分隔
protocol		string			配置关联	使用指定的协议暴露服务，在 多协议时使用，值为<dubbo: protocol>的id属性，多个协议 ID用逗号分隔	2.0.5以上
layer	layer	string			服务治理	服务提供者所在的分层。如： biz、dao、intl:web、china: acton。	2.0.7以上
register	register	boolean		true	服务治理	该协议的服务是否注册到注册中心	2.0.8以上

actives

actives

int

可选

0

性能调优

每服务消费者每服务 每方法最大并发调用数

2.0.5以上

六、消费者配置

1、dubbo:consumer服务消费者缺省配置，配置类：com.alibaba.dubbo.config.ConsumerConfig。

同时，该标签为<dubbo:reference>标签的缺省值设置。

 

属性	对应URL参数	类型	是否必填	缺省值	作用	描述	兼容性
timeout	default.timeout	int		1000	性能调优	远程服务调用 超时时间(毫秒)	1.0.16以上
retries	default.retries	int		2	性能调优	远程服务调用 重试次数，不 包括第一次调 用，不需要重 试请设为0	1.0.16以上
loadbalance	default.loadbalance	string		random	性能调优	负载均衡策略 ，可选值： random, roundrobin, leastactive， 分别表示：随 机，轮循，最 少活跃调用	1.0.16以上
async	default.async	boolean		false	性能调优	是否缺省异步 执行，不可靠 异步，只是忽 略返回值，不 阻塞执行线程	2.0.0以上
connections	default.connections	int		100	性能调优	每个服务对每 个提供者的最 大连接数，rmi、 http、hessian 等短连接协议 支持此配置， dubbo协议长 连接不支持此配置	1.0.16以上
generic	generic	boolean		false	服务治理	是否缺省泛化 接口，如果为 泛化接口，将 返回GenericService	2.0.0以上
check	check	boolean		true	服务治理	启动时检查提 供者是否存在， true报错， false忽略	1.0.16以上
proxy	proxy	string		javassist	性能调优	生成动态代理 方式，可选： jdk/javassist	2.0.5以上
owner	owner	string			服务治理	调用服务负责人 ，用于服务治理， 请填写负责人 公司邮箱前缀	2.0.5以上
actives	default.actives	int		0	性能调优	每服务消费者 每服务每方法 最大并发调用数	2.0.5以上
cluster	default.cluster	string		failover	性能调优	集群方式，可选：failover/failfast/ failsafe/failback/forking	2.0.5以上
filter	reference.filter	string			性能调优	服务消费方远 程调用过程拦 截器名称，多 个名称用逗号分隔	2.0.5以上
listener	invoker.listener	string			性能调优	服务消费方引 用服务监听器 名称，多个名称 用逗号分隔	2.0.5以上
registry		string		缺省向所有 registry注册	配置关联	向指定注册中 心注册，在多 个注册中心时 使用，值为<dubbo: registry>的id属性， 多个注册中心ID用 逗号分隔，如果不想 将该服务注册到 任何registry， 可将值设为N/A	2.0.5以上
layer	layer	string			服务治理	服务调用者所在 的分层。如：biz、 dao、intl:web、 china:acton。	2.0.7以上
init	init	boolean			性能调优	是否在afterPropertiesSet() 时饥饿初始化引用，否则 等到有人注入或引用 该实例时再初始化。	2.0.10以上
cache	cache	string/boolean			服务治理	以调用参数为key，缓存 返回结果，可选：lru,  threadlocal, jcache等	dubbo2.1.0以上
validation	validation	boolean			服务治理	是否启用JSR303标准 注解验证，如果启用， 将对方法参数上的注解 进行校验	dubbo2.1.0以上

 

2、dubbo:reference服务消费者引用服务配置，对应的配置类：com.alibaba.dubbo.config.ReferenceConfig。

 

属性	对应URL参数	类型	是否必填	缺省值	作用	描述	兼容性
id		string	必填		配置关联	服务引用BeanId	1.0.0以上
interface		class	必填		服务发现	服务接口名	1.0.0以上
version	version	string			服务发现	服务版本，与服 务提供者的版本一致	1.0.0以上
group	group	string			服务发现	服务分组，当一个 接口有多个实现， 可以用分组区分， 必需和服务提供方一致	1.0.7以上
timeout	timeout	long		缺省使用<dubbo :consumer>的 timeout	性能调优	服务方法调用 超时时间(毫秒)	1.0.5以上
retries	retries	int		缺省使用<dubbo: consumer>的 retries	性能调优	远程服务调用重 试次数，不包括 第一次调用，不 需要重试请设为0	2.0.0以上
connections	connections	int		缺省使用<dubbo: consumer>的 connections	性能调优	对每个提供者的 最大连接数，rmi、 http、hessian等 短连接协议表示 限制连接数， dubbo等长连接 协表示建立的长 连接个数	2.0.0以上
loadbalance	loadbalance	string		缺省使用<dubbo: consumer>的 loadbalance	性能调优	负载均衡策略， 可选值：random, roundrobin,leastactive， 分别表示：随机， 轮循，最少活跃调用	2.0.0以上
async	async	boolean		缺省使用<dubbo: consumer>的 async	性能调优	是否异步执行， 不可靠异步， 只是忽略返回值， 不阻塞执行线程	2.0.0以上
generic		boolean		缺省使用<dubbo: consumer>的 generic	服务治理	是否缺省泛化接口， 如果为泛化接口， 将返回GenericService	2.0.0以上
check		boolean		缺省使用<dubbo: consumer>的 check	服务治理	启动时检查提供者 是否存在，true 报错，false忽略	2.0.0以上
url	url	string			服务治理	点对点直连服务 提供者地址， 将绕过注册中心	1.0.6以上
stub	stub	class/boolean			服务治理	服务接口客户端 本地代理类名， 用于在客户端 执行本地逻辑， 如本地缓存等， 该本地代理类的 构造函数必须允 许传入远程代理 对象，构造函数 如：public Xxx ServiceLocal(XxxService xxxService)	2.0.0以上
mock	mock	class/boolean			服务治理	服务接口调用失败 Mock实现类名，该 Mock类必须有一个 无参构造函数，与 Local的区别在于， Local总是被执行， 而Mock只在出现 非业务异常(比如 超时，网络异常等) 时执行，Local在远 程调用之前执行， Mock在远程调用后执行。	dubbo1.0.13以上
cache	cache	string/boolean			服务治理	以调用参数为key， 缓存返回结果， 可选：lru, threadlocal,  jcache等	dubbo2.1.0以上
validation	validation	boolean			服务治理	是否启用JSR303 标准注解验证，如 果启用，将对方法 参数上的注解进行校验	dubbo2.1.0以上
proxy	proxy	boolean		javassist	性能调优	选择动态代理实现 策略，可选： javassist, jdk	2.0.2以上
client	client	string			性能调优	客户端传输类型设置， 如Dubbo协议的netty或mina。	2.0.0以上
registry		string		缺省将从所有 注册中心获服 务列表后合并 结果	配置关联	从指定注册中心注册 获取服务列表，在多个 注册中心时使用，值为 <dubbo:registry>的id属性， 多个注册中心ID用逗号分隔	2.0.0以上
owner	owner	string			服务治理	调用服务负责人， 用于服务治理， 请填写负责人公司邮箱前缀	2.0.5以上
actives	actives	int		0	性能调优	每服务消费者 每服务每方法最大 并发调用数	2.0.5以上
cluster	cluster	string		failover	性能调优	集群方式，可选：failover/failfast/ failsafe/failback/forking	2.0.5以上
filter	reference.filter	string		default	性能调优	服务消费方远程调用 过程拦截器名称， 多个名称用逗号分隔	2.0.5以上
listener	invoker.listener	string		default	性能调优	服务消费方引用服务 监听器名称，多个名 称用逗号分隔	2.0.5以上
layer	layer	string			服务治理	服务调用者所在的分层。 如：biz、dao、intl:web、china:acton。	2.0.7以上
init	init	boolean		false	性能调优	是否在afterPropertiesSet() 时饥饿初始化引用，否则等 到有人注入或引用该实例 时再初始化。	2.0.10以上
protocol	protocol	string			服务治理	只调用指定协议的服务 提供方，其它协议忽略。	2.2.0以上