Java Language
XOM - XMLオブジェクトモデル

XMLファイルの読み込み

XOMで XMLデータをロードするには、 Builderを作成してDocumentに組み込む必要があります。

Builder builder = new Builder();
Document doc = builder.build(file);

xmlファイルの上位の親であるルート要素を取得するには、 DocumentインスタンスでgetRootElement()を使用する必要があります。

Element root = doc.getRootElement();

今Elementクラスにはxmlの読み込みを簡単にする便利なメソッドがたくさんあります。最も有用なもののいくつかを以下に示します。

• getChildElements(String name) - 要素の配列として機能するElementsインスタンスを返します
• getFirstChildElement(String name) - そのタグを持つ最初の子要素を返します。
• getValue() - 要素内の値を返します。
• getAttributeValue(String name) - 指定された名前を持つ属性の値を返します。

getChildElements()を呼び出すと、 Elementsインスタンスが取得されます。これから、ループしてget(int index)メソッドを呼び出して、内部のすべての要素を取得できます。

Elements colors = root.getChildElements("color");
for (int q = 0; q < colors.size(); q++){
    Element color = colors.get(q);
}

例： XMLファイルを読み取る例を次に示します。

XMLファイル：

それを読み、印刷するためのコード：

import java.io.File;
import java.io.IOException;
import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.Element;
import nu.xom.Elements;
import nu.xom.ParsingException;

public class XMLReader {
    
    public static void main(String[] args) throws ParsingException, IOException{
        File file = new File("insert path here");
        // builder builds xml data
        Builder builder = new Builder();
        Document doc = builder.build(file);
        
        // get the root element <example>
        Element root = doc.getRootElement();
        
        // gets all element with tag <person>
        Elements people = root.getChildElements("person");
        
        for (int q = 0; q < people.size(); q++){
            // get the current person element
            Element person = people.get(q);
            
            // get the name element and its children: first and last
            Element nameElement = person.getFirstChildElement("name");
            Element firstNameElement = nameElement.getFirstChildElement("first");
            Element lastNameElement = nameElement.getFirstChildElement("last");
            
            // get the age element
            Element ageElement = person.getFirstChildElement("age");
            
            // get the favorite color element
            Element favColorElement = person.getFirstChildElement("fav_color");
            
            String fName, lName, ageUnit, favColor;
            int age;
            
            try {
                fName = firstNameElement.getValue();
                lName = lastNameElement.getValue();
                age = Integer.parseInt(ageElement.getValue());
                ageUnit = ageElement.getAttributeValue("unit");
                favColor = favColorElement.getValue();
                
                System.out.println("Name: " + lName + ", " + fName);
                System.out.println("Age: " + age + " (" + ageUnit + ")");
                System.out.println("Favorite Color: " + favColor);
                System.out.println("----------------");
                
            } catch (NullPointerException ex){
                ex.printStackTrace();
            } catch (NumberFormatException ex){
                ex.printStackTrace();
            }
        }
    }
    
}

これはコンソールに表示されます：

Name: Smith, Dan
Age: 23 (years)
Favorite Color: green
----------------
Name: Autry, Bob
Age: 3 (months)
Favorite Color: N/A
----------------

XMLファイルへの書き込み

XOMを使用してXMLファイルに書き込むことは、この場合はインスタンスをrootから取得するのではなく、インスタンスを作成している点を除いて、読み取りと非常によく似ています。

新しいElementを作成するには、コンストラクターElement(String name)ます。ルート要素を作成して、 Document簡単に追加することができます。

Element root = new Element("root");

Elementクラスには、要素を編集するための便利なメソッドがいくつかあります。それらは以下の通りです：

• appendChild(String name) - これは基本的に要素の値をnameに設定します。
• appendChild(Node node) - nodeの要素を親にします。 （要素はノードなので、要素を解析できます）。
• addAttribute(Attribute attribute) - 要素に属性を追加します。

Attributeクラスには、いくつかの異なるコンストラクタがあります。最も簡単なのはAttribute(String name, String value)です。

すべての要素をルート要素に追加したら、それをDocumentに変換できます。 Documentは、そのコンストラクタの中で引数としてElementをとります。

Serializerを使用してXMLをファイルに書き込むことができます。 Serializerのコンストラクタで解析するために新しい出力ストリームを作成する必要があります。

FileOutputStream fileOutputStream = new FileOutputStream(file);
Serializer serializer = new Serializer(fileOutputStream, "UTF-8");
serializer.setIndent(4);
serializer.write(doc);

例

コード：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import nu.xom.Attribute;
import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.Element;
import nu.xom.Elements;
import nu.xom.ParsingException;
import nu.xom.Serializer;

public class XMLWriter{
    
    public static void main(String[] args) throws UnsupportedEncodingException, 
            IOException{
        // root element <example>
        Element root = new Element("example");
        
        // make a array of people to store
        Person[] people = {new Person("Smith", "Dan", "years", "green", 23), 
            new Person("Autry", "Bob", "months", "N/A", 3)};
        
        // add all the people
        for (Person person : people){
            
            // make the main person element <person>
            Element personElement = new Element("person");
            
            // make the name element and it's children: first and last
            Element nameElement = new Element("name");
            Element firstNameElement = new Element("first");
            Element lastNameElement = new Element("last");
            
            // make age element
            Element ageElement = new Element("age");
            
            // make favorite color element
            Element favColorElement = new Element("fav_color");
            
            // add value to names
            firstNameElement.appendChild(person.getFirstName());
            lastNameElement.appendChild(person.getLastName());
            
            // add names to name
            nameElement.appendChild(firstNameElement);
            nameElement.appendChild(lastNameElement);
            
            // add value to age
            ageElement.appendChild(String.valueOf(person.getAge()));
            
            // add unit attribute to age
            ageElement.addAttribute(new Attribute("unit", person.getAgeUnit()));
            
            // add value to favColor
            favColorElement.appendChild(person.getFavoriteColor());
            
            // add all contents to person
            personElement.appendChild(nameElement);
            personElement.appendChild(ageElement);
            personElement.appendChild(favColorElement);
            
            // add person to root
            root.appendChild(personElement);
        }
        
        // create doc off of root
        Document doc = new Document(root);
        
        // the file it will be stored in
        File file = new File("out.xml");
        if (!file.exists()){
            file.createNewFile();
        }
        
        // get a file output stream ready
        FileOutputStream fileOutputStream = new FileOutputStream(file);
        
        // use the serializer class to write it all
        Serializer serializer = new Serializer(fileOutputStream, "UTF-8");
        serializer.setIndent(4);
        serializer.write(doc);
    }

    private static class Person {

        private String lName, fName, ageUnit, favColor;
        private int age;

        public Person(String lName, String fName, String ageUnit, String favColor, int age){
            this.lName = lName;
            this.fName = fName;
            this.age = age;
            this.ageUnit = ageUnit;
            this.favColor = favColor;
        }

        public String getLastName() { return lName; }
        public String getFirstName() { return fName; }
        public String getAgeUnit() { return ageUnit; }
        public String getFavoriteColor() { return favColor; }
        public int getAge() { return age; }
    }
    
}

これは "out.xml"の内容になります。