【Java】URLをエンコード・デコードする方法についてサンプル付きで解説！

JavaのURLクラスとは？

URLクラスは、Uniform Resource Locator (ユニフォーム・リソース・ロケータ)、World Wide Web上のリソースへのポインタを表すものです。

リソースは、ファイル・ディレクトリのような単純なものである場合や、データベース・検索エンジンに対するクエリーなど、複雑なオブジェクトへの参照の場合もあります。

アクセスしたい情報のURLがわかっていれば、java.net.URLクラスを用いることで、簡単に取得可能です。

URLクラスで使用できるメソッドは次の通りです。

URLのエンコード・デコードとは？

JavaでURLのエンコード・デコードをする場合は、「URLEncoderクラス」「URLDecoderクラス」を使用しましょう。

• URLEncoderクラス：HTML形式をエンコードするためのユーティリティ・クラス
• URLDecoderクラス：HTML形式をデコードするためのユーティリティ・クラス

エンコード・デコードする際は、次のルールが適用されます。

では、実際にサンプルコードで動きを確認しましょう。

■記述例
import java.io.*;
import java.net.*;

public class Main {
    public static void main(String[] args) throws IOException {
      String str = "https://style.potepan.com/ポテパンスタイルの最新記事です";

      // エンコードの例
      String encodedResult = URLEncoder.encode(str, "UTF-8");
      System.out.println("URLをエンコードします:" + encodedResult);

      // デコードの例
      String decodedResult = URLDecoder.decode(encodedResult, "UTF-8");
      System.out.println("URLをデコードします:" + decodedResult);
    }
}
■実行結果
mbp:desktop potepan$ java Main
URLをエンコードします:https%3A%2F%2Fstyle.potepan.com%2F%E3%83%9D%E3%83%86%E3%83%91%E3%83%B3%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%81%AE%E6%9C%80%E6%96%B0%E8%A8%98%E4%BA%8B%E3%81%A7%E3%81%99
URLをデコードします:https://style.potepan.com/ポテパンスタイルの最新記事です

URLをエンコードした結果と、デコードした結果が取得できました。

適用されるルールの通り、エンコード時は指定した文字以外・日本語部分は、16進数表記に変換されています。

URLエンコード時の半角スペース

URLをエンコードする場合、半角スペースは「+」に置き換わります。

置き換わりは不具合ではなく、エンコード時のルールです。

ポテパンダの一言メモ

URLDecoder の場合も、同様の仕様に則って「+」でデコードされます。

実際にサンプルコードで表示を確認すると、次の通りです。

■記述例
import java.io.*;
import java.net.*;

public class Main {
    public static void main(String[] args) throws IOException {
      // URLに半角スペースを追加しました
      String str = "https://style.potepan.com/ポテパンスタイル 最新記事";

      // エンコードの例
      String encodedResult = URLEncoder.encode(str, "UTF-8");
      System.out.println("URLをエンコードします:" + encodedResult);

      // デコードの例
      String decodedResult = URLDecoder.decode(encodedResult, "UTF-8");
      System.out.println("URLをデコードします:" + decodedResult);
    }
}
■実行結果
mbp:desktop potepan$ java Main
URLをエンコードします:https%3A%2F%2Fstyle.potepan.com%2F%E3%83%9D%E3%83%86%E3%83%91%E3%83%B3%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB+%E6%9C%80%E6%96%B0%E8%A8%98%E4%BA%8B
URLをデコードします:https://style.potepan.com/ポテパンスタイル 最新記事

URLエンコード時のスラッシュ

実行結果からわかるように、URLをエンコードする場合、スラッシュ（/）は「%2F」の16進数に変換されます。

URLエンコードでShift_JISは文字化けの可能性あり

URLEncoder、URLDecoder で Shift_JIS の文字列は上手く処理できない場合があります。

ポテパンダの一言メモ

そのため、文字コードは「UTF-8」で指定するのが無難です。

サンプルで、Shift_JISで指定した場合の処理を記載します。

■記述例
import java.io.*;
import java.net.*;
public class Main {
    public static void main(String[] args) throws IOException {
      // URLに半角スペースを追加しました
      String str = "https://style.potepan.com/ｱｲｳｴｵ";
      // エンコードの例
      String encodedResult = URLEncoder.encode(str, "SHIFT-JIS");
      System.out.println("URLをエンコードします:" + encodedResult);
      // デコードの例
      String decodedResult = URLDecoder.decode(encodedResult, "SHIFT-JIS");
      System.out.println("URLをデコードします:" + decodedResult);
    }
}
■実行結果
mbp:desktop potepan$ java Main
URLをエンコードします:https%3A%2F%2Fstyle.potepan.com%2F%B1%B2%B3%B4%B5
URLをデコードします:https://style.potepan.com/ｱｲｳｴｵ

今回のサンプルでは、文字化け等の不具合は起きませんでした。

エンコード・デコード時は第2引数の文字コードを必ず渡す

URLEncoderクラス、URLDecoderクラスには、第2引数の文字コードを省略可能なメソッドが存在します。

指定の必要がないので便利に思えますが、こちらのメソッドの使用は非推奨です。

なぜなら、環境によって文字コードが異なる可能性があるため、予期せぬ不具合が発生することがあるためです。

さまざまな環境で実行する予定がないとはいえ、どんな不具合が生じるのかわかりません。

第2引数の文字コードを省略したメソッドの使用は、念のため避けましょう。