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()`