xml映射为java对象

来源:互联网 发布:mac移除应用 编辑:程序博客网 时间:2024/06/04 17:49

转载自:http://blog.csdn.net/u012228718/article/details/40299723

前言:

1、两套标准:Jax-ws(web service)和 Jax-rs(restful)。

2、在Java EE 5\6中,jaxb可以很方便的与jax-rs、jax-ws集成,极大的简化了web service接口的开发工作量。jaxb负责xml与javaBean的映射。

3、cxf等架构的使用,ws中不需要手动写映射,而restfu则需要手动书写注解。(也可以使用JAXB的XJC工具,通过定义schema的方式实现Java对象与XML的绑定)。

4、jaxb除了在ws与restful中广泛使用,也可以作为解析xml的一种日常技术。


一、web service中的jaxb

1、在使用cxf的客户端时,一般使用 wsdl2java 命令生成,所以不需要自己写jaxb的代码。如: 

[java] view plain copy
  1. @XmlAccessorType(XmlAccessType.FIELD)  
  2. @XmlType(name = "cat", propOrder = {  
  3.     "color",  
  4.     "id",  
  5.     "name"  
  6. })  
  7. public class Cat {  
  8.   
  9.     protected String color;  
  10.     protected Integer id;  
  11.     protected String name;  
  12. //......  
  13. }  

2、其实这边映射的就是 soap消息,与访问的 wsdl 具有一致性。


二、jaxb详解。

(一)实例

1、javaBean实例:

[java] view plain copy
  1. package cn.rest.bean;  
  2.   
  3. import java.util.List;  
  4.   
  5. import javax.xml.bind.annotation.XmlAttribute;  
  6. import javax.xml.bind.annotation.XmlElement;  
  7. import javax.xml.bind.annotation.XmlElementWrapper;  
  8. import javax.xml.bind.annotation.XmlRootElement;  
  9.   
  10. /** 
  11.  *  
  12.  * UserBean.java 
  13.  * 
  14.  * @title User的传输数据类 
  15.  * @description 
  16.  * @author SAM-SHO  
  17.  * @Date 2014-11-25 
  18.  */  
  19.   
  20. @XmlRootElement(name = "USER")  
  21. //@XmlAccessorType(XmlAccessType.FIELD ) //写这个注解,就不需要@XmlElement注解,一般和XmlType一起使用,指定名称。  
  22. //@XmlType(propOrder = { "name", "age" ,"userAddress","phoneList"})  
  23. public class UserBean {  
  24.     private String name;  
  25.     private String key;  
  26.     private String age;  
  27.     private UserAddress userAddress;//地址  
  28.     private List<UserPhone> phoneList ;//手机  
  29.   
  30.     @XmlElement(name="NAME")  
  31.     public String getName() {  
  32.         return name;  
  33.     }  
  34.   
  35.     public void setName(String name) {  
  36.         this.name = name;  
  37.     }  
  38.   
  39.     @XmlElement(name = "AGE")  
  40.     public String getAge() {  
  41.         return age;  
  42.     }  
  43.   
  44.     public void setAge(String age) {  
  45.         this.age = age;  
  46.     }  
  47.   
  48.     @XmlElement(name = "UserAddress")  
  49.     public UserAddress getUserAddress() {  
  50.         return userAddress;  
  51.     }  
  52.   
  53.     public void setUserAddress(UserAddress userAddress) {  
  54.         this.userAddress = userAddress;  
  55.     }  
  56.   
  57.     @XmlElementWrapper(name = "PhoneList")//标注集合  
  58.     @XmlElement(name = "UserPhone")  
  59.     public List<UserPhone> getPhoneList() {  
  60.         return phoneList;  
  61.     }  
  62.   
  63.     public void setPhoneList(List<UserPhone> phoneList) {  
  64.         this.phoneList = phoneList;  
  65.     }  
  66.   
  67.     @XmlAttribute(name="key")//属性  
  68.     public String getKey() {  
  69.         return key;  
  70.     }  
  71.   
  72.     public void setKey(String key) {  
  73.         this.key = key;  
  74.     }  
  75.       
  76. }  
[java] view plain copy
  1. package cn.rest.bean;  
  2.   
  3. public class UserPhone {  
  4.       
  5.     private String type;//电话号码类型  
  6.     private String num;//电话号码  
  7.       
  8.     public String getType() {  
  9.         return type;  
  10.     }  
  11.     public void setType(String type) {  
  12.         this.type = type;  
  13.     }  
  14.     public String getNum() {  
  15.         return num;  
  16.     }  
  17.     public void setNum(String num) {  
  18.         this.num = num;  
  19.     }  
  20.       
  21. }  
[java] view plain copy
  1. package cn.rest.bean;  
  2.   
  3. import javax.xml.bind.annotation.XmlElement;  
  4.   
  5. public class UserAddress {  
  6.       
  7.     private String homeAddress;//家庭地址  
  8.     private String workAddress;//公司地址  
  9.       
  10.     @XmlElement(name = "HomeAddress")  
  11.     public String getHomeAddress() {  
  12.         return homeAddress;  
  13.     }  
  14.     public void setHomeAddress(String homeAddress) {  
  15.         this.homeAddress = homeAddress;  
  16.     }  
  17.   
  18.     @XmlElement(name = "WorkAddress")  
  19.     public String getWorkAddress() {  
  20.         return workAddress;  
  21.     }  
  22.     public void setWorkAddress(String workAddress) {  
  23.         this.workAddress = workAddress;  
  24.     }  
  25.   
  26. }  

2、解析工具。

1)javaBean 映射成 xml,使用 Marshaller 。

[java] view plain copy
  1. /** 
  2.  * Objext 转成 XML 
  3.  *  
  4.  * @param object 
  5.  */  
  6. public static void Object2Xml(Object object) {  
  7.     // FileWriter writer = null;  
  8.     try {  
  9.         JAXBContext context = JAXBContext.newInstance(object.getClass());  
  10.         Marshaller marshal = context.createMarshaller();  
  11.         marshal.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 格式化输出  
  12.         marshal.setProperty(Marshaller.JAXB_ENCODING, "utf-8");// 编码格式,默认为utf-8  
  13.         marshal.setProperty(Marshaller.JAXB_FRAGMENT, false);// 是否省略xml头信息  
  14.         marshal.marshal(object, System.out);  
  15.   
  16.         // writer = new FileWriter("shop.xml");  
  17.         // marshal.marshal(object, writer);  
  18.     } catch (Exception e) {  
  19.         e.printStackTrace();  
  20.     }  
  21. }  

2)xml 映射成 javaBean,使用 Unmarshaller 。

[java] view plain copy
  1. /** 
  2.  * xml 转成特定的Bean 
  3.  *  
  4.  * @param xml 
  5.  * @return 
  6.  */  
  7. public static UserBean parseXml2UserBean(String xml) {  
  8.     try {  
  9.         JAXBContext context = JAXBContext.newInstance(UserBean.class);  
  10.         InputSource is = new InputSource();  
  11.         StringReader xmlStr = new StringReader(xml);  
  12.         is.setCharacterStream(xmlStr);  
  13.         Unmarshaller unmarshaller = context.createUnmarshaller();  
  14.         UserBean user = (UserBean) unmarshaller.unmarshal(is);  
  15.         return user;  
  16.   
  17.     } catch (JAXBException e) {  
  18.         e.printStackTrace();  
  19.         return null;  
  20.     }  
  21. }  

3)测试:

[java] view plain copy
  1. UserBean tUserBean = new UserBean();  
  2. tUserBean.setName("SAM-SHO");  
  3. tUserBean.setAge("27");  
  4. tUserBean.setKey("属性111");  
  5.   
  6. UserAddress tUserAddress = new UserAddress();  
  7. tUserAddress.setWorkAddress("苏州园区");  
  8. tUserAddress.setHomeAddress("苏州高新区");  
  9. tUserBean.setUserAddress(tUserAddress);  
  10.   
  11. List<UserPhone> phoneList = new ArrayList<UserPhone>();  
  12. UserPhone tUserPhone = new UserPhone();  
  13. tUserPhone.setType("移动");  
  14. tUserPhone.setNum("13612345678");  
  15. phoneList.add(tUserPhone);  
  16.   
  17. tUserPhone = new UserPhone();  
  18. tUserPhone.setType("联通");  
  19. tUserPhone.setNum("13798765432");  
  20. phoneList.add(tUserPhone);  
  21. tUserBean.setPhoneList(phoneList);  
  22.   
  23. ObjectAndXmlHandle.Object2Xml(tUserBean);  

【输出】

[html] view plain copy
  1. <?xml version="1.0" encoding="utf-8" standalone="yes"?>  
  2. <USER key="属性111">  
  3.     <AGE>27</AGE>  
  4.     <NAME>SAM-SHO</NAME>  
  5.     <PhoneList>  
  6.         <UserPhone>  
  7.             <num>13612345678</num>  
  8.             <type>移动</type>  
  9.         </UserPhone>  
  10.         <UserPhone>  
  11.             <num>13798765432</num>  
  12.             <type>联通</type>  
  13.         </UserPhone>  
  14.     </PhoneList>  
  15.     <UserAddress>  
  16.         <HomeAddress>苏州高新区</HomeAddress>  
  17.         <WorkAddress>苏州园区</WorkAddress>  
  18.     </UserAddress>  
  19. </USER>  



(二)jaxb 注解详解:

1、@XmlRootElement   将一个Java类映射为一段XML的根节点。参数:

name            定义这个根节点的名称

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


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

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

XmlAccessType.PROPERTY:映射这个类中的属性(get/set方法)到XML

XmlAccessType.PUBLIC_MEMBER:将这个类中的所有public的field或property同时映射到XML(默认)

XmlAccessType.NONE:不映射


3、@XmlElement  指定一个字段或get/set方法映射到XML的节点。如,当一个类的XmlAccessorType 被标注为

PROPERTY时,在某一个没有get/set方法的字段上标注此注解,即可将该字段映射到XML。参数:

defaultValue  指定节点默认值

         name             指定节点名称

         namespace    指定节点命名空间

         required         是否必须(默认为false)

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

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


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

name             指定属性名称

         namespace    指定属性命名空间

         required         是否必须(默认为false)



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


6、@XmlType 定义映射的一些相关规则。参数:

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

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

factoryMethod  指定工厂类的工厂方法

name               定义XML Schema中type的名称

namespace      指定Schema中的命名空间


7、@XmlElementWrapper  为数组元素或集合元素定义一个父节点。如,类中有一元素为List items,若不加此注解,该元素将被映射为
[java] view plain copy
  1. <items>...</items>  
  2.   
  3.   
  4. <items>...</items>  

这种形式,此注解可将这个元素进行包装,如:
[java] view plain copy
  1. @XmlElementWrapper(name="items")  
  2. @XmlElement(name="item")  
  3. public List items;  

将会生成这样的XML样式:

[html] view plain copy
  1. <items>  
  2.     <item>...</item>  
  3.     <item>...</item>  
  4. </items>  

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

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

原创粉丝点击