[servicecomb-docs] branch master updated: [SCB-2011] add documents about javax.el change

[li...@apache.org]

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 4e3258b  [SCB-2011] add documents about javax.el change
4e3258b is described below

commit 4e3258b2d357e8432ea4b001134b63709753b583
Author: liubao <bi...@qq.com>
AuthorDate: Wed Jun 17 17:35:54 2020 +0800

    [SCB-2011] add documents about javax.el change
---
 .../docs/featured-topics/upgrading/2_0_1T2_1_0.md  | 28 +++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_0_1T2_1_0.md b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_0_1T2_1_0.md
index 0074411..036dc9b 100644
--- a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_0_1T2_1_0.md
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_0_1T2_1_0.md
@@ -56,4 +56,30 @@ servicecomb.service.registry.enabled: true
 如果直接使用了 `DiscoveryTreee` 接口，2.1. 将服务发现的接口移动到了 `org.apache.servicecomb.registry`，
 当出现编译错误的时候，重新 import 对应的新 package 类即可。 
 
-如果直接使用了 `ServiceRegistry` 接口， 2.1 将对应接口移动到了 `RegistrationManager`。
\ No newline at end of file
+如果直接使用了 `ServiceRegistry` 接口， 2.1 将对应接口移动到了 `RegistrationManager`。
+
+## 参数校验的变化
+
+参数校验失败，早期版本采用 `ResourceBundleMessageInterpolator` 来生成错误消息。 由于这个类依赖于
+`Expression Language` 库，而这个库 JAVA 慢慢的不再提供支持，从 2.1.0 版本开始，切换为 `ParameterMessageInterpolator`
+来生成错误消息。 然后系统删除来对于 `jakarta.el` 的依赖。 
+
+开发者仍然可以继续使用`ResourceBundleMessageInterpolator` 来生成错误消息。需要额外的做下面的配置：
+
+* 项目中引入依赖
+
+```xml
+    <dependency>
+      <groupId>org.glassfish</groupId>
+      <artifactId>jakarta.el</artifactId>
+    </dependency>
+```
+
+* 增加配置项
+
+```yaml
+servicecomb:
+  filters:
+    validation:
+      useResourceBundleMessageInterpolator: true
+```