dubbo文档,dubbo官网文档

('Dubbo开发指南一、Dubbo介绍1、Dubbo是什么？能做什么？Dubbo是一个分布式服务框架，以及SOA治理方案。其功能主要包括：高性能NIO通讯及多协议集成，服务动态寻址与路由，软负载均衡与容错，依赖分析与降级等。2、Dubbo适用于哪些场景？当网站变大后，不可避免的需要拆分应用进行服务化，以提高开发效率，调优性能，节省关键竞争资源等。当服务越来越多时，服务的URL地址信息就会爆炸式增长，配置管理变得非常困难，F5硬件负载均衡器的单点压力也越来越大。当进一步发展，服务间依赖关系变得错踪复杂，甚至分不清哪个应用要在哪个应用之前启动，架构师都不能完整的描述应用的架构关系。接着，服务的调用量越来越大，服务的容量问题就暴露出来，这个服务需要多少机器支撑？什么时候该加机器？等等……在遇到这些问题时，都可以用Dubbo来解决。二、Dubbo架构节点角色说明：\uf0b7Provider:暴露服务的服务提供方。\uf0b7Consumer:调用远程服务的服务消费方。\uf0b7Registry:服务注册与发现的注册中心。\uf0b7Monitor:统计服务的调用次调和调用时间的监控中心。\uf0b7Container:服务运行容器。调用关系说明：\uf0b70.服务容器负责启动，加载，运行服务提供者。\uf0b71.服务提供者在启动时，向注册中心注册自己提供的服务。\uf0b72.服务消费者在启动时，向注册中心订阅自己所需的服务。\uf0b73.注册中心返回服务提供者地址列表给消费者，如果有变更，注册中心将基于长连接推送变更数据给消费者。\uf0b74.服务消费者，从提供者地址列表中，基于软负载均衡算法，选一台提供者进行调用，如果调用失败，再选另一台调用。\uf0b75.服务消费者和提供者，在内存中累计调用次数和调用时间，定时每分钟发送一次统计数据到监控中心。(1)连通性：\uf0b7注册中心负责服务地址的注册与查找，相当于目录服务，服务提供者和消费者只在启动时与注册中心交互，注册中心不转发请求，压力较小\uf0b7监控中心负责统计各服务调用次数，调用时间等，统计先在内存汇总后每分钟一次发送到监控中心服务器，并以报表展示\uf0b7服务提供者向注册中心注册其提供的服务，并汇报调用时间到监控中心，此时间不包含网络开销\uf0b7服务消费者向注册中心获取服务提供者地址列表，并根据负载算法直接调用提供者，同时汇报调用时间到监控中心，此时间包含网络开销\uf0b7注册中心，服务提供者，服务消费者三者之间均为长连接，监控中心除外\uf0b7注册中心通过长连接感知服务提供者的存在，服务提供者宕机，注册中心将立即推送事件通知消费者\uf0b7注册中心和监控中心全部宕机，不影响已运行的提供者和消费者，消费者在本地缓存了提供者列表\uf0b7注册中心和监控中心都是可选的，服务消费者可以直连服务提供者(2)健状性：\uf0b7监控中心宕掉不影响使用，只是丢失部分采样数据\uf0b7数据库宕掉后，注册中心仍能通过缓存提供服务列表查询，但不能注册新服务\uf0b7注册中心对等集群，任意一台宕掉后，将自动切换到另一台\uf0b7注册中心全部宕掉后，服务提供者和服务消费者仍能通过本地缓存通讯\uf0b7服务提供者无状态，任意一台宕掉后，不影响使用\uf0b7服务提供者全部宕掉后，服务消费者应用将无法使用，并无限次重连等待服务提供者恢复(3)伸缩性：\uf0b7注册中心为对等集群，可动态增加机器部署实例，所有客户端将自动发现新的注册中心\uf0b7服务提供者无状态，可动态增加机器部署实例，注册中心将推送新的服务提供者信息给消费者(4)升级性：\uf0b7当服务集群规模进一步扩大，带动IT治理结构进一步升级，需要实现动态部署，进行流动计算，现有分布式服务架构不会带来阻力：三、Dubbo基本配置提供者dubbo配置文件Provider.xml：消费者Dubbo配置文件：配置文件说明：\uf0b7服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。\uf0b7引用配置，用于创建一个远程服务代理，一个引用可以指向多个注册中心。\uf0b7协议配置，用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。\uf0b7应用配置，用于配置当前应用信息，不管该应用是提供者还是消费者。\uf0b7模块配置，用于配置当前模块信息，可选。\uf0b7注册中心配置，用于配置连接注册中心相关信息。\uf0b7监控中心配置，用于配置连接监控中心相关信息，可选。\uf0b7提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值，可选。\uf0b7消费方缺省配置，当ReferenceConfig某属性没有配置时，采用此缺省值，可选。\uf0b7方法配置，用于ServiceConfig和ReferenceConfig指定方法级的配置信息。\uf0b7用于指定方法参数配置。http://alibaba.github.io/dubbo-doc-static/User+Guide-zh.htm-配置参考手册集群容错各节点关系：\uf0b7这里的Invoker是Provider的一个可调用Service的抽象，Invoker封装了Provider地址及Service接口信息。\uf0b7Directory代表多个Invoker，可以把它看成List，但与List不同的是，它的值可能是动态变化的，比如注册中心推送变更。\uf0b7Cluster将Directory中的多个Invoker伪装成一个Invoker，对上层透明，伪装过程包含了容错逻辑，调用失败后，重试另一个。\uf0b7Router负责从多个Invoker中按路由规则选出子集，比如读写分离，应用隔离等。\uf0b7LoadBalance负责从多个Invoker中选出具体的一个用于本次调用，选的过程包含了负载均衡算法，调用失败后，需要重选。集群容错模式FailoverCluster失败自动切换，当出现失败，重试其它服务器。(缺省)通常用于读操作，但重试会带来更长延迟。可通过retries="2"来设置重试次数(不含第一次)。FailfastCluster快速失败，只发起一次调用，失败立即报错。通常用于非幂等性的写操作，比如新增记录。FailsafeCluster失败安全，出现异常时，直接忽略。通常用于写入审计日志等操作。FailbackCluster失败自动恢复，后台记录失败请求，定时重发。通常用于消息通知操作。ForkingCluster并行调用多个服务器，只要一个成功即返回。通常用于实时性要求较高的读操作，但需要浪费更多服务资源。可通过forks="2"来设置最大并行数。BroadcastCluster广播调用所有提供者，逐个调用，任意一台报错则报错。(2.1.0开始支持)通常用于通知所有提供者更新缓存或日志等本地资源信息。异步调用代码调用：fooService.findFoo(fooId);//此调用会立即返回nullFuturefooFuture=RpcContext.getContext().getFuture();//拿到调用的Future引用，当结果返回后，会被通知和设置到此Future。barService.findBar(barId);//此调用会立即返回nullFuturebarFuture=RpcContext.getContext().getFuture();//拿到调用的Future引用，当结果返回后，会被通知和设置到此Future。//此时findFoo和findBar的请求同时在执行，客户端不需要启动多线程来支持并行，而是借助NIO的非阻塞完成。Foofoo=fooFuture.get();//如果foo已返回，直接拿到返回值，否则线程wait住，等待foo返回后，线程会被notify唤醒。Barbar=barFuture.get();//同理等待bar返回。//如果foo需要5秒返回，bar需要6秒返回，实际只需等6秒，即可获取到foo和bar，进行接下来的处理。你也可以设置是否等待消息发出：(异步总是不等待返回)\uf0b7sent="true"等待消息发出，消息发送失败将抛出异常。\uf0b7sent="false"不等待消息发出，将消息放入IO队列，即刻返回。如果你只是想异步，完全忽略返回值，可以配置return="false"，以减少Future对象的创建和管理成本：参数回调参数回调方式与调用本地callback或listener相同，只需要在Spring的配置文件中声明哪个参数是callback类型即可，Dubbo将基于长连接生成反向代理，这样就可以从服务器端调用客户端逻辑。事件通知在调用之前，调用之后，出现异常时，会触发oninvoke,onreturn,onthrow三个事件，可以配置当事件发生时，通知哪个类的哪个方法。注：callback与async功能正交分解：async=true，表示结果是否马上返回.onreturn表示是否需要回调.组合情况：(async=false默认)异步回调模式：async=trueonreturn="xxx"同步回调模式：async=falseonreturn="xxx"异步无回调：async=true同步无回调：async=false',)