javax.servlet.http
クラス HttpUtils

java.lang.Object
  |
  +--javax.servlet.http.HttpUtils

推奨されていません。 Java(tm) Servlet API 2.3 以降では、これらのメソッドはデフォルト・エンコーディング指定で唯一使用され、また、これらの代替メソッドはリクエスト・インターフェースへ移動されました。

public class HttpUtils

extends Object

コンストラクタの概要

HttpUtils()
推奨されていません。 空のHttpUtilsオブジェクトを構築します。

メソッドの概要

static StringBuffer	getRequestURL(HttpServletRequest req) 推奨されていません。 HttpServletRequestオブジェクトに含まれる情報を利用して、クライアントがリクエストしたURLを再構築します。
static Hashtable	parsePostData(int len, ServletInputStream in) 推奨されていません。 HTTP POSTメソッド、および、application/x-www-form-urlencoded MIMEタイプを利用して、クライアントがサーバに送ったHTMLフォームのデータを構文解析します。
static Hashtable	parseQueryString(String s) 推奨されていません。 クライアントからサーバに渡されるクエリ文字列を構文解析し、キー/値ペアでHashTableオブジェクトを構築します。

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

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

コンストラクタの詳細

HttpUtils

public HttpUtils()

推奨されていません。

空のHttpUtilsオブジェクトを構築します。

メソッドの詳細

parseQueryString

public static Hashtable parseQueryString(String s)

推奨されていません。

クライアントからサーバに渡されるクエリ文字列を構文解析し、キー/値ペアでHashTableオブジェクトを構築します。 クエリ文字列は、フォーム上において、GET もしくは POST メソッドでまとめられた文字列で構成されており、それは、次のペアとの間を & 文字で区切られた各ペアを、キー=値という形式のキー/値ペアで持っています。

クエリ文字列においては、キーは異った複数の値を一回で現すことができません。 しかしながら、ハッシュテーブルにおいて、キーはたった一つしか存在しないものであるため、その値はクエリ文字列より送られた複数の値を含む文字列の配列となります。

ハッシュテーブルにあるキーと値はデコードされた形式で格納されますので、+ 文字は空白に変換され、（%xxのような）16進数表記で送られた文字はASCII文字へと変換されます。

パラメータ:

s - 構文解析されたクエリを含む文字列

戻り値:

構文解析されたキー/値ペアを元に構築されたHashTableオブジェクト

例外:

IllegalArgumentException - クエリ文字列が無効である場合

parsePostData

public static Hashtable parsePostData(int len,
                                      ServletInputStream in)

推奨されていません。

HTTP POSTメソッド、および、application/x-www-form-urlencoded MIMEタイプを利用して、クライアントがサーバに送ったHTMLフォームのデータを構文解析します。

POSTメソッドで送られたデータには、キー/値ペアが含まれています。 POSTされたデータにおいては、キーは異った複数の値を一回で現すことができません。 しかしながら、ハッシュテーブルにおいて、キーはたった一つしか存在しないものであるため、その値はPOSTメソッドで送られた複数の値を含む文字列の配列となります。

ハッシュテーブルにあるキーと値はデコードされた形式で格納されますので、+ 文字は空白に変換され、（%xxのような）16進数表記で送られた文字はASCII文字へと変換されます。

パラメータ:

len - このメソッドへ渡されたServletInputStreamオブジェクトの長さ、すなわち文字数を示す整数値

in - クライアントから送られたデータを含むServletInputStreamオブジェクト

戻り値:

構文解析されたキー/値ペアで構築されたHashTableオブジェクト

例外:

IllegalArgumentException - POSTメソッドで送られたデータが無効である場合。

getRequestURL

public static StringBuffer getRequestURL(HttpServletRequest req)

推奨されていません。

HttpServletRequestオブジェクトに含まれる情報を利用して、クライアントがリクエストしたURLを再構築します。 返されるURLには、プロトコル、サーバ名、ポート番号、そしてサーバ・パスが含まれますが、クエリ文字列のパラメータは含みません。

なぜなら、このメソッドは、文字列ではなくStringBuffer型で返すため、例えば、クエリパラメータを追加する目的でURLを容易に修正することが可能になります。

このメソッドは、リダイレクト・メッセージを生成したり、エラーをレポートするのに有用です。

パラメータ:

req - クライアントから要求されたリクエストを含むHttpServletRequestオブジェクト

戻り値:

再構築されたURLを含むStringBufferオブジェクト