HttpExchange (Java Platform SE 7)

java.lang.Object
- javax.xml.ws.spi.http.HttpExchange

```
public abstract class HttpExchange
extends Object
```
このクラスは、一回の交換で、受信する HTTP 要求と生成される応答をカプセル化します。これは、クライアントからの要求の検査と、応答の作成と送信のための方法を提供します。
ベースとなるリソースを解放または再利用するには、HttpExchange を閉じておく必要があります。交換を閉じられなかった場合の影響は定義されていません。

導入されたバージョン:

JAX-WS 2.2

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static String`	`REQUEST_CIPHER_SUITE` 標準プロパティー:HTTPS での要求の受信時の暗号化方式群値
`static String`	`REQUEST_KEY_SIZE` 標準プロパティー:HTTPS での要求の受信時のアルゴリズムのビットサイズ
`static String`	`REQUEST_X509CERTIFICATE` 標準プロパティー:要求に関連付けられている SSL 証明書 (存在する場合)

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

HttpExchange()

コンストラクタ
コンストラクタと説明
`HttpExchange()`

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`abstract void`	`addResponseHeader(String name, String value)` 指定された名前と値を持つ応答ヘッダーを追加します。
`abstract void`	`close()` これは、交換を終了するために呼び出す必要があります。
`abstract Object`	`getAttribute(String name)` この `HttpExchange` に関連付けられた属性を返します。
`abstract Set<String>`	`getAttributeNames()` この `HttpExchange` に関連付けられたすべての属性名を示します。
`abstract String`	`getContextPath()` アプリケーション内のすべての端点のコンテキストパスを返します。
`abstract HttpContext`	`getHttpContext()` この交換の `HttpContext` を返します。
`abstract InetSocketAddress`	`getLocalAddress()` 要求を受信した未解決のローカルアドレスを返します。
`abstract String`	`getPathInfo()` 要求 URI 内で Web サービスのパスの後ろからクエリー文字列の前までの位置に書かれ、「/」で始まる追加のパス情報を返します。
`abstract String`	`getProtocol()` protocol/majorVersion.minorVersion の形式で要求からのプロトコル文字列を返します。
`abstract String`	`getQueryString()` 要求 URI 内のパスの後ろに含まれているクエリー文字列を返します。
`abstract InetSocketAddress`	`getRemoteAddress()` この要求を呼び出すリモートエンティティーの未解決のアドレスを返します。
`abstract InputStream`	`getRequestBody()` 要求本体を読み込むことができるストリームを返します。
`abstract String`	`getRequestHeader(String name)` 指定された要求ヘッダーの値を返します。
`abstract Map<String,List<String>>`	`getRequestHeaders()` この要求に組み込まれた HTTP ヘッダーを含む不変のマップを返します。
`abstract String`	`getRequestMethod()` HTTP 要求メソッドを取得します
`abstract String`	`getRequestURI()` HTTP 要求の最初の行にあるこの要求の URI の、プロトコル名からクエリー文字列までの部分を返します。
`abstract OutputStream`	`getResponseBody()` 応答本体の書き込み先となるストリームを返します。
`abstract Map<String,List<String>>`	`getResponseHeaders()` HTTP 応答ヘッダーを格納でき、この応答の一部として送信される、変更可能なマップを返します。
`abstract String`	`getScheme()` たとえば http または https のように、この要求に使用されるスキームの名前を返します。
`abstract Principal`	`getUserPrincipal()` この `HttpExchange` に対して認証されたユーザーを表す `Principal` を返します。
`abstract boolean`	`isUserInRole(String role)` 認証されたユーザーが指定された論理的な「ロール」に含まれているかどうかを示します。
`abstract void`	`setStatus(int status)` この応答の HTTP ステータスコードを設定します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - REQUEST_CIPHER_SUITE
```
public static final String REQUEST_CIPHER_SUITE
```
    標準プロパティー:HTTPS での要求の受信時の暗号化方式群値
    型:String
    
    関連項目:
    定数フィールド値
  - REQUEST_KEY_SIZE
```
public static final String REQUEST_KEY_SIZE
```
    標準プロパティー:HTTPS での要求の受信時のアルゴリズムのビットサイズ
    型:Integer
    
    関連項目:
    定数フィールド値
  - REQUEST_X509CERTIFICATE
```
public static final String REQUEST_X509CERTIFICATE
```
    標準プロパティー:要求に関連付けられている SSL 証明書 (存在する場合)
    型:java.security.cert.X509Certificate[] この配列の順序は、信頼に基づく昇順として定義されています。チェーン内の最初の証明書はクライアントによって設定された証明書で、次の証明書は最初の証明書を認証するために使用されます。それ以降も同様です。
    
    関連項目:
    定数フィールド値
- コンストラクタの詳細
  - HttpExchange
```
public HttpExchange()
```
- メソッドの詳細
  - getRequestHeaders
```
public abstract Map<String,List<String>> getRequestHeaders()
```
    この要求に組み込まれた HTTP ヘッダーを含む不変のマップを返します。このマップ内のキーはヘッダー名になり、値は、組み込まれた各値を含む文字列のリストになります。これは、複数回指定されたヘッダー、または単一行のコンマで区切られた値のリストを受け入れるヘッダーの値です。このどちらの場合も、ヘッダー名の値は、要求に組み込まれた順序で表示されます。
    マップ内のキーでは大文字と小文字が区別されません。
    
    戻り値:
    要求ヘッダーへのアクセスに使用できる不変のマップ
  - getRequestHeader
```
public abstract String getRequestHeader(String name)
```
    指定された要求ヘッダーの値を返します。指定された名前のヘッダーが要求にない場合、このメソッドは null を返します。同じ名前のヘッダーが複数存在する場合、このメソッドは要求内の最初のヘッダーを返します。ヘッダー名では、大文字と小文字を区別しません。getRequestHeaders() を使用する代わりに、ヘッダーを取得するための簡易メソッドです。
    
    パラメータ:
    name - 要求ヘッダーの名前
    
    戻り値:
    要求されたヘッダーの値を返す。要求にその名前のヘッダーがない場合は null
  - getResponseHeaders
```
public abstract Map<String,List<String>> getResponseHeaders()
```
    HTTP 応答ヘッダーを格納でき、この応答の一部として送信される、変更可能なマップを返します。マップ内のキーはヘッダー名になり、値は、各値を含む文字列のリストにする必要があります。その文字列は、複数回組み込む各値が、組み込む順序で含まれます。
    マップ内のキーでは大文字と小文字が区別されません。
    
    戻り値:
    応答ヘッダーの設定に使用できる不変のマップ
  - addResponseHeader
```
public abstract void addResponseHeader(String name,
                     String value)
```
    指定された名前と値を持つ応答ヘッダーを追加します。このメソッドにより、応答ヘッダーに複数の値を設定することができるようになります。getResponseHeaders() を使用する代わりに、応答ヘッダーを追加するための簡易メソッドです。
    
    パラメータ:
    name - ヘッダーの名前
    value - 追加のヘッダー値。オクテット文字列を含む場合は、RFC 2047 (http://www.ietf.org/rfc/rfc2047.txt) に従ってエンコードするようにする
    関連項目:
    getResponseHeaders()
  - getRequestURI
```
public abstract String getRequestURI()
```
    HTTP 要求の最初の行にあるこの要求の URI の、プロトコル名からクエリー文字列までの部分を返します。コンテナはこの文字列をデコードしません。
    
    戻り値:
    要求 URI
  - getContextPath
```
public abstract String getContextPath()
```
    アプリケーション内のすべての端点のコンテキストパスを返します。このパスは、要求のコンテキストを示す、要求 URI の一部です。コンテキストパスは常に、要求 URI の先頭にあります。パスは「/」で始まりますが、「/」で終わりません。このメソッドが "" を返す場合は、デフォルトコンテキストを要求しています。コンテナはこの文字列をデコードしません。
    コンテキストパスは、端点のアドレスを計算するために使用されます。HttpContext.getPath() を参照してください。
    
    戻り値:
    アプリケーション内のすべての端点のコンテキストパス
    関連項目:
    HttpContext.getPath()
  - getRequestMethod
```
public abstract String getRequestMethod()
```
    HTTP 要求メソッドを取得します
    
    戻り値:
    要求メソッド
  - getHttpContext
```
public abstract HttpContext getHttpContext()
```
    この交換の HttpContext を返します。コンテナは、要求と関連する端点の HttpContext を一致させます
    
    戻り値:
    この交換の HttpContext
  - close
```
public abstract void close()
                    throws IOException
```
    これは、交換を終了するために呼び出す必要があります。コンテナは、要求と応答ストリームを閉じます。コンテナがベースとなるリソースを解放または再利用できるよう、これを呼び出す必要があります。
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - getRequestBody
```
public abstract InputStream getRequestBody()
                                    throws IOException
```
    要求本体を読み込むことができるストリームを返します。このメソッドを複数回呼び出した場合でも、同じストリームが返されます。
    
    戻り値:
    要求本体を読み取ることができるストリーム。
    
    例外:
    
    IOException - 要求の処理中に入出力エラーが発生した場合
  - getResponseBody
```
public abstract OutputStream getResponseBody()
                                      throws IOException
```
    応答本体の書き込み先となるストリームを返します。このメソッドを呼び出す前に setStatus(int) を呼び出す必要があります。同一の交換用にこのメソッドを複数回呼び出した場合でも、同じストリームが返されます。
    
    戻り値:
    応答本体の書き込み先のストリーム
    
    例外:
    
    IOException - 応答の処理中に入出力エラーが発生した場合
  - setStatus
```
public abstract void setStatus(int status)
```
    この応答の HTTP ステータスコードを設定します。
    このメソッドは、getResponseBody() を呼び出す前に呼び出す必要があります。
    
    パラメータ:
    status - 送信する応答コード
    関連項目:
    getResponseBody()
  - getRemoteAddress
```
public abstract InetSocketAddress getRemoteAddress()
```
    この要求を呼び出すリモートエンティティーの未解決のアドレスを返します。
    
    戻り値:
    呼び出し側の InetSocketAddress
  - getLocalAddress
```
public abstract InetSocketAddress getLocalAddress()
```
    要求を受信した未解決のローカルアドレスを返します。
    
    戻り値:
    ローカルインタフェースの InetSocketAddress
  - getProtocol
```
public abstract String getProtocol()
```
    protocol/majorVersion.minorVersion の形式で要求からのプロトコル文字列を返します。たとえば、「HTTP/1.1」です。
    
    戻り値:
    要求からのプロトコル文字列
  - getScheme
```
public abstract String getScheme()
```
    たとえば http または https のように、この要求に使用されるスキームの名前を返します。
    
    戻り値:
    この要求を行うために使用されたスキーム名
  - getPathInfo
```
public abstract String getPathInfo()
```
    要求 URI 内で Web サービスのパスの後ろからクエリー文字列の前までの位置に書かれ、「/」で始まる追加のパス情報を返します。
    これは MessageContext.PATH_INFO に使用できます
    
    戻り値:
    Web サービスの、デコードされた追加のパス情報。これは、Web サービスパスと要求 URI のクエリー文字列の間のパス。要求 URI に追加のパスがない場合は null
  - getQueryString
```
public abstract String getQueryString()
```
    要求 URI 内のパスの後ろに含まれているクエリー文字列を返します。
    これは MessageContext.QUERY_STRING に使用できます
    
    戻り値:
    要求 URI のデコードされていないクエリー文字列。要求 URI にクエリー文字列がない場合は null
  - getAttribute
```
public abstract Object getAttribute(String name)
```
    この HttpExchange に関連付けられた属性を返します。そうすると、JAX-WS ハンドラと端点は MessageContext を使用して属性にアクセスすることができます。
    サーブレットコンテナは、属性として MessageContext.SERVLET_CONTEXT、MessageContext.SERVLET_REQUEST、および MessageContext.SERVLET_RESPONSE を公開する必要があります。
    コンテナが HTTPS を使用して要求を受け付けると、属性として次の情報が公開される必要があります。属性とは REQUEST_CIPHER_SUITE および REQUEST_KEY_SIZE です。要求に関連付けられた SSL 証明書がある場合は、REQUEST_X509CERTIFICATE を使用して公開する必要があります。
    
    パラメータ:
    name - 属性名
    
    戻り値:
    属性値。属性が存在しない場合は null
  - getAttributeNames
```
public abstract Set<String> getAttributeNames()
```
    この HttpExchange に関連付けられたすべての属性名を示します。
    
    戻り値:
    すべての属性名のセット
    関連項目:
    getAttribute(String)
  - getUserPrincipal
```
public abstract Principal getUserPrincipal()
```
    この HttpExchange に対して認証されたユーザーを表す Principal を返します。
    
    戻り値:
    認証されたユーザーのプリンシパル。ユーザーが認証されていない場合は null
  - isUserInRole
```
public abstract boolean isUserInRole(String role)
```
    認証されたユーザーが指定された論理的な「ロール」に含まれているかどうかを示します。
    
    パラメータ:
    role - ロールの名前を指定する
    
    戻り値:
    この要求を行っているユーザーが、指定のロールに属する場合は true

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス HttpExchange

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

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

フィールドの詳細

REQUEST_CIPHER_SUITE

REQUEST_KEY_SIZE

REQUEST_X509CERTIFICATE

コンストラクタの詳細

HttpExchange

メソッドの詳細

getRequestHeaders

getRequestHeader

getResponseHeaders

addResponseHeader

getRequestURI

getContextPath

getRequestMethod

getHttpContext

close

getRequestBody

getResponseBody

setStatus

getRemoteAddress

getLocalAddress

getProtocol

getScheme

getPathInfo

getQueryString

getAttribute

getAttributeNames

getUserPrincipal

isUserInRole