json

Java – JSON文字列をパースしてオブジェクトに変換する方法

JavaでJSON文字列をパースしてオブジェクトに変換するには、一般的にライブラリを使用します。

代表的なライブラリとして Jackson や Gson があります。

JacksonではObjectMapperクラスを使用し、readValueメソッドでJSON文字列を指定のクラスにマッピングします。

GsonではGsonクラスのfromJsonメソッドを使用します。

どちらもシンプルで効率的にJSONをオブジェクトに変換できます。

目次から探す

Javaで使用する主要なJSONライブラリ
Jacksonを使ったJSONパース
- Jacksonの依存関係
Gsonを使ったJSONパース
- Gsonの依存関係
org.jsonを使ったJSONパース
- org.jsonの依存関係
まとめ

Javaで使用する主要なJSONライブラリ

JavaでJSONを扱うためのライブラリはいくつか存在します。

以下に代表的なライブラリを示します。

これらのライブラリは、JSON文字列をオブジェクトに変換する際に非常に便利です。

ライブラリ名	特徴	使用例
Jackson	高速で柔軟性が高い。データバインディングが容易。	JSONからJavaオブジェクトへの変換が簡単。
Gson	Googleが開発したライブラリ。シンプルで使いやすい。	JavaオブジェクトをJSONに変換するのが得意。
org.json	シンプルなAPIを提供。軽量で使いやすい。	JSONの操作が直感的に行える。

これらのライブラリはそれぞれ異なる特徴を持っており、プロジェクトの要件に応じて選択することが重要です。

次のセクションでは、具体的なライブラリの使用方法について詳しく解説します。

Jacksonを使ったJSONパース

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

高速で柔軟性が高く、データバインディングが容易なため、多くのプロジェクトで利用されています。

以下に、Jacksonを使用してJSON文字列をJavaオブジェクトに変換する方法を示します。

Jacksonの依存関係

まず、Jacksonを使用するためには、以下の依存関係をプロジェクトに追加する必要があります。

Mavenを使用している場合、pom.xmlに次のように記述します。

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下は、Jacksonを使用してJSON文字列をJavaオブジェクトに変換するサンプルコードです。

import com.fasterxml.jackson.databind.ObjectMapper; // JacksonのObjectMapperをインポート
import java.io.IOException; // IOExceptionをインポート
// ユーザー情報を格納するクラス
class User {
    private String name; // ユーザー名
    private int age; // 年齢
    // ゲッターとセッター
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
}
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "{\"name\":\"山田太郎\", \"age\":30}"; // JSON形式の文字列
        ObjectMapper objectMapper = new ObjectMapper(); // ObjectMapperのインスタンスを作成
        try {
            // JSON文字列をUserオブジェクトに変換
            User user = objectMapper.readValue(jsonString, User.class); // パース処理
            // 結果を表示
            System.out.println("名前: " + user.getName()); // ユーザー名を表示
            System.out.println("年齢: " + user.getAge()); // 年齢を表示
        } catch (IOException e) {
            e.printStackTrace(); // エラーが発生した場合はスタックトレースを表示
        }
    }
}

名前: 山田太郎
年齢: 30

このコードでは、ObjectMapperを使用してJSON文字列をUserオブジェクトに変換しています。

readValueメソッドを使うことで、簡単にJSONをJavaオブジェクトにマッピングできます。

エラーハンドリングも行っており、IOExceptionが発生した場合にはスタックトレースを表示します。

Gsonを使ったJSONパース

Gsonは、Googleが開発したJava用のJSONライブラリで、シンプルで使いやすいのが特徴です。

Gsonを使用すると、JavaオブジェクトをJSON形式に変換したり、JSON形式をJavaオブジェクトに変換したりすることが簡単にできます。

以下に、Gsonを使用してJSON文字列をJavaオブジェクトに変換する方法を示します。

Gsonの依存関係

Gsonを使用するためには、以下の依存関係をプロジェクトに追加する必要があります。

Mavenを使用している場合、pom.xmlに次のように記述します。

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.8</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下は、Gsonを使用してJSON文字列をJavaオブジェクトに変換するサンプルコードです。

import com.google.gson.Gson; // Gsonをインポート
// ユーザー情報を格納するクラス
class User {
    private String name; // ユーザー名
    private int age; // 年齢
    // ゲッターとセッター
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
}
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "{\"name\":\"佐藤花子\", \"age\":25}"; // JSON形式の文字列
        Gson gson = new Gson(); // Gsonのインスタンスを作成
        // JSON文字列をUserオブジェクトに変換
        User user = gson.fromJson(jsonString, User.class); // パース処理
        // 結果を表示
        System.out.println("名前: " + user.getName()); // ユーザー名を表示
        System.out.println("年齢: " + user.getAge()); // 年齢を表示
    }
}

名前: 佐藤花子
年齢: 25

このコードでは、Gsonを使用してJSON文字列をUserオブジェクトに変換しています。

fromJsonメソッドを使うことで、JSONをJavaオブジェクトに簡単にマッピングできます。

Gsonは非常に直感的で、少ないコードでJSONの操作が可能です。

org.jsonを使ったJSONパース

org.jsonは、シンプルで軽量なJSON処理ライブラリで、JavaでのJSON操作を直感的に行うことができます。

このライブラリは、JSONオブジェクトの作成や解析が容易で、特に小規模なプロジェクトや簡単なJSON操作に適しています。

以下に、org.jsonを使用してJSON文字列をJavaオブジェクトに変換する方法を示します。

org.jsonの依存関係

org.jsonを使用するためには、以下の依存関係をプロジェクトに追加する必要があります。

Mavenを使用している場合、pom.xmlに次のように記述します。

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20210307</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下は、org.jsonを使用してJSON文字列をJavaオブジェクトに変換するサンプルコードです。

import org.json.JSONObject; // JSONObjectをインポート
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "{\"name\":\"鈴木一郎\", \"age\":40}"; // JSON形式の文字列
        // JSON文字列をJSONObjectに変換
        JSONObject jsonObject = new JSONObject(jsonString); // パース処理
        // 結果を表示
        String name = jsonObject.getString("name"); // ユーザー名を取得
        int age = jsonObject.getInt("age"); // 年齢を取得
        System.out.println("名前: " + name); // ユーザー名を表示
        System.out.println("年齢: " + age); // 年齢を表示
    }
}