JavaのJacksonライブラリでJSONとMapを相互変換する方法

JacksonはJava向けの高性能なJSON処理ライブラリで、強力なデータバインディング機能を備えています。カスタムJavaオブジェクトをJSONにシリアライズしたり、JSONをJavaオブジェクトにデシリアライズしたりするためのフレームワークを提供します。

JSONとMapの相互変換には、com.fasterxml.jackson.databind.ObjectMapperクラスが提供するreadValue()メソッドとwriteValueAsString()メソッドを使用します。

事前準備：Maven依存関係の追加

Jacksonを使用するには、まずプロジェクトに依存関係を追加します。Mavenの場合は、pom.xmlに以下を記述してください。

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.17.1</version>
</dependency>

JSONからMapへの変換

構文

public <T> T readValue(String content, TypeReference valueTypeRef) throws IOException, JsonParseException, JsonMappingException

readValue()メソッドは、JSON文字列を解析し、指定されたTypeReferenceに基づいてJavaオブジェクト（ここではMap）へ変換します。

サンプルコード

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

public class ConvertJSONToMapTest {
   public static void main(String args[]) {
      try {
         ObjectMapper mapper = new ObjectMapper();
         String jsonString = "{\"Name\":\"Raja\", \"Technology\":\"Java\"}";
         Map<String, Object> jsonMap = new HashMap<String, Object>();
         // JSON文字列をMapに変換
         jsonMap = mapper.readValue(jsonString, new TypeReference<Map<String, String>>(){});
         System.out.println(jsonMap);
      } catch(IOException ie) {
         ie.printStackTrace();
      }
   }
}

実行結果

{Name=Raja, Technology=Java}

MapからJSONへの変換

構文

public String writeValueAsString(Object value) throws JsonProcessingException

writeValueAsString()メソッドは、任意のJavaオブジェクト（Mapなど）をJSON形式の文字列にシリアライズします。

サンプルコード

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

public class ConvertMapToJSONTest {
   public static void main(String args[]) throws IOException {
      ObjectMapper mapper = new ObjectMapper();
      String jsonString = "";
      Map<String, Object> map = new HashMap<String, Object>();
      map.put("Raja", "Java Technology");
      map.put("Ravi", "Python Technology");
      map.put("Adithya", "Spark Technology");
      map.put("Vamsi", "Web Technology");
      // MapをJSON文字列に変換
      jsonString = mapper.writeValueAsString(map);
      System.out.println(jsonString);
   }
}

実行結果

{"Raja":"Java Technology", "Vamsi":"Web Technology", "Ravi":"Python Technology", "Adithya":"Spark Technology"}

まとめ

JacksonのObjectMapperクラスを使えば、readValue()でJSONからMapへ、writeValueAsString()でMapからJSONへと簡単に相互変換できます。TypeReferenceを活用することで、ジェネリクスを含む複雑な型への変換も型安全に実装できるのが大きなメリットです。API通信やデータ処理の場面でぜひ活用してみてください。