什么是jaxb?
http://java.sun.com/xml/jaxb/about.html
主要能干什么?
当人们需要用java应用程序来访问数据库的时候,jdbc诞生了
当人们觉得频繁的jdbc操作很繁琐的时候,o/r mapping诞生了
当人们需要用java操作xml的时候,sax, dom诞生了
当人们觉得用dom操作xml很繁琐的时候, jaxb诞生了
jaxb---将xml与java对象绑定的sun规范.
使用:
jaxb的bin目录下有一个xcj.bat的批处理文件, 作用就是根据xml scheme文件比如xsd来生成java文件
sample.xsd
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
jaxb:version="1.0" >
<xsd:element name="registry" type="RegistryType"/>
<xsd:complexType name="RegistryType">
<xsd:sequence>
<xsd:element name="module" type="ModuleType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ModuleType">
<xsd:sequence>
<xsd:element name="serviceFactory" type="ServiceFactoryType"/>
<xsd:element name="serviceClientFactory" type="ServiceClientFactoryType"/>
</xsd:sequence>
<xsd:attribute name="name" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="ServiceFactoryType">
<xsd:sequence>
<xsd:element name="service" type="ServiceType" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ServiceType">
<xsd:attribute name="id" type="xsd:string"/>
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ServiceClientFactoryType">
<xsd:sequence>
<xsd:element name="serviceClient" type="ServiceClientType"/>
</xsd:sequence>
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ServiceClientType">
<xsd:sequence>
<xsd:element name="serviceRender" type="ServiceRenderType" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="id" type="xsd:string"/>
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="renderFactory" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="ServiceRenderType">
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="id" type="xsd:string"/>
</xsd:complexType>
</xsd:schema>
在cmd窗口下 xjc -p com.hairroot.jaxb sample.xsd
这个命令会在com/hairroot/jaxb的目录下生成几个interface, 并在com/hairroot/jaxb/impl下面生成各自的实现类,实现类看起来还是很复杂的。为什么这么复杂,原因就是需要考虑很多的事情,比如进行marshal的时候,如果尽可能的将输出跟输入xml看起来一致的xml, 而不是元素,属性的顺序弄得乱七八糟的。
注意:除了生成的java文件之外,还有一个jaxb.properties, 和ser。这两个东西是不能 丢的,否则会报错。
unmarshall的操作:
两种方式
1)JAXBContext context = JAXBContext.newInstance("com.hairroot.jaxb");
context.createUnmarshaller().unmarshal(new File("d:/hairroot/jaxb/sample.xml"));
2)ObjectFactory factory = new ObjectFactory();
factory.createUnmarshaller().unmarshal(new File("d:/hairroot/jaxb/sample.xml"));
unmarshall返回的结果是一个object, 也就是根类型的一个实现类,可以强制转型了之后进行其它的操作。
marshall的操作:
同样有两种方式
1)JAXBContext context = JAXBContext.newInstance("com.hairroot.jaxb");
Object root = context.createUnmarshaller().unmarshal(new File("d:/hairroot/jaxb/sample.xml"));
context.createMarshaller().marshal(root, System.out);
2)ObjectFactory factory = new ObjectFactory();
Object root = factory.createUnmarshaller().unmarshal(new File("d:/hairroot/jaxb/sample.xml"));
factory.createMarshaller().marshal(root, System.out);
Validation的操作现在略;
如何将xsd:data类型进行格式化的输出:
如果在schema中定义一个xsd:date类型,那么jaxb会将其转化为java.util.Calendar的类型,然而这样有个问题,如果 sample.xml中数据为2005-03-09, 那么进行marshal的操作后生成的xml为2005-03-09+08:00, 解决方法, 在scheme中
<xsd:element name="shipDate" minOccurs="0">
<xsd:simpleType>
<xsd:annotation>
<xsd:appinfo>
<jaxb:javaType name="java.sql.Date" printMethod="toString" parseMethod="valueOf"/>
</xsd:appinfo>
</xsd:annotation>
<xsd:restriction base="xsd:date"/>
</xsd:simpleType>
</xsd:element>
并且还需要在xsd的namespace中加入
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
jaxb:version="1.0" >
这样再进行xjc的时候不会报错,而且输入的date也就符合习惯了,如果不用
<jaxb:javaType name="java.sql.Date" printMethod="toString" parseMethod="valueOf"/>
则需要自己来写一个实现类,详细参考jaxb reference
如何处理java的一些保留字:
如果一个attribute的名字叫做class, 那么xjc产生的java中就有一个getClass的方法, 这与java.lang.Object 的getClass()相冲突,解决方法:
<xsd:attribute name="class" type="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<jaxb:property name="clazz"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:attribute>
可以用<jaxb:property name="clazz"/>来指定xjc生成的java的方法为getClazz()
jaxb1.0的问题:
目前我发现的主要问题是, attribute的输入的顺序跟schema中定义的顺序不一致,网上看到sun的工程师认为这不是一个很重要的问题,而且还认为attribute的顺序没有办法控制,这种借口简直好笑,如果能够做得更好为什么不去做?
推荐解决方法:
在xjc生成了java文件了之后,去看一下impl下面的每一个类的serializeAttributes()方法,调整这个方法的对应的 attribute的处理的上下顺序,就可以控制输出的xml的attribute出现的先后顺序,如此简单的事情,sun的工程师竟然说没有办法控制,当忽悠变成了一种时尚...