65.3.2. JAX-RS 구성

이 섹션에서는 Blueprint XML 또는 Spring XML에서 정의된 JAX-RS 서비스 끝점에서 빈 유효성 검사를 활성화하는 방법을 설명합니다. 빈 유효성 검사를 수행하는 데 사용되는 인터셉터는 JAX-WS 끝점과 JAX-RS 1.1 끝점에 모두 일반적입니다(JAX-RS 2.0 엔드포인트는 다른 인터셉터 클래스를 사용합니다.

이 섹션에 표시된 XML 예제에서는 다음 표에 표시된 것처럼 jaxws 네임스페이스 접두사를 Blueprint 또는 Spring의 적절한 네임스페이스에 매핑해야 합니다.

JAX-RS 끝점에서 빈 유효성 검사를 활성화하는 가장 간단한 방법은 빈 유효성 검사 기능을 엔드포인트에 추가하는 것 입니다. 빈 유효성 검사 기능은 다음 클래스에서 구현됩니다.

또한 JAX-RS 엔드포인트를 사용하려면 유효성 검사 예외를 HTTP 오류 응답에 매핑해야 하는 유효성 검사 예외 매퍼 를 구성해야 합니다. 다음 클래스는 JAX-RS에 대한 유효성 검사 예외 매핑을 구현합니다.

다음 XML 예제에서는 commonValidationFeature bean을 JAX-RS 기능으로 추가하고 exceptionMapper 빈을 JAX-RS 공급자로 추가하여 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"/>

HibernateValidationProviderResolver 클래스의 샘플 구현은 “HibernateValidationProviderResolver 클래스의 예” 을 참조하십시오. OSGi 환경(Apache Karaf)의 컨텍스트에서 beanValidationProvider 를 구성하는 데만 필요합니다.

빈 유효성 검사 기능을 사용하는 대신 빈 유효성 검사 인터셉터를 설치하여 검증 구현을 보다 세밀하게 제어할 수 있습니다. JAX-RS는 이를 위해 JAX-WS와 동일한 인터셉터를 사용합니다. “일반적인 빈 유효성 검사 1.1 인터셉터”

다음 XML 예제에서는 관련 In 인터셉터 빈 및 Out 인터셉터 빈을 서버 엔드포인트에 명시적으로 추가하여 JAX-RS 엔드포인트에서 빈 유효성 검사 기능을 활성화하는 방법을 보여줍니다.

<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"/>

HibernateValidationProviderResolver 클래스의 샘플 구현은 “HibernateValidationProviderResolver 클래스의 예” 을 참조하십시오. OSGi 환경(Apache Karaf)의 컨텍스트에서 beanValidationProvider 를 구성하는 데만 필요합니다.

“BeanValidationProvider 구성” 에 설명된 대로 사용자 정의 BeanValidationProvider 인스턴스를 검증 인터셉터에 삽입할 수 있습니다.