Dubbo SPI 插件定义及使用详细介绍 on Apache Dubbo

协议扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

RPC 协议扩展，封装远程调用细节。

契约：

当用户调用 refer() 所返回的 Invoker 对象的 invoke() 方法时，协议需相应执行同 URL 远端 export() 传入的 Invoker 对象的 invoke() 方法。
其中，refer() 返回的 Invoker 由协议实现，协议通常需要在此 Invoker 中发送远程请求，export() 传入的 Invoker 由框架实现并传入，协议不需要关心。

注意

协议不关心业务接口的透明代理，以 Invoker 为中心，由外层将 Invoker 转换为业务接口。
协议不一定要是 TCP 网络通讯，比如通过共享文件，IPC 进程间通讯等。

扩展接口

org.apache.dubbo.rpc.Protocol
org.apache.dubbo.rpc.Exporter
org.apache.dubbo.rpc.Invoker

public interface Protocol {
 /**
 * 暴露远程服务：<br>
 * 1. 协议在接收请求时，应记录请求来源方地址信息：RpcContext.getContext().setRemoteAddress();<br>
 * 2. export()必须是幂等的，也就是暴露同一个URL的Invoker两次，和暴露一次没有区别。<br>
 * 3. export()传入的Invoker由框架实现并传入，协议不需要关心。<br>
 * 
 * @param <T> 服务的类型
 * @param invoker 服务的执行体
 * @return exporter 暴露服务的引用，用于取消暴露
 * @throws RpcException 当暴露服务出错时抛出，比如端口已占用
 */
 <T> Exporter<T> export(Invoker<T> invoker) throws RpcException;
 
 /**
 * 引用远程服务：<br>
 * 1. 当用户调用refer()所返回的Invoker对象的invoke()方法时，协议需相应执行同URL远端export()传入的Invoker对象的invoke()方法。<br>
 * 2. refer()返回的Invoker由协议实现，协议通常需要在此Invoker中发送远程请求。<br>
 * 3. 当url中有设置check=false时，连接失败不能抛出异常，需内部自动恢复。<br>
 * 
 * @param <T> 服务的类型
 * @param type 服务的类型
 * @param url 远程服务的URL地址
 * @return invoker 服务的本地代理
 * @throws RpcException 当连接服务提供方失败时抛出
 */
 <T> Invoker<T> refer(Class<T> type, URL url) throws RpcException;
 
}

扩展配置

<!-- 声明协议，如果没有配置id，将以name为id -->
<dubbo:protocol id="xxx1" name="xxx" />
<!-- 引用协议，如果没有配置protocol属性，将在ApplicationContext中自动扫描protocol配置 -->
<dubbo:service protocol="xxx1" />
<!-- 引用协议缺省值，当<dubbo:service>没有配置prototol属性时，使用此配置 -->
<dubbo:provider protocol="xxx1" />

已知扩展

org.apache.dubbo.rpc.protocol.injvm.InjvmProtocol
org.apache.dubbo.rpc.protocol.dubbo.DubboProtocol
org.apache.dubbo.rpc.protocol.rmi.RmiProtocol
org.apache.dubbo.rpc.protocol.http.HttpProtocol
org.apache.dubbo.rpc.protocol.http.hessian.HessianProtocol
org.apache.dubbo.rpc.support.MockProtocol

扩展示例

Maven项目结构：

调用拦截扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

服务提供方和服务消费方调用过程拦截，Dubbo 本身的大多功能均基于此扩展点实现，每次远程方法执行，该拦截都会被执行，请注意对性能的影响。

约定：

用户自定义 filter 默认在内置 filter 之后。
特殊值 default，表示缺省扩展点插入的位置。比如：filter="xxx,default,yyy"，表示 xxx 在缺省 filter 之前，yyy 在缺省 filter 之后。
特殊符号 -，表示剔除。比如：filter="-foo1"，剔除添加缺省扩展点 foo1。比如：filter="-default"，剔除添加所有缺省扩展点。
provider 和 service 同时配置的 filter 时，累加所有 filter，而不是覆盖。比如：<dubbo:provider filter="xxx,yyy"/> 和 <dubbo:service filter="aaa,bbb" />，则 xxx,yyy,aaa,bbb 均会生效。如果要覆盖，需配置：<dubbo:service filter="-xxx,-yyy,aaa,bbb" />

扩展接口

org.apache.dubbo.rpc.Filter

扩展配置

<!-- 消费方调用过程拦截 -->
<dubbo:reference filter="xxx,yyy" />
<!-- 消费方调用过程缺省拦截器，将拦截所有reference -->
<dubbo:consumer filter="xxx,yyy"/>
<!-- 提供方调用过程拦截 -->
<dubbo:service filter="xxx,yyy" />
<!-- 提供方调用过程缺省拦截器，将拦截所有service -->
<dubbo:provider filter="xxx,yyy"/>

已知扩展

org.apache.dubbo.rpc.filter.EchoFilter
org.apache.dubbo.rpc.filter.GenericFilter
org.apache.dubbo.rpc.filter.GenericImplFilter
org.apache.dubbo.rpc.filter.TokenFilter
org.apache.dubbo.rpc.filter.AccessLogFilter
org.apache.dubbo.rpc.filter.CountFilter
org.apache.dubbo.rpc.filter.ActiveLimitFilter
org.apache.dubbo.rpc.filter.ClassLoaderFilter
org.apache.dubbo.rpc.filter.ContextFilter
org.apache.dubbo.rpc.filter.ConsumerContextFilter
org.apache.dubbo.rpc.filter.ExceptionFilter
org.apache.dubbo.rpc.filter.ExecuteLimitFilter
org.apache.dubbo.rpc.filter.DeprecatedFilter

扩展示例

Maven 项目结构：

引用监听扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

当有服务引用时，触发该事件。

扩展接口

org.apache.dubbo.rpc.InvokerListener

扩展配置

<!-- 引用服务监听 -->
<dubbo:reference listener="xxx,yyy" /> 
<!-- 引用服务缺省监听器 -->
<dubbo:consumer listener="xxx,yyy" />

已知扩展

org.apache.dubbo.rpc.listener.DeprecatedInvokerListener

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxInvokerListener.java (实现InvokerListener接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.InvokerListener (纯文本文件，内容为：xxx=com.xxx.XxxInvokerListener)

XxxInvokerListener.java：

package com.xxx;
 
import org.apache.dubbo.rpc.InvokerListener;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.RpcException;
 
public class XxxInvokerListener implements InvokerListener {
 public void referred(Invoker<?> invoker) throws RpcException {
 // ...
 }
 public void destroyed(Invoker<?> invoker) throws RpcException {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.InvokerListener：

暴露监听扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

当有服务暴露时，触发该事件。

扩展接口

org.apache.dubbo.rpc.ExporterListener

扩展配置

<!-- 暴露服务监听 -->
<dubbo:service listener="xxx,yyy" />
<!-- 暴露服务缺省监听器 -->
<dubbo:provider listener="xxx,yyy" />

已知扩展

org.apache.dubbo.registry.directory.RegistryExporterListener

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxExporterListener.java (实现ExporterListener接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.ExporterListener (纯文本文件，内容为：xxx=com.xxx.XxxExporterListener)

XxxExporterListener.java：

package com.xxx;
 
import org.apache.dubbo.rpc.ExporterListener;
import org.apache.dubbo.rpc.Exporter;
import org.apache.dubbo.rpc.RpcException;
 
 
public class XxxExporterListener implements ExporterListener {
 public void exported(Exporter<?> exporter) throws RpcException {
 // ...
 }
 public void unexported(Exporter<?> exporter) throws RpcException {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.ExporterListener：

集群扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

当有多个服务提供方时，将多个服务提供方组织成一个集群，并伪装成一个提供方。

扩展接口

org.apache.dubbo.rpc.cluster.Cluster

扩展配置

<dubbo:protocol cluster="xxx" />
<!-- 缺省值配置，如果<dubbo:protocol>没有配置cluster时，使用此配置 -->
<dubbo:provider cluster="xxx" />

已知扩展

org.apache.dubbo.rpc.cluster.support.wrapper.MockClusterWrapper
org.apache.dubbo.rpc.cluster.support.FailoverCluster
org.apache.dubbo.rpc.cluster.support.FailfastCluster
org.apache.dubbo.rpc.cluster.support.FailsafeCluster
org.apache.dubbo.rpc.cluster.support.FailbackCluster
org.apache.dubbo.rpc.cluster.support.ForkingCluster
org.apache.dubbo.rpc.cluster.support.AvailableCluster
org.apache.dubbo.rpc.cluster.support.MergeableCluster
org.apache.dubbo.rpc.cluster.support.BroadcastCluster
org.apache.dubbo.rpc.cluster.support.registry.ZoneAwareCluster

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxCluster.java (实现Cluster接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.cluster.Cluster (纯文本文件，内容为：xxx=com.xxx.XxxCluster)

XxxCluster.java：

package com.xxx;
 
import org.apache.dubbo.rpc.cluster.Cluster;
import org.apache.dubbo.rpc.cluster.support.AbstractClusterInvoker;
import org.apache.dubbo.rpc.cluster.Directory;
import org.apache.dubbo.rpc.cluster.LoadBalance;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.Invocation;
import org.apache.dubbo.rpc.Result;
import org.apache.dubbo.rpc.RpcException;
 
public class XxxCluster implements Cluster {
 public <T> Invoker<T> merge(Directory<T> directory) throws RpcException {
 return new AbstractClusterInvoker<T>(directory) {
 public Result doInvoke(Invocation invocation, List<Invoker<T>> invokers, LoadBalance loadbalance) throws RpcException {
 // ...
 }
 };
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.cluster.Cluster：

路由扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

从多个服务提供方中选择一个进行调用。

扩展接口

org.apache.dubbo.rpc.cluster.RouterFactory
org.apache.dubbo.rpc.cluster.Router

已知扩展

org.apache.dubbo.rpc.cluster.router.ScriptRouterFactory
org.apache.dubbo.rpc.cluster.router.FileRouterFactory
org.apache.dubbo.rpc.cluster.router.condition.config.AppRouterFactory
org.apache.dubbo.rpc.cluster.CacheableRouterFactory
org.apache.dubbo.rpc.cluster.router.condition.ConditionRouterFactory
org.apache.dubbo.rpc.cluster.router.mock.MockRouterFactory
org.apache.dubbo.rpc.cluster.router.condition.config.ServiceRouterFactory
org.apache.dubbo.rpc.cluster.router.tag.TagRouterFactory

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxRouterFactory.java (实现RouterFactory接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.cluster.RouterFactory (纯文本文件，内容为：xxx=com.xxx.XxxRouterFactory)

XxxRouterFactory.java：

package com.xxx;
 
import org.apache.dubbo.rpc.cluster.RouterFactory;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.Invocation;
import org.apache.dubbo.rpc.RpcException;
 
public class XxxRouterFactory implements RouterFactory {
 public Router getRouter(URL url) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.cluster.RouterFactory：

xxx=com.xxx.XxxRouterFactory

负载均衡扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

从多个服务提供方中选择一个进行调用

扩展接口

org.apache.dubbo.rpc.cluster.LoadBalance

扩展配置

<dubbo:protocol loadbalance="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置loadbalance时，使用此配置 -->
<dubbo:provider loadbalance="xxx" />

已知扩展

org.apache.dubbo.rpc.cluster.loadbalance.RandomLoadBalance
org.apache.dubbo.rpc.cluster.loadbalance.RoundRobinLoadBalance
org.apache.dubbo.rpc.cluster.loadbalance.LeastActiveLoadBalance
org.apache.dubbo.rpc.cluster.loadbalance.ConsistentHashLoadBalance
org.apache.dubbo.rpc.cluster.loadbalance.ShortestResponseLoadBalance

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxLoadBalance.java (实现LoadBalance接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.cluster.LoadBalance (纯文本文件，内容为：xxx=com.xxx.XxxLoadBalance)

XxxLoadBalance.java：

package com.xxx;
 
import org.apache.dubbo.rpc.cluster.LoadBalance;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.Invocation;
import org.apache.dubbo.rpc.RpcException; 
 
public class XxxLoadBalance implements LoadBalance {
 public <T> Invoker<T> select(List<Invoker<T>> invokers, Invocation invocation) throws RpcException {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.cluster.LoadBalance：

合并结果扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

合并返回结果，用于分组聚合。

扩展接口

org.apache.dubbo.rpc.cluster.Merger

扩展配置

<dubbo:method merger="xxx" />

已知扩展

org.apache.dubbo.rpc.cluster.merger.ArrayMerger
org.apache.dubbo.rpc.cluster.merger.ListMerger
org.apache.dubbo.rpc.cluster.merger.SetMerger
org.apache.dubbo.rpc.cluster.merger.MapMerger
org.apache.dubbo.rpc.cluster.merger.ByteArrayMerger
org.apache.dubbo.rpc.cluster.merger.CharArrayMerger
org.apache.dubbo.rpc.cluster.merger.ShortArrayMerger
org.apache.dubbo.rpc.cluster.merger.IntArrayMerger
org.apache.dubbo.rpc.cluster.merger.LongArrayMerger
org.apache.dubbo.rpc.cluster.merger.FloatArrayMerger
org.apache.dubbo.rpc.cluster.merger.DoubleArrayMerger
org.apache.dubbo.rpc.cluster.merger.BooleanArrayMerger

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxMerger.java (实现Merger接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.cluster.Merger (纯文本文件，内容为：xxx=com.xxx.XxxMerger)

XxxMerger.java：

package com.xxx;
 
import org.apache.dubbo.rpc.cluster.Merger;
 
public class XxxMerger<T> implements Merger<T> {
 public T merge(T... results) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.cluster.Merger：

xxx=com.xxx.XxxMerger

注册中心扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

负责服务的注册与发现。

扩展接口

org.apache.dubbo.registry.RegistryFactory
org.apache.dubbo.registry.Registry

扩展配置

<!-- 定义注册中心 -->
<dubbo:registry id="xxx1" address="xxx://ip:port" />
<!-- 引用注册中心，如果没有配置registry属性，将在ApplicationContext中自动扫描registry配置 -->
<dubbo:service registry="xxx1" />
<!-- 引用注册中心缺省值，当<dubbo:service>没有配置registry属性时，使用此配置 -->
<dubbo:provider registry="xxx1" />

扩展契约

RegistryFactory.java：

public interface RegistryFactory {
 /**
 * 连接注册中心.
 * 
 * 连接注册中心需处理契约：<br>
 * 1. 当设置check=false时表示不检查连接，否则在连接不上时抛出异常。<br>
 * 2. 支持URL上的username:password权限认证。<br>
 * 3. 支持backup=10.20.153.10备选注册中心集群地址。<br>
 * 4. 支持file=registry.cache本地磁盘文件缓存。<br>
 * 5. 支持timeout=1000请求超时设置。<br>
 * 6. 支持session=60000会话超时或过期设置。<br>
 * 
 * @param url 注册中心地址，不允许为空
 * @return 注册中心引用，总不返回空
 */
 Registry getRegistry(URL url); 
}

RegistryService.java：

监控中心扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

负责服务调用次和调用时间的监控。

扩展接口

org.apache.dubbo.monitor.MonitorFactory
org.apache.dubbo.monitor.Monitor

扩展配置

<!-- 定义监控中心 -->
<dubbo:monitor address="xxx://ip:port" />

已知扩展

org.apache.dubbo.monitor.support.dubbo.DubboMonitorFactory

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxMonitorFactoryjava (实现MonitorFactory接口)
 |-XxxMonitor.java (实现Monitor接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.monitor.MonitorFactory (纯文本文件，内容为：xxx=com.xxx.XxxMonitorFactory)

XxxMonitorFactory.java：

package com.xxx;
 
import org.apache.dubbo.monitor.MonitorFactory;
import org.apache.dubbo.monitor.Monitor;
import org.apache.dubbo.common.URL;
 
public class XxxMonitorFactory implements MonitorFactory {
 public Monitor getMonitor(URL url) {
 return new XxxMonitor(url);
 }
}

XxxMonitor.java：

package com.xxx;
 
import org.apache.dubbo.monitor.Monitor;
 
public class XxxMonitor implements Monitor {
 public void count(URL statistics) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.monitor.MonitorFactory：

扩展点加载扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

扩展点本身的加载容器，可从不同容器加载扩展点。

扩展接口

org.apache.dubbo.common.extension.ExtensionFactory

扩展配置

<dubbo:application compiler="jdk" />

已知扩展

org.apache.dubbo.common.extension.factory.SpiExtensionFactory
org.apache.dubbo.config.spring.extension.SpringExtensionFactory

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxExtensionFactory.java (实现ExtensionFactory接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.extension.ExtensionFactory (纯文本文件，内容为：xxx=com.xxx.XxxExtensionFactory)

XxxExtensionFactory.java：

package com.xxx;
 
import org.apache.dubbo.common.extension.ExtensionFactory;
 
public class XxxExtensionFactory implements ExtensionFactory {
 public Object getExtension(Class<?> type, String name) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.common.extension.ExtensionFactory：

xxx=com.xxx.XxxExtensionFactory

Liveness 存活探针

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

拓展应用存活的检测点。

扩展接口

org.apache.dubbo.qos.probe.LivenessProbe

扩展配置

Dubbo QOS live 命令自动发现

已知扩展

暂无默认实现

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxLivenessProbe.java (实现LivenessProbe接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.qos.probe.LivenessProbe (纯文本文件，内容为：xxx=com.xxx.XxxLivenessProbe)

XxxLivenessProbe.java：

package com.xxx;
 
public class XxxLivenessProbe implements LivenessProbe {
 
 public boolean check() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.qos.probe.LivenessProbe：

xxx=com.xxx.XxxLivenessProbe

动态代理扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

将 Invoker 接口转换成业务接口。

扩展接口

org.apache.dubbo.rpc.ProxyFactory

扩展配置

<dubbo:protocol proxy="xxx" />
<!-- 缺省值配置，当<dubbo:protocol>没有配置proxy属性时，使用此配置 -->
<dubbo:provider proxy="xxx" />

已知扩展

org.apache.dubbo.rpc.proxy.JdkProxyFactory
org.apache.dubbo.rpc.proxy.JavassistProxyFactory

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxProxyFactory.java (实现ProxyFactory接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.rpc.ProxyFactory (纯文本文件，内容为：xxx=com.xxx.XxxProxyFactory)

XxxProxyFactory.java：

package com.xxx;
 
import org.apache.dubbo.rpc.ProxyFactory;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.RpcException;
 
 
public class XxxProxyFactory implements ProxyFactory {
 public <T> T getProxy(Invoker<T> invoker) throws RpcException {
 // ...
 }
 public <T> Invoker<T> getInvoker(T proxy, Class<T> type, URL url) throws RpcException {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.rpc.ProxyFactory：

Readiness 就绪探针

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

拓展应用就绪的检测点。

扩展接口

org.apache.dubbo.qos.probe.ReadinessProbe

扩展配置

Dubbo QOS ready 命令自动发现

已知扩展

org.apache.dubbo.qos.probe.impl.BootstrapReadinessProbe
org.apache.dubbo.qos.probe.impl.ProviderReadinessProbe

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxReadinessProbe.java (实现ReadinessProbe接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.qos.probe.ReadinessProbe (纯文本文件，内容为：xxx=com.xxx.XxxReadinessProbe)

XxxReadinessProbe.java：

package com.xxx;
 
public class XxxReadinessProbe implements ReadinessProbe {
 
 public boolean check() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.qos.probe.ReadinessProbe：

xxx=com.xxx.XxxReadinessProbe

Startup 启动探针

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

拓展应用启动的检测点。

扩展接口

org.apache.dubbo.qos.probe.StartupProbe

扩展配置

Dubbo QOS startup 命令自动发现

已知扩展

org.apache.dubbo.qos.probe.impl.BootstrapLivenessProbe

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxStartupProbe.java (实现StartupProbe接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.qos.probe.StartupProbe (纯文本文件，内容为：xxx=com.xxx.XxxStartupProbe)

XxxStartupProbee.java：

package com.xxx;
 
public class XxxStartupProbe implements StartupProbe {
 
 public boolean check() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.qos.probe.StartupProbe：

xxx=com.xxx.XxxStartupProbe

编译器扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

Java 代码编译器，用于动态生成字节码，加速调用。

扩展接口

org.apache.dubbo.common.compiler.Compiler

扩展配置

自动加载

已知扩展

org.apache.dubbo.common.compiler.support.JdkCompiler
org.apache.dubbo.common.compiler.support.JavassistCompiler

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxCompiler.java (实现Compiler接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.compiler.Compiler (纯文本文件，内容为：xxx=com.xxx.XxxCompiler)

XxxCompiler.java：

package com.xxx;
 
import org.apache.dubbo.common.compiler.Compiler;
 
public class XxxCompiler implements Compiler {
 public Object getExtension(Class<?> type, String name) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.common.compiler.Compiler：

xxx=com.xxx.XxxCompiler

配置中心扩展

Mon, 01 Jan 0001 00:00:00 +0000

设计目的

配置中心的核心功能是作为 Key-Value 存储，Dubbo 框架告知配置中心其关心的 key，配置中心返回该key对应的 value 值。

按照应用场景划分，配置中心在 Dubbo 框架中主要承担以下职责：

作为外部化配置中心，即存储 dubbo.properties 配置文件，此时，key 值通常为文件名如 dubbo.properties，value 则为配置文件内容。
存储单个配置项，如各种开关项、常量值等。
存储服务治理规则，此时key通常按照 “服务名+规则类型” 的格式来组织，而 value 则为具体的治理规则。

为了进一步实现对 key-value 的分组管理，Dubbo 的配置中心还加入了 namespace、group 的概念，这些概念在很多专业的第三方配置中心中都有体现，通常情况下，namespace 用来隔离不同的租户，group 用来对同一租户的key集合做分组。

当前，Dubbo 配置中心实现了对 Zookeeper、Nacos、Etcd、Consul、Apollo 的对接，接下来我们具体看一下 Dubbo 抽象的配置中心是怎么映射到具体的第三方实现中的。

扩展接口

org.apache.dubbo.configcenter.DynamicConfigurationFactory
org.apache.dubbo.configcenter.DynamicConfiguration

已知扩展

org.apache.dubbo.configcenter.support.zookeeper.ZookeeperDynamicConfigurationFactory
org.apache.dubbo.configcenter.support.nacos.NacosDynamicConfigurationFactory
org.apache.dubbo.configcenter.support.etcd.EtcdDynamicConfigurationFactory
org.apache.dubbo.configcenter.consul.ConsulDynamicConfigurationFactory
org.apache.dubbo.configcenter.support.apollo.ApolloDynamicConfigurationFactory
org.apache.dubbo.common.config.configcenter.file.FileSystemDynamicConfigurationFactory

实现原理

Zookeeper

zookeeper提供了一个树状的存储模型，其实现原理如下：

namespace, group, key 等分别对应不同层级的 ZNode 节点，而 value 则作为根 ZNode 节点的值存储。

外部化配置中心 dubbo.properties

上图展示了两个不同作用域的 dubbo.properties 文件在 zookeeper 中的存储结构：
- 命名空间namespace都为：dubbo
- 分组 group：全局级别为 dubbo，所有应用共享；应用级别为应用名 demo-provider，只对该应用生效
- key：dubbo.properties
单个配置项

元数据中心扩展

Mon, 01 Jan 0001 00:00:00 +0000

设计目的

请参见元数据中心手册

扩展接口

org.apache.dubbo.metadata.store.MetadataReportFactory
org.apache.dubbo.metadata.store.MetadataReport

已知扩展

实现原理

SPI定义

参考：org.apache.dubbo.metadata.store.MetadataReportFactory，org.apache.dubbo.metadata.store.MetadataReport

@SPI("redis")
public interface MetadataReportFactory {
 @Adaptive({"protocol"})
 MetadataReport getMetadataReport(URL url);
}

自定义元数据的存储

下面以Redis存储为例进行说明。

新建一个project，需要支持以下修改：

扩展AbstractMetadataReport

public class RedisMetadataReport extends AbstractMetadataReport {
 private final static Logger logger = LoggerFactory.getLogger(RedisMetadataReport.class);
 final JedisPool pool;

 public RedisMetadataReport(URL url) {
 super(url);
 pool = new JedisPool(new JedisPoolConfig(), url.getHost(), url.getPort());
 }
 @Override
 protected void doStoreProviderMetadata(ProviderMetadataIdentifier providerMetadataIdentifier, String serviceDefinitions) {
 this.storeMetadata(providerMetadataIdentifier, serviceDefinitions);
 }
 @Override
 protected void doStoreConsumerMetadata(ConsumerMetadataIdentifier consumerMetadataIdentifier, String value) {
 this.storeMetadata(consumerMetadataIdentifier, value);
 }
 private void storeMetadata(MetadataIdentifier metadataIdentifier, String v) {
 try (Jedis jedis = pool.getResource()) {
 jedis.set(metadataIdentifier.getIdentifierKey() + META_DATA_SOTRE_TAG, v);
 } catch (Throwable e) {
 logger.error("Failed to put " + metadataIdentifier + " to redis " + v + ", cause: " + e.getMessage(), e);
 throw new RpcException("Failed to put " + metadataIdentifier + " to redis " + v + ", cause: " + e.getMessage(), e);
 }
 }
}

扩展 AbstractMetadataReportFactory

public class RedisMetadataReportFactory extends AbstractMetadataReportFactory {
 @Override
 public MetadataReport createMetadataReport(URL url) {
 return new RedisMetadataReport(url);
 }
}

增加 MetadataReportFactory

META-INF/dubbo/internal/org.apache.dubbo.metadata.store.MetadataReportFactory

消息派发扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

通道信息派发器，用于指定线程池模型。

扩展接口

org.apache.dubbo.remoting.Dispatcher

扩展配置

<dubbo:protocol dispatcher="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置dispatcher属性时，使用此配置 -->
<dubbo:provider dispatcher="xxx" />

已知扩展

org.apache.dubbo.remoting.transport.dispatcher.all.AllDispatcher
org.apache.dubbo.remoting.transport.dispatcher.direct.DirectDispatcher
org.apache.dubbo.remoting.transport.dispatcher.message.MessageOnlyDispatcher
org.apache.dubbo.remoting.transport.dispatcher.execution.ExecutionDispatcher
org.apache.dubbo.remoting.transport.dispatcher.connection.ConnectionOrderedDispatcher

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxDispatcher.java (实现Dispatcher接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.remoting.Dispatcher (纯文本文件，内容为：xxx=com.xxx.XxxDispatcher)

XxxDispatcher.java：

package com.xxx;
 
import org.apache.dubbo.remoting.Dispatcher;
 
public class XxxDispatcher implements Dispatcher {
 public Group lookup(URL url) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.remoting.Dispatcher：

xxx=com.xxx.XxxDispatcher

线程池扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

服务提供方线程池实现策略，当服务器收到一个请求时，需要在线程池中创建一个线程去执行服务提供方业务逻辑。

扩展接口

org.apache.dubbo.common.threadpool.ThreadPool

扩展配置

<dubbo:protocol threadpool="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置threadpool时，使用此配置 -->
<dubbo:provider threadpool="xxx" />

已知扩展

org.apache.dubbo.common.threadpool.FixedThreadPool
org.apache.dubbo.common.threadpool.CachedThreadPool

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxThreadPool.java (实现ThreadPool接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.threadpool.ThreadPool (纯文本文件，内容为：xxx=com.xxx.XxxThreadPool)

XxxThreadPool.java：

package com.xxx;
 
import org.apache.dubbo.common.threadpool.ThreadPool;
import java.util.concurrent.Executor;
 
public class XxxThreadPool implements ThreadPool {
 public Executor getExecutor() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.common.threadpool.ThreadPool：

xxx=com.xxx.XxxThreadPool

序列化扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

将对象转成字节流，用于网络传输，以及将字节流转为对象，用于在收到字节流数据后还原成对象。

扩展接口

org.apache.dubbo.common.serialize.Serialization
org.apache.dubbo.common.serialize.ObjectInput
org.apache.dubbo.common.serialize.ObjectOutput

扩展配置

<!-- 协议的序列化方式 -->
<dubbo:protocol serialization="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置serialization时，使用此配置 -->
<dubbo:provider serialization="xxx" />

已知扩展

org.apache.dubbo.common.serialize.dubbo.DubboSerialization
org.apache.dubbo.common.serialize.hessian.Hessian2Serialization
org.apache.dubbo.common.serialize.java.JavaSerialization
org.apache.dubbo.common.serialize.java.CompactedJavaSerialization

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxSerialization.java (实现Serialization接口)
 |-XxxObjectInput.java (实现ObjectInput接口)
 |-XxxObjectOutput.java (实现ObjectOutput接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.serialize.Serialization (纯文本文件，内容为：xxx=com.xxx.XxxSerialization)

XxxSerialization.java：

package com.xxx;
 
import org.apache.dubbo.common.serialize.Serialization;
import org.apache.dubbo.common.serialize.ObjectInput;
import org.apache.dubbo.common.serialize.ObjectOutput;
 
 
public class XxxSerialization implements Serialization {
 public ObjectOutput serialize(Parameters parameters, OutputStream output) throws IOException {
 return new XxxObjectOutput(output);
 }
 public ObjectInput deserialize(Parameters parameters, InputStream input) throws IOException {
 return new XxxObjectInput(input);
 }
}

META-INF/dubbo/org.apache.dubbo.common.serialize.Serialization：

网络传输扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

远程通讯的服务器及客户端传输实现。

扩展接口

org.apache.dubbo.remoting.Transporter
org.apache.dubbo.remoting.Server
org.apache.dubbo.remoting.Client

扩展配置

<!-- 服务器和客户端使用相同的传输实现 -->
<dubbo:protocol transporter="xxx" /> 
<!-- 服务器和客户端使用不同的传输实现 -->
<dubbo:protocol server="xxx" client="xxx" /> 
<!-- 缺省值设置，当<dubbo:protocol>没有配置transporter/server/client属性时，使用此配置 -->
<dubbo:provider transporter="xxx" server="xxx" client="xxx" />

已知扩展

org.apache.dubbo.remoting.transport.transporter.netty.NettyTransporter
org.apache.dubbo.remoting.transport.transporter.mina.MinaTransporter
org.apache.dubbo.remoting.transport.transporter.grizzly.GrizzlyTransporter

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxTransporter.java (实现Transporter接口)
 |-XxxServer.java (实现Server接口)
 |-XxxClient.java (实现Client接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.remoting.Transporter (纯文本文件，内容为：xxx=com.xxx.XxxTransporter)

XxxTransporter.java：

package com.xxx;
 
import org.apache.dubbo.remoting.Transporter;
 
public class XxxTransporter implements Transporter {
 public Server bind(URL url, ChannelHandler handler) throws RemotingException {
 return new XxxServer(url, handler);
 }
 public Client connect(URL url, ChannelHandler handler) throws RemotingException {
 return new XxxClient(url, handler);
 }
}

XxxServer.java：

信息交换扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

基于传输层之上，实现 Request-Response 信息交换语义。

扩展接口

org.apache.dubbo.remoting.exchange.Exchanger
org.apache.dubbo.remoting.exchange.ExchangeServer
org.apache.dubbo.remoting.exchange.ExchangeClient

扩展配置

<dubbo:protocol exchanger="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置exchanger属性时，使用此配置 -->
<dubbo:provider exchanger="xxx" />

已知扩展

org.apache.dubbo.remoting.exchange.exchanger.HeaderExchanger

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxExchanger.java (实现Exchanger接口)
 |-XxxExchangeServer.java (实现ExchangeServer接口)
 |-XxxExchangeClient.java (实现ExchangeClient接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.remoting.exchange.Exchanger (纯文本文件，内容为：xxx=com.xxx.XxxExchanger)

XxxExchanger.java：

package com.xxx;
 
import org.apache.dubbo.remoting.exchange.Exchanger;
 
 
public class XxxExchanger implements Exchanger {
 public ExchangeServer bind(URL url, ExchangeHandler handler) throws RemotingException {
 return new XxxExchangeServer(url, handler);
 }
 public ExchangeClient connect(URL url, ExchangeHandler handler) throws RemotingException {
 return new XxxExchangeClient(url, handler);
 }
}

XxxExchangeServer.java：

对等网络节点组网器扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

对等网络节点组网器。

扩展接口

org.apache.dubbo.container.page.PageHandler

扩展配置

<dubbo:protocol page="xxx,yyy" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置page属性时，使用此配置 -->
<dubbo:provider page="xxx,yyy" />

已知扩展

org.apache.dubbo.container.page.pages.HomePageHandler
org.apache.dubbo.container.page.pages.StatusPageHandler
org.apache.dubbo.container.page.pages.LogPageHandler
org.apache.dubbo.container.page.pages.SystemPageHandler

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxPageHandler.java (实现PageHandler接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.container.page.PageHandler (纯文本文件，内容为：xxx=com.xxx.XxxPageHandler)

XxxPageHandler.java：

package com.xxx;
 
import org.apache.dubbo.container.page.PageHandler;
 
public class XxxPageHandler implements PageHandler {
 public Group lookup(URL url) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.container.page.PageHandler：

xxx=com.xxx.XxxPageHandler

组网扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

对等网络节点组网器。

扩展接口

org.apache.dubbo.remoting.p2p.Networker

扩展配置

<dubbo:protocol networker="xxx" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置networker属性时，使用此配置 -->
<dubbo:provider networker="xxx" />

已知扩展

org.apache.dubbo.remoting.p2p.support.MulticastNetworker
org.apache.dubbo.remoting.p2p.support.FileNetworker

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxNetworker.java (实现Networker接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.remoting.p2p.Networker (纯文本文件，内容为：xxx=com.xxx.XxxNetworker)

XxxNetworker.java：

package com.xxx;
 
import org.apache.dubbo.remoting.p2p.Networker;
 
public class XxxNetworker implements Networker {
 public Group lookup(URL url) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.remoting.p2p.Networker：

xxx=com.xxx.XxxNetworker

Telnet 命令扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

所有服务器均支持 telnet 访问，用于人工干预。

扩展接口

org.apache.dubbo.remoting.telnet.TelnetHandler

扩展配置

<dubbo:protocol telnet="xxx,yyy" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置telnet属性时，使用此配置 -->
<dubbo:provider telnet="xxx,yyy" />

已知扩展

org.apache.dubbo.remoting.telnet.support.ClearTelnetHandler
org.apache.dubbo.remoting.telnet.support.ExitTelnetHandler
org.apache.dubbo.remoting.telnet.support.HelpTelnetHandler
org.apache.dubbo.remoting.telnet.support.StatusTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.ListTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.ChangeTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.CurrentTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.InvokeTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.TraceTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.CountTelnetHandler
org.apache.dubbo.rpc.dubbo.telnet.PortTelnetHandler

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxTelnetHandler.java (实现TelnetHandler接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.remoting.telnet.TelnetHandler (纯文本文件，内容为：xxx=com.xxx.XxxTelnetHandler)

XxxTelnetHandler.java：

package com.xxx;
 
import org.apache.dubbo.remoting.telnet.TelnetHandler;
 
@Help(parameter="...", summary="...", detail="...")
 
public class XxxTelnetHandler implements TelnetHandler {
 public String telnet(Channel channel, String message) throws RemotingException {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.remoting.telnet.TelnetHandler：

状态检查扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

检查服务依赖各种资源的状态，此状态检查可同时用于 telnet 的 status 命令和 hosting 的 status 页面。

扩展接口

org.apache.dubbo.common.status.StatusChecker

扩展配置

<dubbo:protocol status="xxx,yyy" />
<!-- 缺省值设置，当<dubbo:protocol>没有配置status属性时，使用此配置 -->
<dubbo:provider status="xxx,yyy" />

已知扩展

org.apache.dubbo.common.status.support.MemoryStatusChecker
org.apache.dubbo.common.status.support.LoadStatusChecker
org.apache.dubbo.rpc.dubbo.status.ServerStatusChecker
org.apache.dubbo.rpc.dubbo.status.ThreadPoolStatusChecker
org.apache.dubbo.registry.directory.RegistryStatusChecker
org.apache.dubbo.rpc.config.spring.status.SpringStatusChecker
org.apache.dubbo.rpc.config.spring.status.DataSourceStatusChecker

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxStatusChecker.java (实现StatusChecker接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.status.StatusChecker (纯文本文件，内容为：xxx=com.xxx.XxxStatusChecker)

XxxStatusChecker.java：

package com.xxx;
 
import org.apache.dubbo.common.status.StatusChecker;
 
public class XxxStatusChecker implements StatusChecker {
 public Status check() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.common.status.StatusChecker：

容器扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

服务容器扩展，用于自定义加载内容。

扩展接口

org.apache.dubbo.container.Container

扩展配置

java org.apache.dubbo.container.Main spring jetty log4j

已知扩展

org.apache.dubbo.container.spring.SpringContainer
org.apache.dubbo.container.spring.JettyContainer
org.apache.dubbo.container.spring.Log4jContainer

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxContainer.java (实现Container接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.container.Container (纯文本文件，内容为：xxx=com.xxx.XxxContainer)

XxxContainer.java：

package com.xxx;
 
org.apache.dubbo.container.Container;
 
 
public class XxxContainer implements Container {
 public Status start() {
 // ...
 }
 public Status stop() {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.container.Container：

xxx=com.xxx.XxxContainer

缓存扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

用请求参数作为 key，缓存返回结果。

扩展接口

org.apache.dubbo.cache.CacheFactory

扩展配置

<dubbo:service cache="lru" />
<!-- 方法级缓存 -->
<dubbo:service><dubbo:method cache="lru" /></dubbo:service> 
<!-- 缺省值设置，当<dubbo:service>没有配置cache属性时，使用此配置 -->
<dubbo:provider cache="xxx,yyy" />

已知扩展

org.apache.dubbo.cache.support.lru.LruCacheFactory
org.apache.dubbo.cache.support.threadlocal.ThreadLocalCacheFactory
org.apache.dubbo.cache.support.jcache.JCacheFactory

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxCacheFactory.java (实现CacheFactory接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.cache.CacheFactory (纯文本文件，内容为：xxx=com.xxx.XxxCacheFactory)

XxxCacheFactory.java：

package com.xxx;
 
import org.apache.dubbo.cache.CacheFactory;
 
public class XxxCacheFactory implements CacheFactory {
 public Cache getCache(URL url, String name) {
 return new XxxCache(url, name);
 }
}

XxxCache.java：

package com.xxx;
 
import org.apache.dubbo.cache.Cache;
 
public class XxxCache implements Cache {
 public Cache(URL url, String name) {
 // ...
 }
 public void put(Object key, Object value) {
 // ...
 }
 public Object get(Object key) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.cache.CacheFactory：

验证扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

参数验证扩展点。

扩展接口

org.apache.dubbo.validation.Validation

扩展配置

<dubbo:service validation="xxx,yyy" />
<!-- 缺省值设置，当<dubbo:service>没有配置validation属性时，使用此配置 -->
<dubbo:provider validation="xxx,yyy" />

已知扩展

org.apache.dubbo.validation.support.jvalidation.JValidation

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxValidation.java (实现Validation接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.validation.Validation (纯文本文件，内容为：xxx=com.xxx.XxxValidation)

XxxValidation.java：

package com.xxx;
 
import org.apache.dubbo.validation.Validation;
 
public class XxxValidation implements Validation {
 public Object getValidator(URL url) {
 // ...
 }
}

XxxValidator.java：

package com.xxx;
 
import org.apache.dubbo.validation.Validator;
 
public class XxxValidator implements Validator {
 public XxxValidator(URL url) {
 // ...
 }
 public void validate(Invocation invocation) throws Exception {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.validation.Validation：

日志适配扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

日志输出适配扩展点。

扩展接口

org.apache.dubbo.common.logger.LoggerAdapter

扩展配置

<dubbo:application logger="xxx" />

或者：

-Ddubbo:application.logger=xxx

已知扩展

org.apache.dubbo.common.logger.slf4j.Slf4jLoggerAdapter
org.apache.dubbo.common.logger.jcl.JclLoggerAdapter
org.apache.dubbo.common.logger.log4j.Log4jLoggerAdapter
org.apache.dubbo.common.logger.log4j2.Log4j2LoggerAdapter
org.apache.dubbo.common.logger.jdk.JdkLoggerAdapter

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxLoggerAdapter.java (实现LoggerAdapter接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.common.logger.LoggerAdapter (纯文本文件，内容为：xxx=com.xxx.XxxLoggerAdapter)

XxxLoggerAdapter.java：

package com.xxx;
 
import org.apache.dubbo.common.logger.LoggerAdapter;
 
public class XxxLoggerAdapter implements LoggerAdapter {
 public Logger getLogger(URL url) {
 // ...
 }
}

XxxLogger.java：

package com.xxx;
 
import org.apache.dubbo.common.logger.Logger;
 
public class XxxLogger implements Logger {
 public XxxLogger(URL url) {
 // ...
 }
 public void info(String msg) {
 // ...
 }
 // ...
}

META-INF/dubbo/org.apache.dubbo.common.logger.LoggerAdapter：

QoS匿名访问权限验证扩展

Mon, 01 Jan 0001 00:00:00 +0000

扩展说明

QoS匿名访问权限验证扩展点。

扩展接口

org.apache.dubbo.qos.permission.PermissionChecker

扩展配置

Dubbo QoS dubbo.application.qos-anonymous-access-permission-level 匿名访问权限校验。

默认实现

org.apache.dubbo.qos.permission.DefaultAnonymousAccessPermissionChecker

扩展示例

Maven 项目结构：

src
 |-main
 |-java
 |-com
 |-xxx
 |-XxxPermissionChecker.java (实现PermissionChecker接口)
 |-resources
 |-META-INF
 |-dubbo
 |-org.apache.dubbo.qos.permission.PermissionChecker` (纯文本文件，内容为：qosPermissionChecker=com.xxx.XxxPermissionChecker)

XxxPermissionChecker.java：

package com.xxx.qos.permission;

import org.apache.dubbo.qos.permission.PermissionChecker;

public class XxxAnonymousAccessPermissionChecker implements PermissionChecker {

 @Override
 public boolean access(CommandContext commandContext, PermissionLevel defaultCmdRequiredPermissionLevel) {
 // ...
 }
}

META-INF/dubbo/org.apache.dubbo.qos.permission.PermissionChecker：

qosPermissionChecker=com.xxx.XxxPermissionChecker