第一章 dubbo官方配置指南.doc

Configuration Reference Configuration Relation: SLA配置在此完成！Service Layer Agreement ApplicationConfig 应用配置，用于配置当前应用信息，不管该应用是提供者还是消费者。 RegistryConfig 注册中心配置，用于配置连接注册中心相关信息。 ProtocolConfig 协议配置，用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。 ServiceConfig 服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。 ProviderConfig 提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值。 ReferenceConfig 引用配置，用于创建一个远程服务代理，一个引用可以指向多个注册中心。 ConsumerConfig 消费方缺省配置，当ReferenceConfig某属性没有配置时，采用此缺省值。 MethodConfig 方法配置，用于ServiceConfig和ReferenceConfig指定方法级的配置信息。 ArgumentConfig 用于指定方法参数配置。 Configuration Override: 上图中以timeout为例，显示了配置的查找顺序，其它retries, loadbalance, actives等类似。 方法级优先，接口级次之，全局配置再次之。 如果级别一样，则消费方优先，提供方次之。 其中，服务提供方配置，通过URL经由注册中心传递给消费方。 建议由服务提供方设置超时，因为一个方法需要执行多长时间，服务提供方更清楚，如果一个消费方同时引用多个服务，就不需要关心每个服务的超时设置。 理论上ReferenceConfig的非服务标识配置，在ConsumerConfig，ServiceConfig, ProviderConfig均可以缺省配置。 Configuration Type: 注意：只有group，interface，version是服务的匹配条件，三者决定是不是同一个服务，其它配置项均为调优和治理参数。 所有配置项分为三大类，参见下表中的作用一列。 服务发现：表示该配置项用于服务的注册与发现，目的是让消费方找到提供方。 服务治理：表示该配置项用于治理服务间的关系，或为开发测试提供便利条件。 性能调优：表示该配置项用于调优性能，不同的选项对性能会产生影响。 所有配置最终都将转换为URL表示，并由服务提供方生成，经注册中心传递给消费方，各属性对应URL的参数，参见配置项一览表中的对应URL参数列。URL格式： protocol://username:password@host:port/path?key=valuekey=value Schema: /schema/dubbo/dubbo.xsd dubbo:application/ 应用信息配置：配置类：com.alibaba.dubbo.rpc.config.ApplicationConfig 标签 属性 对应URL参数 类型 是否必填 缺省值 作用 描述 兼容性 dubbo:application name application string 必填 服务治理 当前应用名称，用于注册中心计算应用间依赖关系，注意：消费者和提供者应用名不要一样，此参数不是匹配条件，你当前项目叫什么名字就填什么，和提供者消费者角色无关，比如：kylin应用调用了morgan应用的服务，则kylin项目配成kylin，morgan项目配成morgan，可能kylin也提供其它服务给别人使用，但kylin项目永远配成kylin，这样注册中心将显示kylin依赖于morgan 1.0.16以上版本 dubbo:application organization organization string 可选 服务治理 组织名称(BU或部门)，用于注册中心区分服务来源，此配置项建议不要使用autoconfig，直接写死在配置中，比如china,intl,itu,crm,asc,dw,aliexpress等 2.0.0以上版本 dubbo:application organization organization string 可选 服务治理 用于服务分层对应的架构。如，intl、china。不同的架构使用不同的分层。 2.0.7以上版本 dubbo:application environment environment string 可选 服务治理 应用环境，如：develop/test/product，不同环境使用不同的