程序設計:用JAXB生成一個XML文檔

2019-11-18 12:46:47

字體：大中小

來源：轉載

供稿：網友

　　一個xml 模式(Schema)用XML語法表達了一個XML文檔的結構。J2EE的開發者也許會需要一個符合XML模式的XML文檔。java XML綁定架構(JAXB)提供了一個綁定編譯器，xjc,來從一個XML模式中生成Java類。用JAXB的xjc生成的Java類代表了在XML模式中不同的元素和復雜類型(complexType)。（一個復雜類型通過指定屬性和元素內的元素來提供對一個元素的限定）。一個符合XML模式的XML文檔可以從這些Java類中構建出來。
　　
　　在這篇教程中，作者使用了JAXB用來從一個XML模式中生成Java類。這些Java類將會生成一個范例XML文檔。這篇文章由以下幾個部份組成：
　　
　　1.預設置
　　2.概述
　　3.從XMl模式中生成Java類
　　4.從Java類中生成一個XML文檔
　　
　　預設置
　　
　　為了用JAXB從一個XML模式中生成Java類，JAXB API類庫和xjc工具應該存在CLASSPATH環境變量中。將Java Web服務開發包 (JWSDP) 1.5裝入一個安裝目錄中。將下列的.jar文件加入CLASSPATH環境變量中。
　　
　　·<JWSDP>/jaxb/lib/jaxb-api.jar
　　·<JWSDP>/jaxb/lib/jaxb-impl.jar
　　·<JWSDP>/jaxb/lib/jaxb-libs.jar
　　·<JWSDP>/jaxb/lib/jaxb-xjc.jar
　　·<JWSDP>/jwsdp-shared/lib/namespace.jar
　　·<JWSDP>/jwsdp-shared/lib/jax-qname.jar
　　·<JWSDP>/jwsdp-shared/lib/relaxngDatatype.jar
　　
　　<JWSDP>是Java Web服務開發包1.5的安裝目錄。把<JWSDP>/jaxb/bin加入PATH環境變量中。<JWSDP>/jaxb/bin目錄中包含了xjc編譯器。把<JWSDP>/jwsdp-shared/bin目錄加入到PATH環境變量中。<JWSDP>/jwsdp-shared/bin目錄中包含了setenv的批處理文件，它設置了JAVA_HOME, ANT_HOME和JWSDP_HOME這幾個環境變量。
　　
　　概述
　　
　　JAXB生成對應著XML頂層元素和頂層復雜類型元素的Java類和接口。在一個XML模式中，一個元素由<xs:element/>表示，一個復雜類型元素由<xs:complexType/>表示。這篇教程列舉了一個能夠表示一篇在科學雜志上發表的文章的示例模式，同時這個示例模式將會被JAXB綁定編譯器編譯。XML模式，catalog.xsd,如下：
　　
　　<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
　　<xsd:element name="catalog" type="catalogType"/>
　　<xsd:complexType name="catalogType">
　　<xsd:sequence>
　　<xsd:element ref="journal"
　　minOccurs="0" maxOccurs="unbounded"/>
　　</xsd:sequence>
　　<xsd:attribute name="section" type="xsd:string"/>
　　<xsd:attribute name="publisher" type="xsd:string"/>
　　</xsd:complexType>
　　<xsd:element name="journal" type="journalType"/>
　　<xsd:complexType name="journalType">
　　<xsd:sequence>
　　<xsd:element ref="article"
　　minOccurs="0" maxOccurs="unbounded"/>
　　</xsd:sequence>
　　</xsd:complexType>
　　<xsd:element name="article" type="articleType"/>
　　<xsd:complexType name="articleType">
　　<xsd:sequence>
　　<xsd:element name="title" type="xsd:string"/>
　　<xsd:element name="author" type="xsd:string"/>
　　</xsd:sequence>
　　<xsd:attribute name="level" type="xsd:string"/>
　　<xsd:attribute name="date" type="xsd:string"/>
　　</xsd:complexType></xsd:schema>
　　
　　一些XML模式的構造不被JAXB支持。假如這些不被支持的構造包含在了模式中，那么當你試圖用xjc來生成Java類時將會報錯。下列模式元素不被支持：xs:any, xs:anyAttribute, xs:notation, xs:redefine, xs:key, xs:keyref, 和 xs:unique. 下列模式的屬性不被支持: complexType.abstract, element.abstract, element.substitutionGroup, xsi:type, complexType.block, complexType.final, element.block, element.final, schema.blockDefault, 和 schema.finalDefault.
　　
　　生成Java類
　　
　　xjc工具基于此模式來綁定一個模式到Java類。針對本文的示例模式來進行綁定的命令是：
　　
　　>xjc catalog.xsd
　　
　　xjc命令行接口的一些選項列在下表：
　　
　　-nv　　　　對于輸入的模式不執行嚴格的XML驗證
　　
　　-b <file>　　　　指定外部的綁定文件
　　
　　-d <dir>　　　　指定生成的文件的存放路徑
　　
　　-p <pkg>　　　　指定目標包
　　
　　-classpath <arg>　　　　指定classpath
　　
　　-use-runtime <pkg>　　　　impl.runtime包不被生成
　　
　　-xmlschema　　　　輸入的模式是一個W3C XML模式（默認）
　　
　　對于示例模式catalog.xsd來說，xjc將會生成45個類，顯示在如下xjc的輸出中：
　　
　　parsing a schema...
　　compiling a schema...
　　generated/impl/runtime/ErrorHandlerAdaptor.java
　　generated/impl/runtime/MSVValidator.java
　　generated/impl/runtime/NamespaceContext2.java
　　generated/impl/runtime/UnmarshallableObject.java
　　generated/impl/runtime/MarshallerImpl.java
　　generated/impl/runtime/ValidationContext.java
　　generated/impl/runtime/UnmarshallerImpl.java
　　generated/impl/runtime/DefaultJAXBContextImpl.java
　　generated/impl/runtime/ContentHandlerAdaptor.java
　　generated/impl/runtime/GrammarInfoFacade.java
　　generated/impl/runtime/UnmarshallingContext.java
　　generated/impl/runtime/UnmarshallingEventHandlerAdaptor.java
　　generated/impl/runtime/XMLSerializable.java
　　generated/impl/runtime/Discarder.java
　　generated/impl/runtime/PRefixCallback.java
　　generated/impl/runtime/SAXMarshaller.java
　　generated/impl/runtime/NamespaceContextImpl.java
　　generated/impl/runtime/UnmarshallingEventHandler.java
　　generated/impl/runtime/GrammarInfo.java
　　generated/impl/runtime/InterningUnmarshallerHandler.java
　　generated/impl/runtime/ValidatableObject.java
　　generated/impl/runtime/GrammarInfoImpl.java
　　generated/impl/runtime/ValidatingUnmarshaller.java
　　generated/impl/runtime/ValidatorImpl.java
　　generated/impl/runtime/SAXUnmarshallerHandlerImpl.java
　　generated/impl/runtime/XMLSerializer.java
　　generated/impl/runtime/Util.java
　　generated/impl/runtime/SAXUnmarshallerHandler.java
　　generated/impl/runtime/AbstractUnmarshallingEventHandlerImpl.java
　　generated/impl/ArticleImpl.java
　　generated/impl/ArticleTypeImpl.java
　　generated/impl/CatalogImpl.java
　　generated/impl/CatalogTypeImpl.java
　　generated/impl/JAXBVersion.java
　　generated/impl/JournalImpl.java
　　generated/impl/JournalTypeImpl.java
　　generated/Article.java
　　generated/ArticleType.java
　　generated/Catalog.java
　　generated/CatalogType.java
　　generated/Journal.java
　　generated/JournalType.java
　　generated/ObjectFactory.java
　　generated/bgm.ser
　　generated/jaxb.properties
　　
　　對于示例XML模式中的每個頂層xs:element和頂層xs:complexType，都對應地生成了一個Java接口和一個Java類。同時也創建了一個工廠類（ObjectFactory.java）,包含了創建接口對象的方法。可以在在篇文章的示例代碼文件jaxb-java-resources.zip中找到ObjectFactory.java類。
　　
　　Catalog.java是對應頂層元素catalog生成的接口。從模式的元素中生成的接口擴展了javax.xml.bin.Elemnt類。
　　
　　Catalog.java：
　　
　　package generated;public interface Catalog
　　extends javax.xml.bind.Element, generated.CatalogType{}
　　
　　CatalogType.java是對應頂層復雜元素catalogType生成的接口。CatalogType接口對應catalog元素的每個屬性指定了setter和getter方法，還有對應catalog元素中的journal元素的一個getter方法。
　　
　　CatalogType.java：
　　
　　package generated;public interface CatalogType {
　　java.lang.String getSection();
　　void setSection(java.lang.String value);
　　java.util.List getJournal();
　　java.lang.String getPublisher();
　　void setPublisher(java.lang.String value);}
　　
　　CatalogImpl.java 和CatalogTypeImpl.java是分別對應Catalog.java 和 CatalogType.java接口的實現類。
　　
　　從Java類中創建一個XML文檔
　　
　　這一節中，一個示例XMl文檔將會通進JAXB從Java類被創建。示例XML文檔，catalog.xml，如下顯示：
　　
　　<?xml version="1.0" encoding="UTF-8"?>
　　<catalog xmlns="http://www.w3.org/2001/XMLSchema-Instance"
　　section="Java Technology"
　　publisher="IBM　developerWorks">
　　<journal>
　　<article level="Intermediate"　date="January-2004" >
　　<title>Service Oriented Architecture Frameworks </titl

上一篇：有關手機中文問題傳輸的解決辦法

下一篇：使用web.xml控制Web應用的行為二