com.amazonaws.http

クラス DefaultErrorResponseHandler

java.lang.Object

com.amazonaws.http.DefaultErrorResponseHandler

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

HttpResponseHandler<AmazonServiceException>

public class DefaultErrorResponseHandler
extends java.lang.Object
implements HttpResponseHandler<AmazonServiceException>

Amazon Web Services からのエラーレスポンスのみを扱う HttpResponseHandler を実行します。 アンマーシャラのリストはコンストラクタに渡され、エラーレスポンスが正常にXML文字列をJavaのオブジェクトに変換するまで、それぞれのアンマーシャラは順に走査されます。 エラーレスポンスを正しく変換できるアンマーシャラが見つからなかった場合、 汎用的な AmazonServiceException は AWS エラー情報(例： エラーメッセージ、 AWS エラーコード、 AWS リクエスト IDなど) を入力し、作成されます。

コンストラクタの概要

コンストラクタ

コンストラクタと説明
DefaultErrorResponseHandler(java.util.List<com.amazonaws.transform.Unmarshaller<AmazonServiceException,org.w3c.dom.Node>> unmarshallerList) 指定されたアンマーシャラのリストを用いて Amazon サービスからのエラーレスポンスを処理する新しい DefaultErrorResponseHandler を構築します。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
AmazonServiceException	handle(HttpResponse errorResponse) HTTP レスポンスオブジェクトを受け入れ、 T 型のオブジェクトを返します。
boolean	needsConnectionLeftOpen() この応答ハンドラは完全にhandleメソッド間に基本的なHTTP接続からのすべてのデータを消費するので、 HTTP接続を開いたままにしておく必要はありません。

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

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

コンストラクタの詳細

DefaultErrorResponseHandler

public DefaultErrorResponseHandler(java.util.List<com.amazonaws.transform.Unmarshaller<AmazonServiceException,org.w3c.dom.Node>> unmarshallerList)

指定されたアンマーシャラのリストを用いて Amazon サービスからのエラーレスポンスを処理する新しい DefaultErrorResponseHandler を構築します。 エラーレスポンスが正常アンマーシャルされるまで、それぞれのアンマーシャラは順に走査されます。

パラメータ:

unmarshallerList - The list of unmarshallers to try using when handling an error response.

メソッドの詳細

handle

public AmazonServiceException handle(HttpResponse errorResponse)
                              throws java.lang.Exception

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

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

定義:

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

パラメータ:

errorResponse - 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.

needsConnectionLeftOpen

public boolean needsConnectionLeftOpen()

この応答ハンドラは完全にhandleメソッド間に基本的なHTTP接続からのすべてのデータを消費するので、 HTTP接続を開いたままにしておく必要はありません。

定義:

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

戻り値:

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

関連項目:

HttpResponseHandler.needsConnectionLeftOpen()