JAXB_Java Architecture For XML Binding

1:写好XML文件且根据XML文件写出XSD文件:
(或者使用Trang-[java -jar trang.jar source.xml dist.xsd])
XML:

<?xml version="1.0" encoding="UTF-8"?>
<booking xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<company name="ACME Consulting">
		<address>10 Coyote Avenue, Arizona, USA</address>
		<contact name="Duke" email="[e-mail]"
			telephone="1234567890" />
	</company>
	<student firstName="Jane" surname="Dow" />
	<student firstName="John" surname="Doe" />
</booking>

XSD:

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<xsd:element name="booking" type="courseBooking" />
	<xsd:complexType name="courseBooking">
		<xsd:sequence>
			<xsd:element ref="company" />
			<xsd:element ref="student" minOccurs="1"
				maxOccurs="unbounded" />
		</xsd:sequence>
		<xsd:attribute name="courseReference" type="xsd:string"
			use="required" />
		<xsd:attribute name="courseDate" type="xsd:date" use="required" />
		<xsd:attribute name="invoiceReference" type="xsd:string"
			use="required" />
		<xsd:attribute name="totalPrice" type="xsd:decimal"
			use="required" />
	</xsd:complexType>
	<xsd:element name="student" type="studentType" />
	<xsd:complexType name="studentType">
		<xsd:attribute name="firstName" type="xsd:string"
			use="required" />
		<xsd:attribute name="surname" type="xsd:string" use="required" />
	</xsd:complexType>
	<xsd:element name="company" type="companyType" />
	<xsd:complexType name="companyType">
		<xsd:sequence>
			<xsd:element name="address" />
			<xsd:element ref="contact" />
		</xsd:sequence>
		<xsd:attribute name="name" type="xsd:string" />
	</xsd:complexType>
	<xsd:element name="contact" type="contactType" />
	<xsd:complexType name="contactType">
		<xsd:attribute name="name" type="xsd:string" use="required" />
		<xsd:attribute name="telephone" type="xsd:string"
			use="required" />
		<xsd:attribute name="email" type="xsd:string" use="required" />
	</xsd:complexType>
</xsd:schema>

2:在命令行下输入命令(必须安装JDK1.5+):
意思为 利用Java 的XML绑定编译器(Compiler)去根据 test.xsd 生成Java与XML绑定的类放到包名为:com.rui.jaxb且文件夹为src 的目录下

xjc test.xsd -p com.rui.jaxb -d src

3:将 生成好的文件拷贝到eclipse中准备使用

4:XML验证器的的代码如下:

package com.rui.jaxb.validate;

import javax.xml.bind.ValidationEvent;
import javax.xml.bind.ValidationEventHandler;
import javax.xml.bind.ValidationEventLocator;

/**
 * 验证XML有效性的ValidationEventHandler
 */
public class BookingValidationEventHandler implements ValidationEventHandler {


    public boolean handleEvent(ValidationEvent event) {
        System.out.println("print message...");
        // 判断验证严重级别: 1:致命错误:FATAL_ERROR 2: 错误: ERROR 3: 警告 WARNING
        if(event.getSeverity()==ValidationEvent.FATAL_ERROR || event.getSeverity() == ValidationEvent.ERROR) {
            // 获得 locator
            ValidationEventLocator locator = event.getLocator();
            // 从验证事件中得到输出消息
            System.out.println("Invalid booking document: " + locator.getURL());
            System.out.println("Error: " + event.getMessage());
            // 输出 行号和列
            System.out.println("Error at colum: " + locator.getColumnNumber() + 
                                        ", line: " + locator.getLineNumber());
        }
        // 在这里我们只打印出 错误的消息,但是在真实的项目中,一些小的错误是允许的.所以我们一般返回true,这样程序就不会中断XML的处理过程,如果返回false,那么
        // 解析的这个过程将会中断 - 这要看你是想这个解析器是个 错误的报告者,还是错误的中断者
        return true;
    }

}

5:解组的示例代码如下:

package com.rui.jaxb.test;

import java.io.File;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.Unmarshaller;
import javax.xml.bind.ValidationEvent;

import com.rui.jaxb.CourseBooking;
import com.rui.jaxb.validate.BookingValidationEventHandler;
import com.sun.corba.se.pept.transport.EventHandler;

/**
 * 使用JAXB技术-解组过程
 */
public class JaxbUnmarshalTest {
    
    public static void main(String[] args) throws Exception {
        // 以下为怎样使用JAXB技术从XML转换到JAVA类并获取值的过程
        
        // 创建上下文对象 - 这是编组,解组和验证操作的起点. - 参数指定为包含被JAXB映射的类的包名
        JAXBContext jaxbContext = JAXBContext.newInstance("com.rui.jaxb");
        // 创建解组对象
        Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
        // 要想验证XML文件的有效性,必须在解码(unmarshal)之前附加一个ValidationEventHandler
        unmarshaller.setEventHandler(new BookingValidationEventHandler());
        // 从要解组的介质中(可以是文件、流、URL、DOM对象、SAXParser等,在此为XML文件)
        JAXBElement<CourseBooking> bookingElement = (JAXBElement<CourseBooking>)unmarshaller.unmarshal(new File("booking.xml"));
        // 通过getValue() 方法得到解组对象
        CourseBooking booking = bookingElement.getValue();
        // 得到对象中的值
        System.out.println(booking.getCompany().getContact().getTelephone());
        System.out.println(booking.getStudent().get(0).getFirstName());
        
        System.out.println(ValidationEvent.ERROR|ValidationEvent.FATAL_ERROR|ValidationEvent.WARNING);
        System.out.println(ValidationEvent.WARNING);
        System.out.println(ValidationEvent.ERROR);
        System.out.println(ValidationEvent.FATAL_ERROR);
    }

}

6:编组的示例代码如下:

package com.rui.jaxb.test;

import java.io.File;
import java.math.BigDecimal;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.Marshaller;
import javax.xml.datatype.DatatypeFactory;

import com.rui.jaxb.CompanyType;
import com.rui.jaxb.ContactType;
import com.rui.jaxb.CourseBooking;
import com.rui.jaxb.ObjectFactory;
import com.rui.jaxb.StudentType;


/**
 * 使用JAXB技术编组过程
 */
public class JaxbMarshalTest {
    
    public static void main(String[] args) throws Exception {
        // 以下为怎样使用JAXB技术从JAVA类转换到XML的过程
        
        // 创建上下文对象 - 这是编组,解组和验证操作的起点. - 参数指定为包含被JAXB映射的类的包名
        JAXBContext jaxbContext = JAXBContext.newInstance("com.rui.jaxb");
       
        // 创建CourceBooking 对象
        CourseBooking booking = new CourseBooking();
        //  对象初始化过程
        // 必须使用 DatatypeFactory 去处理一些固定的数据类型
        DatatypeFactory datatypes = DatatypeFactory.newInstance();
        booking.setCourseDate(datatypes.newXMLGregorianCalendarDate(2011, 11, 01, 0));
        
        booking.setCourseReference("Agile Software Development");
        booking.setTotalPrice(new BigDecimal(2000));
        booking.setInvoiceReference("123456");
        booking.getStudent().add(new StudentType());
        booking.getStudent().get(0).setFirstName("zhang");
        booking.getStudent().get(0).setSurname("san");
        booking.setCompany(new CompanyType());
        booking.getCompany().setName("rayoo_tech");
        booking.getCompany().setAddress("北清路68号");
        booking.getCompany().setContact(new ContactType());
        booking.getCompany().getContact().setName("calm_flow");
        booking.getCompany().getContact().setTelephone("1501000000");
        booking.getCompany().getContact().setEmail("[e-mail]");
        
        // 初始化完毕后,使用JAXB上下文去创建Marshal对象和JAXBElement对象
        Marshaller marshaller = jaxbContext.createMarshaller();
        // 创建一个包装了你的Java类的JAXBElement对象,这个JAXBElement对象对应着你的文档的根元素
        JAXBElement<CourseBooking> bookingElement = (new ObjectFactory().createBooking(booking));
        // 设置格式化属性 Marshaller.JAXB_FORMATTED_OUTPUT
        marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
        // 设置文件编码属性
        marshaller.setProperty(marshaller.JAXB_ENCODING, "UTF-8");
        // 使用输出流编组
        marshaller.marshal(bookingElement  , new File("booking2.xml")); //System.out);
    }
    
    /*
    // 像JAXB1.0一样去使用 ObjectFactory
    ObjectFactory objectFactory = new ObjectFactory();
    // 创建CourceBooking 对象
    CourseBooking booking = objectFactory.createCourseBooking();
    */
}

7: 类似解析:http://jibx.sourceforge.net/index.html
8:项目及文档见附件: