This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site-v2
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/asf-site-v2 by this push:
new 323c7ddf73 deploy: 753bfbeafb85ed47e54f9321fe88b6002288bb3b
323c7ddf73 is described below
commit 323c7ddf73866dc627163408d66ebc7d68bd2dd2
Author: chickenlj <[email protected]>
AuthorDate: Wed Jul 5 05:45:24 2023 +0000
deploy: 753bfbeafb85ed47e54f9321fe88b6002288bb3b
---
sitemap.xml | 2 +-
zh-cn/overview/reference/protocols/index.xml | 8 +++++++-
zh-cn/overview/reference/protocols/triple-spec/index.html | 6 +++---
zh-cn/sitemap.xml | 2 +-
4 files changed, 12 insertions(+), 6 deletions(-)
diff --git a/sitemap.xml b/sitemap.xml
index 27e6c780ea..81ace6e996 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://dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-07-05T13:26:44+08:00</lastmod></sitemap><sitemap><loc>https://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://dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-07-05T13:39:45+08:00</lastmod></sitemap><sitemap><loc>https://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 c7d6a0cd7d..604ad1565a 100644
--- a/zh-cn/overview/reference/protocols/index.xml
+++ b/zh-cn/overview/reference/protocols/index.xml
@@ -113,7 +113,13 @@ Content-Encoding Accept-Encoding Accept
Content-Length</li>
<p><strong>Request-Headers</strong> 以标准的 HTTP header 的形式发送，如果收到的
headers 数量过多，server 可返回相应错误信息。</p>
<p><strong>TRI-Protocol-Version</strong> 头用来区分具有相同 Content-Type 的
triple 协议请求和其他协议请求，因为 application/json 格式的 Content-Type 非常普遍。所有的 Dubbo
原生客户端实现都应该在请求中携带 TRI-Protocol-Version，Dubbo 服务端或代理可以选择拒绝没有 TRI-Protocol-Version
的请求并返回 Http-Status 400 错误。</p>
<p>如果 Server 不支持 <strong>Message-Codec</strong> 指定的编码格式，则必须返回标准 HTTP
415 编码表明 Unsupported Media Type 异常。</p>
-<p><strong>Bare-Message</strong> 即请求 payload 采用有序的数组编码形式，将方法的参数按顺序进行
Array 封装后进行 json 序列化，方法参数的位置与数组下标保持一致，当 Triple server
接收到请求体时，根据每个参数的类型进行反序列化成对应的参数数组。如果 Content-Encoding 指定了相应值，则 payload
将被压缩。Bare-Message 将作为 HTTP Body 在链路上传输。</p>
+<p><strong>Bare-Message</strong> 即请求 payload 的编码格式取决于 Message-Codec
设置：</p>
+<ul>
+<li>Message-Codec: json 的场景下，payload 采用有序的数组编码形式，即将 rpc 方法的参数按顺序组装进 Array
后进行 json 序列化，方法参数的位置与数组下标保持一致，当 Triple server
接收到请求体时，根据每个参数的类型进行反序列化成对应的参数数组。对于使用 Protocol Buffer 的情形，payload 则是只有一个 json
对象的数组。</li>
+<li>Message-Codec: proto 的场景下，Protobuf 生成的 Request 类包含了编码格式，因此将直接使用 Request
对象中的内置编码方式。</li>
+<li>Message-Codec 支持更多自定义扩展值，请确保框架实现遵循相应的编码与解码约定。</li>
+</ul>
+<p>如果 Content-Encoding 指定了相应值，则 payload
是被压缩过的，应该首先进行解压缩后再解析编码数据，Bare-Message 将作为 HTTP Body 在链路上传输。</p>
<h5 id="request-报文示例">Request 报文示例</h5>
<ul>
<li>请求行
diff --git a/zh-cn/overview/reference/protocols/triple-spec/index.html
b/zh-cn/overview/reference/protocols/triple-spec/index.html
index 2002f3988c..a7603956af 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://dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/><meta
charset=utf-8><meta name=viewport
content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta
name=generator content="Hugo 0.115.1"><link rel="shortcut icon" type=image/png
href=/imgs/favicon.png><link rel=apple-touch-icon
href=/favicons/apple-touch-icon-180x180.png sizes=180x180><link r [...]
+<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=canonical
href=https://dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/><meta
charset=utf-8><meta name=viewport
content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta
name=generator content="Hugo 0.115.1"><link rel="shortcut icon" type=image/png
href=/imgs/favicon.png><link rel=apple-touch-icon
href=/favicons/apple-touch-icon-180x180.png sizes=180x180><link r [...]
<script>var
doNotTrack=!1;if(!doNotTrack){window.dataLayer=window.dataLayer||[];function
gtag(){dataLayer.push(arguments)}gtag("js",new
Date),gtag("config","G-1TFHM5YBH0",{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://dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/";><meta
property="og:title" content="Triple 协议设计理念与规范"><meta name=twitte [...]
<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="
[...]
@@ -718,7 +718,7 @@
</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 工具更容易的访问后端服务，即使用标准 [...]
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
@@ -751,7 +751,7 @@ Content-Encoding Accept-Encoding Accept
Content-Length</li><li>Scheme → &ldquo
</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
[...]
+<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 d5263bcd09..51a4428a32 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://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://dubbo.apache.org/zh-cn/overview/mannual/jav
[...]
\ 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://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://dubbo.apache.org/zh-cn/overview/mannual/jav
[...]
\ No newline at end of file
