spring配置解析
服务配置,用于暴露一个服务,定义服务的元信息,一个服务可以用多个协议暴露,一个服务也可以注册到多个注册中心
<dubbo:service ref="userService" interface="com.patty.dubbo.api.service.UserService"/>
interface用于指定接口名,ref指定服务引用对象,这两者必填,此外还有一些其他属性可供选择,比如:
group: 服务分组,当一个接口有多个实现,可以用分组区分
timeout: 远程服务调用超时时间(毫秒),默认1000ms
retries: 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0,默认值为2
1) 引用配置,用于创建一个远程服务代理,一个引用可以指向多个注册中心。
<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忽略
也可以通过JVM启动参数设置, 如:
2)在开发及测试环境下,经常需要绕过注册中心,只测试指定服务提供者,这时候可能需要点对点直连直连服务,通过设置url属性可指定服务提供者地址,多个地址用逗号隔开。
<dubbo:reference id="xxxService"
interface
=
"com.alibaba.xxx.XxxService"
url=
"dubbo://localhost:20890"
/>
java -Dcom.alibaba.xxx.XxxService=dubbo:
//localhost:20890
3、<dubbo:protocol/> 协议配置,用于配置提供服务的协议信息,协议由提供方指定,消费方被动接受。
<dubbo:protocol name="${dubbo.protocol.name}" port="${dubbo.protocol.port}"/>
name: 协议名称
port: 服务端口
可选协议有
1) dubbo:// Dubbo缺省协议采用单一长连接和NIO异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
< dubbo:protocol name=“dubbo” port=“9090” server=“netty” client=“netty” codec=“dubbo” serialization=“hessian2” charset=“UTF-8” threadpool=“fixed” threads=“100” queues=“0” iothreads=“9” buffer=“8192” accepts=“1000” payload=“8388608” />
|
server: 协议的服务器端实现类型
client:协议的客户端实现类型
codec: 协议编码方式
serialization: 协议序列化方式
threadpool: 线程池类型,可选:fixed/cached
- ThreadPool
- fixed 固定大小线程池,启动时建立线程,不关闭,一直持有。(缺省)
- cached 缓存线程池,空闲一分钟自动删除,需要时重建。
- limited 可伸缩线程池,但池中的线程数只会增长不会收缩。(为避免收缩时突然来了大流量引起的性能问题)。
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/> 注册中心配置,用于配置连接注册中心相关信息。
1)<dubbo:registry protocol="${dubbo.registry.protocol}" address="${dubbo.registry.address}"/>
protocol: 注同中心地址协议,支持dubbo, http, local三种协议,分别表示,dubbo地址,http地址,本地注册中心
address:注册中心服务器地址,如果地址没有端口缺省为9090,同一集群内的多个地址用逗号分隔,如:ip:port,ip:port,不同集群的注册中心,请配置多个<dubbo:registry>标签
2)为方便开发测试,经常会在线下共用一个所有服务可用的注册中心,这时,如果一个正在开发中的服务提供者注册,可能会影响消费者不能正常运行。可以让服务提供者开发方,只订阅服务(开发的服务可能依赖其它服务),而不注册正在开发的服务,通过直连测试正在开发的服务。
<dubbo:registry
address
=
"10.20.153.10:9090"
register
=
"false"
/>
3)同样设置属性subscribe
=
"false",则服务提供方将不进行订阅操作。
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配置,不推荐
9、多协议服务配置
实际应用中, 不同服务在性能上适用不同协议进行传输,比如大数据用短连接协议,小数据大并发用长连接协议。
<!-- 多协议配置 -->
<
dubbo:protocol
name
=
"dubbo"
port
=
"20880"
/>
<
dubbo:protocol
name
=
"rmi"
port
=
"1099"
/>
<!-- 使用dubbo协议暴露服务 -->
<
dubbo:service
interface
=
"com.alibaba.hello.api.HelloService"
version
=
"1.0.0"
ref
=
"helloService"
protocol
=
"dubbo"
/>
<!-- 使用rmi协议暴露服务 -->
<
dubbo:service
interface
=
"com.alibaba.hello.api.DemoService"
version
=
"1.0.0"
ref
=
"demoService"
protocol
=
"rmi"
/>
<!-- 使用多个协议暴露服务 -->
<
dubbo:service
id
=
"helloService"
interface
=
"com.alibaba.hello.api.HelloService"
version
=
"1.0.0"
protocol
=
"dubbo,rmi"
/>
<!-- 多注册中心配置 -->
<
dubbo:registry
id
=
"hangzhouRegistry"
address
=
"10.20.141.150:9090"
/>
<
dubbo:registry
id
=
"qingdaoRegistry"
address
=
"10.20.141.151:9010"
default
=
"false"
/>
<!-- 同一服务向多个注册中心注册 -->
<
dubbo:service
interface
=
"com.alibaba.hello.api.HelloService"
version
=
"1.0.0"
ref
=
"helloService"
registry
=
"hangzhouRegistry,qingdaoRegistry"
/>
<!-- 不同服务向不同的注册中心注册 -->
<!-- 向中文站注册中心注册 -->
<
dubbo:service
interface
=
"com.alibaba.hello.api.TestService"
version
=
"1.0.0"
ref
=
"testService"
registry
=
"chinaRegistry"
/>
<!-- 向国际站注册中心注册 -->
<
dubbo:service
interface
=
"com.alibaba.hello.api.DemoService"
version
=
"1.0.0"
ref
=
"demoService"
registry
=
"intlRegistry"
/>
/** * Version: 3.0 * Author: pattywgm * Time: 17/6/28 下午11:14 * Desc: UserService的另一个实现类,用来测试同一接口多个实现的情况下,将服务进行分组group */ @Service("anotherUserService") public class AnotherUserServiceImpl implements UserService { public AnotherUserServiceImpl(){ } @Override public List<UserVo> findAllUsers() { ArrayList<UserVo> userVos = new ArrayList<UserVo>(); userVos.add(new UserVo("10", "patty", 23, "13812931251")); userVos.add(new UserVo("11", "jack", 22, "18719092278")); return userVos; } @Override public UserVo findUserById(String id) { return new UserVo("15", "rose", 22, "17712013366"); } }
然后,注册该服务,并对其与之前的服务分别进行分组
<dubbo:service ref="userService" group="db" interface="com.patty.dubbo.api.service.UserService"/> <dubbo:service ref="anotherUserService" group="mock" interface="com.patty.dubbo.api.service.UserService"/>
在消费方,我们可以根据分组来调用相应的服务,有两种方式:
一是指定某个特定的分组:
<dubbo:reference id="userService" group="db" interface="com.patty.dubbo.api.service.UserService" timeout="10000" retries="3" mock="true"/>
比如测试代码中,调用db组,是从数据库取数据,得到结果如下:
二是指定任意组,调用时只会调用其中一个可用组的实现。
<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService" timeout="10000" retries="3" mock="true"/>
示例代码运行结果,调用的是mock组的实现,输出结果如下:
如果想要是的所有分组的实现都被调用(当然,我们也可以通过group="db,mock"指定特定的分组),可以在<dubbo: reference>中设置merger="true",表示调用所有指定分组的实现,并将各个分组的结果合并作为最终结果,比如:
<dubbo:reference id="userService" group="db,mock" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" mock="true" merger="true"/>
输出结果为:
此时, 我们的设置是对所调用服务的所有方法,都合并结果,dubbo为我们提供了方法级别的merger,即可以指定只合并多个分组的特定方法,或者只对某个特定方法不合并最终结果。配置方式如下:
<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" mock="true">
<!-- 指定findAllUsers方法结果合并, 其他方法将只调用某个group的可用实现-->
<dubbo:method name="findAllUsers" merger="true">
</dubbo:method>
</dubbo:reference>
<!-- 指定所有分组的所有方法,除了findUserById 方法外,都合并结果 -->
<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" mock="true" merger="true">
<dubbo:method name="findUserById" merger="false">
</dubbo:method>
</dubbo:reference>