JavaのGsonライブラリでJSONオブジェクトをJavaオブジェクトに変換する方法

Gsonは、Googleが開発したJava向けのJSONライブラリです。Gsonを使用することで、JavaオブジェクトからJSONを生成したり、その逆にJSONをJavaオブジェクトへ変換したりすることができます。

JSONオブジェクトをJavaオブジェクトに変換（デシリアライズ）するには、GsonクラスのfromJson()メソッドを呼び出します。このメソッドは、JSON文字列とターゲットとなるクラスを引数に受け取り、対応するJavaオブジェクトを返します。

構文

public <T> fromJson(java.lang.String json, java.lang.Class<T> classOfT) throws JsonSyntaxException

第一引数には変換元のJSON文字列を、第二引数にはマッピング先のクラスのClassオブジェクトを指定します。JSONの形式が不正な場合はJsonSyntaxExceptionがスローされる点に注意してください。

使用例

以下の例では、JSON文字列「{'name':'raja','age':25}」をEmpクラスのオブジェクトに変換しています。

import com.google.gson.*;

public class JSONtoJavaObjTest {
   public static void main(String[] args) {
      Gson gson = new Gson();
      Emp emp = gson.fromJson("{'name':'raja','age':25}", Emp.class);
      System.out.println(emp.getName());
      System.out.println(emp.getAge());
   }
}

// Empクラス
class Emp {
   String name;
   int age;

   public Emp() {
      super();
   }

   public Emp(String name, int age) {
      super();
      this.name = name;
      this.age = 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;
   }
}

実行結果

raja
25

ポイント

• デシリアライズの対象となるクラス（この例ではEmpクラス）には、引数なしのコンストラクタが必要です。Gsonがリフレクションを使ってインスタンスを生成するためです。
• JSONのキー名（name、age）は、クラスのフィールド名と一致している必要があります。一致しない場合は@SerializedNameアノテーションでマッピングを定義できます。
• 依存関係を追加するには、Mavenであれば「com.google.code.gson:gson」をpom.xmlに記述します。