javax.xml.bind.annotation

Annotation Type XmlElementWrapper

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

围绕XML表示生成一个包装元素。这主要是用于在集合中生成一个包装器XML元素。因此，注释支持如下所示的两种形式的序列化。

/ /例如：代码片段int []的名字；/ / XML序列化形式1（打开收集）
 
        
        
        
      
        
      <名称>
       
         
       
         
         
         
  …< /名称>
  
         
         
         
       
         
       <名称>
         …< /名称>╱序列化形式2（包集合）wrapperelement > < 
        <名称>
          项目 
         <名称>
           >的值> 
          <名称>
            项目 
           <名称>
             >的值>的…< / wrapperelement > 
            
           
          
         
       
 
        
        
        
      
        
      

两序列化的XML形式允许空集合来表示的元素与nillable属性的存在或不存在。

使用

的@XmlElementWrapper注释可以用下面的程序元素：

• JavaBean属性
• 非静态的，非瞬态场

使用是受以下约束：

• 属性必须是一个集合属性
• 这个注释可以用下面的注释：XmlElement，XmlElements，XmlElementRef，XmlElementRefs，XmlJavaTypeAdapter。

看到“包装规范”的额外的信息共享javax.xml.bind.package javadoc。

从以下版本开始：

jaxb2.0

另请参见：

XmlElement， XmlElements， XmlElementRef， XmlElementRefs

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	name XML包装器元素的名称。
String	namespace XML包装器元素的XML目标命名空间。
boolean	nillable 如果真的没有，收集利用 xsi:nil='true'代表。
boolean	required 自定义要需要的包装元素声明。

Element Detail

name

public abstract String name

XML包装器元素的名称。默认情况下，XML包装的元素的名称是从JavaBean的属性名称。

Default:

“# #默认”

namespace

public abstract String namespace

XML包装器元素的XML目标命名空间。

如果值是“# #默认的命名空间，然后“确定如下：

1. 如果封闭的包装XmlSchema注释，其elementFormDefault是QUALIFIED，然后外围类的命名空间。
2. 否则“（在默认命名空间中产生不合格的元素”。

Default:

“# #默认”

nillable

public abstract boolean nillable

如果真的没有，收集利用 xsi:nil='true'表示。否则，它是通过元素的缺失表现。

Default:

假

required

public abstract boolean required

自定义要需要的包装元素声明。

如果required()是真的，然后生成相应的XML架构元素声明将有minOccurs="1"，表明包装的元素总是期望。

请注意，这仅影响架构生成，而不是反或编组能力。这只是一个机制，让用户更好地表达他们的应用约束。

从以下版本开始：

JAXB 2.1

Default:

假