java.net
クラス URLEncoder

java.lang.Object
  java.net.URLEncoder

public class URLEncoder
extends Object

HTML 形式をエンコードするためのユーティリティークラスです。このクラスには、String を application/x-www-form-urlencoded MIME 形式に変換するための static メソッドが含まれます。HTML 形式のエンコードの詳細については、HTML の仕様を参照してください。

String を符号化するときに、次の規則が適用されます。

• 英数字文字の「a」から「z」、「A」から「Z」、および「0」から「9」は元のまま残す
• 特殊文字の「.」、「-」、「*」、および「_」は元のまま残す
• 空白文字「 」をプラス記号「+」に変換する
• ほかのすべての文字は安全でなく、最初に何らかのエンコーディング方式を使用して 1 つ以上のバイトに変換される。次に、各バイトが 3 文字から成る文字列「%xy」で表現される。ここで、xy はそのバイトを 2 桁の 16 進数として表現したものである。使用が推奨されるエンコーディング方式は UTF-8 である。 ただし、互換性上の理由によりエンコーディングが指定されていない場合には、プラットフォームのデフォルトのエンコーディングが使用される。

たとえば、エンコーディング方式として UTF-8 を使用すると、文字列「The string ü@foo-bar」は「The+string+%C3%BC%40foo-bar」に変換されます。これは、UTF-8 では、文字「ü」は C3 (16 進数) と BC (16 進数) の 2 バイトとして符号化され、文字「@」は 1 バイトの 40 (16 進数) として変換されるためです。

導入されたバージョン:

JDK1.0

メソッドの概要

static String	encode(String s) 推奨されていません。 プラットフォームのデフォルトのエンコーディングに応じて結果として得られる文字列が変わる可能性があります。代わりに、encode(String,String) メソッドを使ってエンコーディングを指定するようにしてください。
static String	encode(String s, String enc) 特定のエンコーディング方式を使って文字列を application/x-www-form-urlencoded 形式に変換します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

encode

@Deprecated
public static String encode(String s)

推奨されていません。 プラットフォームのデフォルトのエンコーディングに応じて結果として得られる文字列が変わる可能性があります。代わりに、encode(String,String) メソッドを使ってエンコーディングを指定するようにしてください。

文字列を x-www-form-urlencoded 形式に変換します。このメソッドは、安全でない文字に対するバイトを取得するためのエンコーディング方式として、プラットフォームのデフォルトのエンコーディングを使用します。

パラメータ:

s - 変換対象の String

戻り値:

変換後の String

encode

public static String encode(String s,
                            String enc)
                     throws UnsupportedEncodingException

特定のエンコーディング方式を使って文字列を application/x-www-form-urlencoded 形式に変換します。このメソッドは、指定されたエンコーディング方式を使って安全でない文字に対するバイトを取得します。

注: 「World Wide Web Consortium Recommendation」 には、UTF-8 を使用すべきであると明記されています。そうしなかった場合、互換性を確保できなくなる可能性があります。

パラメータ:

s - 変換対象の String

enc - サポートされる「文字セット」の名前

戻り値:

変換後の String

例外:

UnsupportedEncodingException - 指定された文字エンコーディングがサポートされていない場合

導入されたバージョン:

1.4

関連項目:

URLDecoder.decode(java.lang.String, java.lang.String)