You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by gi...@apache.org on 2019/10/10 05:16:35 UTC
[dubbo-website] branch asf-site updated: Automated deployment: Thu
Oct 10 05:16:29 UTC 2019 eb28079cec0c70a56c1cc962a0152f43d096361f
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 0aa189d Automated deployment: Thu Oct 10 05:16:29 UTC 2019 eb28079cec0c70a56c1cc962a0152f43d096361f
0aa189d is described below
commit 0aa189d4ed1f1ad3193dcf2f3955757d57b934e9
Author: htynkn <ht...@users.noreply.github.com>
AuthorDate: Thu Oct 10 05:16:30 2019 +0000
Automated deployment: Thu Oct 10 05:16:29 UTC 2019 eb28079cec0c70a56c1cc962a0152f43d096361f
---
build/blog.js | 2 +-
{zh-cn => en-us}/blog/first-dubbo-filter.html | 66 +++++++++++++++++----------
en-us/blog/first-dubbo-filter.json | 6 +++
en-us/blog/index.html | 2 +-
md_json/blog.json | 5 ++
zh-cn/blog/first-dubbo-filter.html | 2 +-
zh-cn/blog/first-dubbo-filter.json | 2 +-
zh-cn/blog/index.html | 2 +-
8 files changed, 57 insertions(+), 30 deletions(-)
diff --git a/build/blog.js b/build/blog.js
index a1e740a..a442592 100644
--- a/build/blog.js
+++ b/build/blog.js
@@ -1,4 +1,4 @@
-!function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}var n={};t.m=e,t.c=n,t.i=function(e){return e},t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{configurable:!1,enumerable:!0,get:r})},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},t.p="/build/",t(t.s=315 [...]
+!function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}var n={};t.m=e,t.c=n,t.i=function(e){return e},t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{configurable:!1,enumerable:!0,get:r})},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},t.p="/build/",t(t.s=315 [...]
Copyright (c) 2017 Jed Watson.
Licensed under the MIT License (MIT), see
http://jedwatson.github.io/classnames
diff --git a/zh-cn/blog/first-dubbo-filter.html b/en-us/blog/first-dubbo-filter.html
similarity index 68%
copy from zh-cn/blog/first-dubbo-filter.html
copy to en-us/blog/first-dubbo-filter.html
index 708e5ba..13f56fc 100644
--- a/zh-cn/blog/first-dubbo-filter.html
+++ b/en-us/blog/first-dubbo-filter.html
@@ -12,11 +12,14 @@
<link rel="stylesheet" href="/build/blogDetail.css" />
</head>
<body>
- <div id="root"><div class="blog-detail-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/zh-cn/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">En</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a h [...]
-<h3>概述</h3>
-<p>在Dubbo的整体设计中，Filter是一个很重要的概念，包括Dubbo本身的大多数功能，都是基于此扩展点实现的，在每次的调用过程中，Filter的拦截都会被执行。</p>
-<h4>Dubbo Filter的加载机制</h4>
-<p>Dubbo中已经实现的Filter大概有二十几个，它们的入口都是ProtocolFilterWrapper，ProtocolFilterWrapper对Protocol做了Wrapper，会在加载扩展的时候被加载进来，下面我们来看下这个Filter链是如何构造的。</p>
+ <div id="root"><div class="blog-detail-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/en-us/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">中</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a hr [...]
+<h3>Overview</h3>
+<p>In overall design of Dubbo, Filter is a very important concept, most of Dubbo's functions are based on this
+extension point, and the Filter interception will be executed during each call.</p>
+<h4>Extension Mechanism of Dubbo Filter</h4>
+<p>There are already about 20 Filters implemented in Dubbo. Their entry is ProtocolFilterWrapper, ProtocolFilterWrapper
+makes a Wrapper on Protocol and will be loaded when the extension is loaded. Then, let's see how
+the Filter chain is constructed.</p>
<pre><code class="language-java"><span class="hljs-comment">//ProtocolFilterWrapper.java</span>
<span class="hljs-keyword">public</span> <T> <span class="hljs-function">Invoker<T> <span class="hljs-title">refer</span><span class="hljs-params">(Class<T> type, URL url)</span> <span class="hljs-keyword">throws</span> RpcException </span>{
<span class="hljs-keyword">if</span> (Constants.REGISTRY_PROTOCOL.equals(url.getProtocol())) {
@@ -65,8 +68,11 @@
}
</code></pre>
-<h4>Dubbo Filter的激活机制</h4>
-<p>通过上述代码我们可以看到，在<code>buildInvokerChain</code>中,先获取所有已经激活的调用链，这里的调用链是已经排好序的。再通过Invoker来构造出一个Filter的调用链，最后构建出的调用链大致可以表示为：Filter1->Filter2->Filter3->......->Invoker,下面我们来看一下，第一步中获取已经激活的调用链的详细流程：</p>
+<h4>Activation Mechanism of Dubbo Filter</h4>
+<p>Through the above code we can see that, in the method buildInvokerChain, first get all
+activated chains, the chain here is already sorted. Then construct a call chain of Filter
+through the Invoker, finally the constructed call chain can be roughly expressed as: Filter1->Filter2->Filter3->......->Invoker,
+now let's see the detailed flow of the activated chain in the above step.</p>
<pre><code class="language-java"> <span class="hljs-function"><span class="hljs-keyword">public</span> List<T> <span class="hljs-title">getActivateExtension</span><span class="hljs-params">(URL url, String key, String group)</span> </span>{
String value = url.getParameter(key);
<span class="hljs-keyword">return</span> getActivateExtension(url, value == <span class="hljs-keyword">null</span> || value.length() == <span class="hljs-number">0</span> ? <span class="hljs-keyword">null</span> : Constants.COMMA_SPLIT_PATTERN.split(value), group);
@@ -114,9 +120,13 @@
<span class="hljs-keyword">return</span> exts;
}
</code></pre>
-<p>通过以上代码可以看到，用户自己配置的Filter中，有些是默认激活，有些是需要通过配置文件来激活。而所有Filter的加载顺序，也是先处理Dubbo的默认Filter，再来处理用户自己定义并且配置的Filter。通过"-"配置，可以替换掉Dubbo的原生Filter，通过这样的设计，可以灵活地替换或者修改Filter的加载顺序。</p>
-<h4>Dubbo原生的Filter</h4>
-<p>Dubbo原生的Filter很多，RpcContext，accesslog等功能都可以通过Dubbo来实现，下面我们来介绍一下Consumer端用于上下文传递的ConsumerContextFilter：</p>
+<p>Through the above code we can see that, some of the Filters configured by the user are activated by default,
+and some need to be activated by the configuration file. The loading order of all Filters is to process Dubbo's
+default Filter first, and then to process the Filter defined by the user. With the "-" configuration, Dubbo's defualt Filter
+can be replaced, with this configuration, the user can flexibly replace or modify the Filter's load order.</p>
+<h4>Built-in Filter of Dubbo</h4>
+<p>Dubbo has lots of built-in Filter. RpcContext, accesslog and other functions can be implemented by Dubbo.
+Now let's see the ConsumerContextFilter which used by the Consumer side for context delivery:</p>
<pre><code class="language-java"><span class="hljs-function"><span class="hljs-keyword">public</span> Result <span class="hljs-title">invoke</span><span class="hljs-params">(Invoker<?> invoker, Invocation invocation)</span> <span class="hljs-keyword">throws</span> RpcException </span>{
RpcContext.getContext()
.setInvoker(invoker)
@@ -134,20 +144,25 @@
}
}
</code></pre>
-<p>此Filter记录了调用过程中的状态信息，并且通过invocation对象将客户端设置的attachments参数传递到服务端。并且在调用完成后清除这些参数，这就是为什么请求状态信息可以按次记录并且进行传递。</p>
-<h4>实现一个Dubbo Filter</h4>
-<p>得益于Dubbo灵活的设计和良好的可扩展性，我们可以通过实现自己的Dubbo Filter来完成调用链路中的逻辑嵌入，比如，耗时统计，monitor信息统计等，下面我们来实现一个简单的Filter:</p>
-<p>Maven 项目结构：</p>
+<p>This Filter records the state information during call, and passes the attachments parameter set
+by the client to the server through the invocation object, and these parameters will be cleared
+after the call is completed, which is why the request status information can be recorded by times
+and delivered.</p>
+<h4>Implement A Dubbo Filter</h4>
+<p>Because of Dubbo's flexible design and good scalability, we can implement business logic
+in the call chain by implementing our own Dubbo Filter, such as time-consuming statistics, monitor information statistics, etc.
+Now, let's implement a simple Filter:</p>
+<p>Maven project structure:</p>
<pre><code>src
|-main
|-java
|-com
|-xxx
- |-XxxFilter.java (实现Filter接口)
+ |-XxxFilter.java (impelement Filter interface)
|-resources
|-META-INF
|-dubbo
- |-com.alibaba.dubbo.rpc.Filter (纯文本文件，内容为：xxx=com.xxx.XxxFilter)
+ |-com.alibaba.dubbo.rpc.Filter (Plain text file with content：xxx=com.xxx.XxxFilter)
</code></pre>
<p>XxxFilter.java：</p>
<pre><code class="language-java"><span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">XxxFilter</span> <span class="hljs-keyword">implements</span> <span class="hljs-title">Filter</span> </span>{
@@ -162,25 +177,26 @@
<p>META-INF/dubbo/com.alibaba.dubbo.rpc.Filter：</p>
<pre><code>xxx=com.xxx.XxxFilter
</code></pre>
-<p>在 xml 中配置:</p>
-<pre><code class="language-xml"><span class="hljs-comment"><!-- 消费方调用过程拦截 --></span>
+<p>configure in xml as:</p>
+<pre><code class="language-xml"><span class="hljs-comment"><!-- Consumer call process interception --></span>
<span class="hljs-tag"><<span class="hljs-name">dubbo:reference</span> <span class="hljs-attr">filter</span>=<span class="hljs-string">"xxx"</span> /></span>
-<span class="hljs-comment"><!-- 消费方调用过程缺省拦截器，将拦截所有reference --></span>
+<span class="hljs-comment"><!-- Consumer call process default interception，intercept all reference --></span>
<span class="hljs-tag"><<span class="hljs-name">dubbo:consumer</span> <span class="hljs-attr">filter</span>=<span class="hljs-string">"xxx"</span>/></span>
-<span class="hljs-comment"><!-- 提供方调用过程拦截 --></span>
+<span class="hljs-comment"><!-- Provider call process interception --></span>
<span class="hljs-tag"><<span class="hljs-name">dubbo:service</span> <span class="hljs-attr">filter</span>=<span class="hljs-string">"xxx"</span> /></span>
-<span class="hljs-comment"><!-- 提供方调用过程缺省拦截器，将拦截所有service --></span>
+<span class="hljs-comment"><!-- Provider call process default interception，intercept all service --></span>
<span class="hljs-tag"><<span class="hljs-name">dubbo:provider</span> <span class="hljs-attr">filter</span>=<span class="hljs-string">"xxx"</span>/></span>
</code></pre>
-<p>或者使用注解：</p>
+<p>or use annotation as:</p>
<pre><code class="language-java"><span class="hljs-meta">@Activate</span>(group = <span class="hljs-string">"consumer"</span>)
<span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">XxxFilter</span> <span class="hljs-keyword">implements</span> <span class="hljs-title">Filter</span> </span>{
<span class="hljs-comment">// ...</span>
}
</code></pre>
-<p>使用 xml 的配置方式会更加灵活，粒度更细。</p>
-<p>在before和after中，可以实现自己的业务逻辑来赋予改filter一定的功能。编写和配置完成后，该filter就会被Dubbo框架激活并且在调用链中执行。</p>
-</section><footer class="footer-container"><div class="footer-body"><img src="/img/dubbo_gray.png"/><img class="apache" src="/img/apache_logo.png"/><div class="cols-container"><div class="col col-12"><h3></h3><p></p></div><div class="col col-4"><dl><dt>ASF</dt><dd><a href="http://www.apache.org" target="_self">基金会</a></dd><dd><a href="http://www.apache.org/licenses/" target="_self">证书</a></dd><dd><a href="http://www.apache.org/events/current-event" target="_self">事件</a></dd><dd><a href=" [...]
+<p>Using xml configuration is more flexible and granular.</p>
+<p>In before and after, you can implement your own business logic to give the filter a certain function.
+Once written and configured, the filter is activated by the Dubbo and executed in the call chain.</p>
+</section><footer class="footer-container"><div class="footer-body"><img src="/img/dubbo_gray.png"/><img class="apache" src="/img/apache_logo.png"/><div class="cols-container"><div class="col col-12"><h3></h3><p></p></div><div class="col col-4"><dl><dt>ASF</dt><dd><a href="http://www.apache.org" target="_self">Foundation</a></dd><dd><a href="http://www.apache.org/licenses/" target="_self">License</a></dd><dd><a href="http://www.apache.org/events/current-event" target="_self">Events</a></ [...]
<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
<script>
diff --git a/en-us/blog/first-dubbo-filter.json b/en-us/blog/first-dubbo-filter.json
new file mode 100644
index 0000000..ed47b7e
--- /dev/null
+++ b/en-us/blog/first-dubbo-filter.json
@@ -0,0 +1,6 @@
+{
+ "filename": "first-dubbo-filter.md",
+ "__html": "<h1>First Dubbo Filter</h1>\n<h3>Overview</h3>\n<p>In overall design of Dubbo, Filter is a very important concept, most of Dubbo's functions are based on this\nextension point, and the Filter interception will be executed during each call.</p>\n<h4>Extension Mechanism of Dubbo Filter</h4>\n<p>There are already about 20 Filters implemented in Dubbo. Their entry is ProtocolFilterWrapper, ProtocolFilterWrapper\nmakes a Wrapper on Protocol and will be loaded when the extension i [...]
+ "link": "/en-us/blog/first-dubbo-filter.html",
+ "meta": {}
+}
\ No newline at end of file
diff --git a/en-us/blog/index.html b/en-us/blog/index.html
index cc9451d..dbe15fc 100644
--- a/en-us/blog/index.html
+++ b/en-us/blog/index.html
@@ -12,7 +12,7 @@
<link rel="stylesheet" href="/build/blog.css" />
</head>
<body>
- <div id="root"><div class="blog-list-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/en-us/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">中</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a href [...]
+ <div id="root"><div class="blog-list-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/en-us/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">中</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a href [...]
<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
<script>
diff --git a/md_json/blog.json b/md_json/blog.json
index 8e3ddf1..a9afb5c 100644
--- a/md_json/blog.json
+++ b/md_json/blog.json
@@ -181,6 +181,11 @@
}
},
{
+ "filename": "first-dubbo-filter.md",
+ "link": "/en-us/blog/first-dubbo-filter.html",
+ "meta": {}
+ },
+ {
"filename": "gsoc-2018.md",
"link": "/en-us/blog/gsoc-2018.html",
"meta": {
diff --git a/zh-cn/blog/first-dubbo-filter.html b/zh-cn/blog/first-dubbo-filter.html
index 708e5ba..617acb1 100644
--- a/zh-cn/blog/first-dubbo-filter.html
+++ b/zh-cn/blog/first-dubbo-filter.html
@@ -179,7 +179,7 @@
}
</code></pre>
<p>使用 xml 的配置方式会更加灵活，粒度更细。</p>
-<p>在before和after中，可以实现自己的业务逻辑来赋予改filter一定的功能。编写和配置完成后，该filter就会被Dubbo框架激活并且在调用链中执行。</p>
+<p>在before和after中，可以实现自己的业务逻辑来赋予该filter一定的功能。编写和配置完成后，该filter就会被Dubbo框架激活并且在调用链中执行。</p>
</section><footer class="footer-container"><div class="footer-body"><img src="/img/dubbo_gray.png"/><img class="apache" src="/img/apache_logo.png"/><div class="cols-container"><div class="col col-12"><h3></h3><p></p></div><div class="col col-4"><dl><dt>ASF</dt><dd><a href="http://www.apache.org" target="_self">基金会</a></dd><dd><a href="http://www.apache.org/licenses/" target="_self">证书</a></dd><dd><a href="http://www.apache.org/events/current-event" target="_self">事件</a></dd><dd><a href=" [...]
<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
diff --git a/zh-cn/blog/first-dubbo-filter.json b/zh-cn/blog/first-dubbo-filter.json
index 0d39e54..10df83b 100644
--- a/zh-cn/blog/first-dubbo-filter.json
+++ b/zh-cn/blog/first-dubbo-filter.json
@@ -1,6 +1,6 @@
{
"filename": "first-dubbo-filter.md",
- "__html": "<h1>第一个Dubbo Filter</h1>\n<h3>概述</h3>\n<p>在Dubbo的整体设计中，Filter是一个很重要的概念，包括Dubbo本身的大多数功能，都是基于此扩展点实现的，在每次的调用过程中，Filter的拦截都会被执行。</p>\n<h4>Dubbo Filter的加载机制</h4>\n<p>Dubbo中已经实现的Filter大概有二十几个，它们的入口都是ProtocolFilterWrapper，ProtocolFilterWrapper对Protocol做了Wrapper，会在加载扩展的时候被加载进来，下面我们来看下这个Filter链是如何构造的。</p>\n<pre><code class=\"language-java\"><span class=\"hljs-comment\">//ProtocolFilterWrapper.java</span>\n<span class=\"hljs-keyword\">public</span> <T> <span class=\"hljs-functio [...]
+ "__html": "<h1>第一个Dubbo Filter</h1>\n<h3>概述</h3>\n<p>在Dubbo的整体设计中，Filter是一个很重要的概念，包括Dubbo本身的大多数功能，都是基于此扩展点实现的，在每次的调用过程中，Filter的拦截都会被执行。</p>\n<h4>Dubbo Filter的加载机制</h4>\n<p>Dubbo中已经实现的Filter大概有二十几个，它们的入口都是ProtocolFilterWrapper，ProtocolFilterWrapper对Protocol做了Wrapper，会在加载扩展的时候被加载进来，下面我们来看下这个Filter链是如何构造的。</p>\n<pre><code class=\"language-java\"><span class=\"hljs-comment\">//ProtocolFilterWrapper.java</span>\n<span class=\"hljs-keyword\">public</span> <T> <span class=\"hljs-functio [...]
"link": "/zh-cn/blog/first-dubbo-filter.html",
"meta": {}
}
\ No newline at end of file
diff --git a/zh-cn/blog/index.html b/zh-cn/blog/index.html
index 71056b0..cf9426b 100644
--- a/zh-cn/blog/index.html
+++ b/zh-cn/blog/index.html
@@ -12,7 +12,7 @@
<link rel="stylesheet" href="/build/blog.css" />
</head>
<body>
- <div id="root"><div class="blog-list-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/zh-cn/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">En</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a hre [...]
+ <div id="root"><div class="blog-list-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/zh-cn/index.html"><img class="logo" src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">En</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a hre [...]
<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
<script>