javax.xml.bind.annotation
주석형 XmlList

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

프로퍼티을 리스트 단순형에 맵 하기 위해서 사용됩니다.

사용법

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

• JavaBean 프로퍼티
• 필드

컬렉션 프로퍼티이 @XmlElement 만으로 주석 되고 있는 경우, 컬렉션내의 각 항목이 1 개의 요소에 의해 랩 됩니다. 다음에 예를 나타냅니다.

 @XmlRootElement 
 class Foo {
     @XmlElement
     List<String> data;
 }
 

이 경우, 다음과 같은 XML 가 생성됩니다.

 <foo>
   <data>abc</data>
   <data>def</data>
 </foo>
 

한편, @XmlList 주석을 사용했을 경우, 단일의 요소내에서 공백에서 단락지어진 토큰으로서 복수의 값을 표현할 수 있습니다. 다음에 예를 나타냅니다.

 @XmlRootElement 
 class Foo {
     @XmlElement
     @XmlList
     List<String> data;
 }
 

상기의 코드에서는, 다음과 같은 XML 가 생성됩니다.

 <foo>
   <data>abc def</data>
 </foo>
 

이 주석은, 다음의 주석과 함께 사용할 수 있습니다. XmlElement ,XmlAttribute ,XmlValue ,XmlIDREF .

• @XmlList 를 XmlValue 와 함께 사용하는 것 (이것이 가능한 경우)는 장황합니다. XmlList 는,XmlValue 와 같게, 리스트로부터 파생한 단순 schema형에 컬렉션형을 맵 하기 (위해)때문에입니다.
• @XmlList 를 XmlAttribute 와와 함께 사용하는 것 (이것이 가능한 경우)는 장황합니다. XmlList 는,XmlAttribute 와 같게, 리스트로부터 파생한 단순 schema형에 컬렉션형을 맵 하기 (위해)때문에입니다.

도입된 버젼:

JAXB2. 0