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

Jacksonライブラリの中核となるのが ObjectMapper クラスです。このクラスが提供する readValue() メソッドを使用すると、JSON形式の文字列をJavaオブジェクトへ変換（デシリアライズ）することができます。逆に、JavaオブジェクトからJSON文字列を生成したい場合は writeValueAsString() メソッドを利用します。

readValue() メソッドの構文

public <T> readValue(String content, JavaType valueType) throws IOException, JsonParseException, JsonMappingException

第一引数には変換元のJSON文字列を、第二引数にはマッピング先のJavaクラス（またはJavaType）を指定します。JSONの構造が不正な場合や、オブジェクトへのマッピングに失敗した場合には、それぞれ JsonParseException や JsonMappingException がスローされる点に注意してください。

サンプルコード

以下の例では、まずEmployeeオブジェクトを作成してJSON文字列にシリアライズし、その後そのJSON文字列を再びEmployeeオブジェクトへデシリアライズしています。

import java.io.*;
import java.util.*;
import com.fasterxml.jackson.core.*;
import com.fasterxml.jackson.databind.*;

public class JSONToJavaObjectTest {
    public static void main(String args[]) throws JsonGenerationException, JsonMappingException, IOException {
        // Employeeオブジェクトを作成
        Employee emp1 = new Employee();
        emp1.setFirstName("Raja");
        emp1.setLastName("Ramesh");
        emp1.setId(115);
        emp1.getTechnologies().add("Java");
        emp1.getTechnologies().add("Selenium");
        emp1.getTechnologies().add("Spark");

        // JavaオブジェクトをJSON文字列にシリアライズ
        ObjectMapper mapper = new ObjectMapper();
        String jsonStr = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(emp1);
        System.out.println(jsonStr);

        // JSON文字列をJavaオブジェクトにデシリアライズ
        System.out.println("Deserializing JSON to Object:");
        Employee emp2 = mapper.readValue(jsonStr, Employee.class);
        System.out.println(emp2.getId() + " " + emp2.getFirstName() + " " + emp2.getLastName() + " " + emp2.getTechnologies());
    }
}

// Employeeクラス
class Employee {
    private int id;
    private String firstName;
    private String lastName;
    private List technologies = new ArrayList<>();

    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getFirstName() {
        return firstName;
    }
    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }
    public String getLastName() {
        return lastName;
    }
    public void setLastName(String lastName) {
        this.lastName = lastName;
    }
    public List getTechnologies() {
        return technologies;
    }
    public void setTechnologies(List technologies) {
        this.technologies = technologies;
    }
}

実行結果

{
  "id" : 115,
  "firstName" : "Raja",
  "lastName" : "Ramesh",
  "technologies" : [ "Java", "Selenium", "Spark" ]
}
Deserializing JSON to Object:
115 Raja Ramesh [Java, Selenium, Spark]

このように、mapper.readValue(jsonStr, Employee.class) を呼び出すだけで、JSON文字列の各フィールドがEmployeeクラスの対応するプロパティに自動的にマッピングされます。Jacksonはゲッター・セッターの命名規則に基づいてフィールドを判定するため、POJO（Plain Old Java Object）さえ用意しておけば、特別な設定なしでJSONとJavaオブジェクトの相互変換が可能です。