65.3. Cryostat 유효성 검사 구성

65.3.1. Cryostat-WS 구성

65.3.1.1. 개요

이 섹션에서는 블루프린트 XML 또는 Spring XML에서 정의된 Cryostat-WS 서비스 엔드포인트에서 Cryostat 유효성 검사를 활성화하는 방법을 설명합니다. Cryostat 유효성 검사를 수행하는 데 사용되는 인터셉터는 Cryostat-WS 끝점 및 Cryostat-RS 1.1 엔드 포인트(JAX-RS 2.0 끝점 모두 서로 다른 인터셉터 클래스를 사용)에 공통적으로 사용됩니다.

65.3.1.2. 네임스페이스

이 섹션에 표시된 XML 예제에서는 다음 표에 표시된 것과 같이 블루프린트 또는 Spring에 대해 jaxws 네임스페이스 접두사를 적절한 네임스페이스에 매핑해야 합니다.

XML 언어	네임스페이스
Blueprint	`http://cxf.apache.org/blueprint/jaxws`
Spring	`http://cxf.apache.org/jaxws`

65.3.1.3. Cryostat 검증 기능

Cryostat-WS 엔드포인트에서 8080 검증을 활성화하는 가장 간단한 방법은 endpoint에 8080 검증 기능을 추가하는 것입니다. Cryostat 검증 기능은 다음 클래스에 의해 구현됩니다.

org.apache.cxf.validation.BeanValidationFeature: 이 기능 클래스의 인스턴스를 Cryostat-WS 끝점(Java API 또는 jaxws:features 하위 요소 jaxws:endpoint in XML)에 추가하면 엔드포인트에서 Cryostat 유효성 검사를 활성화할 수 있습니다. 이 기능은 두 개의 인터셉터를 설치합니다. 들어오는 메시지 데이터의 유효성을 검사하는 인터셉터와 반환 값의 유효성을 검사하는 아웃 인터셉터(기본 구성 매개 변수를 사용하여 인터셉터가 생성되는 위치)를 설치합니다.

65.3.1.4. Cryostat 검증 기능을 사용한 샘플 Cryostat-WS 구성

다음 XML 예제에서는 commonValidationFeature ctlplane을 엔드포인트에 add-WS-WS 기능으로 추가하여 Cryostat-WS 엔드포인트에서 8080 검증 기능을 활성화하는 방법을 보여줍니다.

<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)의 컨텍스트에서 8080 ValidationProvider 만 구성해야 합니다.

참고

컨텍스트에 따라 블루프린트 또는 Spring에 적합한 XML 네임스페이스에 jaxws 접두사를 매핑해야 합니다.

65.3.1.5. 일반적인 Cryostat 검증 1.1 인터셉터

8080 유효성 검사의 구성을 보다 세밀하게 제어하려면 Cryostat 검증 기능을 사용하는 대신 인터셉터를 개별적으로 설치할 수 있습니다. Quarkus 검증 기능 대신 다음 인터셉터 중 하나 또는 둘 다를 구성할 수 있습니다.

org.apache.cxf.validation.BeanValidationInInterceptor: Cryostat-WS(또는 Cryostat-RS 1.1) 엔드포인트에 설치하는 경우 검증 제약 조건에 대해 리소스 메서드 매개 변수의 유효성을 검사합니다. 유효성 검사가 실패하면 javax.validation.ConstraintViolationException 예외를 발생시킵니다. 이 인터셉터를 설치하려면 XML의 jaxws:inInterceptors 하위 요소(또는 XML의 jaxrs: interceptors 하위 요소)를 통해 엔드포인트에 추가합니다.
org.apache.cxf.validation.BeanValidationOutInterceptor: Cryostat-WS(또는 Cryostat-RS 1.1) 엔드포인트에 설치하는 경우 검증 제약 조건에 대해 응답 값을 검증합니다. 유효성 검사가 실패하면 javax.validation.ConstraintViolationException 예외를 발생시킵니다. 이 인터셉터를 설치하려면 XML의 jaxws:outInterceptors 하위 요소(또는 XML의 jaxrs:outInterceptors 하위 요소)를 통해 엔드포인트에 추가합니다.

65.3.1.6. polkit 검증 인터셉터를 사용한 샘플 Cryostat-WS 구성

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

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

65.3.1.7. CryostatValidationProvider 구성

org.apache.cxf.validation.BeanValidationProvider 는 8080 검증 구현( 검증공급자)을 래핑하는 간단한 래퍼 클래스입니다. 기본 Cryostat ValidationProvider 클래스를 재정의하면 8080 검증 구현을 사용자 지정할 수 있습니다. Cryo statValidationProvider Quarkus를 사용하면 다음 공급자 클래스 중 하나 이상을 덮어쓸 수 있습니다.

javax.validation.ParameterNameProvider: 메서드 및 생성자 매개 변수의 이름을 제공합니다. Java reflect API는 메서드 매개 변수 또는 생성자 매개 변수의 이름에 대한 액세스 권한을 부여하지 않으므로 이 클래스가 필요합니다.
javax.validation.spi.ValidationProvider<T>: 지정된 유형인 T 에 대한 빈 유효성 검사 구현을 제공합니다. 자체 ValidationProvider 클래스를 구현하면 자체 클래스에 대한 사용자 정의 유효성 검사 규칙을 정의할 수 있습니다.By implementing your own ValidationProvider class, you can define custom validation rules for your own classes. 이 메커니즘을 사용하면 metrics 검증 프레임워크를 효과적으로 확장할 수 있습니다.
javax.validation.ValidationProviderResolver: ValidationProvider 클래스를 검색하고 검색된 클래스 목록을 반환하는 메커니즘을 구현합니다.Implements a mechanism for discovering ValidationProvider classes and returns a list of the discovered classes. 기본 확인자는 classpath에서 ValidationProvider 클래스 목록을 포함해야 하는 META-INF/services/javax.validation.spi. ValidationProvider 파일을 찾습니다.
javax.validation.ValidatorFactory: javax.validation.Validator 인스턴스를 반환하는 팩토리입니다.
org.apache.cxf.validation.ValidationConfiguration: 유효성 검사 공급자 계층에서 더 많은 클래스를 재정의할 수 있는 CXF 래퍼 클래스입니다.

Cryostat ValidationProvider 를 사용자 지정하려면 사용자 지정 Cryostat ValidationProvider 인스턴스를 검증 In interceptor의 생성자와 검증 아웃 인터셉터의 생성자에 전달합니다. 예를 들면 다음과 같습니다.

<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. Cryostat-RS 구성

65.3.2.1. 개요

이 섹션에서는 블루프린트 XML 또는 Spring XML에서 정의된 Cryostat-RS 서비스 엔드포인트에서 Cryostat 유효성 검사를 활성화하는 방법을 설명합니다. Cryostat 유효성 검사를 수행하는 데 사용되는 인터셉터는 Cryostat-WS 끝점 및 Cryostat-RS 1.1 엔드 포인트(JAX-RS 2.0 끝점 모두 서로 다른 인터셉터 클래스를 사용)에 공통적으로 사용됩니다.

65.3.2.2. 네임스페이스

XML 언어	네임스페이스
Blueprint	`http://cxf.apache.org/blueprint/jaxws`
Spring	`http://cxf.apache.org/jaxws`

65.3.2.3. Cryostat 검증 기능

Cryostat-RS 엔드포인트에서 8080 검증을 활성화하는 가장 간단한 방법은 endpoint에 8080 검증 기능을 추가하는 것입니다. Cryostat 검증 기능은 다음 클래스에 의해 구현됩니다.

org.apache.cxf.validation.BeanValidationFeature: 이 기능 클래스의 인스턴스를 XML에서 jaxrs:server 의 jaxrs:features 하위 요소를 통해 (Java API를 통해 또는 jaxrs:features 하위 요소를 통해) 엔드포인트에서 Cryostat 유효성 검사를 활성화할 수 있습니다. 이 기능은 두 개의 인터셉터를 설치합니다. 들어오는 메시지 데이터의 유효성을 검사하는 인터셉터와 반환 값의 유효성을 검사하는 아웃 인터셉터(기본 구성 매개 변수를 사용하여 인터셉터가 생성되는 위치)를 설치합니다.

65.3.2.4. 검증 예외 매퍼

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

org.apache.cxf.jaxrs.validation.ValidationExceptionMapper: Cryostat-RS 2.0 사양에 따라 검증 예외 매핑 구현: 모든 입력 매개변수 유효성 검사 위반은 HTTP 상태 코드 400 Bad Request 에 매핑되고, 모든 반환 값 검증 위반(또는 내부 유효성 검사 위반)은 HTTP 상태 코드 500 Internal Server Error 에 매핑됩니다.

65.3.2.5. 샘플 Cryostat-RS 구성

다음 XML 예제에서는 commonValidationFeature Cryostat를 Cryostat-RS 기능으로 추가하고 exceptionMapper Cryostat를 Cryostat-RS 공급자로 추가하여 Cryostat-RS 끝점에서 oscap 유효성 검사 기능을 활성화하는 방법을 보여줍니다.

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

참고

컨텍스트에 따라 블루프린트 또는 Spring에 적합한 XML 네임스페이스에 jaxrs 접두사를 매핑해야 합니다.

65.3.2.6. 일반적인 Cryostat 검증 1.1 인터셉터

RHHI 검증 기능을 사용하는 대신, 선택 옵션으로 useful 검증 인터셉터를 설치하여 검증 구현을 보다 세밀하게 제어할 수 있습니다. Cryostat-RS는 이 목적을 위해 Cryostat-WS와 동일한 인터셉터를 사용합니다. “일반적인 Cryostat 검증 1.1 인터셉터”

65.3.2.7. polkit 검증 인터셉터를 사용한 샘플 Cryostat-RS 구성

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

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

65.3.2.8. CryostatValidationProvider 구성

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

65.3.3. Cryostat-RS 2.0 구성

65.3.3.1. 개요

Cryostat-RS 1.1과는 달리, Cryostat-WS와 공통 유효성 검사 인터셉터를 공유하는), Cryostat-RS 2.0은 Cryostat-RS 2.0 고유의 전용 검증 인터셉터 클래스에 의존합니다.

65.3.3.2. Cryostat 검증 기능

Cryostat-RS 2.0의 경우 다음 클래스에 의해 구현되는 전용 Cryostat 검증 기능이 있습니다.

org.apache.cxf.validation.JAXRSBeanValidationFeature: 이 기능 클래스의 인스턴스를 XML에서 jaxrs:server 의 jaxrs:features 하위 요소(Java API를 통해 또는 jaxrs:features 하위 요소 통해)에 추가하여 Cryostat-RS 2.0 서버 끝점에서 Cryostat 유효성 검사를 활성화할 수 있습니다. 이 기능은 두 개의 인터셉터를 설치합니다. 들어오는 메시지 데이터의 유효성을 검사하는 인터셉터와 반환 값의 유효성을 검사하는 아웃 인터셉터(기본 구성 매개 변수를 사용하여 인터셉터가 생성되는 위치)를 설치합니다.

65.3.3.3. 검증 예외 매퍼

Cryostat-RS 2.0은 Cryostat-RS 1.x와 동일한 검증 예외 매퍼 클래스를 사용합니다.

org.apache.cxf.jaxrs.validation.ValidationExceptionMapper: Cryostat-RS 2.0 사양에 따라 검증 예외 매핑 구현: 모든 입력 매개변수 유효성 검사 위반은 HTTP 상태 코드 400 Bad Request 에 매핑되고, 모든 반환 값 검증 위반(또는 내부 유효성 검사 위반)은 HTTP 상태 코드 500 Internal Server Error 에 매핑됩니다.

65.3.3.4. Cryostat 검증 호출기

기본이 아닌 라이프사이클 정책(예: Spring 라이프사이클 관리 사용)으로 Cryostat-RS 서비스를 구성하는 경우, 엔드포인트 구성에서 jaxrs:invoker 요소를 사용하여 서비스 엔드포인트에서 jaxrs:invoker 요소를 사용하여 org.apache.cxf.jaxrs.validation.JAXRSBeanValidationInvoker 인스턴스를 등록해야 합니다.

Cryostat-RS 서비스 라이프사이클 관리에 대한 자세한 내용은 “Spring XML의 라이프사이클 관리” 을 참조하십시오.

65.3.3.5. Cryostat 검증 기능을 사용한 샘플 Cryostat-RS 2.0 구성

다음 XML 예제에서는 jaxrsValidationFeature Ignition을 Cryostat-RS 기능으로 추가하고 exceptionMapper Cryostat를 a Cryostat-RS 공급자로 추가하여 Cryostat-RS 끝점에서 8080 검증 기능을 활성화하는 방법을 보여줍니다.

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

참고