This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch history/next-staging
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/history/next-staging by this
push:
new 4a0b4e4e67f deploy: d23ba8ec9c36a4b650205c93611bfa3c6b1295ee
4a0b4e4e67f is described below
commit 4a0b4e4e67fa053fb66711eba3f81f87007494ab
Author: AlbumenJ <[email protected]>
AuthorDate: Mon Aug 26 09:50:09 2024 +0000
deploy: d23ba8ec9c36a4b650205c93611bfa3c6b1295ee
---
sitemap.xml | 2 +-
.../3.2-to-3.3-compatibility-guide/index.html | 44 ++++++++++++++++++++--
zh-cn/sitemap.xml | 2 +-
3 files changed, 42 insertions(+), 6 deletions(-)
diff --git a/sitemap.xml b/sitemap.xml
index 07196f6d28a..037a1a3952d 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>2024-08-26T17:37:04+08:00</lastmod></sitemap><sitemap><loc>https://dubbo.apache.org/en/sitemap.xml</loc><lastmod>2024-08-26T09:57:38+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>2024-08-26T17:45:08+08:00</lastmod></sitemap><sitemap><loc>https://dubbo.apache.org/en/sitemap.xml</loc><lastmod>2024-08-26T09:57:38+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
diff --git
a/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/index.html
b/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/index.html
index e527ecd75bf..751afa596ac 100644
---
a/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/index.html
+++
b/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/index.html
@@ -1,5 +1,5 @@
<!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/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/><meta
charset=utf-8><meta name=viewport
content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta
name=generator content="Hugo 0.121.2"><link rel="shortcut icon" type=image/png
href=/imgs/favicon.png><link rel=apple-touch-ic [...]
-<meta property="og:description" content="Dubbo 3.3 升级与兼容性指南"><meta
property="og:type" content="article"><meta property="og:url"
content="https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/";><meta
property="article:section" content="overview"><meta
property="article:modified_time" content="2024-08-22T17:54:56+08:00"><meta
itemprop=name content="3.2 升级至 3.3"><meta itemprop=description content="Dubbo
3. [...]
+<meta property="og:description" content="Dubbo 3.3 升级与兼容性指南"><meta
property="og:type" content="article"><meta property="og:url"
content="https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide/";><meta
property="article:section" content="overview"><meta
property="article:modified_time" content="2024-08-26T17:45:08+08:00"><meta
itemprop=name content="3.2 升级至 3.3"><meta itemprop=description content="Dubbo
3. [...]
<a class=dropdown-item href=/en/download>Admin</a>
<a class=dropdown-item href=/option-3>System</a>
<a class=dropdown-item href=/option-3>Benchmark</a>
@@ -619,8 +619,44 @@
</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>dubbo-spring-boot-starter<span
style=color:#268bd2></artifactId></span>
</span></span><span style=display:flex><span> <span
style=color:#268bd2><version></span>3.3.0<span
style=color:#268bd2></version></span>
</span></span><span style=display:flex><span><span
style=color:#268bd2></dependency></span>
-</span></span></code></pre></div><h1 id=兼容性-checklist>兼容性 CheckList</h1><h3
id=1-默认序列化切换>1. 默认序列化切换</h3><p>Dubbo 3.3.0 版本开始默认序列化方式从 <code>fastjson2</code>
切换为 <code>hessian2</code>，对于升级到 3.3.0 的应用，Dubbo 会自动尝试采用 <code>hessian2</code>
进行序列化。</p><h4 id=q1为什么要切换默认序列化方式>Q1：为什么要切换默认序列化方式？</h4><p><code>hessian2</code>
为 Dubbo 3.1.x 及以下版本中默认的序列化，长期的生产验证了其稳定性和兼容性，在评估了向前兼容性和长期可维护性后，Dubbo 团队决定将
<code>hessian-lite</code> 升级到最新 <code>hessian4</code> 主干版本，以支持 JDK17 和
JDK21。</p><p>升级到 Dubbo 3.3.0 以后，依赖 [...]
-<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><h1 id=兼容性-checklist>兼容性 CheckList</h1><h3
id=1-默认序列化切换>1. 默认序列化切换</h3><p>Dubbo 3.3.0 版本开始默认序列化方式从 <code>fastjson2</code>
切换为 <code>hessian2</code>，对于升级到 3.3.0 的应用，Dubbo 会自动尝试采用 <code>hessian2</code>
进行序列化。</p><h4 id=q1为什么要切换默认序列化方式>Q1：为什么要切换默认序列化方式？</h4><p><code>hessian2</code>
为 Dubbo 3.1.x 及以下版本中默认的序列化，长期的生产验证了其稳定性和兼容性，在评估了向前兼容性和长期可维护性后，Dubbo 团队决定将
<code>hessian-lite</code> 升级到最新 <code>hessian4</code> 主干版本，以支持 JDK17 和
JDK21。</p><p>升级到 Dubbo 3.3.0 以后，依赖 [...]
+对于需要进行优雅上线的机器，配置 <code>-Ddubbo.application.manual-register=true</code> JVM
参数</p><p>完善启动脚本：
+对于需要进行优雅上线的机器，启动脚本中在启动结束后，主动调用 QoS 命令 <code>curl
http://127.0.0.1:22222/online</code>
进行注册</p><p>考虑因素：</p><ol><li>全局一套代码，无论是线上环境、测试环境均对需要优雅上线的服务进行配置
<code>delay=-1</code></li><li>仅对线上环境进行
<code>-Ddubbo.application.manual-register=true</code>
配置，测试环境不配置，保证测试环境的服务能够自动注册</li></ol><hr><h3 id=3-nacos-订阅名字>3. Nacos
订阅名字</h3><p>从 Dubbo 3.3.x 版本开始，将不再订阅 Dubbo 2.7.3 及以前版本的兼容服务名，如果仍需要订阅，请配置
<code>-Dnacos.subscribe.legacy-name=true</code>。</p><h3 id=q1-为什么要做这个调整-1>Q1:
为什么要做这个调整？</h3><p>在 Dubbo 2.7. [...]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>org.apache.dubbo.extensions<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>dubbo-rpc-rest<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><version></span>3.3.0<span
style=color:#268bd2></version></span>
+</span></span><span style=display:flex><span><span
style=color:#268bd2></dependency></span>
+</span></span></code></pre></div><hr><h3 id=7-jdk-序列化>7. JDK 序列化</h3><p>由于 JDK
原生序列化中，如果不手动添加配置，存在大量的反序列化漏洞，为了提升 Dubbo 的安全性，Dubbo 3.3.x 版本中默认不支持 JDK
序列化。</p><p>如果需要使用 JDK
序列化，可以添加以下依赖提供能力兼容，但请注意，<strong>这可能会引入安全风险</strong>。</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-xml data-lang=xml><span style=display:flex><span><span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>org.apache.dubbo.extensions<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>dubbo-serialization-jdk<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><version></span>3.3.0<span
style=color:#268bd2></version></span>
+</span></span><span style=display:flex><span><span
style=color:#268bd2></dependency></span>
+</span></span></code></pre></div><hr><h3 id=8-传递依赖变更>8. 传递依赖变更</h3><p>在 Dubbo
3.3.x 中，默认不再传递以下依赖，如有需要请按需引入：</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-xml data-lang=xml><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>org.springframework<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>spring-core<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>org.springframework<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>spring-beans<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>org.springframework<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>spring-context<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>com.alibaba.spring<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>spring-context-support<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span></code></pre></div><p>同时，新增传递以下依赖：</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-xml data-lang=xml><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>com.google.protobuf<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>protobuf-java<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><dependency></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><groupId></span>com.google.protobuf<span
style=color:#268bd2></groupId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2><artifactId></span>protobuf-java-util<span
style=color:#268bd2></artifactId></span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2></dependency></span>
+</span></span></code></pre></div><p>注：Dubbo 从 3.3.x 开始不再依赖
<code>com.alibaba.spring:spring-context-support</code>
实现自身能力，如果需要请自行引入。</p><div id=pre-footer><h2>反馈</h2><p
class=feedback--prompt>此页是否对您有帮助？</p><button class="btn btn-primary mb-4
feedback--yes">是</button>
+<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/mannual/java-sdk/reference-manual/upgrades-and-compatibility/version/3.2-to-3.3-compatibility-guide.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
[...]
<a
href="https://github.com/apache/dubbo-website/issues/new?title=3.2%20%e5%8d%87%e7%ba%a7%e8%87%b3%203.3";
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><ul><li><a
href=#1-默认序列化切换>1. 默认序列化切换</a></li><li><a href=#2-registerfalse>2.
Register=false</a></li><li><a href=#3-nacos-订阅名字>3. Nacos 订阅名字</a></li><li><a
href=#4-starters>4. Starters</a></li><li><a href=#5-移除-dubbo-native-plugin>5.
移除 dubbo-native-plugin</a></li><li><a href=#6-移除-rest-协议>6. 移除 Rest
协议</a></li><li><a href=#7-jdk-序列化>7. JDK 序 [...]
\ No newline at end of file
+<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><ul><li><a
href=#1-默认序列化切换>1. 默认序列化切换</a></li><li><a
href=#2-使用-registerfalse-不注册时将无法通过-qos-手动注册>2. 使用 <code>register=false</code>
不注册时将无法通过 QoS 手动注册</a></li><li><a href=#3-nacos-订阅名字>3. Nacos
订阅名字</a></li><li><a href=#q1-为什么要做这个调整-1>Q1: 为什么要做这个调整？</a></li><li><a
href=#4-starters>4. Starters</a></li><li><a href=#5-移除-dubbo-native-plugin>5.
移除 [...]
\ No newline at end of file
diff --git a/zh-cn/sitemap.xml b/zh-cn/sitemap.xml
index 9d99af74bb6..c8b18bdb913 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-11-28T15:14:12+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-11-28T15:14:12+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
