65.2. 使用 Bean 验证开发服务

使用 bean 验证开发服务的第一个步骤是将相关验证注解应用到代表服务的 Java 类或接口。验证注解可让您应用约束来将限制应用到方法参数、返回值和类字段，然后在运行时检查该服务。

要验证服务方法的参数-其中参数简单 Java 类型，您可以应用 bean 验证 API 中的任何约束注解（javax.validation.constraints 软件包）。例如，以下代码示例测试了 nullness（@NotNull 注释）、id 字符串与 \\d+ 正则表达式匹配（@Pattern 注释），以及 名称 字符串在范围 1 到 50 的长度：

import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;
...
@POST
@Path("/books")
public Response addBook(
        @NotNull @Pattern(regexp = "\\d+") @FormParam("id") String id,
        @NotNull @Size(min = 1, max = 50) @FormParam("name") String name) {
    // do some work
    return Response.created().build();
}

要验证复杂的输入参数（对象实例），请将 @Valid 注释应用到参数，如下例所示：

import javax.validation.Valid;
...
@POST
@Path("/books")
public Response addBook( @Valid Book book ) {
    // do some work
    return Response.created().build();
}

@Valid 注释不自行指定任何限制。使用 @Valid 注解 Book 参数时，您可以有效地告知验证引擎在 Book 类的定义中（递归）查找验证限制。在本例中，Book 类定义了在其 id 和 name 字段上的验证限制，如下所示：

import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;
...
public class Book {
    @NotNull @Pattern(regexp = "\\d+") private String id;
    @NotNull @Size(min = 1, max = 50) private String name;

    // ...
}

要将验证应用到常规方法返回值（非Response），请在方法签名前添加注解。例如，要测试 nullness（@NotNull 注释）的返回值，并以递归方式测试验证约束（@Valid 注释），请注解 getBook 方法，如下所示：

import javax.validation.constraints.NotNull;
import javax.validation.Valid;
...
@GET
@Path("/books/{bookId}")
@Override
@NotNull @Valid
public Book getBook(@PathParam("bookId") String id) {
    return new Book( id );
}

要将验证应用到返回 javax.ws.rs.core.Response 对象的方法，您可以使用与非接收情况下相同的注解。例如：

import javax.validation.constraints.NotNull;
import javax.validation.Valid;
import javax.ws.rs.core.Response;
...
@GET
@Path("/books/{bookId}")
@Valid @NotNull
public Response getBookResponse(@PathParam("bookId") String id) {
    return Response.ok( new Book( id ) ).build();
}

表 65.1 “Bean 验证的标准注释” 显示 Bean Validation 规范中定义的标准注释，它们可用于定义字段和方法返回值和参数（标准注解没有可以在类级别上应用）。

可以使用 bean 验证 API 自行定义自定义约束注解。有关如何在 Hibernate 验证器实现中进行此操作的详情，请参考 Hibernate 验证器 参考指南 中的 创建自定义约束 章节。