JavaでJSONObjectとCookieを相互変換する方法（toString()・toJSONObject()の使い方）

JSONは、広く利用されているデータ交換フォーマットの一つです。軽量でありながら言語に依存しないという特徴を持ち、多くのシステム間でのデータやり取りに採用されています。

Javaでは、org.json.Cookieクラスが提供するメソッドを使うことで、JSONObjectとCookie文字列を簡単に相互変換できます。具体的には、以下の2つの静的メソッドを使用します。

• toString()：JSONObjectをCookie形式の文字列に変換する
• toJSONObject()：Cookie形式の文字列をJSONObjectに変換する

JSONObjectからCookieへの変換

JSONObjectをCookie文字列に変換するには、Cookie.toString()メソッドを使用します。このメソッドは、JSONObject内の「name」「value」「expires」「path」などの属性をもとに、標準的なCookie形式の文字列を生成します。

構文

public static java.lang.String toString(JSONObject jo) throws JSONException

サンプルコード

import org.json.Cookie;
import org.json.JSONObject;

public class JSONObjectToCookieTest {
    public static void main(String args[]) {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("path", "/");
        jsonObject.put("expires", "Thu, 07 May 2020 12:00:00 UTC");
        jsonObject.put("name", "username");
        jsonObject.put("value", "Adithya");

        String cookie = Cookie.toString(jsonObject);
        System.out.println(cookie);
    }
}

実行結果

username=Adithya;expires=Thu, 07 May 2020 12:00:00 UTC;path=/

このように、JSONObjectに格納した各属性が、セミコロン区切りのCookie形式の文字列として出力されます。

CookieからJSONObjectへの変換

逆に、Cookie形式の文字列をJSONObjectに変換する場合は、Cookie.toJSONObject()メソッドを使用します。Cookie文字列を解析し、各属性をキーと値のペアとしてJSONObjectに格納してくれます。

構文

public static JSONObject toJSONObject(java.lang.String string) throws JSONException

サンプルコード

import org.json.Cookie;
import org.json.JSONObject;

public class ConvertCookieToJSONObjectTest {
    public static void main(String args[]) {
        String cookie = "username=Adithya; expires=Thu, 07 May 2020 12:00:00 UTC; path=/";

        JSONObject jsonObject = Cookie.toJSONObject(cookie);
        System.out.println(jsonObject);
    }
}

実行結果

{"path":"/","expires":"Thu, 07 May 2020 12:00:00 UTC","name":"username","value":"Adithya"}

まとめ

org.json.Cookieクラスを利用すれば、JSONObjectとCookie文字列の変換は非常にシンプルに行えます。Webアプリケーションでクッキー情報をJSONとして扱いたい場合や、その逆の処理が必要な場合に、これらのメソッドを活用すると便利です。なお、不正な形式の入力が渡された場合にはJSONExceptionがスローされるため、実際の開発では適切な例外処理を組み合わせることをおすすめします。