SimpleHttpInvokerRequestExecutor (Spring Framework 5.0.0.RELEASE API)

java.lang.ObjectSE
- org.springframework.remoting.httpinvoker.AbstractHttpInvokerRequestExecutor
- - org.springframework.remoting.httpinvoker.SimpleHttpInvokerRequestExecutor

実装されているすべてのインターフェース:
Aware, BeanClassLoaderAware, HttpInvokerRequestExecutor
```
public class SimpleHttpInvokerRequestExecutor
extends AbstractHttpInvokerRequestExecutor
```
HTTP 認証や詳細構成オプションをサポートせずに、標準の J2SE 機能を使用して POST リクエストを実行する HttpInvokerRequestExecutor 実装。
特定のテンプレートメソッドをカスタマイズして簡単にサブクラス化できるように設計されています。ただし、HttpComponentsHttpInvokerRequestExecutor はより洗練されたニーズがあるため、検討してください。J2SEHttpURLConnection の機能はかなり制限されています。
導入:
1.1
作成者:
Juergen Hoeller
関連事項:
HttpURLConnectionSE

フィールドのサマリー
- クラス org.springframework.remoting.httpinvoker.AbstractHttpInvokerRequestExecutor から継承されたフィールド
  CONTENT_TYPE_SERIALIZED_OBJECT, ENCODING_GZIP, HTTP_HEADER_ACCEPT_ENCODING, HTTP_HEADER_ACCEPT_LANGUAGE, HTTP_HEADER_CONTENT_ENCODING, HTTP_HEADER_CONTENT_LENGTH, HTTP_HEADER_CONTENT_TYPE, HTTP_METHOD_POST, logger

コンストラクターの概要
コンストラクター
コンストラクターと説明
SimpleHttpInvokerRequestExecutor()

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

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected RemoteInvocationResult`	`doExecuteRequest(HttpInvokerClientConfiguration config, ByteArrayOutputStreamSE baos)` 標準の J2SE HttpURLConnection を介して、指定されたリクエストを実行します。
`protected boolean`	`isGzipResponse(HttpURLConnectionSE con)` 指定されたレスポンスが GZIP レスポンスかどうかを判別します。
`protected HttpURLConnectionSE`	`openConnection(HttpInvokerClientConfiguration config)` 指定されたリモート呼び出しリクエストの HttpURLConnection を開きます。
`protected void`	`prepareConnection(HttpURLConnectionSE connection, int contentLength)` 指定された HTTP 接続を準備します。
`protected InputStreamSE`	`readResponseBody(HttpInvokerClientConfiguration config, HttpURLConnectionSE con)` 指定された実行済みのリモート呼び出しリクエストからレスポンス本文を抽出します。
`void`	`setConnectTimeout(int connectTimeout)` 基礎となる URLConnection の接続タイムアウトを設定します（ミリ秒単位）。
`void`	`setReadTimeout(int readTimeout)` 基礎となる URLConnection の読み取りタイムアウトを設定します（ミリ秒単位）。
`protected void`	`validateResponse(HttpInvokerClientConfiguration config, HttpURLConnectionSE con)` HttpURLConnection オブジェクトに含まれているように指定されたレスポンスを検証し、成功した HTTP レスポンスに対応していない場合は例外をスローします。
`protected void`	`writeRequestBody(HttpInvokerClientConfiguration config, HttpURLConnectionSE con, ByteArrayOutputStreamSE baos)` 指定された直列化されたリモート呼び出しをリクエスト本文として設定します。

クラス org.springframework.remoting.httpinvoker.AbstractHttpInvokerRequestExecutor から継承されたメソッド
createObjectInputStream, decorateInputStream, decorateOutputStream, doReadRemoteInvocationResult, doWriteRemoteInvocation, executeRequest, getBeanClassLoader, getByteArrayOutputStream, getContentType, isAcceptGzipEncoding, readRemoteInvocationResult, setAcceptGzipEncoding, setBeanClassLoader, setContentType, writeRemoteInvocation

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - SimpleHttpInvokerRequestExecutor
```
public SimpleHttpInvokerRequestExecutor()
```
- メソッドの詳細
  - setConnectTimeout
```
public void setConnectTimeout(int connectTimeout)
```
    基礎となる URLConnection の接続タイムアウトを設定します（ミリ秒単位）。タイムアウト値 0 は、無限のタイムアウトを指定します。
    デフォルトは、システムのデフォルトのタイムアウトです。
    関連事項:
    URLConnection.setConnectTimeout(int)SE
  - setReadTimeout
```
public void setReadTimeout(int readTimeout)
```
    基礎となる URLConnection の読み取りタイムアウトを設定します（ミリ秒単位）。タイムアウト値 0 は、無限のタイムアウトを指定します。
    デフォルトは、システムのデフォルトのタイムアウトです。
    関連事項:
    URLConnection.setReadTimeout(int)SE
  - doExecuteRequest
```
protected RemoteInvocationResult doExecuteRequest(HttpInvokerClientConfiguration config,
                                                  ByteArrayOutputStreamSE baos)
                                           throws IOExceptionSE,
                                                  ClassNotFoundExceptionSE
```
    標準の J2SE HttpURLConnection を介して、指定されたリクエストを実行します。
    このメソッドは、基本的な処理ワークフローを実装します。実際の作業は、このクラスのテンプレートメソッドで行われます。
    次で指定:
    クラス AbstractHttpInvokerRequestExecutor の doExecuteRequest
    パラメーター:
    config - ターゲットサービスを指定する HTTP インボーカー構成
    baos - 直列化された RemoteInvocation オブジェクトを含む ByteArrayOutputStream
    戻り値:
    RemoteInvocationResult オブジェクト
    例外:
    IOExceptionSE - I/O 操作によってスローされた場合
    ClassNotFoundExceptionSE - 逆直列化中にスローされた場合
    関連事項:
    openConnection(org.springframework.remoting.httpinvoker.HttpInvokerClientConfiguration), prepareConnection(java.net.HttpURLConnection, int), writeRequestBody(org.springframework.remoting.httpinvoker.HttpInvokerClientConfiguration, java.net.HttpURLConnection, java.io.ByteArrayOutputStream), validateResponse(org.springframework.remoting.httpinvoker.HttpInvokerClientConfiguration, java.net.HttpURLConnection), readResponseBody(org.springframework.remoting.httpinvoker.HttpInvokerClientConfiguration, java.net.HttpURLConnection)
  - openConnection
```
protected HttpURLConnectionSE openConnection(HttpInvokerClientConfiguration config)
                                    throws IOExceptionSE
```
    指定されたリモート呼び出しリクエストの HttpURLConnection を開きます。
    パラメーター:
    config - ターゲットサービスを指定する HTTP インボーカー構成
    戻り値:
    指定されたリクエストの HttpURLConnection
    例外:
    IOExceptionSE - I/O メソッドによってスローされた場合
    関連事項:
    URL.openConnection()SE
  - prepareConnection
```
protected void prepareConnection(HttpURLConnectionSE connection,
                                 int contentLength)
                          throws IOExceptionSE
```
    指定された HTTP 接続を準備します。
    デフォルトの実装では、POST をメソッドとして、"application/x-java-serialized-object" を "Content-Type" ヘッダーとして、指定されたコンテンツの長さを "Content-Length" ヘッダーとして指定しています。
    パラメーター:
    connection - 準備する HTTP 接続
    contentLength - 送信するコンテンツの長さ
    例外:
    IOExceptionSE - HttpURLConnection メソッドによってスローされた場合
    関連事項:
    HttpURLConnection.setRequestMethod(java.lang.String)SE, URLConnection.setRequestProperty(java.lang.String, java.lang.String)SE
  - writeRequestBody
```
protected void writeRequestBody(HttpInvokerClientConfiguration config,
                                HttpURLConnectionSE con,
                                ByteArrayOutputStreamSE baos)
                         throws IOExceptionSE
```
    指定された直列化されたリモート呼び出しをリクエスト本文として設定します。
    デフォルトの実装では、シリアライズされた呼び出しを HttpURLConnection の OutputStream に書き込むだけです。これをオーバーライドして、たとえば、特定のエンコーディングを記述し、適切な HTTP リクエストヘッダーを設定することができます。
    パラメーター:
    config - ターゲットサービスを指定する HTTP インボーカー構成
    con - リクエストの本文を書き込む HttpURLConnection
    baos - 直列化された RemoteInvocation オブジェクトを含む ByteArrayOutputStream
    例外:
    IOExceptionSE - I/O メソッドによってスローされた場合
    関連事項:
    URLConnection.getOutputStream()SE, URLConnection.setRequestProperty(java.lang.String, java.lang.String)SE
  - validateResponse
```
protected void validateResponse(HttpInvokerClientConfiguration config,
                                HttpURLConnectionSE con)
                         throws IOExceptionSE
```
    HttpURLConnection オブジェクトに含まれているように指定されたレスポンスを検証し、成功した HTTP レスポンスに対応していない場合は例外をスローします。
    デフォルトの実装では、2xx を超える HTTP ステータスコードはすべて拒否されます。これにより、レスポンス本文の解析や破損したストリームからの逆直列化の試行が回避されます。
    パラメーター:
    config - ターゲットサービスを指定する HTTP インボーカー構成
    con - 検証する HttpURLConnection
    例外:
    IOExceptionSE - 検証に失敗した場合
    関連事項:
    HttpURLConnection.getResponseCode()SE
  - readResponseBody
```
protected InputStreamSE readResponseBody(HttpInvokerClientConfiguration config,
                                       HttpURLConnectionSE con)
                                throws IOExceptionSE
```
    指定された実行済みのリモート呼び出しリクエストからレスポンス本文を抽出します。
    デフォルトの実装は、HttpURLConnection の InputStream から直列化された呼び出しを読み取るだけです。レスポンスが GZIP レスポンスとして認識されると、InputStream は GZIPInputStream にラップされます。
    パラメーター:
    config - ターゲットサービスを指定する HTTP インボーカー構成
    con - レスポンス本文を読み取る HttpURLConnection
    戻り値:
    レスポンス本文の InputStream
    例外:
    IOExceptionSE - I/O メソッドによってスローされた場合
    関連事項:
    isGzipResponse(java.net.HttpURLConnection), GZIPInputStreamSE, URLConnection.getInputStream()SE, HttpURLConnection.getHeaderField(int)SE, HttpURLConnection.getHeaderFieldKey(int)SE
  - isGzipResponse
```
protected boolean isGzipResponse(HttpURLConnectionSE con)
```
    指定されたレスポンスが GZIP レスポンスかどうかを判別します。
    デフォルトの実装では、HTTP の "Content-Encoding" ヘッダーに "gzip" が含まれているかどうかを確認します（大文字と小文字の区別なく）。
    パラメーター:
    con - チェックする HttpURLConnection

クラス SimpleHttpInvokerRequestExecutor

フィールドのサマリー

クラス org.springframework.remoting.httpinvoker.AbstractHttpInvokerRequestExecutor から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.remoting.httpinvoker.AbstractHttpInvokerRequestExecutor から継承されたメソッド

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

コンストラクターの詳細

SimpleHttpInvokerRequestExecutor

メソッドの詳細

setConnectTimeout

setReadTimeout

doExecuteRequest

openConnection

prepareConnection

writeRequestBody

validateResponse

readResponseBody

isGzipResponse