JavaでJSONファイルを作成する方法をわかりやすく解説

JSON（JavaScript Object Notation）は、人間が読みやすい形式でデータを交換するために設計された、軽量なテキストベースのオープン標準フォーマットです。JSONの記法は、C、C++、Java、Python、Perlなど、多くのプログラミング言語に精通したプログラマーにとって馴染み深いものとなっています。

JSONドキュメントのサンプル

以下は、書籍情報を格納した典型的なJSONドキュメントの例です。

{
    "book": [
        {
            "id": "01",
            "language": "Java",
            "edition": "third",
            "author": "Herbert Schildt"
        },
        {
            "id": "07",
            "language": "C++",
            "edition": "second",
            "author": "E.Balagurusamy"
        }
    ]
}

json-simpleライブラリとは

json-simpleは、JSONオブジェクトを処理するための軽量ライブラリです。このライブラリを使用することで、JavaプログラムからJSONドキュメントの内容を読み取ったり、書き込んだりすることができます。シンプルなAPI設計のため、初心者にも扱いやすいのが特徴です。

json-simpleのMaven依存関係

json-simpleライブラリをMavenプロジェクトで利用するには、以下の依存関係をpom.xmlに追加します。

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

上記のコードを、pom.xmlファイル末尾の <dependencies></dependencies> タグ内に貼り付けてください（</project> タグより前の位置に記述します）。

JavaでJSONファイルを作成する手順

Javaプログラムを使ってJSONドキュメントを作成するには、以下の手順に従います。

1. JSONObjectクラスのインスタンス化

まず、json-simpleライブラリのJSONObjectクラスをインスタンス化します。

// JSONObjectオブジェクトの作成
JSONObject jsonObject = new JSONObject();

2. put()メソッドでキーと値を挿入

次に、JSONObjectクラスのput()メソッドを使用して、必要なキーと値のペアを挿入します。

jsonObject.put("key", "value");

3. FileWriterでファイルに書き込み

最後に、FileWriterクラスを使用して、作成したJSONオブジェクトをファイルに書き込みます。

FileWriter file = new FileWriter("E:/output.json");
file.write(jsonObject.toJSONString());
file.close();

完全なサンプルコード

以下のJavaプログラムは、JSONオブジェクトを作成し、output.jsonという名前のファイルに書き込む例です。

import java.io.FileWriter;
import java.io.IOException;
import org.json.simple.JSONObject;
public class CreatingJSONDocument {
    public static void main(String args[]) {
        // JSONObjectオブジェクトの作成
        JSONObject jsonObject = new JSONObject();
        // JSONオブジェクトへのキーと値の挿入
        jsonObject.put("ID", "1");
        jsonObject.put("First_Name", "Shikhar");
        jsonObject.put("Last_Name", "Dhawan");
        jsonObject.put("Date_Of_Birth", "1981-12-05");
        jsonObject.put("Place_Of_Birth", "Delhi");
        jsonObject.put("Country", "India");
        try {
            FileWriter file = new FileWriter("E:/output.json");
            file.write(jsonObject.toJSONString());
            file.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
        System.out.println("JSON file created: "+jsonObject);
    }
}

実行結果

プログラムを実行すると、コンソールには以下のように出力されます。なお、JSONObject内部ではデータがHashMapとして保持されるため、出力順序は挿入順と異なる場合があります。

JSON file created: {
"First_Name":"Shikhar",
"Place_Of_Birth":"Delhi",
"Last_Name":"Dhawan",
"Country":"India",
"ID":"1",
"Date_Of_Birth":
"1981-12-05"}

作成されたJSONファイルの中身を確認すると、プログラムで設定したデータが正しく書き込まれていることがわかります。

まとめ

このように、json-simpleライブラリを使えば、わずか数行のコードでJavaからJSONファイルを簡単に作成できます。より高度な機能が必要な場合は、JacksonやGsonといった他のJSONライブラリも検討するとよいでしょう。