request

javax.servlet.http.HttpServletRequest

javax.servlet.ServletRequest

内部コンテナ固有のクラス

通常の JSP ページとエラーページの両方で利用可能

request 変数には、javax.servlet.ServletRequest インターフェイスを拡張するプロトコル固有のインターフェイスを実装する、内部コンテナ固有のクラスへの参照が割り当てられます。HTTP は JSP 1.1 でサポートされる唯一のプロトコルであるため、このクラスは常に javax.servlet.http.HttpServletRequest インターフェイスを実装します。このセクションのメソッドの説明には、両方のインターフェイスのメソッドが含まれます。

名前付き属性の値を Object として返します。指定された名前の属性が存在しない場合は、null を返します。

この要求で利用できる属性の名前を含む Enumeration を返します。要求に属性がない場合、Enumeration は空になります。

サーブレットを保護するために使用される認証スキームの名前 (たとえば、BASIC や SSL) を返します。サーブレットが保護されていない場合は null を返します。

この要求の本文で使用される文字エンコード方法の名前を返します。要求で文字エンコード方法が指定されない場合は、null を返します。

要求の本文の長さをバイト単位で返します (入力ストリームによって利用できるようになっている場合)。長さが不明の場合は -1 を返します。

要求の本文の MIME タイプを返します。タイプが不明の場合は null を返します。

要求のコンテキストを示す要求 URI の一部を返します。

クライアントがこの要求と共に送信したすべての Cookie オブジェクトを含む配列を返します。要求に Cookie が含まれていない場合は null を返します。

指定された要求ヘッダーの値を、日付値を表す long 値として返します。ヘッダーが要求に含まれていない場合は、-1 を返します。

指定された要求ヘッダーの値を String として返します。要求にヘッダーが含まれていない場合は null を返します。

この要求に含まれているすべてのヘッダー名を、String オブジェクトの Enumeration として返します。要求にヘッダーが含まれていない場合、Enumeration は空になります。

指定された要求ヘッダーのすべての値を、String オブジェクトの Enumeration として返します。指定されたヘッダーが要求に含まれていない場合、Enumeration は空になります。

ServletInputStream を使用して、要求の本文をバイナリデータとして取り出します。

指定された要求ヘッダーの値を int として返します。要求にヘッダーが含まれていない場合は -1 を返します。

Accept-Language ヘッダーに基づいて、クライアントがコンテンツを受け取る推奨の Locale を返します。

Locale オブジェクトの Enumeration を返し、推奨のロケールから降順で、Accept-Language ヘッダーに基づいてクライアントが受け取ることができるロケールが示されます。

この要求が行われた HTTP メソッドの名前を返します。たとえば、GET、POST、PUT などです。

要求パラメータの値を String として返します。パラメータが存在しない場合は、null を返します。

この要求のパラメータ名が含まれている String オブジェクトの Enumeration を返します。

指定されたすべての要求パラメータの値が含まれている String オブジェクトの配列を返します。パラメータが存在しない場合は null を返します。

この要求を行ったときにクライアントが送信した URI に関連付けられている、余分なパス情報を返します。余分なパス情報がない場合は null を返します。JSP ページの場合、このメソッドは常に null を返します。

getPathInfo() を該当するファイルシステムパスに変換した結果を返します。getPathInfo() が null を返す場合は null を返します。

protocol/majorVersion.minorVersion の形式で、要求で使用するプロトコルの名前とバージョン (たとえば、HTTP/1.1) を返します。

パスの後で要求 URI に含まれているクエリー文字列を返します。

BufferedReader を使用して、要求の本文を文字データとして取り出します。

要求を送信したクライアントのインターネットプロトコル (IP) アドレスを返します。

要求を送信したクライアントホストの完全修飾名を返します。ホスト名を判断できない場合は、クライアントの IP アドレスを返します。

ユーザーが認証されている場合は、この要求を行っているユーザーのログイン ID を返します。ユーザーが認証されていない場合は null を返します。

指定されたパスにあるリソースの折り返しとして機能する RequestDispatcher オブジェクトを返します。

クライアントによって指定されたセッション ID を返します。

この要求の URI の一部をプロトコル名から HTTP 要求の最初の行のクエリー文字列に返します。

この要求を行うために使用されたスキーム (プロトコル) の名前 (たとえば、http、https、ftp など) を返します。

要求を受け取ったサーバーのホスト名を返します。

要求を受け取ったポートの番号を返します。

サーブレットを呼び出すこの要求の URI の一部を返します。JSP ページの場合、これはページの完全なコンテキスト相対パスになります。

この要求に関連付けられた現在の HttpSession を返します。要求にセッションがない場合、新しい HttpSession オブジェクトが作成され、要求と関連付けられて返されます。

この要求に関連付けられた現在の HttpSession を返します。現在のセッションがなく、create が true の場合、新しい HttpSession オブジェクトが作成され、要求と関連付けられて返されます。create が false で、要求がセッションと関連付けられていない場合、このメソッドは null を返します。

現在の認証済みユーザーの名前が含まれた Principal オブジェクトを返します。

要求されたセッション ID が Cookie として受信されたかどうかをチェックします。

要求されたセッション ID が要求 URL の一部として受信されたかどうかをチェックします。

要求されたセッション ID がまだ有効かどうかをチェックします。

この要求が、HTTPS などのセキュリティで保護されたチャネルを使用して行われたかどうかを示す boolean を返します。

認証されたユーザーが指定された論理ロールに含まれているかどうかを示す boolean を返します。

指定された属性を要求から削除します。

指定された属性を要求に格納します。

Servlet 2.1 API 時点では、代わりに ServletContext.getRealPath(String) を使用してください。

Servlet 2.1 API 時点では、代わりに isRequestedSessionIdFromURL() を使用してください。