主页
产品
Red Hat Fuse
7.7
Apache CXF 开发指南
65.2. 使用 Bean Validation 开发服务

65.2. 使用 Bean Validation 开发服务

65.2.1. 注解服务 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();
}

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();
}

Copy to Clipboard

Toggle word wrap

验证复杂输入参数
复制链接

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

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

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

Copy to Clipboard

Toggle word wrap

@Valid 注释本身不指定任何限制。使用 @Valid 标注 Book 参数时，您将有效地告知验证引擎在 Book 类的定义内查看（递归）查找验证限制。在本例中，Book 类使用 ID 和名称字段的验证限制定义，如下所示：

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;

    // ...
}

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;

    // ...
}

Copy to Clipboard

Toggle word wrap

验证返回值（非响应）
复制链接

要将验证应用到常规方法返回值（非空间），请在方法签名前添加注解。例如，要测试 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 );
}

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 );
}

Copy to Clipboard

Toggle word wrap

验证返回值(Response)
复制链接

要将验证应用到返回 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();
}

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();
}

Copy to Clipboard

Toggle word wrap

65.2.2. 标准注解
复制链接

Bean 验证限制
复制链接

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

Expand

表 65.1. Bean 验证的标准注解
注解	适用于	描述
`@AssertFalse`	`布尔值`，`布尔值`	检查被注释的元素是否为 `false`。
`@AssertTrue`	`布尔值`，`布尔值`	检查注解的元素是否为 `true`。
`@DecimalMax(value=, inclusive=)`	`BigDecimal`,`BigInteger`,`CharSequence`,`byte`,`short`,`int`, int,`long`, primitive type wrappers	当 `inclusive=false` 时，检查注解的值是否小于指定的最大值。否则，检查值是否小于或等于指定的最大值。`value` 参数指定 `BigDecimal` 字符串格式的最大值。
`@DecimalMin(value=, inclusive=)`	`BigDecimal`,`BigInteger`,`CharSequence`,`byte`,`short`,`int`, int,`long`, primitive type wrappers	当 `inclusive=false` 时，检查注解的值是否大于指定最小值。否则，检查值是否大于或等于指定最小值。`value` 参数指定 `BigDecimal` 字符串格式最小值。
`@Digits(integer=, fraction=)`	`BigDecimal`,`BigInteger`,`CharSequence`,`byte`,`short`,`int`, int,`long`, primitive type wrappers	检查注解的值是否最多有 `整数` 数和 `分数` 数。
`@Future`	`java.util.Date`, `java.util.Calendar`	检查注解的日期是否在未来。
`@Max(value=)`	`BigDecimal`,`BigInteger`,`CharSequence`,`byte`,`short`,`int`, int,`long`, primitive type wrappers	检查注解的值是否小于或等于指定的最大值。
`@Min(value=)`	`BigDecimal`,`BigInteger`,`CharSequence`,`byte`,`short`,`int`, int,`long`, primitive type wrappers	检查注解的值是否大于或等于指定最小值。
`@NotNull`	任何类型	检查注解的值是否 `不为空`。
`@Null`	任何类型	检查注解的值是否为 `null`。
`@Past`	`java.util.Date`, `java.util.Calendar`	检查注解的日期是否过去。
`@Pattern(regex=, flag=)`	`CharSequence`	检查被注释的字符串是否与给定标记匹配的正则表达式正则表达式匹配。
`@Size(min=, max=)`	`CharSequence`、`集合`、`映射` 和数组	检查被注解的集合、映射或数组的大小（包括）是否位于 `min` 和 `max` （含）之间。
`@Valid`	任何非primitive 类型	在注解对象中递归执行验证。如果对象是集合或数组，则会以递归方式验证元素。如果对象是一个映射，则值元素会递归验证。

65.2.3. 自定义注解
复制链接

在 Hibernate 中定义自定义约束
复制链接

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

返回顶部

65.2. 使用 Bean Validation 开发服务

65.2.1. 注解服务 Bean
复制链接

概述
复制链接

验证简单的输入参数
复制链接

验证复杂输入参数
复制链接

验证返回值（非响应）
复制链接

验证返回值(Response)
复制链接

65.2.2. 标准注解
复制链接

Bean 验证限制
复制链接

65.2.3. 自定义注解
复制链接

在 Hibernate 中定义自定义约束
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

65.2. 使用 Bean Validation 开发服务

65.2.1. 注解服务 Bean复制链接链接已复制到粘贴板!

概述复制链接链接已复制到粘贴板!

验证简单的输入参数复制链接链接已复制到粘贴板!

验证复杂输入参数复制链接链接已复制到粘贴板!

验证返回值（非响应）复制链接链接已复制到粘贴板!

验证返回值(Response)复制链接链接已复制到粘贴板!

65.2.2. 标准注解复制链接链接已复制到粘贴板!

Bean 验证限制复制链接链接已复制到粘贴板!

65.2.3. 自定义注解复制链接链接已复制到粘贴板!

在 Hibernate 中定义自定义约束复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

65.2.1. 注解服务 Bean
复制链接

概述
复制链接

验证简单的输入参数
复制链接

验证复杂输入参数
复制链接

验证返回值（非响应）
复制链接

验证返回值(Response)
复制链接

65.2.2. 标准注解
复制链接

Bean 验证限制
复制链接

65.2.3. 自定义注解
复制链接

在 Hibernate 中定义自定义约束
复制链接