javax.xml.bind.annotation
주석형 XmlElementWrapper

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

XML 표현에 관련되는 래퍼 요소를 생성합니다. 이것은 주로, 컬렉션에 관련되는 래퍼 XML 요소를 생성하기 위해서 사용되는 것을 의도하고 있습니다. 그 때문에, 이 주석은, 이하의 2 개의 형식의 직렬화를 지원하고 있습니다.

    //Example:code fragment
      int[] names;

    // XML Serialization Form 1 (Unwrapped collection)
    <names> ...</names>
    <names> ...</names>
 
    // XML Serialization Form 2 ( Wrapped collection )
    <wrapperElement>
       <names> value-of-item </names>
       <names> value-of-item </names>
       ....
    </wrapperElement>
 

이 2 개의 직렬화 된 XML 형식에서는, nillable 속성을 수반하는 요소의 유무에 의해, null 컬렉션을 표현할 수 있습니다.

사용법

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

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

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

• 프로퍼티은, 컬렉션 프로퍼티이 아니면 안됩니다.
• 이 주석은, 다음의 주석과 함께 사용할 수 있습니다. XmlElement ,XmlElements ,XmlElementRef ,XmlElementRefs ,XmlJavaTypeAdapter .

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

도입된 버젼:

JAXB2. 0

관련 항목:

XmlElement , XmlElements , XmlElementRef , XmlElementRefs

임의 요소의 개요

String	name XML 래퍼 요소의 이름입니다.
String	namespace XML 래퍼 요소의 XML 타겟 이름 공간입니다.
boolean	nillable true 의 경우,xsi:nil='true' 를 사용하는 것에 의해, 컬렉션의 부재가 표현됩니다.

name

public abstract String  name

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

디폴트:

"##default"

namespace

public abstract String  namespace

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

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

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

디폴트:

"##default"

nillable

public abstract boolean nillable

true 의 경우,xsi:nil='true' 를 사용하는 것에 의해, 컬렉션의 부재가 표현됩니다. 그렇지 않은 경우, 이 요소가 없는 것에 따라 표현됩니다.

디폴트:

false