request  
 
変数名 :

request

 
インターフェイス名 :

javax.servlet.http.HttpServletRequest

 
拡張するクラス :

javax.servlet.ServletRequest

 
実装先クラス :

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

 
JSP ページタイプ :

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

 
説明

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

getAttribute( )  
public Object getAttribute(String name)

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

getAttributeNames()  
public java.util.Enumeration getAttributeNames()

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

getAuthType()  
public String getAuthType()

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

getCharacterEncoding()  
public String getCharacterEncoding()

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

getContentLength()  
public int getContentLength()

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

getContentType()  
public String getContentType()

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

getContextPath()  
public String getContextPath()

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

getCookies()  
public Cookie[] getCookies()

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

getDateHeader()  
public long getDateHeader(String name)

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

getHeader()  
public String getHeader(String name)

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

getHeaderNames()  
public java.util.Enumeration getHeaderNames()

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

getHeaders()  
public java.util.Enumeration getHeaders(String name)

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

getInputStream()  
public ServletInputStream getInputStream()
  throws java.io.IOException

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

getIntHeader()  
public int getIntHeader(String name)

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

getLocale()  
public java.util.Locale getLocale()

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

getLocales()  
public java.util.Enumeration getLocales()

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

getMethod()  
public String getMethod()

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

getParameter()  
public String getParameter(String name)

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

getParameterNames()  
public String getParameterNames()

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

getParameterValues()  
public String[] getParameterValues()

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

getPathInfo()  
public String getPathInfo()

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

getPathTranslated()  
public String getPathTranslated()

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

getProtocol()  
public String getProtocol()

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

getQueryString()  
public String getQueryString()

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

getReader()  
public java.io.BufferedReader getReader() throws java.io.IOException

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

getRemoteAddr()  
public String getRemoteAddr()

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

getRemoteHost()  
public String getRemoteHost()

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

getRemoteUser()  
public String getRemoteUser()

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

getRequestDispatcher()  
public RequestDispatcher getRequestDispatcher(String path)

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

getRequestedSessionId()  
public String getRequestedSessionId()

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

getRequestURI()  
public String getRequestURI()

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

getScheme()  
public String getScheme()

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

getServerName()  
public String getServerName()

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

getServerPort()  
public int getServerPort()

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

getServletPath()  
public String getServletPath()

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

getSession()  
public HttpSession getSession()

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

getSession()  
public HttpSession getSession(boolean create)

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

getUserPrincipal()  
public java.security.Principal getUserPrincipal()

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

isRequestedSessionIdFromCookie()  
public boolean isRequestedSessionIdFromCookie()

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

isRequestedSessionIdFromURL()  
public boolean isRequestedSessionIdFromURL()

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

isRequestedSessionIdValid()  
public boolean isRequestedSessionIdValid()

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

isSecure()  
public boolean isSecure()

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

isUserInRole()  
public boolean isUserInRole(String role)

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

removeAttribute( )  
public void removeAttribute(String name)

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

setAttribute( )  
public Object setAttribute(String name, Object attribute)

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

getRealPath() 使用されません
public String getRealPath()

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

isRequestSessionIdFromUrl() 使用されません
public boolean isRequestSessionIdFromUrl()

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