管理対象外の RESTful Web サービス JAX-RS 2.0 クライアントを使用したクライアントの実装
WebSphere® Application Server では、Java™ Platform, Standard Edition 8 (Java SE 8) RESTful Web サービス・シン・クライアント・ランタイムが提供されます。これにより、アプリケーション開発者は、JAX-RS クライアント・アプリケーションを素早く簡単に作成することができます。Thin Client for JAX-RS with WebSphere Application Server は、スタンドアロンの Java SE 8 クライアント環境であり、管理対象外の JAX-RS RESTful Web サービス・クライアント・アプリケーションを非 WebSphere 環境で実行して、アプリケーション・サーバーによってホストされる JAX-RS RESTful Web サービスを呼び出すことができます。
始める前に

JAX-RS 管理対象外のクライアント実行環境をセットアップする前に、 Thin Client for JAX-RS Java アーカイブ (JAR) ファイルを取得してください。Thin Client for JAX-RS を取得するには、WebSphere Application Server バージョン 9.0 または Application Client for WebSphere Application Server バージョン 9.0 をインストールしてください。Thin Client for JAX-RS JAR ファイル com.ibm.jaxrs2.0.thinclient_9.0.jar は、app_server_root¥runtimes ディレクトリーにあります。
Thin Client for JAX-RS ファイル (com.ibm.jaxrs2.0.thinclient_9.0.jar) を他のマシンにコピーして、製品と通信できる単純なクライアント環境を作成します。Thin Client for JAX-RS のコピーには、Thin Client for JAX-RS を取得した WebSphere 製品に対する使用許諾契約書の条項が適用されます。 正しい使用法およびその他の制約については、使用許諾契約書を参照してください。
Thin Client for JAX-RS は IBM® Software Development Kits (SDKs) バージョン 8.0 以降で動作します。Thin Client for JAX-RS は、V8.0 以降の IBM Software Development Kits 以外でもサポートされます。
このタスクについて
手順
次のタスク
- com.ibm.ws.jaxrs.client.connection.timeout と com.ibm.ws.jaxrs.client.receive.timeout のシン・クライアント・プロパティーを使用して、タイムアウト値を設定します。
- com.ibm.ws.jaxrs.client.connection.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.connection.timeout", "1000"); Client c = cb.build();
- com.ibm.ws.jaxrs.client.receive.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.receive.timeout", "1000"); Client c = cb.build();
ヒント: タイムアウト・プロパティーの値はミリ秒単位であり、タイプは long または整数です。値のタイプが無効の場合、以下のメッセージが表示されます。CWTRS0700E: JAX-RS クライアント・サイドのプロパティー com.ibm.ws.jaxrs.client.receive.timeout で指定されたタイムアウト値 {0} が無効です。値はデフォルトの 30000 に設定されています。{3}
- com.ibm.ws.jaxrs.client.connection.timeout
- シン・クライアント・プロキシー・サポートに関する次のシン・クライアント・プロパティーを使用します。
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.proxy.host", "hostname"); cb.property("com.ibm.ws.jaxrs.client.proxy.port", "8888";); cb.property("com.ibm.ws.jaxrs.client.proxy.type", "HTTP"); Client c = cb.build();
- com.ibm.ws.jaxrs.client.proxy.host
- com.ibm.ws.jaxrs.client.proxy.portヒント: プロキシー・サーバー・ポート値のタイプは整数でなければなりません。デフォルト値は 80 です。値タイプが無効の場合、以下のメッセージが表示されます。
CWTRS0701E: JAX-RS クライアント・サイドのプロパティー com.ibm.ws.jaxrs.client.proxy.port で指定されたプロキシー・サーバー・ポート値 {0} が無効です。値はデフォルトの 80 に設定されています。{3}
- com.ibm.ws.jaxrs.client.proxy.typeヒント: プロキシー・サーバー・タイプの値は、HTTP または SOCKS でなければなりません。デフォルト値は HTTP です。プロキシー・サーバーのタイプが無効の場合、以下のメッセージが表示されます。
CWTRS0702E: JAX-RS クライアント・サイドのプロパティー com.ibm.ws.jaxrs.client.proxy.type で指定されたプロキシー・サーバー・タイプ値 {0} が無効です。値はデフォルトの HTTP に設定されています。{3}
- LTPA トークン認証情報を検証するように JAX-RS 2.0 クライアントを構成します。
- SSL を使用して JAX-RS シン・クライアントを保護します。
- com.ibm.ws.jaxrs.client.disableCNCheck シン・クライアント・プロパティーを使用して、共通名のチェックを無効にします。
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.disableCNCheck", true);