json

Java – JSONをListに変換する方法

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

JavaでJSONをListに変換するには、一般的にライブラリを使用します。

代表的なものにJacksonやGsonがあります。

JacksonではObjectMapperを使用し、readValueメソッドでJSON文字列をListに変換できます。

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

どちらも型情報を指定することで、リスト内の要素を適切にマッピングできます。

目次から探す

JSONをListに変換する方法：Jackson編

JavaでJSONをListに変換するためには、Jacksonライブラリを使用するのが一般的です。

Jacksonは、JSONデータをJavaオブジェクトに変換するための強力なツールです。

以下に、Jacksonを使ったJSONからListへの変換方法を示します。

Jacksonライブラリの依存関係

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

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

依存関係名	バージョン
`com.fasterxml.jackson.core:jackson-databind`	2.13.0

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

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "[{\"name\":\"山田太郎\",\"age\":30},{\"name\":\"佐藤花子\",\"age\":25}]";
        
        // ObjectMapperのインスタンスを作成
        ObjectMapper objectMapper = new ObjectMapper();
        
        try {
            // JSONをListに変換
            List<Map<String, Object>> list = objectMapper.readValue(jsonString, new TypeReference<List<Map<String, Object>>>(){});
            
            // 結果を表示
            for (Map<String, Object> item : list) {
                System.out.println("名前: " + item.get("name") + ", 年齢: " + item.get("age"));
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

名前: 山田太郎, 年齢: 30
名前: 佐藤花子, 年齢: 25

このコードでは、ObjectMapperを使用してJSON文字列をList<Map<String, Object>>に変換しています。

TypeReferenceを使うことで、ジェネリクスを正しく扱うことができます。

変換後、Listの各要素にアクセスし、名前と年齢を表示しています。

Jacksonは非常に柔軟で、さまざまなデータ構造に対応しています。

JSONをListに変換する方法：Gson編

Gsonは、Googleが提供するJava用のJSONライブラリで、JSONデータをJavaオブジェクトに簡単に変換することができます。

以下では、Gsonを使用してJSONをListに変換する方法を説明します。

Gsonライブラリの依存関係

Gsonをプロジェクトに追加するためには、Mavenを使用している場合、pom.xmlに以下の依存関係を追加します。

依存関係名	バージョン
`com.google.code.gson:gson`	2.8.8

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

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "[{\"name\":\"山田太郎\",\"age\":30},{\"name\":\"佐藤花子\",\"age\":25}]";
        
        // Gsonのインスタンスを作成
        Gson gson = new Gson();
        
        // Listの型を定義
        Type listType = new TypeToken<List<Map<String, Object>>>(){}.getType();
        
        // JSONをListに変換
        List<Map<String, Object>> list = gson.fromJson(jsonString, listType);
        
        // 結果を表示
        for (Map<String, Object> item : list) {
            System.out.println("名前: " + item.get("name") + ", 年齢: " + item.get("age"));
        }
    }
}

名前: 山田太郎, 年齢: 30
名前: 佐藤花子, 年齢: 25

このコードでは、Gsonを使用してJSON文字列をList<Map<String, Object>>に変換しています。

TypeTokenを使うことで、Listの型を正しく指定することができます。

変換後、Listの各要素にアクセスし、名前と年齢を表示しています。

Gsonはシンプルで使いやすく、特に軽量なアプリケーションに適しています。

JSONをListに変換する方法：その他のライブラリ

Javaには、JacksonやGson以外にもJSONをListに変換するためのライブラリがいくつか存在します。

ここでは、代表的なライブラリであるJson-libとorg.jsonを使用した方法を紹介します。

Json-libを使用する方法

Json-libは、JavaオブジェクトとJSONの相互変換をサポートするライブラリです。

以下に、Json-libを使ったJSONからListへの変換方法を示します。

Json-libライブラリの依存関係

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

依存関係名	バージョン
`net.sf.json-lib:json-lib`	2.4

以下は、Json-libを使用してJSON文字列をListに変換するサンプルコードです。

import net.sf.json.JSONArray;
import net.sf.json.JSONObject;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "[{\"name\":\"山田太郎\",\"age\":30},{\"name\":\"佐藤花子\",\"age\":25}]";
        
        // JSON配列を作成
        JSONArray jsonArray = JSONArray.fromObject(jsonString);
        
        // JSONをListに変換
        List<Map<String, Object>> list = jsonArray;
        
        // 結果を表示
        for (Map<String, Object> item : list) {
            System.out.println("名前: " + item.get("name") + ", 年齢: " + item.get("age"));
        }
    }
}

名前: 山田太郎, 年齢: 30
名前: 佐藤花子, 年齢: 25

org.jsonを使用する方法

org.jsonは、シンプルで使いやすいJSON処理ライブラリです。

以下に、org.jsonを使ったJSONからListへの変換方法を示します。

org.jsonライブラリの依存関係

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

依存関係名	バージョン
`org.json:json`	20210307

以下は、org.jsonを使用してJSON文字列をListに変換するサンプルコードです。

import org.json.JSONArray;
import org.json.JSONObject;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        // JSON文字列
        String jsonString = "[{\"name\":\"山田太郎\",\"age\":30},{\"name\":\"佐藤花子\",\"age\":25}]";
        
        // JSON配列を作成
        JSONArray jsonArray = new JSONArray(jsonString);
        
        // Listを作成
        List<Map<String, Object>> list = new ArrayList<>();
        
        // JSONをListに変換
        for (int i = 0; i < jsonArray.length(); i++) {
            JSONObject jsonObject = jsonArray.getJSONObject(i);
            list.add(jsonObject.toMap());
        }
        
        // 結果を表示
        for (Map<String, Object> item : list) {
            System.out.println("名前: " + item.get("name") + ", 年齢: " + item.get("age"));
        }
    }
}

名前: 山田太郎, 年齢: 30
名前: 佐藤花子, 年齢: 25

上記のコードでは、Json-libとorg.jsonを使用してJSON文字列をListに変換しています。

Json-libではJSONArrayを使って直接Listに変換し、org.jsonではJSONObjectを使ってMapに変換した後、Listに追加しています。

これらのライブラリも非常に便利で、特定のニーズに応じて選択することができます。

JSONをListに変換する際の応用例

JSONをListに変換する技術は、さまざまなアプリケーションで活用されています。

ここでは、実際のシナリオに基づいた応用例をいくつか紹介します。

1. APIからのデータ取得

多くのWebアプリケーションでは、外部APIからデータを取得し、表示する必要があります。

JSON形式で返されるデータをListに変換することで、簡単にデータを操作できます。

以下は、APIから取得したJSONデータをListに変換する例です。

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        try {
            // APIのURL
            String apiUrl = "https://api.example.com/data";
            
            // URL接続を作成
            HttpURLConnection connection = (HttpURLConnection) new URL(apiUrl).openConnection();
            connection.setRequestMethod("GET");
            
            // レスポンスを取得
            InputStream responseStream = connection.getInputStream();
            
            // ObjectMapperのインスタンスを作成
            ObjectMapper objectMapper = new ObjectMapper();
            
            // JSONをListに変換
            List<Map<String, Object>> list = objectMapper.readValue(responseStream, new TypeReference<List<Map<String, Object>>>(){});
            
            // 結果を表示
            for (Map<String, Object> item : list) {
                System.out.println("データ: " + item);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. データベースからのデータ取得

データベースから取得したデータをJSON形式で返し、それをListに変換してアプリケーション内で利用することも一般的です。

これにより、データの操作が容易になります。

以下は、データベースから取得したJSONデータをListに変換する例です。

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
import java.util.List;
import java.util.Map;
public class App {
    public static void main(String[] args) {
        try {
            // データベース接続
            Connection connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mydb", "user", "password");
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery("SELECT * FROM users");
            
            // JSON文字列を作成
            StringBuilder jsonString = new StringBuilder("[");
            while (resultSet.next()) {
                jsonString.append("{\"name\":\"").append(resultSet.getString("name")).append("\",\"age\":").append(resultSet.getInt("age")).append("},");
            }
            jsonString.deleteCharAt(jsonString.length() - 1); // 最後のカンマを削除
            jsonString.append("]");
            
            // Gsonのインスタンスを作成
            Gson gson = new Gson();
            
            // Listの型を定義
            Type listType = new TypeToken<List<Map<String, Object>>>(){}.getType();
            
            // JSONをListに変換
            List<Map<String, Object>> list = gson.fromJson(jsonString.toString(), listType);
            
            // 結果を表示
            for (Map<String, Object> item : list) {
                System.out.println("名前: " + item.get("name") + ", 年齢: " + item.get("age"));
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. フロントエンドとのデータ連携

フロントエンドアプリケーション(例えば、ReactやVue.js)とバックエンドJavaアプリケーション間でデータをやり取りする際、JSONを使用することが一般的です。

バックエンドでJSONをListに変換し、フロントエンドに送信することで、データの整合性を保ちながら効率的にデータを扱えます。

4. データ分析

JSON形式で保存されたデータをListに変換し、分析や集計を行うことも可能です。

例えば、ユーザーの行動データをJSONで取得し、Listに変換して統計情報を生成することができます。

これらの応用例からもわかるように、JSONをListに変換する技術は、さまざまなシナリオで非常に役立ちます。

データの取得、操作、分析を効率的に行うために、これらの技術を活用してみてください。

JSONをListに変換する際のベストプラクティス

JSONをListに変換する際には、いくつかのベストプラクティスを守ることで、コードの可読性やメンテナンス性を向上させることができます。

以下に、具体的なポイントをいくつか紹介します。

1. 適切なライブラリの選定

Jackson: 高速で柔軟性があり、広く使われています。
Gson: シンプルで使いやすく、特に軽量なアプリケーションに適しています。
Json-libやorg.json: 特定のニーズに応じて選択することができます。

2. 型安全性の確保

JSONをListに変換する際は、型安全性を確保するために、適切な型を指定することが重要です。

例えば、TypeReferenceやTypeTokenを使用して、Listの型を明示的に指定しましょう。

// Jacksonの例
List<Map<String, Object>> list = objectMapper.readValue(jsonString, new TypeReference<List<Map<String, Object>>>(){});
// Gsonの例
Type listType = new TypeToken<List<Map<String, Object>>>(){}.getType();
List<Map<String, Object>> list = gson.fromJson(jsonString, listType);

3. エラーハンドリングの実装

JSONのパース中にエラーが発生する可能性があるため、適切なエラーハンドリングを実装することが重要です。

例外をキャッチし、適切なメッセージを表示することで、デバッグが容易になります。

try {
    // JSONをListに変換
} catch (JsonParseException e) {
    System.err.println("JSONのパース中にエラーが発生しました: " + e.getMessage());
} catch (IOException e) {
    System.err.println("入出力エラーが発生しました: " + e.getMessage());
}