This is an automated email from the ASF dual-hosted git repository.
albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new f0485e1dd5 [fix] 参数校验 (#1160)
f0485e1dd5 is described below
commit f0485e1dd541d462831acd4dc647577a14f251e8
Author: JIAN ZHONG <[email protected]>
AuthorDate: Tue Jun 28 15:42:34 2022 +0800
[fix] 参数校验 (#1160)
---
.../rpc/parameter-validation.md | 41 +++++++++++++---------
1 file changed, 24 insertions(+), 17 deletions(-)
diff --git
a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/parameter-validation.md
b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/parameter-validation.md
index cafcdde477..20e19ea377 100644
---
a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/parameter-validation.md
+++
b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/parameter-validation.md
@@ -3,12 +3,12 @@ type: docs
title: "参数校验"
linkTitle: "参数校验"
weight: 2
-description: "在 Dubbo 中进行参数校验"
+description: "在 dubbo3 中进行参数校验"
---
-
+## 特性说明
参数验证功能是基于 [JSR303](https://jcp.org/en/jsr/detail?id=303) 实现的，用户只需标识 JSR303
标准的验证 annotation，并通过声明 filter 来实现验证。
-## Maven 依赖
+#### Maven 依赖
```xml
<dependency>
@@ -23,9 +23,16 @@ description: "在 Dubbo 中进行参数校验"
</dependency>
```
-## 示例
+#### 示例类型
+- 参数标注
+- 分组验证
+- 关联验证
+- 参数验证
+
+## 使用场景
+## 使用方式
-### 参数标注示例
+#### 参数标注示例
```java
import java.io.Serializable;
@@ -102,7 +109,7 @@ public class ValidationParameter implements Serializable {
}
```
-### 分组验证示例
+#### 分组验证示例
```java
public interface ValidationService { // 缺省可按服务接口区分验证场景，如：@NotNull(groups =
ValidationService.class)
@@ -112,7 +119,7 @@ public interface ValidationService { // 缺省可按服务接口区分验证场
}
```
-### 关联验证示例
+#### 关联验证示例
```java
import javax.validation.GroupSequence;
@@ -127,7 +134,7 @@ public interface ValidationService {
}
```
-### 参数验证示例
+#### 参数验证示例
```java
import javax.validation.constraints.Min;
@@ -138,16 +145,17 @@ public interface ValidationService {
void delete(@Min(1) int id); // 直接对基本类型参数验证
}
```
+#### 配置
+- 客户端
+- 服务器端
-## 配置
-
-### 在客户端验证参数
+#### 在客户端验证参数
```xml
<dubbo:reference id="validationService"
interface="org.apache.dubbo.examples.validation.api.ValidationService"
validation="true" />
```
-### 在服务器端验证参数
+#### 在服务器端验证参数
```xml
<dubbo:service
interface="org.apache.dubbo.examples.validation.api.ValidationService"
ref="validationService" validation="true" />
@@ -157,7 +165,7 @@ public interface ValidationService {
Dubbo 默认支持 hibernate-validator 版本 <=6.x，若使用 hibernate-validator 7.x 版本，请将
validation 参数声明为 jvalidatorNew
{{% /alert %}}
-## 验证异常信息
+#### 验证异常信息
```java
import javax.validation.ConstraintViolationException;
@@ -189,9 +197,8 @@ public class ValidationConsumer {
}
```
-{{% alert title="提示" color="primary" %}}
-自 `2.1.0` 版本开始支持, 如何使用可以参考 [dubbo
项目中的示例代码](https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-validation)
+#### 提示：
+自 `2.1.0` 版本开始支持, 如何使用 [dubbo
项目中的示例代码](https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-validation)
-验证方式可扩展，扩展方式参见开发者手册中的[验证扩展](../../../java-sdk/reference-manual/spi/description/validation)
-{{% /alert %}}
+验证方式可扩展，扩展方式参见开发者手册中的
[验证扩展](../../../reference-manual/spi/description/validation)
