spring配置解析
服务配置,用于暴露一个服务,定义服务的元信息,一个服务可以用多个协议暴露,一个服务也可以注册到多个注册中心
<dubbo:service ref="userService" interface="com.patty.dubbo.api.service.UserService"/>interface用于指定接口名,ref指定服务引用对象,这两者必填,此外还有一些其他属性可供选择,比如:group: 服务分组,当一个接口有多个实现,可以用分组区分timeout: 远程服务调用超时时间(毫秒),默认1000msretries: 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0,默认值为2
引用配置,用于创建一个远程服务代理,一个引用可以指向多个注册中心。
<dubbo:reference id="userService" interface="com.patty.dubbo.api.service.UserService" timeout="10000" retries="3" check="false"/>id: 服务所引用的bean id, 对应service中ref属性的值check:启动时检查提供者是否存在,为false表示关闭检查。<
dubbo:consumer
check
=
"false"
/> 关闭所有服务的检查,没有提供者的时候check值为true报错,false忽略
<
dubbo:registry
check
=
"false"
/> 关闭注册中心启动时检查,注册订阅失败时check值为true报错, false忽略
3、<dubbo:protocol/> 协议配置,用于配置提供服务的协议信息,协议由提供方指定,消费方被动接受。
<dubbo:protocol name="${dubbo.protocol.name}" port="${dubbo.protocol.port}"/>name: 协议名称port: 服务端口可选协议有1) dubbo:// Dubbo缺省协议采用单一长连接和NIO异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
|
server: 协议的服务器端实现类型
client:协议的客户端实现类型
codec: 协议编码方式
serialization: 协议序列化方式
threadpool: 线程池类型,可选:fixed/cached
threads: 服务线程池大小(固定大小),默认100
accepts: 服务提供者最大可接受连接数
缺省协议,使用基于mina1.1.7+hessian3.2.1的tbremoting交互。
-
- 连接个数:单连接
- 连接方式:长连接
- 传输协议:TCP
- 传输方式:NIO异步传输
- 序列化:Hessian二进制序列化
- 适用范围:传入传出参数数据包较小(建议小于100K),消费者比提供者个数多,单一消费者无法压满提供者,尽量不要用dubbo协议传输大文件或超大字符串。
- 适用场景:常规远程服务方法调用
2) rmi://
3)hessian://
4) http://
- 连接个数:多连接
- 连接方式:短连接
- 传输协议:HTTP
- 传输方式:同步传输
- 序列化:表单序列化
- 适用范围:传入传出参数数据包大小混合,提供者比消费者个数多,可用浏览器查看,可用表单或URL传入参数,暂不支持传文件。
- 适用场景:需同时给应用程序和浏览器JS使用的服务。
可选的server有jetty和servlet.
5) thrift://
6) memcached://
7)redis://
8) webservice://
4、<dubbo:application/> 应用配置,用于配置当前应用信息,不管该应用是提供者还是消费者。
<dubbo:application name="${dubbo.application.name}"/>
name:当前应用名称,用于注册中心计算应用间依赖关系,服务方和消费方不必保持一样,该名称不是匹配条件
version:当前应用的版本
5、<dubbo:registry/> 注册中心配置,用于配置连接注册中心相关信息。
<dubbo:registry protocol="${dubbo.registry.protocol}" address="${dubbo.registry.address}"/>protocol: 注同中心地址协议,支持dubbo, http, local三种协议,分别表示,dubbo地址,http地址,本地注册中心address:注册中心服务器地址,如果地址没有端口缺省为9090,同一集群内的多个地址用逗号分隔,如:ip:port,ip:port,不同集群的注册中心,请配置多个<dubbo:registry>标签
6、其他的一些配置项
- <dubbo:module/> 模块配置,用于配置当前模块信息,可选。
- <dubbo:monitor/> 监控中心配置,用于配置连接监控中心相关信息,可选。
- <dubbo:provider/> 提供方的缺省值,当ProtocolConfig和ServiceConfig某属性没有配置时,采用此缺省值,可选。
- <dubbo:consumer/> 消费方缺省配置,当ReferenceConfig某属性没有配置时,采用此缺省值,可选。
- <dubbo:method/> 方法配置,用于ServiceConfig和ReferenceConfig指定方法级的配置信息。
- <dubbo:argument/> 用于指定方法参数配置。
7、配置优先级
- 上图中以timeout为例,显示了配置的查找顺序,其它retries, loadbalance, actives等类似。
- 方法级优先,接口级次之,全局配置再次之。
- 如果级别一样,则消费方优先,提供方次之。
- 其中,服务提供方配置,通过URL经由注册中心传递给消费方。
- 建议由服务提供方设置超时,因为一个方法需要执行多长时间,服务提供方更清楚,如果一个消费方同时引用多个服务,就不需要关心每个服务的超时设置。
- 理论上ReferenceConfig的非服务标识配置,在ConsumerConfig,ServiceConfig, ProviderConfig均可以缺省配置。
8、属性配置方式
1)dubbo.properties文件
如果公共配置很简单,没有多注册中心,多协议等情况,或者想多个Spring容器想共享配置,可以使用dubbo.properties作为缺省配置
Dubbo将自动加载classpath根目录下的dubbo.properties,可以通过JVM启动参数:-Ddubbo.properties.file=xxx.properties 改变缺省配置位置
覆盖策略:
- JVM启动-D参数优先,这样可以使用户在部署和启动时进行参数重写,比如在启动时需改变协议的端口。
- XML次之,如果在XML中有配置,则dubbo.properties中的相应配置项无效。
- Properties最后,相当于缺省值,只有XML没有配置时,dubbo.properties的相应配置项才会生效,通常用于共享公共配置,比如应用名。
2)注解配置
服务提供方注解:
import
com.alibaba.dubbo.config.annotation.Service;
@Service
(version=
"1.0.0"
)
public
class
FooServiceImpl
implements
FooService {
// ......
}
服务提供方配置:
<!-- 公共信息,也可以用dubbo.properties配置 -->
<
dubbo:application
name
=
"annotation-provider"
/>
<
dubbo:registry
address
=
"127.0.0.1:4548"
/>
<!-- 扫描注解包路径,多个包用逗号分隔,不填pacakge表示扫描当前ApplicationContext中所有的类 -->
<
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.properties配置 -->
<
dubbo:application
name
=
"annotation-consumer"
/>
<
dubbo:registry
address
=
"127.0.0.1:4548"
/>
<!-- 扫描注解包路径,多个包用逗号分隔,不填pacakge表示扫描当前ApplicationContext中所有的类 -->
<
dubbo:annotation
package
=
"com.foo.bar.action"
/>
3)API配置,不推荐