javax.xml.bind.annotation
주석형 XmlValue

@Retention (value =RUNTIME )
@Target (value ={FIELD ,METHOD })
public @interface XmlValue

simpleContent 를 포함한 XML Schema 복합형, 또는 XML Schema 단순형에의 클래스의 매핑을 가능하게 합니다.

사용법:

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

• JavaBean 프로퍼티.
• static 가 아닌 비일시 필드.

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

사용에는 다음의 사용상의 제약이 있습니다.

• @XmlValue 주석을 지정할 수 있는 것은, 최대 1 개의 필드 또는 프로퍼티입니다.
• @XmlValue 는, 다음의 주석과 함께 사용할 수 있습니다(XmlList ). 그러나,XmlValue 와 같이,XmlList 는 리스트에 의해 파생한 단순 schema형에 형태를 맵 하기 위한(해), 이것은 장황합니다.
• 필드 또는 프로퍼티의 형태가 컬렉션형의 경우, 컬렉션 항목의 형태가 단순 schema형에 맵 되지 않으면 안됩니다.
• 필드 또는 프로퍼티의 형태가 컬렉션형 이외의 경우, 그 형태가 XML schema 단순형에 맵 되지 않으면 안됩니다.

주석 된 JavaBean 프로퍼티이 XML Schema 작성에 맵 되는 유일한 클래스 멤버인 경우, 클래스는 단순형에 맵 됩니다. XML 속성에 맵 되는 다른 JavaBean 프로퍼티 (@XmlValue 로 주석 된 JavaBean 프로퍼티 이외)이 있는 경우, 클래스는 simpleContent 를 포함한 복합형에 맵 됩니다.

예 1: XML Schema simpleType 에의 클래스의 매핑

 
     // Example 1:Code fragment
     public class USPrice {
         @XmlValue
         public java.math.BigDecimal price;
     }
  
     <! -- Example 1:XML Schema fragment -->
     <xs:simpleType name="USPrice">
       <xs:restriction base="xs:decimal"/>
     </xs:simpleType>

   

예 2: simpleContent 를 포함한 XML Schema complexType 에의 클래스의 매핑

   // Example 2:Code fragment
   public class InternationalPrice {
       @XmlValue
       public java.math.BigDecimal price;
 
       @XmlAttribute
       public String currency;
   }
  
   <! -- Example 2:XML Schema fragment -->
   <xs:complexType name="InternationalPrice">
     <xs:simpleContent>
       <xs:extension base="xs:decimal">
         <xs:element name="name" type="xs:string"/>
       </xs:extension>
     </xs:simpleContent>
   </xs:complexType>

   

도입된 버젼:

JAXB2. 0

관련 항목:

XmlType