JavaでGsonを使って重複キーなしのJSONを解析する方法

Gsonは、Googleが開発したJava向けのJSONライブラリです。Gsonを利用することで、JSONの生成や、JSONからJavaオブジェクトへの変換を簡単に行うことができます。Gsonインスタンスを作成するには、GsonBuilderクラスのインスタンスを生成し、create()メソッドを呼び出します。

重複キーを持たないJSONを解析する場合は、TypeTokenクラスを使用します。Map型の型リテラル（Type Literal）を作成したいときは、空の匿名内部クラス（匿名サブクラス）を定義するのが一般的な手法です。Mapではキーの重複が許されないため、もしJSONに同じキーが含まれていた場合、解析時に以下のような実行時エラーが発生します。

Exception in thread "main" com.google.gson.JsonSyntaxException: duplicate key

TypeTokenクラスの構文

public class TypeToken<T> extends Object

TypeTokenはジェネリック型の情報を実行時に保持するためのクラスで、getType()メソッドを呼び出すことで、対応するJavaのTypeオブジェクトを取得できます。これにより、Map<Integer, String>のような複雑なジェネリック型も正しく指定できるようになります。

コード例

以下は、GsonとTypeTokenを使って、キーがInteger型・値がString型のMapとしてJSONを解析するサンプルコードです。

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

public class JsonWithoutDuplicateKeysTest {
    public static void main(String args[]) throws Exception {
        String json = "{\"123\":\"abc\", \"124\":\"def\", \"125\":\"ghi\"}";
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        Type mapType = new TypeToken<Map<Integer, String>>() {}.getType();
        Map<String, String> map = gson.fromJson(json, mapType);
        System.out.println(map);
    }
}

実行結果

{123=abc, 124=def, 125=ghi}

ポイントまとめ

• GsonBuilder#create()でGsonインスタンスを生成する。
• ジェネリック型（Mapなど）を指定する際は、TypeTokenの匿名サブクラスを作成してgetType()で型情報を取得する。
• JSON内に重複キーが存在すると、JsonSyntaxException: duplicate keyがスローされるため、事前にデータの検証を行っておくと安全です。