javax.xml.bind.annotation
주석형 XmlAttribute

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

JavaBean 프로퍼티을 XML 속성에 맵 합니다.

사용법

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

• JavaBean 프로퍼티
• 필드

static final 필드는, XML 고정 속성에 맵 됩니다.

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

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

• 필드 또는 프로퍼티의 형태가 컬렉션형의 경우, 컬렉션 항목의 형태가 schema 단순형에 맵 되지 않으면 안됩니다.

       // Examples
       @XmlAttribute List<Integer> items; //legal
       @XmlAttribute List<Bar> foo; // illegal if Bar does not map to a schema simple type
   

• 필드 또는 프로퍼티의 형태가 컬렉션형이 아닌 경우, 그 프로퍼티 또는 필드의 형태가 단순 schema형에 맵 되지 않으면 안됩니다.

       // Examples
       @XmlAttribute int foo; // legal
       @XmlAttribute Foo foo; // illegal if Foo does not map to a schema simple type
   

• 이 주석은, 다음의 주석과 함께 사용할 수 있습니다. XmlID ,XmlIDREF ,XmlList ,XmlSchemaType ,XmlValue ,XmlAttachmentRef ,XmlMimeType ,XmlInlineBinaryData ,XmlJavaTypeAdapter .
.

예 1: JavaBean 프로퍼티을 XML 속성에 맵 합니다.

     //Example:Code fragment
     public class USPrice {
         @XmlAttribute
         public java.math.BigDecimal getPrice() {...} ;
         public void setPrice(java.math.BigDecimal ) {...};
     }

     <! -- Example:XML Schema fragment -->
     <xs:complexType name="USPrice">
       <xs:sequence>
       </xs:sequence>
       <xs:attribute name="price" type="xs:decimal"/>
     </xs:complexType>
 

예 2: JavaBean 프로퍼티을, 익명형을 사용한 XML 속성에 맵 합니다.

@XmlType 의 예 7 을 참조해 주세요.

예 3: JavaBean 컬렉션 프로퍼티을 XML 속성에 맵 합니다.

     // Example: Code fragment
     class Foo {
         ...
         @XmlAttribute List<Integer> items;
     }

     <! -- Example: XML Schema fragment -->
     <xs:complexType name="foo">
         ...
       <xs:attribute name="items">
         <xs:simpleType>
           <xs:list itemType="xs:int"/>
         </xs:simpleType>
     </xs:complexType>

 

도입된 버젼:

JAXB2. 0

관련 항목:

XmlType

임의 요소의 개요

String	name XML schema 속성의 이름입니다.
String	namespace XML Schema 속성의 XML 타겟 이름 공간을 지정합니다.
boolean	required XML Schema 속성이 생략 가능한가 필수인지를 지정합니다.

name

public abstract String  name

XML schema 속성의 이름입니다. 디폴트에서는, XML schema 속성명은, JavaBean 프로퍼티명으로부터 파생합니다.

디폴트:

"##default"

required

public abstract boolean required

XML Schema 속성이 생략 가능한가 필수인지를 지정합니다. true 의 경우, JavaBean 프로퍼티은, 필수의 XML Schema 속성에 맵 됩니다. true 가 아닌 경우, 생략 가능한 XML Schema 속성에 맵 됩니다.

디폴트:

false

namespace

public abstract String  namespace

XML Schema 속성의 XML 타겟 이름 공간을 지정합니다.

디폴트:

"##default"