常见配置:
一、<dubbo:service />
1、服务发现
1.1、
interface
dubbo服务暴露的接口全路径,如
<dubbo:service interface="com.demo.service.ImgService"></dubbo:service>
1.2、ref
dubbo服务暴露的接口的实现类,如
<bean id="userService" class="com.demo.service.impl.UserServiceImpl" />
<dubbo:service interface="com.demo.service.UserService" ref="userServie" />
1.3、version
服务版本号,服务提供方和服务消费方的version务必保持一致
1.4、group
服务分组,当一个接口有多个实现,可以用分组区分配置类:com.alibaba.dubbo.config.ServiceConfig
2、服务治理
2.1、stub
设为true,表示使用缺省代理类名,即:接口名 + Local后缀,服务接口客户端本地代理类名,用于在客户端执行本地逻辑,如本地缓存等,该本地代理类的构造函数必须允许传入远程代理对象,构造函数如:public XxxServiceLocal(XxxService xxxService)
2.2、mock
设为true,表示使用缺省Mock类名,即:接口名 + Mock后缀,服务接口调用失败Mock实现类,该Mock类必须有一个无参构造函数,与Local的区别在于,Local总是被执行,而Mock只在出现非业务异常(比如超时,网络异常等)时执行,Local在远程调用之前执行,Mock在远程调用后执行。
2.3、token
令牌验证,为空表示不开启,如果为true,表示随机生成动态令牌,否则使用静态令牌,令牌的作用是防止消费者绕过注册中心直接访问,保证注册中心的授权功能有效,如果使用点对点调用,需关闭令牌功能
2.4、registry
向指定注册中心注册,在多个注册中心时使用,值为<dubbo:registry>
的id属性,多个注册中心ID用逗号分隔,如果不想将该服务注册到任何registry,可将值设为N/A
2.5、provider
指定provider,值为<dubbo:provider>
的id属性
2.6、deprecate
服务是否过时,如果设为true,消费方引用时将打印服务过时警告error日志
2.7、dynamic
服务是否动态注册,如果设为false,注册后将显示后disable状态,需人工启用,并且服务提供者停止时,也不会自动取消册,需人工禁用。
2.8、accesslog
设为true,将向logger中输出访问日志,也可填写访问日志文件路径,直接把访问日志输出到指定文件
2.9、owner
服务负责人,用于服务治理,请填写公司邮箱前缀
2.10、protocol
使用指定的协议暴露服务,在多协议时使用,值为<dubbo:protocol>
的id属性,多个协议ID用逗号分隔,可以有dubbo/hessian/rmi/thrift/redis等,后面会详细介绍每种协议
2.11、register
该协议的服务是否注册到注册中心
3、服务调优
3.1、delay
延迟注册服务时间(毫秒) ,设为-1时,表示延迟到Spring容器初始化完成时暴露服务
3.2、timeout
远程调用服务超时时间,如果客户端服务端都配置了以客户端为准,客户端没配以服务端为准,单位毫秒默认1000
3.3、retries
远程服务调用重试次数,不包括第一次调用,不需要重试请设为0,默认2
3.4、connections
对每个提供者的最大连接数,rmi、http、hessian等短连接协议表示限制连接数,dubbo等长连接协表示建立的长连接个数,默认100
3.5、loadbalance
负载均衡策略,random,roundrobin,leastactive,分别表示:随机,轮循,最少活跃调用
3.6、async
是否缺省异步执行,不可靠异步,只是忽略返回值,不阻塞执行线程
3.7、weigth
服务权重,结合负载均衡策略使用
3.8、executes
服务提供者每服务每方法最大可并行执行请求数
3.9、actives
每服务消费者每服务每方法最大并发调用数
3.10、proxy
生成动态代理方式,可选:jdk/javassist
3.11、cluster
集群方式,可选:
(1)【failover】 :失败自动切换,当出现失败,重试其他服务器(缺省),通常用于读操作,但重试会带来更长的延时,可通过retries=“2”来设置重试次数(不含第一次)
<dubbo:service retries="2">
<dubbo:reference retries="2">
<dubbo:reference>
<dubbo:method name="findFoo" retries=2>
<dubbo:reference/>
(2)【failfast】 :快速失效,只发起一次调用,失败立即报错。通常用于非幂等性写操作,比如说新增记录
<dubbo:service cluster="failfast">
<dubbo:reference cluster="failfast"
(3)【failsafe】 :失败安全,出现异常时,直接忽略,通常用于写入审计日志等操作
<dubbo:service cluster="failsafe">
<dubbo:reference cluster="failsafe">
(4)【failback】
失败自动恢复,后台记录失败请求,定时重发,通常用于消息通知操作
<dubbo:service cluster="failback">
<dubbo:reference cluster="failback">
(5)【forking】
并行调用多个服务器,只要一个成功即返回。通常用于实时性要求较高的读操作,但需要浪费更多的服务器资源。可通过forks=“2”来设置最大并行数。
<dubbo:service cluster="forking">
<dubbo:reference cluster="forking">
3.12、filter
服务提供方远程调用过程拦截器名称,多个名称用逗号分隔,Spring拦截器可以拦截Web接口,无法拦截dubbo接口,但是dubbo提供了Filter扩展
3.13、listener
服务提供方导出服务监听器名称,多个名称用逗号分隔。
二、<dubbo:protocol/>
配置类:com.alibaba.dubbo.config.ProtocolConfig
说明:如果需要支持多协议,可以声明多个<dubbo:protocol>
标签,并在<dubbo:service>
中通过protocol属性指定使用的协议。
1、服务发现
1、id
协议BeanId,可以在<dubbo:service protocol="">
中引用此ID,如果ID不填,缺省和name属性值一样,重复则在name后加序号
2、port
dubbo协议缺省端口为20880,rmi协议缺省端口为1099,http和hessian协议缺省端口为80 如果配置为-1 或者 没有配置port,则会分配一个没有被占用的端口。Dubbo 2.4.0+,分配的端口在协议缺省端口的基础上增长,确保端口段可控;
3、host
默认查找本机IP,服务主机名,多网卡选择或指定VIP及域名时使用,为空则自动查找本机IP,-建议不要配置,让Dubbo自动获取本机IP
1.4、path
提供者上下文路径,为服务path的前缀
2、服务治理
1、accesslog
设为true,将向logger中输出访问日志,也可填写访问日志文件路径,直接把访问日志输出到指定文件
2、telnet
所支持的telnet命令,多个命令用逗号分隔
3、register
该协议的服务是否注册到注册中心服务调优类
1、name
协议名称,支持常见的传输协议:RMI、Dubbo、Hessain、WebService、Http等
2、threadpool
默认fixed,线程池类型,可选:fixed/cached
3、threads
服务线程池大小(固定大小)
4、iothreads
io线程池大小(固定大小)
5、accepts
服务提供方最大可接受连接数
6、payload
请求及响应数据包大小限制,单位:字节,默认值88388608(=8M)
7、codec
协议编码方式
8、serialization
dubbo协议缺省为hessian2,rmi协议缺省为java,http协议缺省为json;协议序列化方式,当协议支持多种序列化方式时使用,比如:dubbo协议的dubbo,hessian2,java,compactedjava,以及http协议的json等
9、transporter
协议的服务端和客户端实现类型,比如:dubbo协议的mina,netty等,可以分拆为server和client配置
10、server
协议的服务器端实现类型,比如:dubbo协议的mina,netty等,http协议的jetty,servlet等
11、client
协议的客户端实现类型,比如:dubbo协议的mina,netty等
1**2、dispather**
协议的消息派发方式,用于指定线程模型,比如:dubbo协议的all, direct, message, execution, connection等
13、queues
线程池队列大小,当线程池满时,排队等待执行的队列大小,建议不要设置,当线程程池时应立即失败,重试其它服务提供机器,而不是排队,除非有特殊需求。
14、charset
序列化编码
15、buffer
网络缓冲区大小
16、heartbeat
心跳间隔,对于长连接,当物理层断开时,比如拔网线,TCP的FIN消息来不及发送,对方收不到断开事件,此时需要心跳来帮助检查连接是否已断开