65.3. 配置 Bean 验证

65.3.1. JAX-WS 配置

概述

这部分论述了如何在 JAX-WS 服务端点中启用 bean 验证，该端点在 Blueprint XML 或 Spring XML 中定义。用于执行 bean 验证的拦截器在 JAX-WS 端点和 JAX-RS 1.1 端点(JAX-RS 2.0 端点)都很常见（但使用不同的拦截器类）。

命名空间

在本节所示的 XML 示例中，您必须记得将 jaxws 命名空间前缀映射到适当的命名空间，可以是 Blueprint 或 Spring，如下表中所示：

XML 语言	命名空间
蓝图（Blueprint）	`http://cxf.apache.org/blueprint/jaxws`
Spring	`http://cxf.apache.org/jaxws`

Bean 验证功能

在 JAX-WS 端点上启用 Bean 验证的最简单方式是将 bean 验证功能 添加到端点。Bean 验证功能由以下类实现：

org.apache.cxf.validation.BeanValidationFeature: 通过将此功能类的实例添加到 JAX-WS 端点（通过 Java API，或通过 XML 中的 jaxws: features 子元素），您可以在端点上启用 bean 验证。此功能安装两个拦截器：一个拦截器验证传入的消息数据；以及验证返回值的 Out 拦截器（其中，拦截器会使用默认配置参数创建）。

带有 bean 验证功能的 JAX-WS 配置示例

以下 XML 示例演示了如何在 JAX-WS 端点中启用 bean 验证功能，方法是在端点中添加 commonValidationFeature bean 作为 JAX-WS 功能：

<jaxws:endpoint xmlns:s="http://bookworld.com"
                serviceName="s:BookWorld"
                endpointName="s:BookWorldPort"
                implementor="#bookWorldValidation"
                address="/bwsoap">
    <jaxws:features>
        <ref bean="commonValidationFeature" />
    </jaxws:features>
</jaxws:endpoint>

<bean id="bookWorldValidation" class="org.apache.cxf.systest.jaxrs.validation.spring.BookWorldImpl"/>

<bean id="commonValidationFeature" class="org.apache.cxf.validation.BeanValidationFeature">
    <property name="provider" ref="beanValidationProvider"/>
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

有关 HibernateValidationProviderResolver 类的示例实现，请参阅 “HibernateValidationProviderResolver 类示例”一节。只需要在 OSGi 环境(Apache Karaf)环境中配置 beanValidationProvider。

注意

根据具体情况，请记住将 jaxws 前缀映射到蓝图或 Spring 的相应 XML 命名空间。

Common bean 验证 1.1 拦截器

如果要对 bean 验证的配置具有更精细的控制，您可以单独安装拦截器，而不是使用 bean 验证功能。要代替 bean 验证功能，您可以配置以下拦截器之一或两者：

org.apache.cxf.validation.BeanValidationInInterceptor: 在 JAX-WS （或 JAX-RS 1.1）端点中安装时，根据验证限制验证资源方法参数。如果验证失败，则引发 javax.validation.ConstraintViolationException 异常。要安装此拦截器，请通过 XML 中的 jaxws:inInterceptors 子元素（或 XML 中的 jaxrs:inInterceptors 子元素）将其添加到端点。
org.apache.cxf.validation.BeanValidationOutInterceptor: 在 JAX-WS （或 JAX-RS 1.1）端点中安装时，根据验证限制验证响应值。如果验证失败，则引发 javax.validation.ConstraintViolationException 异常。要安装此拦截器，请通过 XML 中的 jaxws:outInterceptors 子元素（或 XML 中的 jaxrs:outInterceptors 子元素）将其添加到端点。

带有 bean 验证拦截器的 JAX-WS 配置示例

以下 XML 示例演示了如何在 JAX-WS 端点中启用 bean 验证功能，方法是明确将相关的 In 拦截器 bean 和 Out 拦截器 bean 添加到端点：

<jaxws:endpoint xmlns:s="http://bookworld.com"
                serviceName="s:BookWorld"
                endpointName="s:BookWorldPort"
                implementor="#bookWorldValidation"
                address="/bwsoap">
    <jaxws:inInterceptors>
        <ref bean="validationInInterceptor" />
    </jaxws:inInterceptors>

    <jaxws:outInterceptors>
        <ref bean="validationOutInterceptor" />
    </jaxws:outInterceptors>
</jaxws:endpoint>

<bean id="bookWorldValidation" class="org.apache.cxf.systest.jaxrs.validation.spring.BookWorldImpl"/>

<bean id="validationInInterceptor" class="org.apache.cxf.validation.BeanValidationInInterceptor">
    <property name="provider" ref="beanValidationProvider"/>
</bean>
<bean id="validationOutInterceptor" class="org.apache.cxf.validation.BeanValidationOutInterceptor">
    <property name="provider" ref="beanValidationProvider"/>
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

配置 BeanValidationProvider

org.apache.cxf.validation.BeanValidationProvider 是一个简单打包程序类，用于包装 Bean 验证实施(验证供应商)。通过覆盖默认的 BeanValidationProvider 类，您可以自定义 bean 验证的实现。BeanValidationProvider bean 允许您覆盖以下一个或多个提供程序类：

javax.validation.ParameterNameProvider: 为方法和构造器参数提供名称。请注意，这个类是必需的，因为 Java 反映的 API 不提供 方法参数或构造器参数的名称。
javax.validation.spi.ValidationProvider<T>: 提供指定类型 T 的 Bean 验证实施。通过实施自己的 ValidationProvider 类，您可以为您自己的类定义自定义验证规则。这种机制有效允许您扩展 bean 验证框架。
javax.validation.ValidationProviderResolver: 实施用于发现 ValidationProvider 类的机制，并返回发现的类列表。默认解析器会在 classpath 中查找 META-INF/services/javax.validation.spi.ValidationProvider 文件，它应包含 ValidationProvider 类列表。
javax.validation.ValidatorFactory: 返回 javax.validation.Validator 实例的工厂。
org.apache.cxf.validation.ValidationConfiguration: CXF 打包程序类可让您覆盖验证供应商层中的更多类。

要自定义 BeanValidationProvider，请将自定义 BeanValidationProvider 实例传递到验证参与拦截器的构造器，并传递给验证传出拦截器的构造器。例如：

<bean id="validationProvider" class="org.apache.cxf.validation.BeanValidationProvider" />

<bean id="validationInInterceptor" class="org.apache.cxf.validation.BeanValidationInInterceptor">
    <property name="provider" ref="validationProvider" />
</bean>

<bean id="validationOutInterceptor" class="org.apache.cxf.validation.BeanValidationOutInterceptor">
    <property name="provider" ref="validationProvider" />
</bean>

65.3.2. JAX-RS 配置

概述

这部分论述了如何在 JAX-RS 服务端点中启用 bean 验证，该端点在 Blueprint XML 或 Spring XML 中定义。用于执行 bean 验证的拦截器在 JAX-WS 端点和 JAX-RS 1.1 端点(JAX-RS 2.0 端点)都很常见（但使用不同的拦截器类）。

命名空间

在本节所示的 XML 示例中，您必须记得将 jaxws 命名空间前缀映射到适当的命名空间，可以是 Blueprint 或 Spring，如下表中所示：

XML 语言	命名空间
蓝图（Blueprint）	`http://cxf.apache.org/blueprint/jaxws`
Spring	`http://cxf.apache.org/jaxws`

Bean 验证功能

在 JAX-RS 端点上启用 Bean 验证的最简单方式是将 bean 验证功能 添加到端点。Bean 验证功能由以下类实现：

org.apache.cxf.validation.BeanValidationFeature: 通过将此功能类的实例添加到 JAX-RS 端点（通过 Java API 或 XML 中的 jaxrs: features 子元素），您可以在端点上启用 bean 验证。此功能安装两个拦截器：一个拦截器验证传入的消息数据；以及验证返回值的 Out 拦截器（其中，拦截器会使用默认配置参数创建）。

验证异常映射程序

JAX-RS 端点还要求您配置 验证异常映射程序，它负责将验证异常映射到 HTTP 错误响应。以下类实施 JAX-RS 的验证异常映射：

org.apache.cxf.jaxrs.validation.ValidationExceptionMapper: 根据 JAX-RS 2.0 规范实施验证异常映射：任何输入参数验证违反情况都映射到 HTTP 状态代码 400 Bad Request ；以及任何返回值验证违反（或内部验证违反）都映射到 HTTP 状态代码 500 Internal Server Error。

JAX-RS 配置示例

以下 XML 示例演示了如何在 JAX-RS 端点中启用 bean 验证功能，方法是添加 commonValidationFeature bean 作为 JAX-RS 功能，通过将 exceptionMapper bean 添加为 JAX-RS 供应商：

<jaxrs:server address="/bwrest">
    <jaxrs:serviceBeans>
        <ref bean="bookWorldValidation"/>
    </jaxrs:serviceBeans>
    <jaxrs:providers>
        <ref bean="exceptionMapper"/>
    </jaxrs:providers>
    <jaxrs:features>
        <ref bean="commonValidationFeature" />
    </jaxrs:features>
</jaxrs:server>

<bean id="bookWorldValidation" class="org.apache.cxf.systest.jaxrs.validation.spring.BookWorldImpl"/>
<beanid="exceptionMapper"class="org.apache.cxf.jaxrs.validation.ValidationExceptionMapper"/>

<bean id="commonValidationFeature" class="org.apache.cxf.validation.BeanValidationFeature">
    <property name="provider" ref="beanValidationProvider"/>
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

注意

根据具体情况，请记住将 jaxrs 前缀映射到蓝图或 Spring 的相应 XML 命名空间。

Common bean 验证 1.1 拦截器

您可以选择安装 bean 验证拦截器来获取对验证实施进行更精细的控制，而不是使用 bean 验证功能。JAX-RS 将与 JAX-WS 相同的拦截器用于此目的-请参阅 “Common bean 验证 1.1 拦截器”一节

带有 bean 验证拦截器的 JAX-RS 配置示例

以下 XML 示例演示了如何在 JAX-RS 端点中启用 bean 验证功能，方法是明确将相关的 In 拦截器 bean 和 Out 拦截器 bean 添加到服务器端点：

<jaxrs:server address="/">
    <jaxrs:inInterceptors>
        <ref bean="validationInInterceptor" />
    </jaxrs:inInterceptors>

    <jaxrs:outInterceptors>
        <ref bean="validationOutInterceptor" />
    </jaxrs:outInterceptors>

    <jaxrs:serviceBeans>
    ...
    </jaxrs:serviceBeans>

    <jaxrs:providers>
        <ref bean="exceptionMapper"/>
    </jaxrs:providers>
</jaxrs:server>

<bean id="exceptionMapper" class="org.apache.cxf.jaxrs.validation.ValidationExceptionMapper"/>

<bean id="validationInInterceptor" class="org.apache.cxf.validation.BeanValidationInInterceptor">
    <property name="provider" ref="beanValidationProvider" />
</bean>

<bean id="validationOutInterceptor" class="org.apache.cxf.validation.BeanValidationOutInterceptor">
    <property name="provider" ref="beanValidationProvider" />
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

配置 BeanValidationProvider

您可以将自定义 BeanValidationProvider 实例注入验证拦截器，如 “配置 BeanValidationProvider”一节所述。

65.3.3. JAX-RS 2.0 配置

概述

与 JAX-RS 1.1 （使用 JAX-WS 共享常见验证拦截器）不同，JAX-RS 2.0 配置依赖于特定于 JAX-RS 2.0 的专用验证拦截器类。

Bean 验证功能

对于 JAX-RS 2.0，有一个专门的 bean 验证功能，它由以下类实施：

org.apache.cxf.validation.JAXRSBeanValidationFeature: 通过将此功能类的实例添加到 JAX-RS 端点（通过 Java API 或 XML 中的 jaxrs: features 子元素），您可以在 JAX-RS 2.0 服务器端点上启用 bean 验证。此功能安装两个拦截器：一个拦截器验证传入的消息数据；以及验证返回值的 Out 拦截器（其中，拦截器会使用默认配置参数创建）。

验证异常映射程序

JAX-RS 2.0 使用与 JAX-RS 1.x 相同的验证异常映射程序类：

org.apache.cxf.jaxrs.validation.ValidationExceptionMapper: 根据 JAX-RS 2.0 规范实施验证异常映射：任何输入参数验证违反情况都映射到 HTTP 状态代码 400 Bad Request ；以及任何返回值验证违反（或内部验证违反）都映射到 HTTP 状态代码 500 Internal Server Error。

Bean 验证调用器

如果您使用非默认生命周期策略（例如，使用 Spring 生命周期管理）配置 JAX-RS 服务，您还应注册 org.apache.cxf.jaxrs.validation.JAXRSBeanValidationInvoker 实例使用端点配置中的 jaxrs:invoker 元素，以确保正确调用了 bean 验证。

有关 JAX-RS 服务生命周期管理的更多详情，请参阅 “Spring XML 中的生命周期管理”一节。

带有 bean 验证功能的 JAX-RS 2.0 配置示例

以下 XML 示例演示了如何在 JAX-RS 2.0 端点中启用 bean 验证功能，方法是将 jaxrsValidationFeature bean 添加为 JAX-RS 功能，并通过将 exceptionMapper bean 添加为 JAX-RS 提供程序：

<jaxrs:server address="/">
    <jaxrs:serviceBeans>
    ...
    </jaxrs:serviceBeans>
    <jaxrs:providers>
        <ref bean="exceptionMapper"/>
    </jaxrs:providers>
    <jaxrs:features>
        <ref bean="jaxrsValidationFeature" />
    </jaxrs:features>
</jaxrs:server>

<bean id="exceptionMapper" class="org.apache.cxf.jaxrs.validation.ValidationExceptionMapper"/>
<bean id="jaxrsValidationFeature" class="org.apache.cxf.validation.JAXRSBeanValidationFeature">
    <property name="provider" ref="beanValidationProvider"/>
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

注意

根据具体情况，请记住将 jaxrs 前缀映射到蓝图或 Spring 的相应 XML 命名空间。

Common bean 验证 1.1 拦截器

如果您想对 bean 验证的配置具有更精细的控制，您可以单独安装 JAX-RS 拦截器，而不使用 bean 验证功能。配置以下 JAX-RS 拦截器之一或两者：

org.apache.cxf.validation.JAXRSBeanValidationInInterceptor: 在 JAX-RS 2.0 服务器端点中安装时，根据验证限制验证资源方法参数。如果验证失败，则引发 javax.validation.ConstraintViolationException 异常。要安装此拦截器，请通过 XML 中的 jaxrs:inInterceptors 子元素将其添加到端点中。
org.apache.cxf.validation.JAXRSBeanValidationOutInterceptor: 在 JAX-RS 2.0 端点中安装时，根据验证限制验证响应值。如果验证失败，则引发 javax.validation.ConstraintViolationException 异常。要安装此拦截器，请通过 XML 中的 jaxrs:inInterceptors 子元素将其添加到端点中。

带有 bean 验证拦截器的 JAX-RS 2.0 配置示例

以下 XML 示例演示了如何在 JAX-RS 2.0 端点中启用 bean 验证功能，方法是明确将相关的 In 拦截器 bean 和 Out 拦截器 bean 添加到服务器端点：

<jaxrs:server address="/">
    <jaxrs:inInterceptors>
        <ref bean="validationInInterceptor" />
    </jaxrs:inInterceptors>

    <jaxrs:outInterceptors>
        <ref bean="validationOutInterceptor" />
    </jaxrs:outInterceptors>

    <jaxrs:serviceBeans>
    ...
    </jaxrs:serviceBeans>

    <jaxrs:providers>
        <ref bean="exceptionMapper"/>
    </jaxrs:providers>
</jaxrs:server>

<bean id="exceptionMapper" class="org.apache.cxf.jaxrs.validation.ValidationExceptionMapper"/>

<bean id="validationInInterceptor" class="org.apache.cxf.jaxrs.validation.JAXRSBeanValidationInInterceptor">
    <property name="provider" ref="beanValidationProvider" />
</bean>

<bean id="validationOutInterceptor" class="org.apache.cxf.jaxrs.validation.JAXRSBeanValidationOutInterceptor">
    <property name="provider" ref="beanValidationProvider" />
</bean>

<bean id="beanValidationProvider" class="org.apache.cxf.validation.BeanValidationProvider">
    <constructor-arg ref="validationProviderResolver"/>
</bean>

<bean id="validationProviderResolver" class="org.example.HibernateValidationProviderResolver"/>

配置 BeanValidationProvider

您可以将自定义 BeanValidationProvider 实例注入验证拦截器，如 “配置 BeanValidationProvider”一节所述。

配置 JAXRSParameterNameProvider

org.apache.cxf.jaxrs.validation.JAXRSParameterNameProvider 类是 javax.validation.ParameterNameProvider 接口的实现，可用于在 JAX-RS 2.0 端点的上下文中为方法和构造器参数提供名称。

65.3. 配置 Bean 验证

65.3.1. JAX-WS 配置

概述

命名空间

Bean 验证功能

带有 bean 验证功能的 JAX-WS 配置示例

Common bean 验证 1.1 拦截器

带有 bean 验证拦截器的 JAX-WS 配置示例

配置 BeanValidationProvider

65.3.2. JAX-RS 配置

概述

命名空间

Bean 验证功能

验证异常映射程序

JAX-RS 配置示例

Common bean 验证 1.1 拦截器

带有 bean 验证拦截器的 JAX-RS 配置示例

配置 BeanValidationProvider

65.3.3. JAX-RS 2.0 配置

概述

Bean 验证功能

验证异常映射程序

Bean 验证调用器

带有 bean 验证功能的 JAX-RS 2.0 配置示例

Common bean 验证 1.1 拦截器

带有 bean 验证拦截器的 JAX-RS 2.0 配置示例

配置 BeanValidationProvider

配置 JAXRSParameterNameProvider

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links