GsonでJSON配列をJavaのジェネリック型Listにデシリアライズする方法

Gsonライブラリには、ジェネリック型の情報を保持するための com.google.gson.reflect.TypeToken クラスが用意されています。TypeToken を継承した匿名サブクラスを作成して対象のクラス型を指定することで、Gson はジェネリッククラスに渡された実際の型を正しく認識できるようになります。

構文

public class TypeToken<T> extends Object

Java の型消去（Type Erasure）の仕様上、実行時にはジェネリック型のパラメータ情報が失われます。しかし、TypeToken を使えば匿名サブクラス経由でその型情報を実行時に取得でき、JSON配列を特定のオブジェクト型のリストへ安全にマッピングできます。

以下の例では、JSON文字列を List<Student> 型にデシリアライズしています。

コード例

import java.lang.reflect.Type;
import java.util.*;
import com.google.gson.*;
import com.google.gson.reflect.*;

public class JSONArrayToListTest {
    public static void main(String args[]) throws Exception {
        String jsonStr = "[{\"name\":\"Adithya\", \"course\":\"Java\"},"
                       + "{\"name\":\"Ravi\", \"course\":\"Python\"}]";

        // TypeTokenでList<Student>の型情報を取得
        Type listType = new TypeToken<ArrayList<Student>>() {}.getType();

        List<Student> students = new Gson().fromJson(jsonStr, listType);
        System.out.println(students);
    }
}

// Studentクラス
class Student {
    String name;
    String course;

    @Override
    public String toString() {
        return "Student [name=" + name + ", course=" + course + "]";
    }
}

実行結果

[Student [name=Adithya, course=Java], Student [name=Ravi, course=Python]]

ポイントまとめ

• TypeToken<ArrayList<Student>>() {} のように、波括弧付きで匿名サブクラスを生成することが重要です。
• getType() メソッドで完全なジェネリック型情報（ParameterizedType）を取得します。
• 取得した型情報を Gson().fromJson() の第二引数に渡すことで、JSON配列が Student オブジェクトのリストとして復元されます。
• 単純に List.class を指定した場合、要素が Student ではなく LinkedTreeMap になってしまうため注意が必要です。