JavaのJSON処理｜Jacksonライブラリの使い方

先生

JavaでJSONを扱うならJackson一択！導入からシリアライズ・デシリアライズまで、サクッと理解してJSONマスターになろう！

Jacksonライブラリとは？JavaでのJSON処理を強力にサポート

JavaでJSONデータを扱う際、Jacksonライブラリは非常に強力なツールとなります。JSON（JavaScript Object Notation）は、軽量なデータ交換フォーマットであり、Web APIとの連携や設定ファイルの記述など、様々な場面で利用されています。

Jacksonは、JSONデータの解析（デシリアライズ）とJSONデータの生成（シリアライズ）を簡単に行うことができるJavaライブラリです。高速な処理速度、柔軟な設定オプション、そして使いやすさが特徴で、多くのJavaプロジェクトで採用されています。

この記事では、Jacksonライブラリの基本的な使い方から、より高度なテクニックまでを解説します。JSON処理を効率化し、より洗練されたJavaアプリケーションを開発するための知識を習得しましょう。

Jacksonライブラリの導入方法

Jacksonライブラリを使用するには、まずプロジェクトにライブラリを追加する必要があります。MavenまたはGradleを使用している場合は、以下の依存関係を追加します。

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.16.1</version>
</dependency>
implementation 'com.fasterxml.jackson.core:jackson-databind:2.16.1'

上記の例では、jackson-databindというコアモジュールを追加しています。このモジュールには、基本的なJSONのシリアライズ・デシリアライズ機能が含まれています。他のモジュール（jackson-core, jackson-annotationsなど）も必要に応じて追加できます。

IDE（IntelliJ IDEA, Eclipseなど）を使用している場合は、依存関係を追加すると自動的にライブラリがダウンロードされ、プロジェクトで使用できるようになります。

JSONのシリアライズ（JavaオブジェクトからJSONへ変換）

JavaオブジェクトをJSON文字列に変換することをシリアライズと呼びます。Jacksonライブラリでは、ObjectMapperクラスを使用してシリアライズを行います。

以下は、JavaオブジェクトをJSON文字列に変換する例です。

import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;

public class SerializationExample {

    public static void main(String[] args) throws IOException {
        // Javaオブジェクトの定義
        Person person = new Person("Taro", "Yamada", 30);

        // ObjectMapperのインスタンス生成
        ObjectMapper objectMapper = new ObjectMapper();

        // JavaオブジェクトをJSON文字列に変換
        String jsonString = objectMapper.writeValueAsString(person);

        // JSON文字列の出力
        System.out.println(jsonString); // 出力: {"firstName":"Taro","lastName":"Yamada","age":30}
    }
}

// Personクラス（getter, setter, コンストラクタは省略）
class Person {
    private String firstName;
    private String lastName;
    private int age;

    public Person(String firstName, String lastName, int age) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.age = age;
    }

    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 int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

ObjectMapper#writeValueAsString()メソッドは、Javaオブジェクトを受け取り、対応するJSON文字列を返します。この例では、PersonオブジェクトがJSON文字列に変換されています。

JSONのデシリアライズ（JSONからJavaオブジェクトへ変換）

JSON文字列をJavaオブジェクトに変換することをデシリアライズと呼びます。Jacksonライブラリでは、ObjectMapperクラスを使用してデシリアライズを行います。

以下は、JSON文字列をJavaオブジェクトに変換する例です。

import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;

public class DeserializationExample {

    public static void main(String[] args) throws IOException {
        // JSON文字列の定義
        String jsonString = "{\"firstName\":\"Taro\",\"lastName\":\"Yamada\",\"age\":30}";

        // ObjectMapperのインスタンス生成
        ObjectMapper objectMapper = new ObjectMapper();

        // JSON文字列をJavaオブジェクトに変換
        Person person = objectMapper.readValue(jsonString, Person.class);

        // Javaオブジェクトの情報の出力
        System.out.println(person.getFirstName()); // 出力: Taro
        System.out.println(person.getLastName());  // 出力: Yamada
        System.out.println(person.getAge());       // 出力: 30
    }
}

// Personクラス（getter, setter, コンストラクタは省略、シリアライズの例と同じものを使用）
class Person {
    private String firstName;
    private String lastName;
    private int age;

    public Person(String firstName, String lastName, int age) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.age = age;
    }

    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 int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

ObjectMapper#readValue()メソッドは、JSON文字列とJavaクラスを受け取り、JSONデータに対応するJavaオブジェクトを返します。この例では、JSON文字列がPersonオブジェクトに変換されています。

参考リンク

まとめ

Jacksonライブラリは、JavaでのJSON処理を簡単かつ効率的に行うための強力なツールです。シリアライズとデシリアライズの基本を理解することで、Web APIとの連携や設定ファイルの処理など、様々な場面でJSONデータを活用することができます。この記事を参考に、Jacksonライブラリを使いこなして、より洗練されたJavaアプリケーションを開発してください。