XML

Java – XMLとJSONを相互に変換する方法を解説

2025-04-15更新日: 2025-04-15

Javaでは、XMLとJSONを相互に変換するために、ライブラリを活用するのが一般的です。

例えば、Jacksonやorg.jsonがよく使用されます。

Jacksonでは、XmlMapperを使用してXMLをJavaオブジェクトに変換し、そのオブジェクトをObjectMapperでJSONに変換できます。

org.jsonでは、XML.toJSONObject()を使ってXMLをJSONに変換し、逆にJSONObject.toString()でJSONをXMLに変換可能です。

目次から探す
  1. JavaでXMLとJSONを相互変換する方法
  2. Jacksonを使ったXMLとJSONの相互変換
  3. org.jsonを使ったXMLとJSONの相互変換
  4. 実際の使用例と注意点
  5. まとめ

JavaでXMLとJSONを相互変換する方法

Javaでは、XMLとJSONのデータ形式を相互に変換するためのライブラリがいくつか存在します。

ここでは、主にJacksonとorg.jsonを使用した方法を解説します。

これらのライブラリを使うことで、簡単にデータの変換が可能です。

まずは、Jacksonを使った方法から見ていきましょう。

Jacksonを使ったXMLとJSONの相互変換

Jacksonは、JavaでJSONを扱うための非常に人気のあるライブラリです。

XMLのサポートもあり、XMLとJSONの相互変換が可能です。

以下に、Jacksonを使ったサンプルコードを示します。

Jacksonのインストール

Mavenを使用している場合、以下の依存関係をpom.xmlに追加します。

ライブラリ名グループIDアーティファクトID
Jackson XMLcom.fasterxml.jackson.dataformatjackson-dataformat-xml
Jackson JSONcom.fasterxml.jackson.corejackson-databind
<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.13.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下は、XMLをJSONに変換するサンプルコードです。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import java.io.File;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        try {
            // XMLファイルを読み込む
            XmlMapper xmlMapper = new XmlMapper();
            MyData data = xmlMapper.readValue(new File("data.xml"), MyData.class);
            // JSONに変換する
            ObjectMapper jsonMapper = new ObjectMapper();
            String jsonString = jsonMapper.writeValueAsString(data);
            // 結果を表示
            System.out.println("JSON形式のデータ:");
            System.out.println(jsonString);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
// データクラス
class MyData {
    public String name;
    public int age;
}

上記のコードを実行すると、以下のようなJSON形式のデータが出力されます。

JSON形式のデータ:
{"name":"山田太郎","age":30}

org.jsonを使ったXMLとJSONの相互変換

次に、org.jsonライブラリを使用したXMLとJSONの相互変換について解説します。

このライブラリも非常にシンプルで使いやすいです。

org.jsonのインストール

Mavenを使用している場合、以下の依存関係をpom.xmlに追加します。

ライブラリ名グループIDアーティファクトID
org.jsonorg.jsonjson
<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20210307</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下は、JSONをXMLに変換するサンプルコードです。

import org.json.JSONObject;
import org.json.XML;
public class App {
    public static void main(String[] args) {
        // JSONデータ
        String jsonString = "{\"name\":\"山田太郎\",\"age\":30}";
        // JSONをXMLに変換する
        JSONObject jsonObject = new JSONObject(jsonString);
        String xmlString = XML.toString(jsonObject);
        // 結果を表示
        System.out.println("XML形式のデータ:");
        System.out.println(xmlString);
    }
}

上記のコードを実行すると、以下のようなXML形式のデータが出力されます。

XML形式のデータ:
<name>山田太郎</name><age>30</age>

実際の使用例と注意点

XMLとJSONの相互変換は、データのフォーマットを変える際に非常に便利です。

ただし、以下の点に注意が必要です。

  • XMLは階層構造を持つため、JSONに変換する際に情報が失われる可能性があります。
  • JSONはデータ型が明確でないため、XMLからJSONに変換する際に型の情報が失われることがあります。
  • 変換後のデータ形式が期待通りであるか、必ず確認することが重要です。

これらのライブラリを活用することで、JavaでのXMLとJSONの相互変換が簡単に行えます。

Jacksonを使ったXMLとJSONの相互変換

Jacksonは、JavaでJSONを扱うための非常に人気のあるライブラリであり、XMLのサポートも充実しています。

これにより、XMLとJSONの相互変換が簡単に行えます。

以下では、Jacksonを使用してXMLをJSONに変換する方法と、JSONをXMLに変換する方法をそれぞれ解説します。

Jacksonのインストール

Jacksonを使用するためには、まず必要なライブラリをプロジェクトに追加する必要があります。

Mavenを使用している場合、以下の依存関係をpom.xmlに追加します。

ライブラリ名グループIDアーティファクトID
Jackson XMLcom.fasterxml.jackson.dataformatjackson-dataformat-xml
Jackson JSONcom.fasterxml.jackson.corejackson-databind
<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.13.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>

XMLをJSONに変換するサンプルコード

以下は、XMLファイルを読み込み、JSON形式に変換するサンプルコードです。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import java.io.File;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        try {
            // XMLファイルを読み込む
            XmlMapper xmlMapper = new XmlMapper();
            MyData data = xmlMapper.readValue(new File("data.xml"), MyData.class);
            // JSONに変換する
            ObjectMapper jsonMapper = new ObjectMapper();
            String jsonString = jsonMapper.writeValueAsString(data);
            // 結果を表示
            System.out.println("JSON形式のデータ:");
            System.out.println(jsonString);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
// データクラス
class MyData {
    public String name; // 名前
    public int age;     // 年齢
}

上記のコードを実行すると、以下のようなJSON形式のデータが出力されます。

JSON形式のデータ:
{"name":"山田太郎","age":30}

JSONをXMLに変換するサンプルコード

次に、JSONデータをXML形式に変換するサンプルコードを示します。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        try {
            // JSONデータ
            String jsonString = "{\"name\":\"山田太郎\",\"age\":30}";
            // JSONをオブジェクトに変換
            ObjectMapper jsonMapper = new ObjectMapper();
            MyData data = jsonMapper.readValue(jsonString, MyData.class);
            // XMLに変換する
            XmlMapper xmlMapper = new XmlMapper();
            String xmlString = xmlMapper.writeValueAsString(data);
            // 結果を表示
            System.out.println("XML形式のデータ:");
            System.out.println(xmlString);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
// データクラス
class MyData {
    public String name; // 名前
    public int age;     // 年齢
}

上記のコードを実行すると、以下のようなXML形式のデータが出力されます。

XML形式のデータ:
<MyData><name>山田太郎</name><age>30</age></MyData>

注意点

  • XMLとJSONの構造は異なるため、変換時に情報が失われる可能性があります。

特に、XMLの属性やネストされた要素はJSONに変換する際に注意が必要です。

  • Jacksonのバージョンによっては、特定の機能が異なる場合がありますので、最新のドキュメントを確認することをお勧めします。

Jacksonを使用することで、XMLとJSONの相互変換が非常に簡単に行えることがわかりました。

これにより、異なるデータフォーマットを扱う際の柔軟性が向上します。

org.jsonを使ったXMLとJSONの相互変換

org.jsonライブラリは、JSONデータを扱うためのシンプルで使いやすいライブラリです。

このライブラリには、XMLとJSONの相互変換を行うための便利な機能が含まれています。

以下では、org.jsonを使用してJSONをXMLに変換する方法と、XMLをJSONに変換する方法を解説します。

org.jsonのインストール

org.jsonライブラリを使用するためには、まず必要な依存関係をプロジェクトに追加する必要があります。

Mavenを使用している場合、以下の依存関係をpom.xmlに追加します。

ライブラリ名グループIDアーティファクトID
org.jsonorg.jsonjson
<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20210307</version> <!-- 最新のバージョンを確認してください -->
</dependency>

JSONをXMLに変換するサンプルコード

以下は、JSONデータをXML形式に変換するサンプルコードです。

import org.json.JSONObject;
import org.json.XML;
public class App {
    public static void main(String[] args) {
        // JSONデータ
        String jsonString = "{\"name\":\"山田太郎\",\"age\":30}";
        // JSONをXMLに変換する
        JSONObject jsonObject = new JSONObject(jsonString);
        String xmlString = XML.toString(jsonObject);
        // 結果を表示
        System.out.println("XML形式のデータ:");
        System.out.println(xmlString);
    }
}

上記のコードを実行すると、以下のようなXML形式のデータが出力されます。

XML形式のデータ:
<name>山田太郎</name><age>30</age>

XMLをJSONに変換するサンプルコード

次に、XMLデータをJSON形式に変換するサンプルコードを示します。

import org.json.JSONObject;
import org.json.XML;
public class App {
    public static void main(String[] args) {
        // XMLデータ
        String xmlString = "<MyData><name>山田太郎</name><age>30</age></MyData>";
        // XMLをJSONに変換する
        JSONObject jsonObject = XML.toJSONObject(xmlString);
        String jsonString = jsonObject.toString();
        // 結果を表示
        System.out.println("JSON形式のデータ:");
        System.out.println(jsonString);
    }
}

上記のコードを実行すると、以下のようなJSON形式のデータが出力されます。

JSON形式のデータ:
{"MyData":{"name":"山田太郎","age":30}}

注意点

  • org.jsonライブラリは、XMLの構造をJSONに変換する際に、XMLの要素名がJSONのキーとして使用されます。

これにより、XMLのネストされた構造がJSONに反映されますが、場合によっては意図しない結果になることがあります。

  • XMLの属性はJSONに変換されないため、XMLの属性を使用している場合は注意が必要です。

org.jsonを使用することで、XMLとJSONの相互変換が簡単に行えることがわかりました。

このライブラリは、シンプルなAPIを提供しており、データの変換を迅速に行うことができます。

実際の使用例と注意点

XMLとJSONの相互変換は、さまざまなアプリケーションやシステムで必要とされる機能です。

特に、異なるシステム間でデータをやり取りする際に、XMLとJSONのフォーマットを変換することが求められます。

以下では、実際の使用例とともに、注意すべき点について解説します。

実際の使用例

  1. Web APIのデータ交換

多くのWeb APIは、JSON形式でデータを返しますが、古いシステムや特定の業界ではXMLが使用されることがあります。

APIを介してデータを取得し、必要に応じてXMLとJSONを相互に変換することで、異なるシステム間でのデータ交換が可能になります。

  1. データベースとの連携

一部のデータベースはXML形式でデータを保存することができます。

アプリケーションがJSON形式でデータを処理する場合、XMLからJSONへの変換を行い、データベースとの連携をスムーズにすることができます。

  1. 設定ファイルの管理

アプリケーションの設定をXML形式で管理している場合、ユーザーインターフェースやAPIでJSON形式を使用することが一般的です。

設定ファイルをXMLからJSONに変換することで、ユーザーが設定を簡単に変更できるようになります。

注意点

  • データの整合性

XMLとJSONは異なるデータ構造を持つため、変換時にデータの整合性が失われる可能性があります。

特に、XMLの属性やネストされた要素はJSONに変換する際に注意が必要です。

変換後のデータが期待通りであるか、必ず確認することが重要です。

  • パフォーマンス

大量のデータを変換する場合、パフォーマンスに影響を与えることがあります。

特に、XMLはJSONに比べて冗長な構造を持つため、変換処理が重くなることがあります。

必要に応じて、変換処理を最適化することを検討してください。

  • ライブラリの選定

使用するライブラリによって、変換の精度や機能が異なる場合があります。

Jacksonやorg.jsonなど、目的に応じたライブラリを選定し、ドキュメントを確認して使用することが重要です。

  • エラーハンドリング

変換処理中にエラーが発生する可能性があります。

特に、無効なXMLやJSONデータを処理する際には、適切なエラーハンドリングを実装することが重要です。

これにより、アプリケーションの安定性が向上します。

XMLとJSONの相互変換は、データの柔軟な取り扱いを可能にしますが、注意点を理解し、適切に実装することが求められます。

これにより、異なるシステム間でのデータ交換が円滑に行えるようになります。

まとめ

この記事では、Javaを使用してXMLとJSONを相互に変換する方法について詳しく解説しました。

Jacksonやorg.jsonといったライブラリを活用することで、データのフォーマットを簡単に変換できることがわかりました。

これらの技術を実際のプロジェクトに取り入れることで、異なるシステム間でのデータ交換がよりスムーズに行えるようになるでしょう。

ぜひ、実際のアプリケーションでこれらの手法を試してみてください。

2025-04-15更新日: 2025-04-15

関連記事

[Java] XMLに要素を追加する方法まとめ

Java – XMLに要素を追加する方法まとめ

2025-04-15
[Java] XMLで特定の要素の中身を書き換える方法

Java – XMLで特定の要素の中身を書き換える方法

2025-04-15
[Java] XMLドキュメントから要素を取得する方法まとめ

Java – XMLドキュメントから要素を取得する方法まとめ

2025-04-15
[Java] XMLから特定の要素を削除する方法

Java – XMLから特定の要素を削除する方法

2025-04-15
[Java] XMLで要素が存在するか検索する方法

Java – XMLで要素が存在するか検索する方法

2025-04-15
[Java] XMLでのエスケープ処理を簡単に行う方法と手動で行う方法

Java – XMLでのエスケープ処理を簡単に行う方法と手動で行う方法

2025-04-15
[Java] XMLを読み込んでパースするまでをわかりやすく解説

Java – XMLを読み込んでパースするまでをわかりやすく解説

2025-04-15
[Java] XMLオブジェクトをただの文字列に変換する方法

Java – XMLオブジェクトをただの文字列に変換する方法

2025-04-15
[Java] XMLをJavaオブジェクトに変換する方法

Java – XMLをJavaオブジェクトに変換する方法

2025-04-15
[Java] XMLを読み込んでMapに変換する方法

Java – XMLを読み込んでMapに変換する方法

2025-04-15
Back to top button