com.iijgio.dag.http

Interface HttpResponseHandler<T>

Type Parameters:

T - このレスポンスハンドラの返す型

All Known Implementing Classes:

AbstractResponseHandler, ResponseHeaderHandlerChain, StorageErrorResponseHandler, StorageMetadataResponseHandler, StorageObjectResponseHandler, StorageStringResponseHandler, StorageXmlResponseHandler

public interface HttpResponseHandler<T>

HTTPレスポンスの処理を定義するインターフェースです。 HTTPレスポンスの処理行い、任意の型のオブジェクトを返します。 たとえな、典型的なレスポンスハンドラはレスポンスを受け取り、具体的な型のオブジェクトに 変換します。

Method Summary

Modifier and Type	Method and Description
T	handle(HttpResponse response) HTTPレスポンスオブジェクトを受け取り、任意の型のオブジェクトを変えｈします。 それぞれの実装ではレスポンスを処理するか選択することが出来ます。しかし、 なんらかの型のレスポンスは返す必要があります
boolean	needsConnectionLeftOpen() このレスポンスハンドラが、HTTP Connectionを必要とするか、レスポンスの 処理のあと自動的にConnectionを閉じて良いかを返します。

Method Detail

handle

T handle(HttpResponse response)
  throws Exception

HTTPレスポンスオブジェクトを受け取り、任意の型のオブジェクトを変えｈします。 それぞれの実装ではレスポンスを処理するか選択することが出来ます。しかし、 なんらかの型のレスポンスは返す必要があります

Parameters:

response - 処理を行う、IIJ GIOストレージ＆アナリシスサービス APIより返された HTTPレスポンスオブジェクト

Returns:

それぞれの実装による、任意の型のオブジェクト

Throws:

Exception - レスポンスの処理で問題が発生した場合

needsConnectionLeftOpen

boolean needsConnectionLeftOpen()

このレスポンスハンドラが、HTTP Connectionを必要とするか、レスポンスの 処理のあと自動的にConnectionを閉じて良いかを返します。

たとえば、ハンドラオブジェクトが返すオブジェクトがHTTP Connectionのストリーム データをマニュアルで管理しており、すべてのデータをhandle(HttpResponse) メソッドで読み取らない場合、このメソッドを使って自動的なConnectionのクローズに よって、Connectionが早まって閉じられてしまう事を避けることが出来ます

しかし、レスポンスハンドラはこのオプションの使用には非常に慎重に行うべきです。 すなわち、リソースのクリーンアップが自動的に行われなくなるため、明示的にクローズを 行わないと、HTTPコネクションリソースを使い果たしてしまいます

Returns:

レスポンスハンドラが HTTP Connectionを必要とし、 自動的なConnection のクローズを行わない場合は True、そうでなければ False