JAXB中处理泛型集合

        假设一种场景，我们要从面向对象的角度描绘地球、国家、省、市。一般性的思维是：地球上有很多国家（earth对象中有一个countries的泛型集合）,每个国家有很多的省（country对象中有一个provinces的泛型集合），城市，同理。

        在上篇JAXB中，描述了怎么映射诸如数值、字符串等类型的字段，如果需要映射集合类型，我们可以使用@XmlElementWrapper注解。它为数组元素或集合元素定义一个父节点。如，类中有一元素为Vector items，若不加此注解，该元素将被映射为
    <items>...</items>

    <items>...</items>

       这种形式，此注解可将这个元素进行包装，如：

      @XmlElementWrapper(name="items")
      @XmlElement(name="item")
      public Vector<E> getItems(){

             return items;

       }
      将会生成这样的XML样式：

      <items>

        <item>...</item>

        <item>...</item>

      </items>

      对于文章开头的问题，现在给出其实现代码。

代码一

import java.util.Vector;

import javax.xml.bind.annotation.XmlAttribute;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlElementWrapper;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="earth")

public class Earth {

    private String description="earth";

    private Vector<Country> countries;

    @XmlAttribute

    public String getDescription() {

       return description;

    }

    public void setDescription(String description) {

       this.description = description;

    }

    @XmlElementWrapper(name="countrys")

    @XmlElement(name="country")

    public Vector<Country> getCountries() {

       return countries;

    }

    public void setCountries(Vector<Country> countries) {

       this.countries = countries;

    }

}

代码二：

import java.util.Vector;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlElementWrapper;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="country")

public class Country {

    private String description;

    private String name;

    private Vector<Province> provinces;

    @XmlElement

    public String getName() {

       return name;

    }

    public void setName(String name) {

       this.name = name;

    }

    @XmlElement

    public String getDescription() {

       return description;

    }

    public void setDescription(String description) {

       this.description = description;

    }

    @XmlElementWrapper(name="provinces")

    @XmlElement(name="province")//如果provice对象中没有集合或者数组类型的属性了，该注解可以省略。否则，它是必须的。

    public Vector<Province> getProvinces() {

       return provinces;

    }

    public void setProvinces(Vector<Province> provinces) {

       this.provinces = provinces;

    }

}

代码三：

import java.util.Vector;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlElementWrapper;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="province")

public class Province {

    private String name;

    private Vector<City> cities;

    @XmlElementWrapper(name="cities")

    @XmlElement(name="city")

    public Vector<City> getCities() {

       return cities;

    }

    public void setCities(Vector<City> cities) {

       this.cities = cities;

    }

    @XmlElement()

    public String getName() {

       return name;

    }

    public void setName(String name) {

       this.name = name;

    }

}

代码四：

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="city")

public class City {

    private String name;

    @XmlElement

    public String getName() {

       return name;

    }

    public void setName(String name) {

       this.name = name;

    }

}

好了，现在可以测试了。关键代码如下：

      City zhengzhou=new City();

       City jinan=new City();

       zhengzhou.setName("郑州");

       jinan.setName("济南");

      

       Province henan=new Province();

       henan.setName("河南");

       Vector<City> henanCity=new Vector<City>();

       henanCity.add(zhengzhou);

       henan.setCities(henanCity);

       Province shandong=new Province();

       shandong.setName("山东");

       Vector<City> sdCity=new Vector<City>();

       sdCity.add(zhengzhou);

       henan.setCities(sdCity);

      

       Country country=new Country();

       country.setDescription("这里是天朝");

       country.setName("中国");

       Vector<Province> provinces=new Vector<Province>();

       provinces.add(henan);

       provinces.add(shandong);

       country.setProvinces(provinces);

      

       Earth earth=new Earth();

       earth.setDescription("地球...");

       Vector<Country> countrys=new Vector<Country>();

       countrys.add(country);

       earth.setCountries(countrys);

      

       FileOutputStream outPut=null;

       try { 

           outPut=new FileOutputStream("earth.xml");

           JAXBContext jc=JAXBContext.newInstance(Earth.class);

           Marshaller m=jc.createMarshaller();

           m.marshal(earth, outPut);

       } catch(Exception e){

           e.printStackTrace();

       }

       finally { 

           try { 

              outPut.close(); 

           } catch (IOException e) { 

           } 

      其实编组、解组都不复杂，JAXB都可以帮我们完成，我们需要掌握一些注解，来告诉JAXB——你按照什么形式将我的Java Class转换成XML文件，下面是一些常用的注解：

@XmlRootElement   将一个Java类映射为一段XML的根节点

参数：name            定义这个根节点的名称

          namespace   定义这个根节点命名空间



@XmlAccessorType  定义映射这个类中的何种类型需要映射到XML。可接收四个参数，分别是：

      XmlAccessType.FIELD：映射这个类中的所有字段到XML

      XmlAccessType.PROPERTY：映射这个类中的属性（get/set方法）到XML

      XmlAccessType.PUBLIC_MEMBER：将这个类中的所有public的field或property同时映射到XML（默认）

      XmlAccessType.NONE：不映射



@XmlElement  指定一个字段或get/set方法映射到XML的节点。如，当一个类的XmlAccessorType 被标注为PROPERTY时，在某一个没有get/set方法的字段上标注此注解，即可将该字段映射到XML。

参数：defaultValue  指定节点默认值

         name             指定节点名称

         namespace    指定节点命名空间

         required         是否必须（默认为false）

         nillable           该字段是否包含 nillable="true" 属性（默认为false）

         type               定义该字段或属性的关联类型



@XmlAttribute  指定一个字段或get/set方法映射到XML的属性。

参数：name             指定属性名称

         namespace    指定属性命名空间

         required         是否必须（默认为false）



@XmlTransient  定义某一字段或属性不需要被映射为XML。如，当一个类的XmlAccessorType 被标注为PROPERTY时，在某一get/set方法的字段上标注此注解，那么该属性则不会被映射。



@XmlType 定义映射的一些相关规则

参数：propOrder        指定映射XML时的节点顺序

         factoryClass     指定UnMarshal时生成映射类实例所需的工厂类，默认为这个类本身

         factoryMethod  指定工厂类的工厂方法

         name               定义XML Schema中type的名称

         namespace      指定Schema中的命名空间



@XmlJavaTypeAdapter  自定义某一字段或属性映射到XML的适配器。如，类中包含一个接口，我们可以定义一个适配器（继承自 javax.xml.bind.annotation.adapters.XmlAdapter类），指定这个接口如何映射到XML。



@XmlSchema 配置整个包的namespace，这个注解需放在package-info.java文件中。

jaxb编码：

           JAXBContext jaxbContext = JAXBContext.newInstance(clazz);
            Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
            InputStreamReader reader=new InputStreamReader(inputStream,"GBK");   //在此修改编码
            return unmarshaller.unmarshal(reader);