JAXB2简介及特性使用总结

一、简介

1、概念是什么：（Java Architecture for XML Binding) 是一个业界的标准，是一项可以根据XML Schema产生Java类的技术。是一种xml与object映射绑定技术标准，既然是标准就可以有不同实现.
2、JAXB中有什么：包含“xjc”工具和一个“schemagen”工具。
“xjc”工具可以用来将XML模式或其他类型模式文件（Java 1.6试验性地支持RELAX NG，DTD以及WSDL）转换为Java类。Java类使用javax.xml.bind.annotation包下的Java 标注，例如@XmlRootElement和@XmlElement。XML列表序列表示为java.util.List类型的属性， 通过JAXBContext可以创建Marshallers（将Java对象转换成XML）和Unmarshallers（将XML解析为Java对象）。 另外的“schemagen”工具，能够执行“xjc”的反向操作，通过一组标注的Java类创建一个XML模式。

二、JDK5以下开发需要的jar包：activation.jar、jaxb-api.jar、 jaxb-impl.jar、 jsr173-api.jar; 如果是基于JDK6以上版本已经集成JAXB2的JAR，在目录{JDK_HOME}/jre/lib/rt.jar中。



三、标注相关
注意：
1、注解可在属性定义上，也可在getter()方法上，最好在方法上注解，修饰属性用private，方法是public，属性注解可能会出现问题（如：JAXB “Class has two properties of the same name”）。

2、对象中的属性可以不全部映射到xml中，xml中出现的元素也不一定与映射的实体一一对应，映射的双方可以灵活对应

3、类上注解后，类中元素也默认按默认名称映射，但是对象属性名称与xml节点元素名称不一致时或者不需要显示在xml节点中时，则必须做对应的映射配置。

4、注解实例：映射一般分分：类名与xml根节点的映射、普通属性与xml节点的映射、集合与xml中包含子元素的节点的映射。


/**
*转换为xml的实体类
*/
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

//类注解，一个类最多可以有一个根元素
@XmlRootElement(name="Property")
public class Property {

private String sequence;
private Integer styleId;
private String elementName;
private String entityField;

//普通属性
@XmlElement
public String getSequence() {
return sequence;
}
public void setSequence(String sequence) {
this.sequence = sequence;
}
@XmlElement
public Integer getStyleId() {
return styleId;
}
public void setStyleId(Integer styleId) {
this.styleId = styleId;
}
@XmlElement
public String getElementName() {
return elementName;
}
public void setElementName(String elementName) {
this.elementName = elementName;
}
@XmlElement
public String getEntityField() {
return entityField;
}
public void setEntityField(String entityField) {
this.entityField = entityField;
}
}


/**
*包含上面对象实体的类
*/
import java.util.ArrayList;
import java.util.List;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlElements;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Resouce {
private String picLarge;
private List<Property> Properties;

@XmlElement
public String getPicLarge() {
return picLarge;
}
public void setPicLarge(String picLarge) {
this.picLarge = picLarge;
}
// 如果想在节点外面包一层xml元素节点，可以用
// @XmlElementWrapper(name="wrapper" )
@XmlElements( {
@XmlElement(name = "Property", type = Property.class),
// @XmlElement(name = "adInfo", type = AdInfo.class)一个集合可以放置多个xml元素名称和对象类型、在xml中是相互独立的集合元素，无包含关系
})
public List<Property> getProperties() {
return Properties;
}
public void setProperties(List<Property> properties) {
Properties = properties;
}

public static void main(String [] args){
Property property = new Property();
property.setElementName("elementName");
property.setEntityField("entityField");
property.setSequence("sequence");
property.setStyleId(11111);

Property property1 = new Property();
property1.setElementName("elementName111");
property1.setEntityField("entityField111");
property1.setSequence("sequence1111");
property1.setStyleId(22222);

List<Property> list = new ArrayList<Property>();
list.add(property);
list.add(property1);

Resouce resouce = new Resouce();
resouce.setPicLarge("picLarge");
resouce.setProperties(list);

JAXB2Tester.bean2Xml(resouce);

}

}


import java.io.ByteArrayInputStream;
import java.io.InputStream;
import java.io.StringWriter;
import java.io.UnsupportedEncodingException;
import java.util.ArrayList;
import java.util.List;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import javax.xml.bind.Unmarshaller;

/**
*xml与JAVA对象相互转化
*/
public class JAXB2Tester {


/**
* 将生成的xml转换为对象
* @param zClass 转换为实例的对象类类型
* @param xmlPath 需要转换的xml路径
*/
public static Object xml2Bean(Class<?> zClass, String xml) {
Object obj = null;
JAXBContext context = null;
if (null == xml || "".equals(xml) || "null".equalsIgnoreCase(xml)
|| xml.length() < 1)
return obj;
try {
context = JAXBContext.newInstance(zClass);
// if without "utf-8", Invalid byte 2 of 2-byte UTF-8 sequence.
InputStream iStream = new ByteArrayInputStream(xml.getBytes("utf-8"));
Unmarshaller um = context.createUnmarshaller();
obj = (Object) um.unmarshal(iStream);
return obj;
} catch (JAXBException e) {
e.printStackTrace();
}catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return obj;
}


public static String bean2Xml(Object bean) {
String xmlString = null;
JAXBContext context;
StringWriter writer;
if (null == bean)
return xmlString;
try {
//下面代码将对象转变为xml
context = JAXBContext.newInstance(bean.getClass());
Marshaller m = context.createMarshaller();
writer = new StringWriter();
m.marshal(bean, writer);
xmlString = writer.toString();
System.out.println(xmlString);
return xmlString;
} catch (Exception e) {
e.printStackTrace();
}
return xmlString;
}

}