public abstract class HttpExchange extends ObjectSE
基礎となるリソースを解放または再利用するには、HttpExchange
を閉じる必要があります。取引所の閉鎖に失敗した場合の影響は定義されていません。
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | REQUEST_CIPHER_SUITE 標準プロパティ: HTTPS 経由でリクエストを受信したときの暗号スイートの値 |
static StringSE | REQUEST_KEY_SIZE 標準プロパティ: HTTPS 経由でリクエストを受信したときのアルゴリズムのビットサイズ |
static StringSE | REQUEST_X509CERTIFICATE 標準プロパティ: リクエストに関連付けられている SSL 証明書(ある場合) |
コンストラクターと説明 |
---|
HttpExchange() |
修飾子と型 | メソッドと説明 |
---|---|
abstract void | addResponseHeader(StringSE name, StringSE value) 指定された名前と値でレスポンスヘッダーを追加します。 |
abstract void | close() 交換を終了するには、これを呼び出す必要があります。 |
abstract ObjectSE | getAttribute(StringSE name) この HttpExchange に関連付けられている属性を返します。 |
abstract SetSE<StringSE> | getAttributeNames() この HttpExchange に関連付けられているすべての属性名を指定します。 |
abstract StringSE | getContextPath() アプリケーション内のすべてのエンドポイントのコンテキストパスを返します。 |
abstract HttpContext | getHttpContext() この交換の HttpContext を返します。 |
abstract InetSocketAddressSE | getLocalAddress() リクエストを受信した未解決のローカルアドレスを返します。 |
abstract StringSE | getPathInfo() Web サービスパスに続くが、リクエスト URI のクエリ文字列の前にあり、"/" 文字で始まる追加のパス情報を返します。 |
abstract StringSE | getProtocol() リクエストからプロトコル文字列を protocol/majorVersion.minorVersion の形式で返します。 |
abstract StringSE | getQueryString() パスの後にリクエスト URI に含まれているクエリ文字列を返します。 |
abstract InetSocketAddressSE | getRemoteAddress() このリクエストを呼び出すリモートエンティティの未解決のアドレスを返します。 |
abstract InputStreamSE | getRequestBody() リクエスト本文を読み取ることができるストリームを返します。 |
abstract StringSE | getRequestHeader(StringSE name) 指定されたリクエストヘッダーの値を返します。 |
abstract MapSE<StringSE, ListSE<StringSE>> | getRequestHeaders() このリクエストに含まれていた HTTP ヘッダーを含む不変のマップを返します。 |
abstract StringSE | getRequestMethod() HTTP リクエストメソッドを取得する |
abstract StringSE | getRequestURI() プロトコル名から HTTP リクエストの最初の行のクエリ文字列までのリクエストの URI の一部を返します。 |
abstract OutputStreamSE | getResponseBody() レスポンス本文を書き込む必要のあるストリームを返します。 |
abstract MapSE<StringSE, ListSE<StringSE>> | getResponseHeaders() HTTP レスポンスヘッダーを格納でき、このレスポンスの一部として送信される可変マップを返します。 |
abstract StringSE | getScheme() このリクエストを行うために使用されたスキームの名前を返します(例: http または https)。 |
abstract PrincipalSE | getUserPrincipal() この HttpExchange の認証済みユーザーを表す Principal SE を返します。 |
abstract boolean | isUserInRole(StringSE role) 認証されたユーザーが指定された論理「ロール」に含まれるかどうかを示します。 |
abstract void | setStatus(int status) レスポンスの HTTP ステータスコードを設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public static final StringSE REQUEST_CIPHER_SUITE
タイプ: String
public static final StringSE REQUEST_KEY_SIZE
タイプ: 整数
public abstract MapSE<StringSE,ListSE<StringSE>> getRequestHeaders()
Map のキーでは、大文字と小文字は区別されません。
public abstract StringSE getRequestHeader(StringSE name)
getRequestHeaders()
を使用する代わりに)ヘッダーを取得するための便利なメソッドです。name
- リクエストヘッダーの名前 public abstract MapSE<StringSE,ListSE<StringSE>> getResponseHeaders()
Map のキーでは、大文字と小文字は区別されません。
public abstract void addResponseHeader(StringSE name, StringSE value)
getResponseHeaders()
を使用する代わりに)レスポンスヘッダーを追加するための便利なメソッドです。name
- ヘッダーの名前 value
- 追加のヘッダー値。オクテット文字列が含まれている場合は、RFC2047 に従ってエンコードする必要があります (http://www.ietf.org/rfc/rfc2047.txt)getResponseHeaders()
public abstract StringSE getRequestURI()
public abstract StringSE getContextPath()
コンテキストパスは、エンドポイントアドレスの計算に使用されます。HttpContext.getPath()
を参照してください
HttpContext.getPath()
public abstract StringSE getRequestMethod()
public abstract HttpContext getHttpContext()
HttpContext
を返します。コンテナーは、リクエストを関連するエンドポイントの HttpContext と照合します public abstract void close() throws IOExceptionSE
IOExceptionSE
- I/O エラーがある場合 public abstract InputStreamSE getRequestBody() throws IOExceptionSE
IOExceptionSE
- リクエスト処理中に I/O エラーが発生した場合 public abstract OutputStreamSE getResponseBody() throws IOExceptionSE
setStatus(int)
)を呼び出す必要があります。このメソッドを(同じ交換に対して)複数回呼び出すと、同じストリームが返されます。IOExceptionSE
- レスポンス処理中に I/O エラーが発生した場合 public abstract void setStatus(int status)
このメソッドは、getResponseBody()
を呼び出す前に呼び出す必要があります。
status
- 送信するレスポンスコード getResponseBody()
public abstract InetSocketAddressSE getRemoteAddress()
public abstract InetSocketAddressSE getLocalAddress()
public abstract StringSE getProtocol()
public abstract StringSE getScheme()
public abstract StringSE getPathInfo()
これは MessageContext.PATH_INFO
に使用できます
null
のクエリ文字列の前にあるパスです(リクエスト URI に追加のパスがない場合)。public abstract StringSE getQueryString()
これは MessageContext.QUERY_STRING
に使用できます
null
public abstract ObjectSE getAttribute(StringSE name)
HttpExchange
に関連付けられている属性を返します。Jakarta XML Web Services ハンドラーとエンドポイントは、MessageContext
を介して属性にアクセスできます。 サーブレットコンテナーは、MessageContext.SERVLET_CONTEXT
、MessageContext.SERVLET_REQUEST
、MessageContext.SERVLET_RESPONSE
を属性として公開する必要があります。
HTTPS を使用してコンテナーがリクエストを受信した場合は、次の情報を属性として公開する必要があります。これらの属性は、REQUEST_CIPHER_SUITE
および REQUEST_KEY_SIZE
です。リクエストに関連付けられた SSL 証明書がある場合は、REQUEST_X509CERTIFICATE
を使用して公開する必要があります
name
- 属性名 null
public abstract SetSE<StringSE> getAttributeNames()
HttpExchange
に関連付けられているすべての属性名を指定します。getAttribute(String)
public abstract PrincipalSE getUserPrincipal()
HttpExchange
の認証済みユーザーを表す Principal
SE を返します。null
public abstract boolean isUserInRole(StringSE role)
role
- ロールの名前を指定します true
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.