|
|||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
HTTP Servletのためのリクエスト情報を与えるために
ServletRequest
インタフェースを拡張します。
ServletコンテナはHttpServletRequest
オブジェクトを生成し、Servletのサービスメソッド(doGet
、
doPost
等)に引数で渡します。
フィールドの概要 | |
static String |
BASIC_AUTH
基本認証のための識別文字列です。 |
static String |
CLIENT_CERT_AUTH
基本認証のための識別文字列です。 |
static String |
DIGEST_AUTH
基本認証のための識別文字列です。 |
static String |
FORM_AUTH
基本認証のための識別文字列です。 |
メソッドの概要 | |
String |
getAuthType()
Servletを保護するために使われている認証スキームの名前を返します。 |
String |
getContextPath()
リクエストされたURIのうち、 リクエストのコンテキストを指す部分を返します。 |
Cookie[] |
getCookies()
このリクエストと一緒にクライアントから送られてきた全ての Cookie オブジェクトの配列を返します。
|
long |
getDateHeader(String name)
指定されたリクエストヘッダの値を Date オブジェクトを表す
long 値として返します。
|
String |
getHeader(String name)
指定されたリクエストヘッダの値を String として返します。
|
Enumeration |
getHeaderNames()
このリクエストに含まれる全てのヘッダ名のEnumerationを返します。 |
Enumeration |
getHeaders(String name)
指定されたリクエストヘッダの全ての値を String オブジェクトの
Enumeration として返します。
|
int |
getIntHeader(String name)
指定されたリクエストヘッダの値を int 値として返します。
|
String |
getMethod()
例えばGET、POST、PUTのような、 このリクエストを生成したHTTPメソッドの名前を返します。 |
String |
getPathInfo()
このリクエストを生成した時にクライアントが URLに関連づけて送った拡張パス情報を返します。 |
String |
getPathTranslated()
Servlet名の後ろからクエリ文字列の前にある拡張パス情報を返しますが、 実際のパスに変換してから返します。 |
String |
getQueryString()
リクエストされたURLのパスの後ろに含まれているクエリ文字列を返します。 |
String |
getRemoteUser()
リクエストを生成したユーザが認証されている場合はそのユーザのログイン名を返します。 |
String |
getRequestedSessionId()
クライアントによって指定されたセッションのIDを返します。 |
String |
getRequestURI()
このHTTPリクエストの最初の行にある、 リクエストのURLのうちプロトコル名からクエリ文字列までの部分を返します。 |
StringBuffer |
getRequestURL()
クライアントがこのリクエストを生成するのに使ったURLを再構築します。 |
String |
getServletPath()
このリクエストのURLのうち、Servletを呼び出すための部分を返します。 |
HttpSession |
getSession()
このリクエストに関連づけられている現在のセッションを返します。 |
HttpSession |
getSession(boolean create)
このリクエストに関連づけられている現在の HttpSession
もしくは現在のセッションが存在せずかつ
create が真である場合は新しいセッションを返します。
|
Principal |
getUserPrincipal()
現在の認証ユーザの名前を含む java.security.Principal
オブジェクトを返します。
|
boolean |
isRequestedSessionIdFromCookie()
リクエストされたセッションのIDがCookieとして送られてきたのかどうかを調べます。 |
boolean |
isRequestedSessionIdFromUrl()
推奨されていません。 Java Servlet APIのバージョン2.1以降では、 代わりに isRequestedSessionIdFromURL()
を使うようにして下さい。 |
boolean |
isRequestedSessionIdFromURL()
リクエストされたセッションIDがリクエストされたURL の一部分として送られてきたのかどうかを調べます。 |
boolean |
isRequestedSessionIdValid()
リクエストされたセッションのIDが未だに有効であるかどうかを調べます。 |
boolean |
isUserInRole(String role)
認証されているユーザが指定された論理的な「ロール」に含まれているかどうかを表すbooleanを返します。 |
フィールドの詳細 |
public static final String BASIC_AUTH
public static final String FORM_AUTH
public static final String CLIENT_CERT_AUTH
public static final String DIGEST_AUTH
メソッドの詳細 |
public String getAuthType()
null
を返します。
この値はCGI変数のAUTH_TYPEと同じ値です。
null
public Cookie[] getCookies()
Cookie
オブジェクトの配列を返します。
Cookieが送られていない場合はnull
を返します。
Cookie
の配列。
リクエストにCookieが付加されていない場合はnull
public long getDateHeader(String name)
Date
オブジェクトを表す
long
値として返します。
このメソッドはIf-Modified-Since
のような、
日付を含むヘッダに対して使用して下さい。
返す日付は、1970年1月1日グリニッジ標準時00:00:00.000 からの経過時間をミリ秒で表した数値です。
このリクエストが指定された名前のヘッダを持たない場合、
-1を返します。
指定されたヘッダが日付に変換できない場合、
IllegalArgumentException
をスローします。
name
- ヘッダ名を表すString
long
値。
日付は、1970年1月1日グリニッジ標準時00:00:00.000
からの経過時間をミリ秒で表した数値。
指定された名前を持つヘッダがこのリクエストに存在しない場合は * -1
IllegalArgumentException
- ヘッダの値を日付に変換できない場合public String getHeader(String name)
String
として返します。
リクエストが指定された名前を持つヘッダを持たない場合は
null
を返します。
ヘッダ名は大文字小文字を区別しません。
あらゆるリクエストヘッダに関してこのメソッドを用いることができます。
name
- ヘッダ名を表すString
String
。
指定した名前を持つヘッダが存在しない場合はnull
public Enumeration getHeaders(String name)
String
オブジェクトの
Enumeration
として返します。
Accept-Language
のようないくつかのヘッダは、
カンマで区切られたリストの形式ではなく、
異なる値を持ついくつかのヘッダとしてクライアントから送信されることがあります。
このリクエストが指定された名前を持つヘッダを持たない場合、
空のEnumeration
を返します。
ヘッダ名は大文字小文字を区別しません。
あらゆるリクエストヘッダに関してこのメソッドを用いることができます。
name
- ヘッダ名を表すString
Enumeration
。
このリクエストが指定された名前のヘッダを持たない場合、
空のEnumerationを返す。
コンテナがヘッダ情報へのアクセスを禁止している場合、
nullを返すpublic Enumeration getHeaderNames()
ある種のServletコンテナは
Servletがこのメソッドを用いてヘッダにアクセスすることを禁じています。
その場合このメソッドはnull
を返します。
null
public int getIntHeader(String name)
int
値として返します。
このリクエストが指定された名前のヘッダを持たない場合は
-1を返します。
ヘッダを整数に変換することができない場合は
NumberFormatException
をスローします。
ヘッダ名は大文字小文字を区別しません。
name
- リクエストヘッダ名を表すString
NumberFormatException
- ヘッダの値をint
に変換できなかった場合public String getMethod()
String
public String getPathInfo()
null
を返します。
この値はCGI変数のPATH_INFOの値を同じです。
String
。
拡張パス情報とは、リクエストされたURLのうち、
Servletのパスの後ろからクエリ文字列の前までの文字列。
URLが拡張パス情報を持たない場合はnull
を返すpublic String getPathTranslated()
URLが拡張パス情報を持たない場合はnull
を返します。
Webコンテナはこの文字列をデコードしません。
(訳注:原文「The web container does not decode thins string.」
中のthins は this の typo?)
String
。
URLが拡張パス情報を持っていない場合は
null
を返すpublic String getContextPath()
String
public String getQueryString()
null
を返します。
この値はCGI変数のQUERY_STRINGの値と同じです。
String
。
URLがクエリ文字列を持たない場合はnull
を返します。
値はコンテナによってデコードされません。public String getRemoteUser()
null
を返します。
一連のそれぞれのリクエストとともにユーザ名が送信されるかどうかは、
ブラウザと認証タイプに依存します。
この値はCGI変数のREMOTE_USERと同じです。
String
。
ユーザのログイン名が分からない場合はnull
を返します。public boolean isUserInRole(String role)
false
を返します。
role
- ロール名を表すString
boolean
。
ユーザが認証されていない場合はfalse
を返すpublic Principal getUserPrincipal()
java.security.Principal
オブジェクトを返します。
ユーザが認証されていない場合はnull
を返します。
java.security.Principal
。
ユーザが認証されていない場合はnull
を返すpublic String getRequestedSessionId()
null
を返します。
String
。
リクエストがセッションIDを持ってない場合は
null
isRequestedSessionIdValid()
public String getRequestURI()
HTTPリクエストの最初の行 | 返される値 | |
---|---|---|
POST /some/path.html HTTP/1.1 | /some/path.html | |
GET http://foo.bar/a.html HTTP/1.0 | /a.html | |
HEAD /xyz?a=b HTTP/1.1 | /xyz |
スキームとホストを用いてURLを再構築するためには
HttpUtils.getRequestURL(javax.servlet.http.HttpServletRequest)
を用いて下さい。
String
HttpUtils.getRequestURL(javax.servlet.http.HttpServletRequest)
public StringBuffer getRequestURL()
このメソッドは文字列ではなくStringBuffer
を返しますので、
例えばクエリパラメータを加えるなど、
URLを簡単に変更することができます。
This method is useful for creating redirect messages and for reporting errors.
このメソッドはリダイレクトメッセージを生成したりエラーを報告したりするために役に立ちます。
StringBuffer
public String getServletPath()
String
。public HttpSession getSession(boolean create)
HttpSession
もしくは現在のセッションが存在せずかつ
create
が真である場合は新しいセッションを返します。
create
がfalse
の時、
リクエストが有効なHttpSession
を持たない場合は
null
を返します。
セッションを確実に正しく維持するために、 レスポンスがコミットされる前にこのメソッドを呼び出して下さい。 コンテナがCookieを使ってセッションを維持している場合、 レスポンスがコミットされる時に新しいセッションを生成するように指定されると IllegalStateExceptionをスローします。
HttpSession
。
create
の値がfalse
である場合、リクエストが有効なセッションを持っていなければ
null
getSession()
public HttpSession getSession()
HttpSession
getSession(boolean)
public boolean isRequestedSessionIdValid()
true
を返し、そうでない場合はfalse
を返します。getRequestedSessionId()
,
getSession(boolean)
,
HttpSessionContext
public boolean isRequestedSessionIdFromCookie()
true
。
そうでない場合はfalse
getSession(boolean)
public boolean isRequestedSessionIdFromURL()
true
。
そうでない場合はfalse
getSession(boolean)
public boolean isRequestedSessionIdFromUrl()
isRequestedSessionIdFromURL()
を使うようにして下さい。
|
|||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
このドキュメントは、Ja-Jakarta Project により翻訳されました。コメントがある場合は、jajakarta-report@jajakarta.good-day.netまでお願いします。
Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.