<dubbo:service /> 用于服务生产者暴露服务配置
属 性 | 类 型 | 是否必填 | 缺省值 | 描 述 |
interface | class | 必填 | 无 | 服务接口全路径 |
ref | object | 必填 | 无 | 服务对象实现引用 |
version | string | 可选 | 0.0.0 | 服务版本,建议使用两位数字版本如1.0,通常在接口不兼容时版本号才需要升级 |
timeout | int | 可选 | 1000 | 远程服务调用超时时间(毫秒) |
retries | int | 可选 | 2 | 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0 |
connections | int | 可选 | 100 | 每个生产者的最大连接数,短连接协议如rmi,表示限制连接数;长连接协议如dubbo表示建立的长连接个数 |
loadbalance | string | 可选 | random | 负载均衡策略,可选值为:random(随机)、roundrobin(轮询)、leastactive(最少活跃调用) |
async | boolean | 可选 | FALSE | 是否缺省异步执行,不可靠的异步,只是忽略返回值,不阻塞执行线程 |
register | boolean | 可选 | TRUE | 该协议的服务是否注册到注册中心 |
<dubbo:reference /> 用于服务消费者引用服务配置
属 性 | 类 型 | 是否必填 | 缺省值 | 描 述 |
id | string | 必填 | 无 | 服务引用beanId |
interface | class | 必填 | 无 | 服务接口全路径 |
version | string | 可选 | 无 | 服务版本,与服务生产者的版本一致 |
timeout | long | 可选 | 使用<dubbo:consumer>的timeout | 服务方法调用超时时间(毫秒) |
retries | int | 可选 | 使用<dubbo:consumer>的retries | 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0 |
connections | int | 可选 | 使用<dubbo:consumer>的connections | 每个生产者的最大连接数,短连接协议如rmi,表示限制连接数;长连接协议如dubbo表示建立的长连接个数 |
loadbalance | string | 可选 | 使用<dubbo:consumer>的loadbalance | 负载均衡策略,可选值为:random(随机)、roundrobin(轮询)、leastactive(最少活跃调用) |
async | boolean | 可选 | 使用<dubbo:consumer>的async | 是否缺省异步执行,不可靠的异步,只是忽略返回值,不阻塞执行线程 |
check | boolean | 可选 | 使用<dubbo:consumer>的check | 启动时检查服务生产者是否存在,true则报错,false则忽略 |
url | string | 可选 | 无 | 点对点直连服务提供者地址,将绕过注册中心,比如"dubbo://localhost:20890",这个比较多的使用在测试中 |
protocol | string | 可选 | 无 | 只调用指定协议的服务生产者,其他协议忽略 |
<dubbo:protocol /> 用于服务生产者协议配置
(如果需要支持多协议,可以声明多个此标签,并在<dubbo:service />通过protocol属性指定使用的协议)
属 性 | 类 型 | 是否必填 | 缺省值 | 描 述 |
id | string | 可选 | dubbo | 协议beanId,<dubbo service />中的protocol引用此ID,如果不填缺省和name属性值一样 |
name | sring | 必填 | dubbo | 协议名称,dubbo->20800,rmi->1099,http->80,hessian->80 |
port | int | 可选 | 如果配置为-1或未配置,则会分配一个没有被占用的端口服务端口 | |
host | string | 可选 | 自动查找本机ip | 为空则自动查找本机ip,建议不配置让Dubbo自动获取本机ip |
threadpool | string | 可选 | fixed | 线程池类型,可选fixed/cached |
threads | int | 可选 | 100 | 服务线程池大小(固定大小) |
serialization | string | 可选 | dubbo->hession2,rmi->java,http->json | 协议序列化方式,当协议支持多种序列化方式时使用 |
register | boolean | 可选 | true | 该协议的服务是否注册到注册中心 |
<dubbo:registry /> 用于注册中心配置
(如果有多个不同的注册中心可以声明多个标签并且<dubbo:service />或<dubbo:reference />中使用registry属性指定)
属 性 | 类 型 | 是否必填 | 缺省值 | 描 述 |
id | string | 可选 | 无 | 注册中心引用beanId,可在<dubbo:service />或<dubbo:reference />中引用此ID |
address | string | 必填 | 无 | 注册中心服务地址,如果地址没有端口缺省为9090,同一个集群内的多个地址用逗号分隔,如:ip:port,ip:port,不同的集群注册中心请配置多个<dubbo:registry />标签 |
protocol | string | 可选 | dubbo | 注册中心地址协议,支持dubbo、http、local三种协议,分别表示dubbo地址、http地址和本地注册中心 |
port | int | 可选 | 9090 | 注册中心缺省端口,当address没有带端口时使用此端口作为缺省值 |
username | string | 可选 | 无 | 登陆注册中心用户名,如果注册中心不需要验证可不填 |
password | string | 可选 | 无 | 登陆注册中心密码,如果注册中心不需要验证可不填 |
transport | string | 可选 | netty | 网络传输方式,可选mina、netty |
timeout | int | 可选 | 5000 | 注册中心请求超时时间(毫秒) |
file | string | 可选 | 无 | 使用文件缓存注册中心地址列表以及服务提供者列表,应用重启时将基于此文件恢复,注意两个注册中心不能使用同一文件存储 |
check | boolean | 可选 | true | 注册中心不存在时,是否报错 |
register | boolean | 可选 | true | 是否向此注册中心注册服务,如果设为false,将只订阅,不注册 |
subscribe | boolean | 可选 | true | 是否向此注册中心订阅服务,如果设为false,将只注册,不订阅 |
dubbo:method />用于方法级配置
(该标签为<dubbo:service/>或<dubbo:reference/>的子标签,用于控制到方法级)
属 性 | 类 型 | 是否必填 | 缺省值 | 描 述 |
method | string | 必填 | 无 | 方法名 |
timeout | int | 可选 | 缺省为<dubbo:reference/>的timeout | 方法调用超时时间(毫秒) |
retires | int | 可选 | 缺省为<dubbo:reference/>的retries | 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0 |
loadbalance | string | 可选 | 缺省为<dubbo:reference/>的loadbalance | 负载均衡策略,可选值为:random(随机)、roundrobin(轮询)、leastactive(最少活跃调用) |
async | boolean | 可选 | 缺省为<dubbo:reference/>的async | 是否异步执行,不可靠异步,只是忽略返回值,不阻塞执行线程 |
actives | int | 可选 | 0 | 每服务消费者最大并发调用限制 |
executes | int | 可选 | 0 | 每服务每方法最大使用线程数限制,此属性只在<dubbo:method/>作为<dubbo:service/>子标签时有效 |
另外,还有<dubbo:provider/>和<dubbo:consumer/>分别表示服务提供者(生产者)和服务消费者的缺省值配置,就不列举了。
Dubbo协议dubbo://
前面有说到一个Dubbo协议,下面来看一下Dubbo协议。
Dubbo协议Dubbo的缺省协议,使用基于mina1.1.7+hessian3.2.1的tbremoting交互。
连接个数:单连接
连接方式:长连接
传输协议:TCP
传输方式:NIO异步传输
序列化:Hessian二进制序列化
适用范围:传入传出参数数据包较小(建议小于100K),消费者比提供者个数多,单一消费者无法压满提供者,尽量不要使用dubbo协议传输大文件或超大字符串
使用场景:常规远程服务方法调用
从上面的适用范围总结,dubbo适合小数据量大并发的服务调用,以及消费者机器远大于生产者机器数的情况,不适合传输大数据量的服务比如文件、视频等,除非请求量很低。
另外,Dubbo手册还给开发者列出了Dubbo协议使用的约束:
参数及返回值需要实现Serializable接口
参数及返回值自定义实现List、Map、Number、Date、Calendar等接口,只能用JDK自带的实现,因为hessian会做特殊处理,自定义实现类中的属性值都会丢失