getProperties()メソッド
説明
クライアントに関連するすべてのフィーチャのマップを取得します。
構文
public Map<String,Object> getProperties()
パラメタ
ありません。
戻り値
フィーチャのマップを返します。nullを返すことはありません。
注意事項
getProperties()メソッドの使用例を次に示します。
// クライアントを設定する ClientConfig cc = new DefaultClientConfig(); // 読み込みタイムアウト値を設定する cc.getProperties().put(ClientConfig.PROPERTY_READ_TIMEOUT, 10000); // クライアントの設定を利用してClientオブジェクトを生成する Client client = Client.create(cc); // HTTPリクエストを生成する ClientRequest cRequest = ClientRequest.create().build(new URI("http://example.com/example"), "GET"); try{ // HTTPレスポンスをClientResponseオブジェクトとして受信する ClientResponse cResponse = client.handle(cRequest); } catch(ClientHandlerException e){ // 適切な処理を実行する }
この例では,まず,getPropertiesメソッドで変更可能なプロパティマップを取得し,読み込みタイムアウト値を10,000ミリ秒に設定しています。Clientクラスのcreate(ClientConfig cc)メソッドではこのクライアント設定を使って,クライアントインスタンスを作成します。次にClientRequestオブジェクトを作成し,Clientクラスのhandleメソッドを利用してHTTP通信を行い,HTTPレスポンスをClientResponseオブジェクトとして受信しています。HTTPレスポンスが完全に読み込まれるまでに読み込みタイムアウトが発生した場合,エラーとなり(KDJJ18888-E),SocketTimeoutExceptionをラップしたClientHandlerExceptionがスローされます。