JAXB(Java Architecture for XML Binding) 是一个业界的标准,是一项可以根据XML Schema产生Java类的技术。该过程中,JAXB也提供了将XML实例文档反向生成Java对象树的方法,并能将Java对象树的内容重新写到XML实例文档。从另一方面来讲,JAXB提供了快速而简便的方法将XML模式绑定到Java表示,从而使得Java开发者在Java应用程序中能方便地结合XML数据和处理函数。
注解介绍
1) @XmlType
2) @XmlElement
3) @XmlRootElement
4) @XmlAttribute
5) @XmlAccessorType
6) @XmlAccessorOrder (不常用)
7) @XmlTransient (不常用)
8) @XmlJavaTypeAdapter (不常用)
1) @XmlType
@XmlType用在class类的注解,常与@XmlRootElement,@XmlAccessorType一起使用。
它有三个属性:name、propOrder、namespace,经常使用的只有前两个属性。如:
@XmlType(name = "basicStruct", propOrder = {
"intValue",
"stringArray",
"stringValue"
)
在使用@XmlType的propOrder 属性时,必须列出JavaBean对象中的所有属性,否则会报错。
在上面的例子中,不用列出也没事
2) @XmlElement
@XmlElement将java对象的属性映射为xml的节点,在使用@XmlElement时,可通过name属性改变java对象属性在xml中显示的名称。如:
@XmlElement(name="Address")
private String yourAddress;
3) @XmlRootElement
@XmlRootElement用于类级别的注解,对应xml的跟元素,常与 @XmlType 和 @XmlAccessorType一起使用。如:
@XmlType
@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement
public class Address {}
4) @XmlAttribute
@XmlAttribute用于把java对象的属性映射为xml的属性,并可通过name属性为生成的xml属性指定别名。如:
@XmlAttribute(name="Country")
private String state;
5) @XmlAccessorType
@XmlAccessorType用于指定由java对象生成xml文件时对java对象属性的访问方式。
常与@XmlRootElement、@XmlType一起使用。它的属性值是XmlAccessType的4个枚举值,分
别为:
XmlAccessType.FIELD:java对象中的所有成员变量
XmlAccessType.PROPERTY:java对象中所有通过getter/setter方式访问的成员变量
XmlAccessType.PUBLIC_MEMBER:java对象中所有的public访问权限的成员变量和通过getter/setter方式访问的成员变量
XmlAccessType.NONE:java对象的所有属性都不映射为xml的元素
注意:@XmlAccessorType的默认访问级别是XmlAccessType.PUBLIC_MEMBER,
因此,如果java对象中的private成员变量设置了public权限的getter/setter方法,就不要在
private变量上使用@XmlElement和@XmlAttribute注解,否则在由java对象生成xml时会报同一个属性在java类里存在两次的错误。
同理,如果@XmlAccessorType的访问权限为XmlAccessType.NONE,
如果在java的成员变量上使用了@XmlElement或@XmlAttribute注解,
这些成员变量依然可以映射到xml文件。
6) @XmlAccessorOrder
@XmlAccessorOrder用于对java对象生成的xml元素进行排序。它有两个属性值:
AccessorOrder.ALPHABETICAL:对生成的xml元素按字母书序排序
XmlAccessOrder.UNDEFINED:不排序
7) @XmlTransient
@XmlTransient用于标示在由java对象映射xml时,忽略此属性。即,在生成的xml文件中不出现此元素。
8) @XmlJavaTypeAdapter
@XmlJavaTypeAdapter常用在转换比较复杂的对象时,如map类型或者格式化日期等。使用此注解时,需要自己写一个adapter类继承XmlAdapter抽象类,并实现里面的方法。
@XmlJavaTypeAdapter(value=xxx.class),value为自己定义的adapter类
XmlAdapter如下:
public abstract class XmlAdapter {
// Do-nothing constructor for the derived classes.
protected XmlAdapter() {}
// Convert a value type to a bound type.
public abstract BoundType unmarshal(ValueType v);
// Convert a bound type to a value type.
public abstract ValueType marshal(BoundType v);
}
代码案例:
@XmlRootElement(name = "opDetail") //根节点
classOpDetail {
@XmlElement//节点元素
privateRecordInfo recordInfo;public voidsetRecordInfo(RecordInfo recordInfo) {this.recordInfo =recordInfo;
}
@OverridepublicString toString() {return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
}
}classRecordInfo {
@XmlElementprivate ListfieldInfo;
@XmlAttribute//节点属性
privateString isNew;public voidsetIsNew(String isNew) {this.isNew =isNew;
}public void setFieldInfo(ListfieldInfo) {this.fieldInfo =fieldInfo;
}
@OverridepublicString toString() {return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
}
}classFieldInfo {privateString fieldChName;privateString fieldEnName;privateString fieldContent;publicString getFieldChName() {returnfieldChName;
}public voidsetFieldChName(String fieldChName) {this.fieldChName =fieldChName;
}publicString getFieldEnName() {returnfieldEnName;
}public voidsetFieldEnName(String fieldEnName) {this.fieldEnName =fieldEnName;
}publicString getFieldContent() {returnfieldContent;
}public voidsetFieldContent(String fieldContent) {this.fieldContent =fieldContent;
}
@OverridepublicString toString() {return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
}
}
main方法测试:
public static void main(String[] args) throwsException {
OpDetail opDetail= newOpDetail();
RecordInfo recordInfo= newRecordInfo();
recordInfo.setIsNew("new");
List fieldInfo = new ArrayList<>();
FieldInfo f1= newFieldInfo();
f1.setFieldChName("地区1");
f1.setFieldEnName("area1");
f1.setFieldContent("中国");
FieldInfo f2= newFieldInfo();
f2.setFieldChName("地区2");
f2.setFieldEnName("area2");
f2.setFieldContent("马来西亚");
fieldInfo.add(f1);
fieldInfo.add(f2);
recordInfo.setFieldInfo(fieldInfo);
opDetail.setRecordInfo(recordInfo);//创建输出流
StringWriter sw = new StringWriter();try{//利用jdk中自带的转换类实现
JAXBContext context = JAXBContext.newInstance(OpDetail.class);
Marshaller marshaller = context.createMarshaller();//设置编码
marshaller.setProperty(Marshaller.JAXB_ENCODING, "GBK");//是否要带 <?xml version="1.0" encoding="GBK" standalone="yes"?>
marshaller.setProperty(Marshaller.JAXB_FRAGMENT, Boolean.FALSE);//格式化xml输出的格式
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);//将对象转换成输出流形式的xml
marshaller.marshal(opDetail, sw);
}catch(JAXBException e) {
e.printStackTrace();
}
System.out.println(sw.toString());
/*输出如下:
地区1
中国
area1
地区2
马来西亚
area2
*/
/*将xml字符串 转换成 java对象*/
//String xml = "<?xml version=\"1.0\" encoding=\"GBK\" standalone=\"yes\"?>地区1中国area1地区2马来西亚area2";//JAXBContext jc = JAXBContext.newInstance(OpDetail.class);//Unmarshaller u = jc.createUnmarshaller();//OpDetail o = (OpDetail)u.unmarshal(new StreamSource(new StringReader(xml)));//System.out.println(o.toString());
/*输出如下:
com.cmcc.open.ss.model.OpDetail@1b74318a[
recordInfo=com.cmcc.open.ss.model.RecordInfo@6960691a[
fieldInfo=[com.cmcc.open.ss.model.FieldInfo@38946002[
fieldChName=地区1
fieldEnName=area1
fieldContent=中国
], com.cmcc.open.ss.model.FieldInfo@152b4053[
fieldChName=地区2
fieldEnName=area2
fieldContent=马来西亚
]]
isNew=
]
*/
}