com.amazonaws.http

クラス StaxResponseHandler<T>

java.lang.Object

com.amazonaws.http.StaxResponseHandler<T>

型パラメータ:

T - Indicates the type being unmarshalled by this response handler.

すべての実装されたインタフェース:

HttpResponseHandler<AmazonWebServiceResponse<T>>

直系の既知のサブクラス:

SimpleDBStaxResponseHandler

public class StaxResponseHandler<T>
extends java.lang.Object
implements HttpResponseHandler<AmazonWebServiceResponse<T>>

AWS サービスと StAX アンマーシャラを用いた XML 文字列を Java オブジェクトに変換した結果から、 正しいレスポンスを受け取った HttpResponseHandler のデフォルトの実装

コンストラクタの概要

コンストラクタ

コンストラクタと説明
StaxResponseHandler(com.amazonaws.transform.Unmarshaller<T,com.amazonaws.transform.StaxUnmarshallerContext> responseUnmarshaller) 指定された StAX アンマーシャラを用いて、サービスレスポンスをマーシャリングし、 サービスのレスポンスからビジネスデータの基幹を見つけるため、指定されたレスポンスの要素のパスを用いて、 新しいレスポンスハンドラを作成します。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
AmazonWebServiceResponse<T>	handle(HttpResponse response) HTTP レスポンスオブジェクトを受け入れ、 T 型のオブジェクトを返します。
boolean	needsConnectionLeftOpen() このレスポンスハンドラが基盤となる HTTP 接続と handle メソッド間からのすべてのデータを消費すると、 HTTP コネクションを開けたままにする必要がなくなります。
protected void	registerAdditionalMetadataExpressions(com.amazonaws.transform.StaxUnmarshallerContext unmarshallerContext) Hook for subclasses to override in order to collect additional metadata from service responses.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

StaxResponseHandler

public StaxResponseHandler(com.amazonaws.transform.Unmarshaller<T,com.amazonaws.transform.StaxUnmarshallerContext> responseUnmarshaller)

指定された StAX アンマーシャラを用いて、サービスレスポンスをマーシャリングし、 サービスのレスポンスからビジネスデータの基幹を見つけるため、指定されたレスポンスの要素のパスを用いて、 新しいレスポンスハンドラを作成します。

パラメータ:

responseUnmarshaller - The StAX unmarshaller to use on the response.

メソッドの詳細

handle

public AmazonWebServiceResponse<T> handle(HttpResponse response)
                                   throws java.lang.Exception

インタフェースからコピーされた説明: HttpResponseHandler

HTTP レスポンスオブジェクトを受け入れ、 T 型のオブジェクトを返します。 個別の実装において、必要であったとしてもその応答ハンドラを選択し、求める型を返します。

定義:

handle インタフェース内 HttpResponseHandler<AmazonWebServiceResponse<T>>

パラメータ:

response - The HTTP response to handle, as received from an AWS service.

戻り値:

An object of type T, as defined by individual implementations.

例外:

java.lang.Exception - If any problems are encountered handling the response.

関連項目:

HttpResponseHandler.handle(com.amazonaws.http.HttpResponse)

registerAdditionalMetadataExpressions

protected void registerAdditionalMetadataExpressions(com.amazonaws.transform.StaxUnmarshallerContext unmarshallerContext)

Hook for subclasses to override in order to collect additional metadata from service responses.

パラメータ:

unmarshallerContext - The unmarshaller context used to process a service's response data.

needsConnectionLeftOpen

public boolean needsConnectionLeftOpen()

このレスポンスハンドラが基盤となる HTTP 接続と handle メソッド間からのすべてのデータを消費すると、 HTTP コネクションを開けたままにする必要がなくなります。

定義:

needsConnectionLeftOpen インタフェース内 HttpResponseHandler<AmazonWebServiceResponse<T>>

戻り値:

True if this response handler requires that the underlying HTTP connection be left open, and not automatically closed, otherwise false.

関連項目:

HttpResponseHandler.needsConnectionLeftOpen()