| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – SPI 扩展使用手册</title><link>https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/</link><description>Recent content in SPI 扩展使用手册 on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><atom:link href="https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/index.xml" rel="self" type="application/rss+xml"/><item><title>Overview: Dubbo SPI 概述</title><link>https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/overview/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/overview/</guid><description> |
| <h2 id="扩展设计理念">扩展设计理念</h2> |
| <p>可扩展性是任何一个系统所追求的，对于 Dubbo 来说是同样适用。</p> |
| <h3 id="什么是可扩展性">什么是可扩展性</h3> |
| <p>可扩展性是一种设计理念，代表了我们对未来的一种预想，我们希望在现有的架构或设计基础上，当未来某些方面发生变化的时候，我们能够以最小的改动来适应这种变化。</p> |
| <h3 id="可扩展性的优点">可扩展性的优点</h3> |
| <p>可扩展性的优点主要表现模块之间解耦，它符合开闭原则，对扩展开放，对修改关闭。当系统增加新功能时，不需要对现有系统的结构和代码进行修改，仅仅新增一个扩展即可。</p> |
| <h3 id="扩展实现方式">扩展实现方式</h3> |
| <p>一般来说，系统会采用 Factory、IoC、OSGI 等方式管理扩展(插件)生命周期。考虑到 Dubbo 的适用面，不想强依赖 Spring 等 IoC 容器。 |
| 而自己造一个小的 IoC 容器，也觉得有点过度设计，所以选择最简单的 Factory 方式管理扩展(插件)。在 Dubbo 中，所有内部实现和第三方实现都是平等的。</p> |
| <h3 id="dubbo-中的可扩展性">Dubbo 中的可扩展性</h3> |
| <ul> |
| <li>平等对待第三方的实现。在 Dubbo 中，所有内部实现和第三方实现都是平等的，用户可以基于自身业务需求，替换 Dubbo 提供的原生实现。</li> |
| <li>每个扩展点只封装一个变化因子，最大化复用。每个扩展点的实现者，往往都只是关心一件事。如果用户有需求需要进行扩展，那么只需要对其关注的扩展点进行扩展就好，极大的减少用户的工作量。</li> |
| </ul> |
| <h2 id="dubbo-扩展的特性">Dubbo 扩展的特性</h2> |
| <p>Dubbo 中的扩展能力是从 JDK 标准的 SPI 扩展点发现机制加强而来，它改进了 JDK 标准的 SPI 以下问题：</p> |
| <ul> |
| <li>JDK 标准的 SPI 会一次性实例化扩展点所有实现，如果有扩展实现初始化很耗时，但如果没用上也加载，会很浪费资源。</li> |
| <li>如果扩展点加载失败，连扩展点的名称都拿不到了。比如：JDK 标准的 ScriptEngine，通过 getName() 获取脚本类型的名称，但如果 RubyScriptEngine 因为所依赖的 jruby.jar 不存在，导致 RubyScriptEngine 类加载失败，这个失败原因被吃掉了，和 ruby 对应不起来，当用户执行 ruby 脚本时，会报不支持 ruby，而不是真正失败的原因。</li> |
| </ul> |
| <p>用户能够基于 Dubbo 提供的扩展能力，很方便基于自身需求扩展其他协议、过滤器、路由等。下面介绍下 Dubbo 扩展能力的特性。</p> |
| <ul> |
| <li>按需加载。Dubbo 的扩展能力不会一次性实例化所有实现，而是用扩展类实例化，减少资源浪费。</li> |
| <li>增加扩展类的 IOC 能力。Dubbo 的扩展能力并不仅仅只是发现扩展服务实现类，而是在此基础上更进一步，如果该扩展类的属性依赖其他对象，则 Dubbo 会自动的完成该依赖对象的注入功能。</li> |
| <li>增加扩展类的 AOP 能力。Dubbo 扩展能力会自动的发现扩展类的包装类，完成包装类的构造，增强扩展类的功能。</li> |
| <li>具备动态选择扩展实现的能力。Dubbo 扩展会基于参数，在运行时动态选择对应的扩展类，提高了 Dubbo 的扩展能力。</li> |
| <li>可以对扩展实现进行排序。能够基于用户需求，指定扩展实现的执行顺序。</li> |
| <li>提供扩展点的 Adaptive 能力。该能力可以使的一些扩展类在 consumer 端生效，一些扩展类在 provider 端生效。</li> |
| </ul> |
| <p>从 Dubbo 扩展的设计目标可以看出，Dubbo 实现的一些例如动态选择扩展实现、IOC、AOP 等特性，能够为用户提供非常灵活的扩展能力。</p> |
| <h2 id="dubbo-扩展加载流程">Dubbo 扩展加载流程</h2> |
| <p>Dubbo 加载扩展的整个流程如下：</p> |
| <p><img src="https://dubbo.apache.org/imgs/v3/concepts/extension-load.png" alt="//imgs/v3/concepts/extension-load.png"></p> |
| <p>主要步骤为 4 个：</p> |
| <ul> |
| <li>读取并解析配置文件</li> |
| <li>缓存所有扩展实现</li> |
| <li>基于用户执行的扩展名，实例化对应的扩展实现</li> |
| <li>进行扩展实例属性的 IOC 注入以及实例化扩展的包装类，实现 AOP 特性</li> |
| </ul> |
| <h2 id="如何使用-dubbo-扩展能力进行扩展">如何使用 Dubbo 扩展能力进行扩展</h2> |
| <p>下面以扩展协议为例进行说明如何利用 Dubbo 提供的扩展能力扩展 Triple 协议。</p> |
| <p>(1) 在协议的实现 jar 包内放置文本文件：META-INF/dubbo/org.apache.dubbo.remoting.api.WireProtocol</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>tri=org.apache.dubbo.rpc.protocol.tri.TripleHttp2Protocol |
| </span></span></code></pre></div><p>(2) 实现类内容</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#268bd2">@Activate</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">TripleHttp2Protocol</span> <span style="color:#268bd2">extends</span> Http2WireProtocol <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// ... |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><p>说明下：Http2WireProtocol 实现了 WireProtocol 接口</p> |
| <p>(3) Dubbo 配置模块中，扩展点均有对应配置属性或标签，通过配置指定使用哪个扩展实现。比如：</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>&lt;dubbo:protocol name=&#34;tri&#34; /&gt; |
| </span></span></code></pre></div><p>从上面的扩展步骤可以看出，用户基本在黑盒下就完成了扩展。</p> |
| <h2 id="dubbo-扩展的应用">Dubbo 扩展的应用</h2> |
| <p>Dubbo 的扩展能力非常灵活，在自身功能的实现上无处不在。</p> |
| <p><img src="https://dubbo.apache.org/imgs/v3/concepts/extension-use.png" alt="//imgs/v3/concepts/extension-use.png"></p> |
| <p>Dubbo 扩展能力使得 Dubbo 项目很方便的切分成一个一个的子模块，实现热插拔特性。用户完全可以基于自身需求，替换 Dubbo 原生实现，来满足自身业务需求。</p> |
| <h2 id="dubbo-扩展的使用场景">Dubbo 扩展的使用场景</h2> |
| <ul> |
| <li>如果你需要自定义负载均衡策略，你可以使用 Dubbo 扩展能力。</li> |
| <li>如果你需要实现自定义的注册中心，你可以使用 Dubbo 扩展能力。</li> |
| <li>如果你需要实现自定义的过滤器，你可以使用 Dubbo 扩展能力。</li> |
| </ul> |
| <p>Dubbo 扩展平等的对待内部实现和第三方实现。更多使用场景，参见 <a href="../description/">SPI 扩展实现</a></p></description></item><item><title>Overview: Dubbo SPI 扩展实现说明</title><link>https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/</guid><description/></item></channel></rss> |
