This is an automated email from the ASF dual-hosted git repository.
liubao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 04e788c prepare release 2.6.0 and add upgrade notice (#251)
04e788c is described below
commit 04e788c86b066fd64f8cfcbef8a2a10707342c9e
Author: liubao68 <[email protected]>
AuthorDate: Thu Nov 25 10:56:08 2021 +0800
prepare release 2.6.0 and add upgrade notice (#251)
---
.../zh_CN/docs/featured-topics/upgrading.md | 3 +-
.../docs/featured-topics/upgrading/2_1_5T2_6_0.md | 45 ++++++++++++++++++++++
.../zh_CN/docs/transports/rest-over-vertx.md | 2 +-
3 files changed, 48 insertions(+), 2 deletions(-)
diff --git a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
index 5e8e595..6598047 100644
--- a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
@@ -4,4 +4,5 @@
* [2.0.0 升级 2.0.1指导](upgrading/2_0_0T2_0_1.md)
* [2.0.1 升级 2.1.0指导](upgrading/2_0_1T2_1_0.md)
* [2.1.0 升级 2.1.1指导](upgrading/2_1_0T2_1_1.md)
-* [2.1.1 升级 2.1.5指导](upgrading/2_1_1T2_1_5.md)
\ No newline at end of file
+* [2.1.1 升级 2.1.5指导](upgrading/2_1_1T2_1_5.md)
+* [2.1.5 升级 2.6.0指导](upgrading/2_1_5T2_6_0.md)
\ No newline at end of file
diff --git
a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_1_5T2_6_0.md
b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_1_5T2_6_0.md
new file mode 100644
index 0000000..a4f6bd4
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_1_5T2_6_0.md
@@ -0,0 +1,45 @@
+# 2.1.5 升级 2.6.0 指导
+
+## 支持`@NotBlank`和`@NotEmpty`
+
+参考下面的例子。这个新的特性在一些特殊的情况下可能导致业务故障，比如业务错误的加上了这些标签，但是实际上不会做参数校验，现在变更为校验。
+
+```java
+public class Teacher {
+
+ @NotBlank
+ private String name;
+
+ private String age;
+
+ // getters, setters
+}
+```
+
+## `servicecomb.rest.client.connection.idleTimeoutInSeconds` 缺省值修改为 30s
+
+因为服务端HTTP连接的Idle Timeout时间设置通常是60s（包括Vert.x、Tomcat等），为了尽可能降低客户端使用已经关闭了连接
+的概率，调整了这个参数的默认值。如果业务系统中没有设置这个参数，并且有些场景将 `servicecomb.request.timeout` 设置
+为大于30s， 那么可能导致这些请求提前超时。
+
+更多详细信息可以[参考案例](https://github.com/apache/servicecomb-java-chassis/issues/2603)。
+
+## `netty`和`vert.x` 升级
+
+2.6.0目前使用了最新的 `netty` 和 `vert.x` 版本， 这两个软件最新版本做了较多的重构，需要保证版本匹配才能够正常工作。
+业务尽可能不要自行单独调整单个软件的版本，保持和java-chassis使用一致，否则容易导致一些兼容性问题。 未来的版本，两个软件
+的兼容情况应该会有所改善，建议业务升级后，及时调整这两个软件的废弃用法。
+
+这两个软件升级目前已知的可能影响业务功能的点包括：
+
+* `servicecomb.rest.server.maxFormAttributeSize` 的缺省值为 8192。
java-chassis的缺省值使用了 `vert.x`
+ 的缺省值。这个值在最近的几个版本中，发生过几次变更，从无限制变更为1024， 变更为2048，到现在的8192。 如果业务需要
+ 依赖比较大的值，建议在配置文件设置适合应用场景的限制，不跟随这个缺省值。
+
+## `Spring` 和 `Spring Boot` 升级
+
+2.6.0目前使用了最新的 `Spring` 和 `Spring Boot` 版本，这个版本存在少量的变更，可能在某些特殊场景下影响业务功能。已知的情况包括：
+
+* 对URL进行了更加严格的校验，以符合HTTP协议标准。早期一些不符合标准的URL可能会报告错误。
+* `StringUtils`的`isEmpty`方法废弃了，这个方法容易造成误用，建议切换使用其他接口或者使用Commons Lang组件的接口。
+
diff --git a/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
b/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
index a2630fb..ebd34ce 100644
--- a/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
+++ b/java-chassis-reference/zh_CN/docs/transports/rest-over-vertx.md
@@ -36,7 +36,7 @@ REST over Vertx通道在microservice.yaml文件中有以下配置项：
| servicecomb.rest.server.compression | false
| 服务端是否支持启用压缩 |
| servicecomb.rest.server.maxInitialLineLength | 4096
| 服务端接收请求的最大 initial line 长度，单位字节 |
| servicecomb.rest.server.maxHeaderSize | 32768
| 服务端接收请求的最大header长度，单位字节 |
-| servicecomb.rest.server.maxFormAttributeSize | 2048
| 服务端接收请求的最大 form 长度，单位为字节 |
+| servicecomb.rest.server.maxFormAttributeSize | 8192
| 服务端接收请求的最大 form 长度，单位为字节 |
| servicecomb.rest.server.compressionLevel | 6
| 服务端gzip/deflate压缩级别
| servicecomb.rest.server.maxChunkSize | 8192
| 最大http chunk大小，单位为字节 |
| servicecomb.rest.server.decoderInitialBufferSize | 128
| HttpObjectDecoder的最大初始缓冲区大小 |
