javax.xml.bind.annotation
주석형 XmlEnumValue

@Retention (value =RUNTIME )
@Target (value =FIELD )
public @interface XmlEnumValue

Enum 형의 enum 정수를 XML 표현에 맵 합니다.

사용법

@XmlEnumValue 주석은, 다음의 프로그램 요소로 사용할 수 있습니다.

• enum 정수

추가의 일반적인 정보에 대해서는, javax.xml.bind.package javadoc 의 「패키지의 스펙」을 참조해 주세요.

이 주석을 XmlEnum 와 함께 사용하는 것으로써, 열거형을 XML 표현에 매핑 할 수 있습니다.

열거형은, 열거 파셋트를 가지는 schema 단순형에 맵 됩니다. schema형은,@XmlEnum.value() 로 지정된 Java 형으로부터 파생합니다. 각 enum 정수 @XmlEnumValue 에는,@XmlEnum.value() 형에 대한 유효한 자구 표현이 필요하게 됩니다.

이 주석이 없는 경우,Enum.name() 는 XML 표현으로서 사용됩니다.

예 1:enum 정수명 -> 열거 파셋트의 맵

     //Example:Code fragment
     @XmlEnum(String.class)
     public enum Card { CLUBS, DIAMONDS, HEARTS, SPADES }

     <! -- Example:XML Schema fragment -->
     <xs:simpleType name="Card">
       <xs:restriction base="xs:string"/>
         <xs:enumeration value="CLUBS"/>
         <xs:enumeration value="DIAMONDS"/>
         <xs:enumeration value="HEARTS"/>
         <xs:enumeration value="SPADES"/>
     </xs:simpleType>
 

예 2:enum 정수명 (값) -> 열거 파셋트의 맵

     //Example:code fragment
     @XmlType
     @XmlEnum(Integer.class)
     public enum Coin { 
         @XmlEnumValue("1") PENNY(1),
         @XmlEnumValue("5") NICKEL(5),
         @XmlEnumValue("10") DIME(10),
         @XmlEnumValue("25") QUARTER(25) }

     <! -- Example:XML Schema fragment -->
     <xs:simpleType name="Coin">
       <xs:restriction base="xs:int">
         <xs:enumeration value="1"/>
         <xs:enumeration value="5"/>
         <xs:enumeration value="10"/>
         <xs:enumeration value="25"/>
       </xs:restriction>
     </xs:simpleType>
 

예 3:enum 정수명 -> 열거 파셋트의 맵

     //Code fragment
     @XmlType
     @XmlEnum(Integer.class)
     public enum Code {
         @XmlEnumValue("1") ONE,
         @XmlEnumValue("2") TWO;
     }
 
     <! -- Example:XML Schema fragment -->
     <xs:simpleType name="Code">
       <xs:restriction base="xs:int">
         <xs:enumeration value="1"/>
         <xs:enumeration value="2"/>
       </xs:restriction>
     </xs:simpleType>
 

도입된 버젼:

JAXB 2.0

필수 요소의 개요

String

value

요소의 상세

value

public abstract String  value