【Java】JSONオブジェクトをファイルに書き込む方法（json-simpleライブラリの使い方）

JSON（JavaScript Object Notation）は、現在もっとも広く使われているデータ交換フォーマットのひとつです。軽量であることと、特定のプログラミング言語に依存しないことが大きな特徴で、異なるシステム間でのデータやり取りに最適です。

JavaでJSONファイルを読み書きするには、json-simple ライブラリが便利です。json-simpleは軽量なJSON処理ライブラリで、JSONテキストのエンコード（書き込み）とデコード（読み込み）の両方に対応しており、JSON仕様（RFC4627）に完全準拠しています。

ライブラリの準備

json-simpleを使用するには、まず json-simple.jar ファイルをダウンロードし、プロジェクトのクラスパスに設定します。Mavenを利用している場合は、以下の依存関係を pom.xml に追加するだけで導入できます。

<dependency>
    <groupId>com.googlecode.json-simple</groupId>
    <artifactId>json-simple</artifactId>
    <version>1.1.1</version>
</dependency>

サンプルコード：JSONオブジェクトをファイルに書き込む

以下は、JSONObject を作成し、その内容をJSONファイルとして保存する例です。

import java.io.*;
import java.util.*;
import org.json.simple.*;
import org.json.simple.parser.*;
public class JSONObjectWriterToFileTest {
   public static void main(String[] args) throws IOException {
      JSONObject obj = new JSONObject();
      obj.put("Name", "Adithya");
      obj.put("Course", "MCA");
      JSONArray subjects = new JSONArray();
      subjects.add("Subject1: DBMS");
      subjects.add("Subject2: JAVA");
      subjects.add("Subject3: PYTHON");
      obj.put("Subjects:", subjects);
      try (FileWriter file = new FileWriter("/Users/User/Desktop/course1.json")) {
         file.write(obj.toJSONString());
         System.out.println("JSON Object write to a File successfully");
         System.out.println("JSON Object: " + obj);
      }
   }
}

コードのポイント

• JSONObject クラスの put() メソッドでキーと値のペアを追加します。
• JSONArray クラスを使うと、複数の要素を配列形式で格納できます。
• toJSONString() メソッドでオブジェクトをJSON形式の文字列に変換し、FileWriter 経由でファイルに書き出します。
• try-with-resources 構文を使用することで、ストリームのクローズ漏れを防ぎ、リソースを自動的に解放できます。

出力された course1.json ファイル

プログラムを実行すると、指定したパスに以下のようなJSONファイルが生成されます。

実行結果

JSON Object write to a File successfully
JSON Object: {"Subjects:":["Subject1: DBMS","Subject2: JAVA","Subject3: PYTHON"],"Course":"MCA","Name":"Adithya"}

このように、json-simpleライブラリを使えば、数行のコードで簡単にJSONオブジェクトをファイルへ書き込むことができます。設定ファイルの保存やAPIレスポンスのキャッシュなど、さまざまな場面で活用できるので、ぜひ参考にしてください。