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 u@foo-bar」は「The+string+%C3%BC%40foo-bar」に変換されます。これは、UTF-8 では、文字「u」は 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)