HttpInvokerServiceExporter (Spring Framework 5.2.5.RELEASE API)

java.lang.ObjectSE
- org.springframework.remoting.support.RemotingSupport
- - org.springframework.remoting.support.RemoteExporter
  - - org.springframework.remoting.support.RemoteInvocationBasedExporter
    - - org.springframework.remoting.rmi.RemoteInvocationSerializingExporter
      - org.springframework.remoting.httpinvoker.HttpInvokerServiceExporter

実装されたすべてのインターフェース:
Aware, BeanClassLoaderAware, InitializingBean, HttpRequestHandler
```
public class HttpInvokerServiceExporter
extends RemoteInvocationSerializingExporter
implements HttpRequestHandler
```
指定されたサービス Bean を HTTP インボーカーサービスエンドポイントとしてエクスポートするサーブレット API ベースの HTTP リクエストハンドラー。HTTP インボーカープロキシ経由でアクセスできます。
リモート呼び出しオブジェクトをデシリアライズし、リモート呼び出し結果オブジェクトを直列化します。RMI と同様に Java シリアライゼーションを使用しますが、Caucho の HTTP ベースの Hessian プロトコルと同じように簡単にセットアップできます。
HTTP 呼び出し側は、Java から Java へのリモート化の推奨プロトコルです。Hessian よりも強力で拡張性がありますが、Java に縛られています。それでも、Hessian と同じように簡単にセットアップできます。これは、RMI と比較した場合の主な利点です。
警告: 安全でない Java の逆直列化による脆弱性に注意してください。操作された入力ストリームは、逆直列化ステップ中にサーバー上で望ましくないコード実行を引き起こす可能性があります。結果として、HTTP 呼び出し側エンドポイントを信頼できないクライアントに公開するのではなく、独自のサービス間で公開するようにしてください。一般的に、代わりに他のメッセージ形式（JSON など）を強くお勧めします。
導入:
1.1
作成者:
Juergen Hoeller
関連事項:
HttpInvokerClientInterceptor, HttpInvokerProxyFactoryBean, RmiServiceExporter, HessianServiceExporter

フィールドのサマリー
- クラス org.springframework.remoting.rmi.RemoteInvocationSerializingExporter から継承されたフィールド
  CONTENT_TYPE_SERIALIZED_OBJECT
- クラス org.springframework.remoting.support.RemotingSupport から継承されたフィールド
  logger

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

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

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected InputStreamSE`	`decorateInputStream(HttpServletRequestEE request, InputStreamSE is)` リモート呼び出しの読み取りに使用する InputStream を返します。指定された元の InputStream を装飾する可能性があります。
`protected OutputStreamSE`	`decorateOutputStream(HttpServletRequestEE request, HttpServletResponseEE response, OutputStreamSE os)` リモート呼び出し結果の書き込みに使用する OutputStream を返します。指定された元の OutputStream を装飾する可能性があります。
`void`	`handleRequest(HttpServletRequestEE request, HttpServletResponseEE response)` リクエストからリモート呼び出しを読み取り、それを実行して、リモート呼び出し結果をレスポンスに書き込みます。
`protected RemoteInvocation`	`readRemoteInvocation(HttpServletRequestEE request)` 指定された HTTP リクエストから RemoteInvocation を読み取ります。
`protected RemoteInvocation`	`readRemoteInvocation(HttpServletRequestEE request, InputStreamSE is)` 指定された InputStream から RemoteInvocation オブジェクトを逆直列化します。
`protected void`	`writeRemoteInvocationResult(HttpServletRequestEE request, HttpServletResponseEE response, RemoteInvocationResult result)` 指定された RemoteInvocationResult を指定された HTTP レスポンスに書き込みます。
`protected void`	`writeRemoteInvocationResult(HttpServletRequestEE request, HttpServletResponseEE response, RemoteInvocationResult result, OutputStreamSE os)` 指定された RemoteInvocation を指定された OutputStream に直列化します。

クラス org.springframework.remoting.rmi.RemoteInvocationSerializingExporter から継承されたメソッド
afterPropertiesSet, createObjectInputStream, createObjectOutputStream, doReadRemoteInvocation, doWriteRemoteInvocationResult, getContentType, getProxy, isAcceptProxyClasses, prepare, setAcceptProxyClasses, setContentType

クラス org.springframework.remoting.support.RemoteInvocationBasedExporter から継承されたメソッド
getRemoteInvocationExecutor, invoke, invokeAndCreateResult, setRemoteInvocationExecutor

クラス org.springframework.remoting.support.RemoteExporter から継承されたメソッド
checkService, checkServiceInterface, getExporterName, getProxyForService, getService, getServiceInterface, setInterceptors, setRegisterTraceInterceptor, setService, setServiceInterface

クラス org.springframework.remoting.support.RemotingSupport から継承されたメソッド
getBeanClassLoader, overrideThreadContextClassLoader, resetThreadContextClassLoader, setBeanClassLoader

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

- コンストラクターの詳細
  - HttpInvokerServiceExporter
```
public HttpInvokerServiceExporter()
```
- メソッドの詳細
  - handleRequest
```
public void handleRequest(HttpServletRequestEE request,
                          HttpServletResponseEE response)
                   throws ServletExceptionEE,
                          IOExceptionSE
```
    リクエストからリモート呼び出しを読み取り、それを実行して、リモート呼び出し結果をレスポンスに書き込みます。
    次で指定:
    インターフェース HttpRequestHandler の handleRequest
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    例外:
    ServletExceptionEE - 一般的なエラーの場合
    IOExceptionSE - I/O エラーの場合
    関連事項:
    readRemoteInvocation(HttpServletRequest), RemoteInvocationBasedExporter.invokeAndCreateResult(org.springframework.remoting.support.RemoteInvocation, Object), writeRemoteInvocationResult(HttpServletRequest, HttpServletResponse, RemoteInvocationResult)
  - readRemoteInvocation
```
protected RemoteInvocation readRemoteInvocation(HttpServletRequestEE request)
                                         throws IOExceptionSE,
                                                ClassNotFoundExceptionSE
```
    指定された HTTP リクエストから RemoteInvocation を読み取ります。
    servlet request's input streamEE を使用して readRemoteInvocation(HttpServletRequest, InputStream) にデリゲートします。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    RemoteInvocation オブジェクト
    例外:
    IOExceptionSE - I/O 障害の場合
    ClassNotFoundExceptionSE - 逆直列化によってスローされた場合
  - readRemoteInvocation
```
protected RemoteInvocation readRemoteInvocation(HttpServletRequestEE request,
                                                InputStreamSE is)
                                         throws IOExceptionSE,
                                                ClassNotFoundExceptionSE
```
    指定された InputStream から RemoteInvocation オブジェクトを逆直列化します。
    decorateInputStream(javax.servlet.http.HttpServletRequest, java.io.InputStream) に最初にストリームを装飾する機会を与えます（たとえば、カスタム暗号化または圧縮のため）。CodebaseAwareObjectInputStream を作成し、RemoteInvocationSerializingExporter.doReadRemoteInvocation(java.io.ObjectInputStream) を呼び出して実際にオブジェクトを読み取ります。
    呼び出しのカスタム直列化のためにオーバーライドできます。
    パラメーター:
    request - 現在の HTTP リクエスト
    is - 読み込み元の InputStream
    戻り値:
    RemoteInvocation オブジェクト
    例外:
    IOExceptionSE - I/O 障害の場合
    ClassNotFoundExceptionSE - 逆直列化中にスローされた場合
  - decorateInputStream
```
protected InputStreamSE decorateInputStream(HttpServletRequestEE request,
                                          InputStreamSE is)
                                   throws IOExceptionSE
```
    リモート呼び出しの読み取りに使用する InputStream を返します。指定された元の InputStream を装飾する可能性があります。
    デフォルトの実装は、指定されたストリームをそのまま返します。たとえば、カスタムの暗号化や圧縮のためにオーバーライドできます。
    パラメーター:
    request - 現在の HTTP リクエスト
    is - オリジナルの InputStream
    戻り値:
    潜在的に装飾された InputStream
    例外:
    IOExceptionSE - I/O 障害の場合
  - writeRemoteInvocationResult
```
protected void writeRemoteInvocationResult(HttpServletRequestEE request,
                                           HttpServletResponseEE response,
                                           RemoteInvocationResult result)
                                    throws IOExceptionSE
```
    指定された RemoteInvocationResult を指定された HTTP レスポンスに書き込みます。
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    result - RemoteInvocationResult オブジェクト
    例外:
    IOExceptionSE - I/O 障害の場合
  - writeRemoteInvocationResult
```
protected void writeRemoteInvocationResult(HttpServletRequestEE request,
                                           HttpServletResponseEE response,
                                           RemoteInvocationResult result,
                                           OutputStreamSE os)
                                    throws IOExceptionSE
```
    指定された RemoteInvocation を指定された OutputStream に直列化します。
    デフォルトの実装では、decorateOutputStream(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.io.OutputStream) が最初にストリームを装飾する機会が与えられます（たとえば、カスタムの暗号化または圧縮のため）。最終ストリームの ObjectOutputStreamSE を作成し、RemoteInvocationSerializingExporter.doWriteRemoteInvocationResult(org.springframework.remoting.support.RemoteInvocationResult, java.io.ObjectOutputStream) を呼び出して実際にオブジェクトを書き込みます。
    呼び出しのカスタム直列化のためにオーバーライドできます。
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    result - RemoteInvocationResult オブジェクト
    os - 書き込む OutputStream
    例外:
    IOExceptionSE - I/O 障害の場合
    関連事項:
    decorateOutputStream(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.io.OutputStream), RemoteInvocationSerializingExporter.doWriteRemoteInvocationResult(org.springframework.remoting.support.RemoteInvocationResult, java.io.ObjectOutputStream)
  - decorateOutputStream
```
protected OutputStreamSE decorateOutputStream(HttpServletRequestEE request,
                                            HttpServletResponseEE response,
                                            OutputStreamSE os)
                                     throws IOExceptionSE
```
    リモート呼び出し結果の書き込みに使用する OutputStream を返します。指定された元の OutputStream を装飾する可能性があります。
    デフォルトの実装は、指定されたストリームをそのまま返します。たとえば、カスタムの暗号化や圧縮のためにオーバーライドできます。
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    os - オリジナルの OutputStream
    戻り値:
    潜在的に装飾された OutputStream
    例外:
    IOExceptionSE - I/O 障害の場合

クラス HttpInvokerServiceExporter

フィールドのサマリー

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

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

コンストラクターの概要

メソッドのサマリー

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

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

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

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

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

コンストラクターの詳細

HttpInvokerServiceExporter

メソッドの詳細

handleRequest

readRemoteInvocation

readRemoteInvocation

decorateInputStream

writeRemoteInvocationResult

writeRemoteInvocationResult

decorateOutputStream