XML解析の基本！Javaで要素や属性を取得する方法

システム開発やデータ連携の現場では、設定ファイルやAPIレスポンスなどでXML形式のデータを扱う機会が多くあります。
この記事では、Javaを使ってXMLを解析し、要素（タグ内の値）や属性を取得する基本的な方法を解説します。

XML解析の代表的な方法

JavaではXMLを解析するために、いくつかのAPIが用意されています。

解析方法	特徴
DOM（Document Object Model）	メモリ上にXML全体を読み込み、ツリー構造で扱う。小規模ファイル向き。
SAX（Simple API for XML）	イベント駆動型で順次読み込む。大規模ファイル向き。
StAX（Streaming API for XML）	ストリーム処理を行いながら解析。SAXより柔軟。

今回は最も基本的なDOMパーサを使用します。

DOMパーサでXMLを解析する手順

以下のサンプルXMLを例にします。

<books>
    <book id="1" category="novel">
        <title>風の谷のナウシカ</title>
        <author>宮崎 駿</author>
    </book>
    <book id="2" category="science">
        <title>宇宙への旅</title>
        <author>野口 聡一</author>
    </book>
</books>

<books>

<title>風の谷のナウシカ</title>

</book>

<title>宇宙への旅</title>

</book>

</books>

Javaサンプルコード

import org.w3c.dom.*;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;

public class XmlParserExample {
    public static void main(String[] args) {
        try {
            // XMLファイルをパース
            DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
            DocumentBuilder builder = factory.newDocumentBuilder();
            Document doc = builder.parse("books.xml");

            // ルート要素を取得
            Element root = doc.getDocumentElement();
            System.out.println("Root: " + root.getNodeName());

            // book要素を取得
            NodeList bookList = doc.getElementsByTagName("book");

            for (int i = 0; i < bookList.getLength(); i++) {
                Element book = (Element) bookList.item(i);

                // 属性を取得
                String id = book.getAttribute("id");
                String category = book.getAttribute("category");

                // 子要素を取得
                String title = book.getElementsByTagName("title").item(0).getTextContent();
                String author = book.getElementsByTagName("author").item(0).getTextContent();

                System.out.println("ID: " + id + " / カテゴリ: " + category);
                System.out.println("タイトル: " + title);
                System.out.println("著者: " + author);
                System.out.println("--------------------");
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

import org.w3c.dom.*;

import javax.xml.parsers.DocumentBuilder;

import javax.xml.parsers.DocumentBuilderFactory;

public class XmlParserExample {

public static void main(String[] args) {

try {

// XMLファイルをパース

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();

DocumentBuilder builder = factory.newDocumentBuilder();

Document doc = builder.parse("books.xml");

// ルート要素を取得

Element root = doc.getDocumentElement();

System.out.println("Root: " + root.getNodeName());

// book要素を取得

NodeList bookList = doc.getElementsByTagName("book");

for (int i = 0; i < bookList.getLength(); i++) {

Element book = (Element) bookList.item(i);

// 属性を取得

String id = book.getAttribute("id");

String category = book.getAttribute("category");

// 子要素を取得

String title = book.getElementsByTagName("title").item(0).getTextContent();

String author = book.getElementsByTagName("author").item(0).getTextContent();

System.out.println("ID: " + id + " / カテゴリ: " + category);

System.out.println("タイトル: " + title);

System.out.println("著者: " + author);

System.out.println("--------------------");

}

} catch (Exception e) {

e.printStackTrace();

}

実行結果

Root: books
ID: 1 / カテゴリ: novel
タイトル: 風の谷のナウシカ
著者: 宮崎 駿
--------------------
ID: 2 / カテゴリ: science
タイトル: 宇宙への旅
著者: 野口 聡一
--------------------

Root: books

ID: 1 / カテゴリ: novel

タイトル: 風の谷のナウシカ

著者: 宮崎駿

--------------------

ID: 2 / カテゴリ: science

タイトル: 宇宙への旅

著者: 野口聡一

--------------------

ポイント解説

DocumentBuilderFactory：XML解析のためのインスタンスを生成
getDocumentElement()：ルート要素を取得
getElementsByTagName()：指定タグのノードリストを取得
getAttribute()：要素の属性値を取得
getTextContent()：タグ内のテキスト値を取得

よくあるエラー例

エラー内容	原因と対処法
FileNotFoundException	XMLファイルのパスが誤っている。絶対パスまたは相対パスを確認。
SAXParseException	XML構文が正しくない（タグの閉じ忘れやエンコーディング不一致など）。
NullPointerException	該当タグが存在しない場合にitem(0)でNullを参照している。要素の存在チェックを追加する。

まとめ

XML解析ではDOM・SAX・StAXなどの手法がある。
小規模なXMLではDOMパーサが使いやすい。
ElementやNodeListを通じて要素・属性を自由に操作できる。

JavaでXMLを扱う基本を押さえておくと、設定ファイルや外部システム連携処理をスムーズに開発できます。

覚え書き.com

XML解析の基本！Javaで要素や属性を取得する方法

XML解析の代表的な方法

DOMパーサでXMLを解析する手順

Javaサンプルコード

実行結果

ポイント解説

よくあるエラー例

まとめ

コメントを残す

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

XML解析の代表的な方法

DOMパーサでXMLを解析する手順

Javaサンプルコード

実行結果

ポイント解説

よくあるエラー例

まとめ

関連記事

コメントを残す コメントをキャンセル

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

　関連記事

コメントを残す