JavaでJacksonのObject Modelを使ってJSONデータをマッピングする方法

JavaでJSONを扱う際に広く利用されているJacksonライブラリでは、ObjectMapperクラスがJavaオブジェクトとJSON構造の間の相互変換を担います。

JSONデータをオブジェクトモデル（Object Model）として表現し、特定のJavaオブジェクトへマッピングするには、ツリー構造を活用します。このアプローチでは、JSONコンテンツ全体が一度にメモリへ読み込まれ、木構造として保持されます。

処理の流れはシンプルです。まずJSONデータをJsonNodeオブジェクトとして読み込み、続いてObjectMapperクラスのtreeToValue()メソッドを呼び出すことで、そのノードを任意のJavaオブジェクトのインスタンスへ変換します。

treeToValue()メソッドの構文

public <T> T treeToValue(TreeNode n, Class<T> valueType) throws JsonProcessingException

サンプルコード

以下の例では、JSON形式の文字列をreadTree()でJsonNodeとして読み込み、treeToValue()によってUserクラスのオブジェクトへマッピングしています。

import java.io.*;
import com.fasterxml.jackson.core.*;
import com.fasterxml.jackson.databind.*;
public class JsonTreeModelDemo {
    public static void main(String[] args) throws JsonProcessingException, IOException {
        String jsonString = "{\"id\":\"102\", \"name\":\"Raja Ramesh\", \"address\":[{\"area\":\"Madhapur\", \"city\":\"Hyderabad\"}]}";
        ObjectMapper objectMapper = new ObjectMapper();
        JsonNode jsonNode = objectMapper.readTree(jsonString);
        User user = objectMapper.treeToValue(jsonNode, User.class);
        System.out.println(user);
    }
}
// Userクラス
class User {
    private int id;
    private String name;
    private Address[] address;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public Address[] getAddress() {
        return address;
    }
    public void setAddress(Address[] address) {
        this.address = address;
    }
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        sb.append(id).append(",");
        sb.append(name).append(",");
        for(Address address1 : address) {
            sb.append(address1).append(",");
        }
        sb.append("}");
        return sb.toString();
    }
}
// Addressクラス
class Address {
    private String area;
    private String city;
    public String getArea() {
        return area;
    }
    public void setArea(String area) {
        this.area = area;
    }
    public String getCity() {
        return city;
    }
    public void setCity(String city) {
        this.city = city;
    }
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        sb.append(area).append(",");
        sb.append(city);
        sb.append("}");
        return sb.toString();
    }
}

実行結果

{102,Raja Ramesh,{Madhapur,Hyderabad}}

ポイント解説

• readTree()：JSON文字列を解析し、JsonNodeによるツリー構造としてメモリ上に展開します。
• treeToValue()：読み込んだJsonNodeを、指定したJavaクラス（POJO）のインスタンスへ変換します。
• JSON内の配列やネストされたオブジェクトも、Address[]のような対応するフィールド型へ自動的にマッピングされます。