65장. Cryostat 유효성 검사

Cryostat 유효성 검사 1.1(#159-349) - 원래의 Cryostat 유효성 검사 1.0(JSR-303) 표준의 진화로, Java 주석을 사용하여 런타임에 확인할 수 있는 제약 조건을 선언할 수 있습니다.https://jcp.org/en/jsr/detail?id=349 주석을 사용하여 Java 코드의 다음 부분에 제약 조건을 정의할 수 있습니다.

다음 예제에서는 몇 가지 표준VLAN 검증 제약 조건을 사용하여 주석이 달린 Java 클래스를 보여줍니다.

// Java
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Max;
import javax.validation.Valid;
...
public class Person {
    @NotNull private String firstName;
    @NotNull private String lastName;
    @Valid @NotNull private Person boss;

    public @NotNull String saveItem( @Valid @NotNull Person person, @Max( 23 ) BigDecimal age ) {
        // ...
    }
}

빈 유효성 검사 및 스키마 유효성 검사는 매우 유사합니다. XML 스키마를 사용하여 끝점을 구성하는 것은 웹 서비스 끝점에서 런타임에 메시지의 유효성을 검사하는 잘 설정된 방법입니다. XML 스키마는 들어오고 나가는 메시지에 대한VLAN 검증과 동일한 제약 조건의 많은 부분을 확인할 수 있습니다. 그러나 polkit 유효성 검사는 다음 이유 중 하나 이상에 유용한 대체 방법이 될 수 있습니다.

Cryostat Validation 1.1(JSR-349) 표준은 구현이 아닌 API만 정의합니다. 따라서 종속성은 다음 두 부분으로 제공되어야 합니다.

Cryostat 검증을 사용하려면 프로젝트의 Maven pom.xml 파일에 다음 코어 종속 항목을 추가해야 합니다.

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.1.0.Final</version>
</dependency>
<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <!-- use 3.0-b02 version for Java 6 -->
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.el</artifactId>
    <!-- use 3.0-b01 version for Java 6 -->
    <version>3.0.0</version>
</dependency>

8080 검증의 Hibernate Validator 구현을 사용하려면 프로젝트의 Maven pom.xml 파일에 다음과 같은 종속 항목을 추가해야 합니다.

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.0.3.Final</version>
</dependency>

검증 공급자를 해결하기 위한 기본 메커니즘에는 공급자 리소스를 찾기 위해 classpath를 스캔해야 합니다. 그러나 OSGi(Apache Karaf) 환경의 경우 유효성 검사 공급자(예: Hibernate 유효성 검사기)가 별도의 번들로 패키지되어 애플리케이션 classpath에서 자동으로 제공되지 않기 때문에 이 메커니즘은 작동하지 않습니다. OSGi의 컨텍스트에서 Hibernate 검증기를 애플리케이션 번들에 연결해야 하며 OSGi는 이를 성공적으로 수행하려면 약간의 도움이 필요합니다.

OSGi의 컨텍스트에서 자동 검색을 사용하는 대신 검증 공급자를 명시적으로 구성해야 합니다. 예를 들어 공통 검증 기능( “Cryostat 검증 기능”참조)을 사용하여 빈 유효성 검사를 활성화하는 경우 다음과 같이 검증 공급자를 사용하여 구성해야 합니다.

<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 는 Hibernate 검증 공급자를 래핑하는 사용자 지정 클래스입니다.

다음 코드 예제에서는 Hibernate 유효성 검사기를 확인하는 사용자 정의 HibernateValidationProviderResolver 를 정의하는 방법을 보여줍니다.

// Java
package org.example;

import static java.util.Collections.singletonList;
import org.hibernate.validator.HibernateValidator;
import javax.validation.ValidationProviderResolver;
import java.util.List;

/**
 * OSGi-friendly implementation of {@code javax.validation.ValidationProviderResolver} returning
 * {@code org.hibernate.validator.HibernateValidator} instance.
 *
 */
public class HibernateValidationProviderResolver implements ValidationProviderResolver {

    @Override
    public List getValidationProviders() {
        return singletonList(new HibernateValidator());
    }
}

Maven 번들 플러그인을 사용하도록 구성된 Maven 빌드 시스템에서 이전 클래스를 빌드하면 애플리케이션이 배포 시 Hibernate 유효성 검사기 번들에 연결됩니다( 이미 Hibernate 검증기 번들을 OSGi 컨테이너에 배포했다고 가정).