JavaのGsonライブラリでMapをJSONに変換する方法をわかりやすく解説

Gsonは、JavaオブジェクトをJSONに変換（シリアライズ）したり、その逆にJSONからJavaオブジェクトへ変換（デシリアライズ）したりできるGoogle製のオープンソースライブラリです。JSON文字列を同等のJavaオブジェクトにマッピングすることも可能です。これらの変換を行うには、Javaプログラムにcom.google.gsonパッケージをインポートする必要があります。

Gsonインスタンスの生成方法

Gsonのインスタンスは、主に以下の2つの方法で作成できます。

• new Gson() を使って直接インスタンス化する
• GsonBuilder のインスタンスを作成し、create() メソッドを呼び出して生成する

GsonBuilderを使用すると、整形出力（pretty printing）やnull値の扱いなど、細かいカスタマイズも可能になります。

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

以下のプログラムでは、SortedMap（TreeMap）に格納したデータをGsonを使ってJSON形式の文字列に変換しています。ジェネリクスの型情報を保持するために、TypeTokenを利用している点がポイントです。

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

public class ConvertMapToJsonTest {
    public static void main(String args[]) {
        SortedMap<String, String> data = new TreeMap<String, String>();
        data.put("Raja", "Java");
        data.put("Ravi", "SAP");
        data.put("Surya", "Python");
        data.put("Kiran", "Scala");
        data.put("Vamsi", "Selenium");

        Gson gson = new Gson();
        Type gsonType = new TypeToken<SortedMap<String, String>>(){}.getType();
        String gsonString = gson.toJson(data, gsonType);
        System.out.println(gsonString);
    }
}

実行結果

{"Kiran":"Scala","Raja":"Java","Ravi":"SAP","Surya":"Python","Vamsi":"Selenium"}

TreeMapはキーを自然順序（アルファベット順）でソートするため、出力されるJSONも「Kiran」「Raja」「Ravi」「Surya」「Vamsi」の順になっています。このように、GsonとTypeTokenを組み合わせることで、Map型のコレクションでも型安全にJSONへ変換できます。