javax.xml.bind.annotation
주석형 XmlElement

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

JavaBean 프로퍼티을, 프로퍼티명으로부터 파생한 XML 요소에 맵 합니다.

사용법

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

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

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

• 이 주석은, 다음의 주석과 함께 사용할 수 있는：XmlID ,XmlIDREF ,XmlList ,XmlSchemaType ,XmlValue ,XmlAttachmentRef ,XmlMimeType ,XmlInlineBinaryData ,XmlElementWrapper ,XmlJavaTypeAdapter
• JavaBean 프로퍼티의 형태가 배열 컬렉션형, 인덱스 첨부 프로퍼티, 또는 파라미터화 리스트이며, 이 주석이 XmlElements 와 함께 사용되었을 경우, 컬렉션 항목형이 기존이기 (위해)때문에,@XmlElement.type() 가 DEFAULT.class 가 아니면 안됩니다.

@XmlElement 으로 주석 된 JavaBean 프로퍼티은, 그것을 포함한 클래스가 맵 되는 XML Schema 복합형의 로컬 요소에 맵 됩니다.

예 1: public 의 비 static 비 final 필드를 로컬 요소에 맵 합니다.

     //Example: Code fragment
     public class USPrice {
         @XmlElement(name="itemprice")
         public java.math.BigDecimal price;
     }

     <! -- Example: Local XML Schema element -->
     <xs:complexType name="USPrice"/>
       <xs:sequence>
         <xs:element name="itemprice" type="xs:decimal" minOccurs="0"/>
       </sequence>
     </xs:complexType>
   

예 2: 필드를 nillable 요소에 맵 합니다.

     //Example: Code fragment
     public class USPrice {
         @XmlElement(nillable=true)
         public java.math.BigDecimal price;
     }

     <! -- Example: Local XML Schema element -->
     <xs:complexType name="USPrice">
       <xs:sequence>
         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs
="0"/>
       </sequence>
     </xs:complexType>
   

예 3: 필드를 nillable, required 요소에 맵 합니다.

     //Example: Code fragment
     public class USPrice {
         @XmlElement(nillable=true, required=true)
         public java.math.BigDecimal price;
     }

     <! -- Example: Local XML Schema element -->
     <xs:complexType name="USPrice">
       <xs:sequence>
         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs ="1"/>
       </sequence>
     </xs:complexType>
   

예 4: 익명형을 사용해, JavaBean 프로퍼티을 XML 요소에 맵 합니다.

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

도입된 버젼:

JAXB2. 0

임의 요소의 개요

String	defaultValue 이 요소의 디폴트 값입니다.
String	name XML schema 요소의 이름입니다.
String	namespace XML Schema 요소의 XML 타겟 이름 공간입니다.
boolean	nillable 요소 선언을 커스터마이즈 해 nillable 로 합니다.
boolean	required 요소 선언을 커스터마이즈 해 required 로 합니다.
Class	type 참조되는 Java 클래스입니다.

name

public abstract String  name

XML schema 요소의 이름입니다.

값이 「##default」의 경우, 요소명은 JavaBean 프로퍼티명으로부터 파생합니다.

디폴트:

"##default"

nillable

public abstract boolean nillable

요소 선언을 커스터마이즈 해 nillable 로 합니다.

nillable()가 true 의 경우, JavaBean 프로퍼티은 XML Schema nillable 요소 선언에 맵 됩니다.

디폴트:

false

required

public abstract boolean required

요소 선언을 커스터마이즈 해 required 로 합니다.

required()가 true 의 경우, JavaBean 프로퍼티은, 「minOccurs="1"」의 XML Schema 요소 선언에 맵 됩니다. maxOccurs 는, 단일치의 프로퍼티의 경우는 「1」, 복수치의 프로퍼티의 경우는 「unbounded」입니다.

required()가 false 의 경우, JavaBean 프로퍼티은, 「minOccurs="0"」의 XML Schema 요소 선언에 맵 됩니다. maxOccurs 는, 단일치의 프로퍼티의 경우는 「1」, 복수치의 프로퍼티의 경우는 「unbounded」입니다.

디폴트:

false

namespace

public abstract String  namespace

XML Schema 요소의 XML 타겟 이름 공간입니다.

값이 「##default」의 경우, 이름 공간은 다음과 같이 결정됩니다.

1. 포함 하고 있는 패키지에 XmlSchema 주석이 있어, 그것의 elementFormDefault 가 QUALIFIED 의 경우, 그 포함 하는 클래스의 이름 공간.
2. 그 이외의 경우, 「」(이것은, 디폴트 이름 공간에 비수식 요소를 생성합니다).

디폴트:

"##default"

defaultValue

public abstract String  defaultValue

이 요소의 디폴트 값입니다.

이 주석 요소의 디폴트로서 지정되고 있는 「」값은, null 대신에 사용해 구현이 비디폴트 값 상태를 인식할 수 있도록(듯이) 하는 경제적인 대체품입니다.

디폴트:

"\u0000"

type

public abstract Class  type

참조되는 Java 클래스입니다.

디폴트:

javax.xml.bind.annotation.XmlElement.DEFAULT.class