Apache Wink REST クライアントを使用するクライアントの実装
Apache Wink REST クライアントを使用して、要求を 送信し、RESTful サービスからの応答を処理することができます。このクライアント API を Java™ プログラム内で使用して、Web サービスと通信することができます。
このタスクについて
デフォルトでは、Apache Wink クライアントは、 要求の発行および応答の処理のために、Java ランタイム 環境から java.net.HttpURLConnection クラスを使用します。Apache Wink クライアントは、 基礎となるクライアント・トランスポートとして Apache HttpClient 4.0 を 使用することもできます。
また、要求エンティティーの直列化または 応答エンティティーの非直列化のために JAX-RS エンティティー・プロバイダーを利用することもできます。クライアントと一緒に、 JAX-RS サーバー・サイド・サービス内で使用される標準 JAX-RS プロバイダーが提供されています。
Apache Wink REST クライアント はプログラムで構成するか、または、Java Virtual Machine (JVM) プロパティーを設定することによって構成できます。
Apache Wink REST クライアント を実装するには、まず最初に org.apache.wink.client.ClientConfig オブジェクトを 作成する必要があり、次に、このオブジェクトが org.apache.wink.client.RestClient を作成するために使用されます。プログラムで RestClient オブジェクト の構成設定を変更するか、または、 JVM プロパティーを使用してデフォルト ClientConfig オブジェクト値を 変更することができます。
- wink.client.readTimeout
このプロパティーは、RestClient オブジェクト が要求への応答をどれだけの間 (ミリ秒) 待機すればタイムアウトになるのかを指定します。値 0 は、クライアントが無限に待機して、タイムアウトにならないことを意味します。
デフォルト値は 60,000 ミリ秒です。
- wink.client.connectTimeout
このプロパティーは、RestClient オブジェクトが、ターゲット・リソースに接続しようとするときに、 どれだけの間 (ミリ秒) 待機すればタイムアウトになるのかを指定します。値 0 は、クライアントが無限に待機して、タイムアウトにならないことを意味します。
デフォルト値は 60,000 ミリ秒です。
JVM プロパティーを使用して 指定する RestClient オブジェクトの値は、すべてプログラムで変更 することができます。プログラムで設定する値は、JVM プロパティー値に 優先します。
手順
タスクの結果
JAX-RS アプリケーションに要求を発行できる Apache Wink REST クライアントを使用する JAX-RS クライアントの実装が完了しました。