Day09_03_Dubbo教程之dubbo配置清单

青旅半醒 2024-01-20 08:03 35阅读 0赞

## dubbo配置清单 ##

### 一. 服务发布者配置清单 ###

在服务发布者的主配置文件application.properties中添加dubbo配置信息.

#dubbo服务名
    spring.dubbo.application.name=xxx
    
    #注册中心地址
    spring.dubbo.registry.address=zookeeper://127.0.0.1:2181
    
    #dubbo的RPC协议
    spring.dubbo.protocol.name=dubbo
    
    #dubbo的RPC端口
    spring.dubbo.protocol.port=20880
    
    #远程服务的超时时间
    spring.dubbo.provider.timeout=5000
    
    #发布服务扫描的路径
    spring.dubbo.base-package=xxx

### 二. 服务调用者配置清单 ###

在服务调用者的主配置文件application.properties中添加dubbo配置

#dubbo应用名
    spring.dubbo.application.name=xxx
    
    #连接的注册中心地址
    spring.dubbo.registry.address=zookeeper://127.0.0.1:2181
    
    #远程服务的调用超时时间
    spring.dubbo.consumer.timeout=5000
    
    #启动时检查提供者是否存在,true报错,false忽略
    spring.dubbo.consumer.check=false
    
    #引用服务扫描的路径
    spring.dubbo.base-package=xxx

### 三. 应用配置参数(必须配置) ###

spring:
      dubbo: 
      application:
      name: service-provider # 必填, 服务治理中当前应用的名称,用于注册中心计算应用间的依赖关系,注意:消费者和提供者应用的名称不要一样,此参数不是匹配条件.一般当前项目名称是什么就填什么,和提供者消费者角色无关. 1.0.16以上版本有该属性.
      
      owner: yyg # 可选, 服务治理中应用的负责人,用于服务治理,请填写负责人公司邮箱前缀.2.0.5以上版本有该属性.
     
      architecture: # 可选, 服务治理中用于服务分层对应的架构.如,intl、china,不同的架构使用不同的分层. 2.0.7以上版本有该属性.
     
      compiler: javassist # 可选, 性能优化属性,Java字节码编译器,用于动态类的生成,可选 jdk 或 javassist 两个值. 2.1.0以上版本有该属性.
     
      environment: # 可选, 服务治理中应用环境,如: develop/test/product,不同环境使用不同的缺省值,以及作为只用于开发测试功能的限制条件. 2.0.0以上版本有该属性.
     
      logger: slf4j # 可选, 性能优化属性,配置日志输出方式,可选: slf4j,jcl,log4j,jdk . 2.2.0以上版本有该属性.
      
      organization: # 可选, 服务治理中的组织名称(BU或部门),用于注册中心区分服务来源,此配置项建议不要使用autoconfig，直接写死在配置中,比如china,intl,itu,crm,asc,dw,aliexpress等. 2.0.0以上版本有该属性.
     
      version: # 可选, 服务治理中当前应用的版本. 2.2.0以上版本有该属性.

### 四. 服务扫描的包 ###

spring:
      dubbo: 
        base-package: # service提供者和消费者所在的java包,多个包用逗号分割.

### 五. 注册中心支持的配置参数(必须配置) ###

spring:
      dubbo:
        registry: # 应用注册中心配置项
          protocol: zookeeper # 必填, 服务发现属性, 注册中心支持的协议, 包括 dubbo,multicast,zookeeper,redis,默认是zookeeper.
          
          address: 127.0.0.1 # 必填, 服务发现属性, 注册中心服务器地址,如果地址没有端口则缺省为9090,同一集群内的多个地址用逗号分隔,如: ip:port,ip:port,不同集群的注册中心,请配置多个spring.dubbo.registry标签;
          
          port: 2181 # 可选, 服务发现属性, 注册中心缺省端口,当address没有带端口时使用此端口做为缺省值;
     
          client: zkclient # 可选, 服务发现属性, 注册中心支持的客户端.， zookeeper支持的客户端包括 curator和zkclient,如果不配置,默认使用zkclient;
     
          session: 60000 # 可选, 性能调优 属性,注册中心会话超时时间(毫秒),用于检测提供者非正常断线后的脏数据,比如用心跳检测的实现,此时间就是心跳间隔,不同注册中心实现不一样;
     
          register: true # 可选, 服务治理属性, 是否向此注册中心注册服务,如果设为false,将只订阅,不注册;
     
          check: false # 可选, 服务治理属性, 服务是否动态注册,如果设为false,注册后将显示后disable状态,需人工启用,并且服务提供者停止时,也不会自动取消注册,需人工禁用; 
         
          dynamic: true # 可选, 服务治理属性, 服务是否动态注册,如果设为false,注册后将显示disable状态,需人工启用,并且服务提供者停止时,也不会自动取消注册,需人工禁用;
     
          file: regcache.log # 可选, 服务治理属性, 使用文件缓存注册中心地址列表及服务提供者列表,应用重启时将基于此文件恢复,注意:两个注册中心不能使用同一文件存储;
     
          username: # 可选, 服务治理属性, 注册中心的用户名,如果注册中心不需要验证可不填;
     
          password: # 可选, 服务治理属性, 注册中心的密码,如果注册中心不需要验证可不填;
          
          subscribe: # 可选, 服务治理属性, 是否向此注册中心订阅服务,如果设为false,将只注册,不订阅;
         
          timeout: # 可选, 性能调优属性, 注册中心请求超时时间(毫秒);
     
          wait: 0 # 可选, 性能调优属性, 停止时等待通知完成时间(毫秒);
     
          transport: netty # 可选, 性能调优属性, 网络传输方式,可选mina,netty; 
        
          id: # 可选, 配置关联属性, 注册中心引用BeanId,可以在<dubbo:service registry="">或<dubbo:reference registry="">中引用此ID;
        
          registrys: # 多个应用注册中心时配置项(注意,如果要配置多个注册中心,必须指定的不同的id和名字)
            - id: test2
            name: test2
            protocol: zookeeper # 必填, 服务发现属性, 注册中心支持的协议, 包括 dubbo,multicast,zookeeper,redis, 默认是zookeeper;
            address: 127.0.0.1 # 必填, 服务发现属性, 注册中心服务器地址,如果地址没有端口缺省为9090,同一集群内的多个地址用逗号分隔,如: ip:port,ip:port,不同集群的注册中心,请配置多个spring.dubbo.registry标签;
            port: 2182 # 可选 服务发现 注册中心缺省端口，当address没有带端口时使用此端口做为缺省值 2.0.0以上版本
            client: zkclient # 可选, 服务发现属性, 注册中心支持的客户端, zookeeper 支持客户端包括 curator和zkclient,如果不配置,默认使用zkclient.

### 六. 服务协议支持的类型 ###

spring:
      dubbo:
        protocol: # 默认的应用协议栈
        name: dubbo # 必填, 性能调优属性 协议名称;
        serialization: hessian2 #可选, 性能调优属性, 协议的序列化方式,当协议支持多种序列化方式时使用,比如: dubbo协议dubbo,hessian2,java,compactedjava,以及http协议的json等;
        accepts: 0 # 可选, 性能调优属性, 服务提供方最大可接受连接数;
        accesslog: false # 可选, 服务治理属性, 设为true,将向logger中输出访问日志,也可填写访问日志文件路径,直接把访问日志输出到指定文件;
        buffer: 8192 # 可选, 性能调优属性, 网络读写缓冲区大小;
        charset: UTF-8 # 可选, 性能调优属性, 序列化编码;
        client: netty # 可选, 性能调优属性, 协议的客户端实现类型,比如:dubbo协议的mina,netty等;
        codec: dubbo # 可选, 性能调优属性, 协议编码方式;
        contextpath: # 可选, 服务治理属性;
        dispatcher: all # 可选, 性能调优属性, 协议的消息派发方式,用于指定线程模型,比如: dubbo协议的all, direct, message, execution, connection等;
        heartbeat: 0 # 可选, 性能调优属性,心跳间隔,对于长连接,当物理层断开时,比如拔网线,TCP的FIN消息来不及发送,对方收不到断开事件,此时需要心跳来帮助检查连接是否已断开;
        host: # 可选, 服务发现属性, -服务主机名,多网卡选择或指定VIP及域名时使用,为空则自动查找本机IP,-建议不要配置,让Dubbo自动获取本机IP; 
        id: dubbo # 可选, 配置关联属性, 协议BeanId,可以在<dubbo:service protocol="">中引用此ID,如果ID不填,缺省和name属性值一样,重复则在name后加序号;
        iothreads: # 可选, 性能调优属性,io线程池大小(固定大小); 
        path: # 可选, 服务发现属性, 提供者上下文路径,为服务path的前缀;
        payload: 88388608 # 可选, 性能调优属性, 请求及响应数据包大小限制,单位:字节;
        port: # 可选, 服务发现属性, 不输入或者输入0,将自动在53600~53688之间生产一个服务端口; 
        queues: 0 # 可选, 性能调优属性, 线程池队列大小,当线程池满时,排队等待执行的队列大小,建议不要设置,当线程程池时应立即失败,重试其它服务提供机器,而不是排队,除非有特殊需求;
        register: true # 可选, 服务治理属性, 该协议的服务是否注册到注册中心;
        server: # 可选, 性能调优属性, 协议的服务器端实现类型,比如:dubbo协议的mina,netty等,http协议的jetty,servlet等;
        telnet: # 可选, 服务治理属性, 所支持的telnet命令,多个命令用逗号分隔;
        threadpool: fixed # 可选, 性能调优属性,线程池类型,可选:fixed/cached;
        threads: 100 # 可选, 性能调优属性, 服务线程池大小(固定大小);
        transporter: netty # 可选, 性能调优属性, 协议的服务端和客户端实现类型,比如: dubbo协议的mina,netty等,可以分拆为server和client配置.

### 七. 提供者默认的配置参数 ###

spring:
      dubbo: 
        provider: # 公用的生产者配置
          retries: -1 # 可选, 性能调优属性,远程服务调用重试次数,不包括第一次调用,不需要重试请设为0;
          accesslog: false # 可选, 服务治理属性, 设为true,将向logger中输出访问日志,也可填写访问日志文件路径,直接把访问日志输出到指定文件;
          delay: 0 # 可选, 性能调优属性, 延迟注册服务时间(毫秒)-,设为-1时,表示延迟到Spring容器初始化完成时暴露服务;
          deprecated: false # 可选, 服务治理属性, 服务是否过时,如果设为true,消费方引用时将打印服务过时警告error日志;
          document: # 可选, 服务治理属性, 服务文档URL;
          dynamic: true # 可选, 服务治理 属性,服务是否动态注册,如果设为false,注册后将显示后disable状态,需人工启用,并且服务提供者停止时,也不会自动取消册,需人工禁用;
          executes: 0 # 可选, 性能调优属性,服务提供者每服务每方法最大可并行执行请求数;
          group: # 可选, 服务发现属性, 服务分组,当一个接口有多个实现,可以用分组区分;
          id: dubbo # 可选, 配置关联属性, 协议BeanId,可以在<dubbo:service proivder="">中引用此ID;
          layer: # 可选, 服务治理属性, 服务提供者所在的分层;如：biz、dao、intl:web、china:acton;
          listener: # 可选, 性能调优属性, 服务提供方导出服务监听器名称,多个名称用逗号分隔;
          mock: false # 可选, 服务治理属性, 设为true,表示使用缺省Mock类名,即:接口名 + Mock后缀;
          owner: # 可选, 服务治理属性, 服务负责人,用于服务治理,请填写负责人公司邮箱前缀;
          path: # 可选, 服务发现属性, 提供者上下文路径,为服务path的前缀;
          protocol: dubbo # 可选, 性能调优属性, 协议名称;
          proxy: javassist # 可选, 性能调优属性, 生成动态代理方式,可选:jdk/javassist;
          registry: # 可选, 配置关联属性, 向指定注册中心注册,在多个注册中心时使用,值为spring.dubbo.registry.的id属性,多个注册中心ID用逗号分隔,如果不想将该服务注册到任何registry,可将值设为N/A;
          stub: false # 可选, 服务治理属性, 设为true,表示使用缺省代理类名,即:接口名 + Local后缀;
          token: false # 可选, 服务治理属性, 令牌验证,为空表示不开启,如果为true,表示随机生成动态令牌;
          version: 0.0.0 # 可选, 服务发现属性, 服务版本,建议使用两位数字版本,如:1.0,通常在接口不兼容时版本号才需要升级;
          weight: 0 # 可选, 性能调优属性, 服务权重;
          accepts: 0 # 可选, 性能调优属性, 服务提供者最大可接受连接数;
          actives: 0 # 可选, 性能调优属性, 每服务消费者每服务每方法最大并发调用数;
          async: false # 可选, 性能调优, 是否缺省异步执行,不可靠异步,只是忽略返回值,不阻塞执行线程;
          buffer: 8192 # 可选, 性能调优, 网络读写缓冲区大小;
          charset: UTF-8 # 可选, 性能调优, 序列化编码;
          client: netty # 可选, 性能调优 协议的客户端实现类型,比如:dubbo协议的mina,netty等;
          cluster: failover # 可选, 性能调优, 集群方式,可选:failover/failfast/failsafe/failback/forking;
          codec: dubbo # 可选, 性能调优 协议编码方式;
          connections: 0 # 可选, 性能调优, 对每个提供者的最大连接数,rmi、http、hessian等短连接协议表示限制连接数,dubbo等长连接协表示建立的长连接个数; 
          default: false # 可选, 配置关联, 是否为缺省协议,用于多协议;
          host: # 可选, 服务发现, 服务主机名,多网卡选择或指定VIP及域名时使用,为空则自动查找本机IP,建议不要配置,让Dubbo自动获取本机IP;
          iothreads: # 可选, 性能调优, IO线程池,接收网络读写中断,以及序列化和反序列化,不处理业务,业务线程池参见threads配置,此线程池和CPU相关,不建议配置;
          loadbalance: random # 可选, 性能调优, 负载均衡策略,可选值:random,roundrobin,leastactive,分别表示:随机,轮循,最少活跃调用;
          payload: 88388608 # 可选, 性能调优, 请求及响应数据包大小限制,单位:字节;
          queues: 0 # 可选, 性能调优, 线程池队列大小,当线程池满时,排队等待执行的队列大小,建议不要设置,当线程程池时应立即失败,重试其它服务提供机器,而不是排队,除非有特殊需求;
          serialization: hessian2 # 可选, 性能调优, 协议序列化方式,当协议支持多种序列化方式时使用,比如:dubbo协议的dubbo,hessian2,java,compactedjava,以及http协议的json,xml等;
          server: netty # 可选, 性能调优 ,协议的服务器端实现类型,比如:dubbo协议的mina,netty等,http协议的jetty,servlet等;
          telnet: # 可选, 服务治理, 所支持的telnet命令,多个命令用逗号分隔; 
          threadpool: fixed # 可选, 性能调优, 线程池类型,可选:fixed/cached;
          threads: 100 # 可选, 性能调优 线程池类型,可选:fixed/cached;
          timeout: 1000 # 可选, 性能调优 ,远程服务调用超时时间(毫秒);
          filter: # 可选, 性能调优, 服务提供方远程调用过程拦截器名称,多个名称用逗号分隔.

### 八. 调用者默认的配置 ###

spring:
      dubbo: 
        consumer: # 公用的消费者配置
          lazy: true #
          timeout: 1000 # 可选, 性能调优, 远程服务调用超时时间(毫秒);
          check: true # 可选, 服务治理, 启动时检查提供者是否存在,true报错,false忽略;
          retries: 2 # 可选, 性能调优, 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0;
          filter: # 可选, 性能调优, 服务消费方远程调用过程拦截器名称,多个名称用逗号分隔;
          actives: 0 # 可选, 性能调优, 每服务消费者每服务每方法最大并发调用数;
          async: false # 可选, 性能调优,是否缺省异步执行,不可靠异步,只是忽略返回值,不阻塞执行线程;
          cache: # 可选, 服务治理, 以调用参数为key,缓存返回结果,可选:lru,threadlocal,jcache等;
          cluster: failover # 可选, 性能调优, 集群方式,可选:failover/failfast/failsafe/failback/forking;
          connections: 100 # 可选, 性能调优,每个服务对每个提供者的最大连接数,rmi、http、hessian等短连接协议支持此配置,dubbo协议长连接不支持此配置;
          generic: false # 可选, 服务治理,是否缺省泛化接口,如果为泛化接口,将返回GenericService;
          init: false # 可选, 性能调优, 是否在afterPropertiesSet()时饥饿初始化引用,否则等到有人注入或引用该实例时再初始化;
          layer: # 可选, 服务治理, 服务调用者所在的分层,如:biz、dao、intl:web、china:acton;
          listener: # 可选, 性能调优, 服务消费方引用服务监听器名称,多个名称用逗号分隔;
          loadbalance: random # 可选,性能调优, 负载均衡策略,可选值:random,roundrobin,leastactive,分别表示:随机,轮循,最少活跃调用;
          owner: # 可选, 服务治理, 调用服务负责人,用于服务治理,请填写负责人公司邮箱前缀;
          proxy: javassist # 可选, 性能调优,生成动态代理方式,可选: jdk/javassist;
          registry: # 可选, 配置关联, 向指定注册中心注册,在多个注册中心时使用,值为spring.dubbo.registry.的id属性,多个注册中心ID用逗号分隔,如果不想将该服务注册到任何registry,可将值设为N/A;
          retries: 2 # 可选, 性能调优,远程服务调用重试次数,不包括第一次调用,不需要重试请设为0;
          validation: