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

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
URLDecoder()

メソッドのサマリー

メソッド

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

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

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

コンストラクタの詳細

URLDecoder

public URLDecoder()

メソッドの詳細

decode

@Deprecated
public static String decode(String s)

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

x-www-form-urlencoded 文字列をデコードします。プラットフォームのデフォルトのエンコーディングに基づいて、「%xy」という形式の任意の連続するシーケンスがどの文字を表しているかが決定されます。

パラメータ:

s - デコードする String

戻り値:

新しくデコードされた String

decode

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

特定のエンコーディング方式を使って application/x-www-form-urlencoded 文字列をデコードします。指定されたエンコーディングに基づいて、「%xy」という形式の任意の連続するシーケンスがどの文字を表しているかが決定されます。

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

パラメータ:

s - デコードする String

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

戻り値:

新しくデコードされた String

例外:

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

導入されたバージョン:

1.4

関連項目:

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