38.2. XML 스키마의 Java 클래스 지정

기본적으로 XML 스키마 유형은 Java 기본 유형에 매핑됩니다. XML 스키마와 Java 간의 가장 논리적인 매핑이지만 애플리케이션 개발자의 요구 사항을 항상 충족하는 것은 아닙니다. XML 스키마 기본 유형을 추가 정보를 저장할 수 있는 Java 클래스에 매핑하거나 XML 기본 유형을 간단한 형식 대체를 허용하는 클래스에 매핑해야 할 수 있습니다.

CryostatB javaType 사용자 지정 요소를 사용하면 XML 스키마 기본 유형과 Java 기본 유형 간의 매핑을 사용자 지정할 수 있습니다. 글로벌 수준 및 개별 인스턴스 수준에서 매핑을 사용자 지정하는 데 사용할 수 있습니다. javaType 요소를 간단한 형식 정의의 일부로 사용하거나 복잡한 형식 정의의 일부로 사용할 수 있습니다.

javaType 사용자 지정 요소를 사용하는 경우 기본 유형의 XML 표현을 대상 Java 클래스로 변환하기 위한 메서드를 지정해야 합니다. 일부 매핑에는 기본 변환 방법이 있습니다. 기본 매핑이 없는 인스턴스의 경우 Apache CXF는 CryostatB 메서드를 제공하여 필요한 메서드를 쉽게 개발할 수 있습니다.

javaType 사용자 지정 요소는 표 38.1. “XML 스키마 유형에 대한 Java 클래스 생성 사용자 지정을 위한 속성” 에 설명된 대로 4개의 속성을 사용합니다.

javaType 사용자 지정 요소는 다음 세 가지 방법으로 사용할 수 있습니다.

Apache CXF는 XML 스키마 기본 유형을 임의의 Java 클래스로 변환할 수 없습니다. javaType 요소를 사용하여 XML 스키마 기본 유형의 매핑을 사용자 지정할 때 코드 생성기는 사용자 지정된 XML 스키마 기본 유형을 마샬링하고 unmarshal하는 데 사용되는 어댑터 클래스를 만듭니다. 샘플 어댑터 클래스는 예 38.10. “CryostatB 어댑터 클래스” 에 표시됩니다.

public class Adapter1 extends XmlAdapter<String, javaType>
{
  public javaType unmarshal(String value)
  {
    return(parseMethod(value));
  }

  public String marshal(javaType value)
  {
    return(printMethod(value));
  }
}

parseMethod 및 printMethod 는 해당 parseMethod 속성 및 printMethod 속성 값으로 교체됩니다. 값은 유효한 Java 메서드를 식별해야 합니다. 다음 두 가지 방법 중 하나로 메서드의 이름을 지정할 수 있습니다.

parseMethod 특성에 대한 값이 제공되지 않으면 코드 생성기는 name 특성에 지정된 Java 클래스에 첫 번째 매개 변수가 Java String 개체인 생성자가 있다고 가정합니다. 생성된 어댑터의 unmarshal() 메서드는 가정된 생성자를 사용하여 Java 개체를 XML 데이터로 채웁니다.

printMethod 속성 값을 제공하지 않으면 코드 생성기는 name 특성에 지정된 Java 클래스에 toString() 메서드가 있다고 가정합니다. 생성된 어댑터의 marshal() 메서드는 가정된 toString() 메서드를 사용하여 Java 개체를 XML 데이터로 변환합니다.

javaType 요소의 name 속성이 Java 기본 유형 또는 Java 기본의 래퍼 유형 중 하나를 지정하는 경우 코드 생성기는 기본 변환기를 사용합니다. 기본 변환기에 대한 자세한 내용은 “기본 기본 유형 변환기” 을 참조하십시오.

“변환기 지정” 에서 언급했듯이 javaType 사용자 지정 요소를 사용하면 XML 스키마 기본 유형의 각 사용자 지정에 대해 하나의 어댑터 클래스 생성이 트리거됩니다. 어댑터는 패턴 AdapterN 을 사용하여 순서대로 지정됩니다. 두 개의 기본 유형 사용자 지정을 지정하면 코드 생성기는 Adapter1 및 Adapter2 의 두 가지 어댑터 클래스를 만듭니다.

XML 스키마 구성에 대해 생성된 코드는 영향을 받는 XML 스키마 구성이 전역적으로 정의된 요소인지 아니면 복잡한 유형의 일부로 정의되었는지에 따라 달라집니다.

XML 스키마 구성이 전역적으로 정의된 요소인 경우 유형에 대해 생성된 개체 팩토리 메서드는 다음과 같이 기본 메서드에서 수정됩니다.

예 38.11. “글로벌 요소를 위한 사용자 지정 오브젝트 Cryostat 방법” 예 38.7. “글로벌 우선순위 유형 사용자 정의” 에 표시된 사용자 지정의 영향을 받는 요소의 오브젝트 팩토리 메서드를 표시합니다.

 @XmlElementDecl(namespace = "http://widgetVendor.com/types/widgetTypes", name = "shorty")
 @XmlJavaTypeAdapter(org.w3._2001.xmlschema.Adapter1.class)
 public JAXBElement<Integer> createShorty(Integer value) {
     return new JAXBElement<Integer>(_Shorty_QNAME, Integer.class, null, value);
 }

XML 스키마 구성이 복잡한 유형의 일부로 정의되면 생성된 Java 속성은 다음과 같이 수정됩니다.

예 38.12. “사용자 정의 복잡한 유형” 예 38.7. “글로벌 우선순위 유형 사용자 정의” 에 표시된 사용자 지정의 영향을 받는 요소의 오브젝트 팩토리 메서드를 표시합니다.

public class NumInventory {

    @XmlElement(required = true, type = String.class) @XmlJavaTypeAdapter(Adapter1.class) @XmlSchemaType(name = "short") protected Integer numLeft;
    @XmlElement(required = true)
    protected String size;

    public Integer getNumLeft() {
        return numLeft;
    }

    public void setNumLeft(Integer value) {
        this.numLeft = value;
    }

    public String getSize() {
        return size;
    }

    public void setSize(String value) {
        this.size = value;
    }

}

Apache CXF 런타임은 parseMethod 속성 및 printMethod 특성에 지정된 메서드를 호출해야 한다는 점을 제외하고 javaType 요소에서 지정한 Java 클래스로 XML 기본 유형을 변환하는 방법을 알 수 없습니다. 런타임 호출을 수행하는 메서드의 구현을 제공해야 합니다. 구현된 메서드는 XML 기본 유형의 사전 구조로 작업할 수 있어야 합니다.

데이터 변환 방법 구현을 단순화하기 위해 Apache CXF는 javax.xml.bind.DatatypeConverter 클래스를 제공합니다. 이 클래스는 모든 XML 스키마 기본 유형을 구문 분석하고 출력하기 위한 메서드를 제공합니다. 구문 분석 메서드는 XML 데이터의 문자열 표현을 사용하고 표 34.1. “XML Schema Primitive Type to Java Native Type Mapping” 에 정의된 기본 유형의 인스턴스를 반환합니다. 출력 메서드는 기본 유형의 인스턴스를 사용하고 XML 데이터의 문자열 표현을 반환합니다.

DatatypeConverter 클래스에 대한 Java 문서는 https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/DatatypeConverter.html 에서 확인할 수 있습니다.

Java 기본 유형 또는 Java 기본 유형 Wrapper 클래스 중 하나를 지정할 때 javaType 요소의 name 속성에서 parseMethod 속성 또는 printMethod 특성에 대한 값을 지정할 필요가 없습니다. Apache CXF 런타임은 값이 제공되지 않는 경우 기본 변환기를 대체합니다.

기본 데이터 변환기는 CryostatB DatatypeConverter 클래스를 사용하여 XML 데이터를 구문 분석합니다. 기본 변환기는 변환 작업을 수행하는 데 필요한 모든 유형을 캐스팅합니다.