モジュール java.base

パッケージ java.net

クラスURLDecoder

java.lang.Object

java.net.URLDecoder

public class URLDecoder extends Object

HTML形式をデコードするためのユーティリティ・クラスです。 このクラスには、application/x-www-form-urlencoded MIME形式からStringをデコードするためのstaticメソッドが含まれます。

その変換処理は、URLEncoderクラスによって使用される処理の逆になります。 エンコード済み文字列に含まれる文字は必ず、次のいずれかであると仮定されます。"a" - "z"、"A" - "Z"、"0" - "9"、"-"、"_"、"."、"*"。 文字「%」は使用可能ですが、これは、特殊なエスケープ・シーケンスの開始と解釈されます。

次の表記ルールが適用されます。

• 英数字文字の「a」から「z」、「A」から「Z」、および「0」から「9」は元のまま残します。
• 特殊文字の「.」、「-」、「*」、および「_」は元のまま残します。
• プラス記号「+」を空白文字「 」に変換します。
• 「%xy」という形式のシーケンスは、バイトの表現として扱われます。ここで、xyは8ビットを2桁の16進数で表現したものです。 次に、それらのバイト・シーケンスを連続して1つ以上含む部分文字列はすべて、エンコーディング結果がそれらの連続したバイトになるような文字へと置換されます。 これらの文字をデコードするために使用されるエンコーディング・スキームを指定するか、指定されていない場合はデフォルトの文字セットが使用されます。

このデコーダが不正な文字列を処理する際に使用できる方法は、2つあります。 不正な文字をそのまま残すこともできますし、IllegalArgumentExceptionをスローすることもできます。 デコーダがどちらの方法を取るかは、実装によって異なります。

導入されたバージョン:

1.2

関連項目:

• Charset.defaultCharset()

メソッドのサマリー

修飾子と型	メソッド	説明
static String	decode(String s)	非推奨。 結果の文字列は、デフォルトの文字セットによって異なります。
static String	decode(String s, String enc)	特定のエンコーディング・スキームを使用して、application/x-www-form-urlencoded文字列をデコードします。
static String	decode(String s, Charset charset)	特定のCharsetを使用してapplication/x-www-form-urlencoded文字列をデコードします。

クラスjava.lang.Objectで宣言されたメソッド

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

メソッドの詳細

decode

@Deprecated public static String decode(String s)

非推奨。

結果の文字列は、デフォルトの文字セットによって異なります。 代わりに、decode(String,String)メソッドを使ってエンコーディングを指定するようにしてください。

x-www-form-urlencoded文字列をデコードします。 デフォルトの文字セットは、「%xy」形式の連続したシーケンスで表される文字を決定するために使用されます。

パラメータ:

s - デコードするString

戻り値:

新しくデコードされたString

例外:

IllegalArgumentException - 実装で不正なエスケープ・シーケンスが発生した場合

decode

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

特定のエンコーディング・スキームを使用して、application/x-www-form-urlencoded文字列をデコードします。

このメソッドは、decode(java.lang.String,java.nio.charset.Charset)と同じように動作しますが、「文字セットを参照」は指定されたエンコーディング名を使用します。

パラメータ:

s - デコードするString

enc - サポートされる文字エンコーディングの名前。

戻り値:

新しくデコードされたString

例外:

UnsupportedEncodingException−文字エンコーディングを参照する必要があるが、指定された文字エンコーディングがサポートされていない場合

IllegalArgumentException - 実装で不正なエスケープ・シーケンスが発生した場合

導入されたバージョン:

1.4

関連項目:

• URLEncoder.encode(java.lang.String, java.lang.String)

decode

public static String decode(String s, Charset charset)

特定のCharsetを使用してapplication/x-www-form-urlencoded文字列をデコードします。 指定された文字セットは、%xyという形式の連続するエスケープ・シーケンスによって表される文字を決定するために使用されます。 誤ったバイトは、指定されたCharsetの「置換値」に置き換えられます。

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

パラメータ:

s - デコードするString

charset - 指定された文字セット

戻り値:

新しくデコードされたString

例外:

NullPointerException - sまたはcharsetがnullの場合

IllegalArgumentException - 実装で不正なエスケープ・シーケンスが発生した場合

導入されたバージョン:

10

外部仕様

• HTML 4.01仕様

関連項目:

• URLEncoder.encode(java.lang.String, Charset)