參數驗證功能是基於 JSR303 實現的，用戶只需標識 JSR303 標準的驗證 annotation，並通過聲明 filter 來實現驗證。

Maven 依賴

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.0.0.GA</version>
</dependency>
<dependency>
    <groupId>
 
org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>4.2.0.Final</version>
</dependency>

示例

參數標註示例

public class ValidationParameter implements Serializable {
    private static final long serialVersionUID = 7158911668568000392L;

    @NotNull 
 
// 不允許為空
    @Size(min = 1, max = 20) // 長度或大小範圍
    private String name;

    @NotNull(groups = ValidationService.Save.class) // 保存時不允許為空，更新時允許為空 ，表示不更新該字段
    @Pattern(regexp = "^\\s*\\w+(?:\\.{0,1}[\\w-]+)*@[a-zA-Z0-9]+(?:[-.][a-zA-Z0-9]+)*\\.[a-zA-Z]+\\s*$")
    private String email;

    @Min(18) // 最小值
    @Max(100) //
 
 最大值
    private int age;

    @Past // 必須為一個過去的時間
    private Date loginDate;

    @Future // 必須為一個未來的時間
    private Date expiryDate;
    
    //Get()/Set()
}

分組驗證示例

public interface ValidationService { // 缺省可按服務接口區分驗證場景，如：@NotNull(groups = ValidationService.class)   
    @interface Save{} // 與方法同名接口，首字母大寫，用於區分驗證場景，如：@NotNull(groups = ValidationService.Save.class)，可選
    void save(ValidationParameter parameter);
    void update(ValidationParameter parameter);
}

關聯驗證示例

public interface ValidationService {   
    @GroupSequence(Update.class) // 同時驗證Update組規則
    @interface Save{}
    void save(ValidationParameter parameter);

    @interface Update{} 
    void update(ValidationParameter parameter);
}

參數驗證示例

public interface ValidationService {
    void save(@NotNull ValidationParameter parameter); // 驗證參數不為空
    void delete(@Min(1) int id); // 直接對基本類型參數驗證
}

配置

在客戶端驗證參數

<dubbo:reference id="validationService" interface="com.alibaba.dubbo.examples.validation.api.ValidationService" validation="true" />

在服務器端驗證參數

<dubbo:service interface="com.alibaba.dubbo.examples.validation.api.ValidationService" ref="validationService" validation="true" />

驗證異常信息

public class ValidationConsumer {   
    public static void main(String[] args) throws Exception {
        String config = ValidationConsumer.class.getPackage().getName().replace(‘.‘, ‘/‘) + "/validation-consumer.xml";
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(config);
        context.start();
        ValidationService validationService = (ValidationService)context.getBean("validationService");
        // Error
        try {
            parameter = new ValidationParameter();
            validationService.save(parameter);
            System.out.println("Validation ERROR");
        } catch (RpcException e) { // 拋出的是RpcException
            ConstraintViolationException ve = (ConstraintViolationException) e.getCause(); // 裏面嵌了一個ConstraintViolationException
            Set<ConstraintViolation<?>> violations = ve.getConstraintViolations(); // 可以拿到一個驗證錯誤詳細信息的集合
            System.out.println(violations);
        }
    } 
}

參數驗證 validation