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 2023/07/13 12:42:48 UTC
[dubbo-website] branch cn-site updated: deploy: c5b7d9fb46c03bc518a5afde395316a35aa015a9
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch cn-site
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/cn-site by this push:
new a9309775d1 deploy: c5b7d9fb46c03bc518a5afde395316a35aa015a9
a9309775d1 is described below
commit a9309775d114d077ceffedf0f234f3e8b9c86058
Author: AlbumenJ <Al...@users.noreply.github.com>
AuthorDate: Thu Jul 13 12:42:43 2023 +0000
deploy: c5b7d9fb46c03bc518a5afde395316a35aa015a9
---
sitemap.xml | 2 +-
zh-cn/overview/reference/protocols/index.xml | 8 ++++----
zh-cn/overview/reference/protocols/triple-spec/index.html | 10 +++++-----
zh-cn/sitemap.xml | 2 +-
4 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/sitemap.xml b/sitemap.xml
index 375b3337ec..dd474989c4 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-07-13T20:12:32+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2023-05-10T11:59:30+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-07-13T20:36:41+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2023-05-10T11:59:30+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
diff --git a/zh-cn/overview/reference/protocols/index.xml b/zh-cn/overview/reference/protocols/index.xml
index 6b497af8f4..298c3a7f17 100644
--- a/zh-cn/overview/reference/protocols/index.xml
+++ b/zh-cn/overview/reference/protocols/index.xml
@@ -67,10 +67,10 @@
<p>Triple 协议支持同时运行在 HTTP/1 和 HTTP/2 协议之上，其包含以下两部分内容：</p>
<ol>
<li>一套自定义的精简 HTTP RPC 子协议，支持 HTTP/1 和 HTTP/2 作为传输层实现，仅支持 Request-Response 类型的 Unary RPC。</li>
-<li>一套基于 gRPC 协议的扩展子协议（仍保持和 gRPC 的 100% 兼容），仅支持 HTTP/2 实现，支持 Streaming RPC。</li>
+<li>一套基于 gRPC 协议的扩展子协议（仍保持和 gRPC 的 100% 兼容），仅支持 HTTP/2 实现，支持 Unary RPC 和 Streaming RPC。</li>
</ol>
<h3 id="31-triple-之-http-rpc-协议">3.1 Triple 之 HTTP RPC 协议</h3>
-<p>大部分的 RPC 调用都是 unary (request-response) 模式的。Triple HTTP RPC 协议 unary 模式能很好的满足后端服务间的数据传输需求，同时可以让浏览器、cURL 以及其他一些 HTTP 工具更容易的访问后端服务，即使用标准的 HTTP 协议发起调用即可。</p>
+<p>大部分的 RPC 调用都是 unary (request-response) 模式的，Triple HTTP RPC 协议 unary 模式能很好的满足后端服务间的数据传输需求。同时解决了gRPC协议的痛点，让浏览器、cURL 以及其他一些 HTTP 工具更容易的访问后端服务，即不需要借助代理和gRPC-web，使用标准的 HTTP 协议直接发起调用。</p>
<p>Triple HTTP RPC 同时支持 HTTP/1、HTTP/2 作为底层传输层协议，在实现上对应支持的 content-type 类型为 application/json、application/proto</p>
<h4 id="311-请求-request">3.1.1 请求 Request</h4>
<ul>
@@ -92,7 +92,7 @@ Content-Encoding Accept-Encoding Accept Content-Length</li>
<li>TRI-Protocol-Version → &ldquo;tri-protocol-version&rdquo; &ldquo;1&rdquo;</li>
<li>TRI-Service-Timeout → “tri-service-timeout: ” Timeout-Milliseconds</li>
<li>Timeout-Milliseconds → positive integer</li>
-<li>TRI-Service-Version → “tri-unary-service-version: ” Version</li>
+<li>TRI-Service-Version → “tri-service-version: ” Version</li>
<li>Version → dubbo service version</li>
<li>TRI-Service-Group → &ldquo;tri-service-group: &quot; Group</li>
<li>Group → dubbo service group</li>
@@ -265,7 +265,7 @@ Content-Encoding Accept-Encoding Accept Content-Length</li>
</table>
</blockquote>
<h3 id="32-triple-之扩展版-grpc-协议">3.2 Triple 之扩展版 gRPC 协议</h3>
-<p>Triple 协议的 Streaming 请求处理完全遵循 gRPC 协议规范，且仅支持 HTTP/2 作为传输层协议。</p>
+<p>Triple 协议的 Streaming 请求处理完全遵循 gRPC 协议规范，且仅支持 HTTP/2 作为传输层协议。并且后端服务间的 Unary 请求默认采用扩展版 gPRC 协议。</p>
<p>Triple 支持的 content-type 类型为标准的 gRPC 类型，包括 application/grpc、application/grpc+proto、application/grpc+json，除此之外，Triple 在实现上还扩展了 application/triple+wrapper 编码格式。</p>
<h4 id="321-outline">3.2.1 Outline</h4>
<p>The following is the general sequence of message atoms in a GRPC request &amp; response message stream</p>
diff --git a/zh-cn/overview/reference/protocols/triple-spec/index.html b/zh-cn/overview/reference/protocols/triple-spec/index.html
index dec4719a96..08e21dd656 100644
--- a/zh-cn/overview/reference/protocols/triple-spec/index.html
+++ b/zh-cn/overview/reference/protocols/triple-spec/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS content="INDEX, FOLLOW"><link rel=canonical href=https://cn.dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/><script>var _hmt=_hmt||[];(function(){var e,t=document.createElement("script");t.src="https://hm.baidu.com/hm.js?3b78f49ba47181e4d998a66b689446e9",e=document.getElementsByTagName("script")[0],e.parentNode.insertBefore(t,e)})()</script><meta charset=utf-8><meta name=viewport content="width=device-wi [...]
+<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS content="INDEX, FOLLOW"><link rel=canonical href=https://cn.dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/><script>var _hmt=_hmt||[];(function(){var e,t=document.createElement("script");t.src="https://hm.baidu.com/hm.js?3b78f49ba47181e4d998a66b689446e9",e=document.getElementsByTagName("script")[0],e.parentNode.insertBefore(t,e)})()</script><meta charset=utf-8><meta name=viewport content="width=device-wi [...]
<script>var doNotTrack=!1;if(!doNotTrack){window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag("js",new Date),gtag("config","G-NM6FFMT51J",{anonymize_ip:!1})}</script><link rel=preload href=/scss/main.min.fe7176cbe3102a33d3e8c0c9cec61eb52508abd24a2cc1ae23ccf535a481ffde.css as=style><link href=/scss/main.min.fe7176cbe3102a33d3e8c0c9cec61eb52508abd24a2cc1ae23ccf535a481ffde.css rel=stylesheet integrity><script src=/js/jquery-3.5.1.min.js integrity="sha256-9/a [...]
<link rel=stylesheet href=https://cdn.jsdelivr.net/npm/@docsearch/css@3><meta name=theme-color content="#326ce5"><link rel=stylesheet href=/css/feature-states.css><meta name=description content="Triple 协议规范"><meta property="og:description" content="Triple 协议规范"><meta name=twitter:description content="Triple 协议规范"><meta property="og:url" content="https://cn.dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/"><meta property="og:title" content="Triple 协议设计理念与规范"><meta name=twi [...]
<link href=/css/community.css rel=stylesheet><link href=/css/contactus.css rel=stylesheet><link href=/css/language.css rel=stylesheet><script src=/js/script.js></script></head><body class="td-page td-documentation"><header><nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar" data-auto-burger=primary><a class=navbar-brand href=/zh-cn/><span class=navbar-logo></span><span class="text-uppercase font-weight-bold">Apache Dubbo</span></a><div class=" [...]
@@ -716,9 +716,9 @@
</span></span><span style=display:flex><span>HEADERS (flags = END_STREAM, END_HEADERS)
</span></span><span style=display:flex><span>grpc-status = 0 # OK
</span></span><span style=display:flex><span>trace-proto-bin = jher831yy13JHy3hc
-</span></span></code></pre></div><h2 id=3-规范详情>3 规范详情</h2><p>Triple 协议支持同时运行在 HTTP/1 和 HTTP/2 协议之上，其包含以下两部分内容：</p><ol><li>一套自定义的精简 HTTP RPC 子协议，支持 HTTP/1 和 HTTP/2 作为传输层实现，仅支持 Request-Response 类型的 Unary RPC。</li><li>一套基于 gRPC 协议的扩展子协议（仍保持和 gRPC 的 100% 兼容），仅支持 HTTP/2 实现，支持 Streaming RPC。</li></ol><h3 id=31-triple-之-http-rpc-协议>3.1 Triple 之 HTTP RPC 协议</h3><p>大部分的 RPC 调用都是 unary (request-response) 模式的。Triple HTTP RPC 协议 unary 模式能很好的满足后端服务间的数据传输需求，同时可以让浏览器、cURL 以及其他一些 HTTP 工具更容易的访问后端服务，即使用标准 [...]
+</span></span></code></pre></div><h2 id=3-规范详情>3 规范详情</h2><p>Triple 协议支持同时运行在 HTTP/1 和 HTTP/2 协议之上，其包含以下两部分内容：</p><ol><li>一套自定义的精简 HTTP RPC 子协议，支持 HTTP/1 和 HTTP/2 作为传输层实现，仅支持 Request-Response 类型的 Unary RPC。</li><li>一套基于 gRPC 协议的扩展子协议（仍保持和 gRPC 的 100% 兼容），仅支持 HTTP/2 实现，支持 Unary RPC 和 Streaming RPC。</li></ol><h3 id=31-triple-之-http-rpc-协议>3.1 Triple 之 HTTP RPC 协议</h3><p>大部分的 RPC 调用都是 unary (request-response) 模式的，Triple HTTP RPC 协议 unary 模式能很好的满足后端服务间的数据传输需求。同时解决了gRPC协议的痛点，让浏览器、cURL 以及其他一些 [...]
Schema Http-Method Path Http-Host Content-Type TRI-Service-Timeout TRI-Service-Version TRI-Service-Group
-Content-Encoding Accept-Encoding Accept Content-Length</li><li>Scheme → “http” / “https”</li><li>Http-Method → POST</li><li>Path → /Service-Name/Method-Name; case-sensitive</li><li>Service-Name → service interface full classname</li><li>Method-Name → service interface declared method`s name</li><li>Http-Host → Target-IP:Target-Port</li><li>Target-IP → target server ip or domain</li><li>Target-Port → target server process port</li><li>Content-Type → “Content-Type: [...]
+Content-Encoding Accept-Encoding Accept Content-Length</li><li>Scheme → “http” / “https”</li><li>Http-Method → POST</li><li>Path → /Service-Name/Method-Name; case-sensitive</li><li>Service-Name → service interface full classname</li><li>Method-Name → service interface declared method`s name</li><li>Http-Host → Target-IP:Target-Port</li><li>Target-IP → target server ip or domain</li><li>Target-Port → target server process port</li><li>Content-Type → “Content-Type: [...]
</span></span><span style=display:flex><span>Host: 127.0.0.1:30551
</span></span><span style=display:flex><span>Content-Type: application/json
</span></span><span style=display:flex><span>Accept: application/json
@@ -750,8 +750,8 @@ Content-Encoding Accept-Encoding Accept Content-Length</li><li>Scheme → &ldquo
</span></span><span style=display:flex><span> 70 500 service error
</span></span><span style=display:flex><span> 80 500 internal server error
</span></span><span style=display:flex><span> 90 500 internal client error
-</span></span></code></pre></div><blockquote><p>Connect 的 HTTP to Error Code 参考</p><table><thead><tr><th>HTTP Status</th><th>Inferred Code</th></tr></thead><tbody><tr><td>400 Bad Request</td><td>invalid_argument</td></tr><tr><td>401 Unauthorized</td><td>unauthenticated</td></tr><tr><td>403 Forbidden</td><td>permission_denied</td></tr><tr><td>404 Not Found</td><td>unimplemented</td></tr><tr><td>408 Request Timeout</td><td>deadline_exceeded</td></tr><tr><td>409 Conflict</td><td>aborted</td [...]
-<button class="btn btn-primary mb-4 feedback--no">否</button></div><script>const yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled [...]
+</span></span></code></pre></div><blockquote><p>Connect 的 HTTP to Error Code 参考</p><table><thead><tr><th>HTTP Status</th><th>Inferred Code</th></tr></thead><tbody><tr><td>400 Bad Request</td><td>invalid_argument</td></tr><tr><td>401 Unauthorized</td><td>unauthenticated</td></tr><tr><td>403 Forbidden</td><td>permission_denied</td></tr><tr><td>404 Not Found</td><td>unimplemented</td></tr><tr><td>408 Request Timeout</td><td>deadline_exceeded</td></tr><tr><td>409 Conflict</td><td>aborted</td [...]
+<button class="btn btn-primary mb-4 feedback--no">否</button></div><script>const yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled [...]
<a href="https://github.com/apache/dubbo-website/new/master/content/zh-cn/overview/reference/protocols/triple-spec.md?filename=change-me.md&value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md%60+-+e.g.+%60getting-started.md%60%0A%2A+Edit+the+%22fron [...]
<a href="https://github.com/apache/dubbo-website/issues/new?title=Triple%20%e5%8d%8f%e8%ae%ae%e8%ae%be%e8%ae%a1%e7%90%86%e5%bf%b5%e4%b8%8e%e8%a7%84%e8%8c%83" target=_blank><i class="fab fa-github fa-fw"></i> 登记问题</a>
<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas fa-tasks fa-fw"></i> 提交项目问题</a></div><nav id=TableOfContents><ul><li><a href=#1-协议设计理念>1 协议设计理念</a></li><li><a href=#2-示例>2 示例</a><ul><li><a href=#21-unary-请求>2.1 Unary 请求</a></li><li><a href=#22-streaming-调用请求>2.2 Streaming 调用请求</a></li></ul></li><li><a href=#3-规范详情>3 规范详情</a><ul><li><a href=#31-triple-之-http-rpc-协议>3.1 Triple 之 HTTP RPC 协议</a></li><li><a href=#32-triple-之扩展版-grpc-协议>3.2 Triple 之扩展版 gRPC 协议</ [...]
diff --git a/zh-cn/sitemap.xml b/zh-cn/sitemap.xml
index 41a7b4a0b0..2a8a7a23ef 100644
--- a/zh-cn/sitemap.xml
+++ b/zh-cn/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-02-22T15:03:22+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://cn.dubbo.apache.org/zh-cn/overview/mannu [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-02-22T15:03:22+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://cn.dubbo.apache.org/zh-cn/overview/mannu [...]
\ No newline at end of file