<dubbo:service />服务配置,用于暴露一个服务,定义服务的信息,一个服务可以用多个协议暴露,一个服务也可以注册到多个注册中心。
<dubbo:reference/>引用配置,用于创建一个远程服务代理,一个引用可以指向多个注册中心。
<dubbo:protocol/>协议配置,用于配置提供服务的协议信息,协议由提供方指定,消费方被动接受。
<dubbo:application/>应用配置,用于配置当前应用信息,不管该应用是提供者还是消费者。
<dubbo:module/>模块配置,用于配置当前模块信息,可选。
<dubbo:registry/>注册中心配置,用于配置连接注册中心相关信息。
<dubbo:monitor/>监控中心配置,用于配置连接监控中心相关信息,可选。
<dubbo:provider/>提供方的缺省值,当ProtocolConfig和ServiceConfig某属性没有配置时采用些缺省值,可选。
<dubbo:consumer/>消费方缺省配置,当ReferenceConfig某属性没有配置时,采用此缺少值,可选。
<dubbo:method/>方法配置,用于ServiceConfig和ReferenceConfig指定方法级的配置信息。
<dubbo:argument/>用于指定方法参数配置。
配置的查找顺序:
- 方法级优先,接口级次之,全局配置再次之。
- 如果级别一样,则消费方优先,提供方次之。
属性配置:
1.如果公共配置很简单,没有多注册中心,多协议等情况,或者想多个Spring容器共享配置,可以使用dubbo.properties作为缺省配置。
2.dubbo将自动加载classpath根目录下的dubbo.properties,可以通过JVM启动参数:-Ddubbo.properties.file=xxx.properties改变缺省配置位置。
如果classpath根目录下存在多个dubbo.properties,dubbo会任意加载。
覆盖策略:
1.JVM启动-D参数优先。
2.XML次之。
3.Properties最后。
API配置
1.服务提供者
import com.alibaba.dubbo.rpc.config.ApplicationConfig;
import com.alibaba.dubbo.rpc.config.RegistryConfig;
import com.alibaba.dubbo.rpc.config.ProviderConfig;
import com.alibaba.dubbo.rpc.config.ServiceConfig;
import com.xxx.XxxService;
import com.xxx.XxxServiceImpl;
// 服务实现
XxxService xxxService= new XxxServiceImpl();
// 当前应用配置
ApplicationConfigapplication = new ApplicationConfig();
application.setName("xxx");
// 连接注册中心配置
RegistryConfigregistry = new RegistryConfig();
registry.setAddress("10.20.130.230:9090");
registry.setUsername("aaa");
registry.setPassword("bbb");
// 服务提供者协议配置
ProtocolConfigprotocol = new ProtocolConfig();
protocol.setName("dubbo");
protocol.setPort(12345);
protocol.setThreads(200);
// 注意:ServiceConfig为重要对象,内部封装了与注册中心的连接,以及开启服务端口
// 服务提供者暴露服务配置
ServiceConfig<XxxService>service = new ServiceConfig<XxxService>();
// 此实例很重,封装了与注册中心的连接,请自行缓存,否则可能造成内存和连接泄漏
service.setApplication(application);
service.setRegistry(registry);// 多个注册中心可以用setRegistries()
service.setProtocol(protocol);// 多个协议可以用setProtocols()
service.setInterface(XxxService.class);
service.setRef(xxxService);
service.setVersion("1.0.0");
// 暴露及注册服务
service.export();
2.服务消费者
import com.alibaba.dubbo.rpc.config.ApplicationConfig;
import com.alibaba.dubbo.rpc.config.RegistryConfig;
import com.alibaba.dubbo.rpc.config.ConsumerConfig;
import com.alibaba.dubbo.rpc.config.ReferenceConfig;
import com.xxx.XxxService;
// 当前应用配置
ApplicationConfigapplication = new ApplicationConfig();
application.setName("yyy");
// 连接注册中心配置
RegistryConfigregistry = new RegistryConfig();
registry.setAddress("10.20.130.230:9090");
registry.setUsername("aaa");
registry.setPassword("bbb");
// 注意:ReferenceConfig为重对象,内部封装了与注册中心的连接,以及与服务提供方的连接
// 引用远程服务
ReferenceConfig<XxxService>reference = new ReferenceConfig<XxxService>();
// 此实例很重,封装了与注册中心的连接以及与提供者的连接,请自行缓存,否则可能造成内存和连接泄漏
reference.setApplication(application);
reference.setRegistry(registry);// 多个注册中心可以用setRegistries()
reference.setInterface(XxxService.class);
reference.setVersion("1.0.0");
// 和本地bean一样使用xxxService
XxxService xxxService= reference.get(); // 注意:此代理对象内部封装了所有通讯细节,对象较重,请缓存复用
3.方法级设置
// 方法级配置
List<MethodConfig>methods = new ArrayList<MethodConfig>();
MethodConfig method =new MethodConfig();
method.setName("createXxx");
method.setTimeout(10000);
method.setRetries(0);
methods.add(method);
// 引用远程服务
ReferenceConfig<XxxService>reference = new ReferenceConfig<XxxService>();
// 此实例很重,封装了与注册中心的连接以及与提供者的连接,请自行缓存,否则可能造成内存和连接泄漏
...
reference.setMethods(methods);// 设置方法级配置
...
4.点对点直连
ReferenceConfig<XxxService>reference = new ReferenceConfig<XxxService>();
// 此实例很重,封装了与注册中心的连接以及与提供者的连接,请自行缓存,否则可能造成内存和连接泄漏
// 如果点对点直连,可以用reference.setUrl()指定目标地址,设置url后将绕过注册中心,
// 其中,协议对应provider.setProtocol()的值,端口对应provider.setPort()的值,
// 路径对应service.setPath()的值,如果未设置path,缺省path为接口名
reference.setUrl("dubbo://10.20.130.230:20880/com.xxx.XxxService");
最后欢迎大家访问我的个人网站:1024s