JavaからXMLおよびXMLからJavaへのコーディングを5分未満で開始したい場合は、シンプルなXMLシリアル化を試してください。JAXB API http://simple.sourceforge.net/download/stream/doc/tutorial/tutorial.phpの学習に何時間も費やさないで
ください
ただし、JAXBの学習に本当に熱心な場合は、次の優れたチュートリアルをご覧ください。
http://blogs.oracle.com/teera/entry/jaxb_for_simple_java_xml
チュートリアルの内容:
単純なJava-XMLシリアライゼーション用のJAXB
JavaでXMLシリアル化を行う方法はいくつかあります。解析とシリアル化をきめ細かく制御したい場合は、SAX、DOM、またはStaxを使用してパフォーマンスを向上させることができます。それでも、私がよくやりたいのは、POJOとXMLの間の単純なマッピングです。ただし、XMLイベント解析を手動で実行するJavaクラスを作成するのは簡単ではありません。私は最近、JAXBが迅速かつ便利なJava-XMLマッピングまたはシリアライゼーションであることを発見しました。
JAXBには多くの便利な機能が含まれています。ここでリファレンス実装を確認できます。 Kohsukeのブログは、JAXBについてさらに学ぶための優れたリソースでもあります。このブログエントリでは、JAXBを使用して簡単なJava-XMLシリアル化を行う方法を紹介します。
POJOからXML
私がItem Javaオブジェクトを持っているとしましょう。ItemオブジェクトをXML形式にシリアル化したいのですが。最初に行う必要があるのは、このPOJOにjavax.xml.bind.annotation。*パッケージからのいくつかのXMLアノテーションを付けることです。Item.javaのコードリスト1を参照してください
コードから
@XmlRootElement(name="Item")
ルート要素になりたいことを示します。
@XmlType(propOrder = {"name", "price"})
要素をXML出力に配置する順序を示します。
@XmlAttribute(name="id", ...)
idがルート要素の属性であることを示します。
@XmlElement(....)
価格と名前をアイテム内の要素にしたいことを示します。
私Item.java
は準備ができています。次に、アイテムをマーシャリングするためのJAXBスクリプトを作成します。
//creating Item data object
Item item = new Item();
item.setId(2);
item.setName("Foo");
item.setPrice(200);
.....
JAXBContext context = JAXBContext.newInstance(item.getClass());
Marshaller marshaller = context.createMarshaller();
//I want to save the output file to item.xml
marshaller.marshal(item, new FileWriter("item.xml"));
完全なコードリストについては、コードリスト2を参照してくださいmain.java
。出力コードリスト3 item.xml
ファイルが作成されます。次のようになります。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns1:item ns1:id="2" xmlns:ns1="http://blogs.sun.com/teera/ns/item">
<ns1:itemName>Foo</ns1:itemName>
<ns1:price>200</ns1:price>
</ns1:item>
簡単でしょう?または、次のようにmarshal(...)メソッドのパラメーターを変更するだけで、出力XMLをテキスト文字列、ストリーム、ライター、ContentHandlerなどとしてチャネリングできます。
...
JAXBContext context = JAXBContext.newInstance(item.getClass());
Marshaller marshaller = context.createMarshaller();
// save xml output to the OutputStream instance
marshaller.marshal(item, <java.io.OutputStream instance>);
...
JAXBContext context = JAXBContext.newInstance(item.getClass());
Marshaller marshaller = context.createMarshaller();
StringWriter sw = new StringWriter();
//save to StringWriter, you can then call sw.toString() to get java.lang.String
marshaller.marshal(item, sw);
XMLからPOJO
プロセスを逆にしましょう。XML文字列データがあり、それをItem.javaオブジェクトに変換したいとします。XMLデータ(コードリスト3)は次のようになります。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns1:item ns1:id="2" xmlns:ns1="http://blogs.sun.com/teera/ns/item">
<ns1:itemName>Bar</ns1:itemName>
<ns1:price>80</ns1:price>
</ns1:item>
次に、このxmlコードをItemオブジェクトに非整列化できます。
...
ByteArrayInputStream xmlContentBytes = new ByteArrayInputStream (xmlContent.getBytes());
JAXBContext context = JAXBContext.newInstance(Item.getClass());
Unmarshaller unmarshaller = context.createUnmarshaller();
//note: setting schema to null will turn validator off
unmarshaller.setSchema(null);
Object xmlObject = Item.getClass().cast(unmarshaller.unmarshal(xmlContentBytes));
return xmlObject;
...
完全なコードリストについては、コードリスト2(main.java)を参照してください。XMLソースは、ストリームとファイルの両方からさまざまな形式で提供されます。唯一の違いは、ここでもメソッドパラメータです。
...
unmarshaller.unmarshal(new File("Item.xml")); // reading from file
...
// inputStream is an instance of java.io.InputStream, reading from stream
unmarshaller.unmarshal(inputStream);
XMLスキーマによる検証
ここで最後に触れておきたいのは、Javaオブジェクトに非整列化する前に、入力XMLをスキーマで検証することです。item.xsdというXMLスキーマファイルを作成します。完全なコードリストについては、コードリスト4(Item.xsd)を参照してください。次に、このスキーマを検証用に登録する必要があります。
...
Schema schema = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI)
.newSchema(new File("Item.xsd"));
unmarshaller.setSchema(schema); //register item.xsd shcema for validation
...
XMLデータをPOJOに非整列化しようとすると、入力XMLがスキーマに準拠していない場合、例外がキャッチされます。完全なコードリストについては、コードリスト5(invalid_item.xml)を参照してください。
javax.xml.bind.UnmarshalException
- with linked exception:
javax.xml.bind.JAXBException caught: null
[org.xml.sax.SAXParseException: cvc-datatype-valid.1.2.1: 'item1' is
not a valid value for 'integer'.]
ここで、「id」属性を整数ではなく文字列に変更します。
XML入力がスキーマに対して有効な場合、XMLデータは正常にItem.javaオブジェクトに非整列化されます。