管理対象外の 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 サービスを呼び出すことができます。

始める前に

サポートされる構成 サポートされる構成: Thin Client for JAX-RS with WebSphere Application Server は、スタンドアロン・クライアント・ランタイムとして、純粋な Java SE 環境内で使用できます。WebSphere Application Server 環境内または WebSphere Application Client 環境内での Thin Client for JAX-RS の実行はサポートされていません。このバージョンのアプリケーション・サーバーでは、アプリケーション・サーバーと共に提供される他の Thin Client ランタイムも CLASSPATH に存在でき、Thin Client for JAX-RS と共存できます。sptcfg

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 以外でもサポートされます。

このタスクについて

次のステップを実行して、Thin Client for JAX-RS 環境をセットアップします。

手順

  1. パスを構成します。 以下のコマンドを入力して、 Java bin ディレクトリーをパスに追加します。
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. クラス・パスを構成します。 Thin Client for JAX-RS JAR ファイルをクラスパス定義に追加します。以下に例を示します。
    [Windows][z/OS]
    set CLASSPATH=.;<your_jax-rs_thin_client_install_directory>¥com.ibm.jaxrs2.0.thinclient_9.0.jar;
    <your_application_jars>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<your_JAX-RS_thin_client_install_directory>/com.ibm.jaxrs2.0.thinclient_9.0.jar:
    <your_application_jars>;$CLASSPATH
  3. 以下のコマンドを入力して、クライアント・アプリケーションを実行します。
    [Windows][z/OS]
    %JAVA_HOME%/bin/java <your_client_application>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java <your_client_application>

次のタスク

  • com.ibm.ws.jaxrs.client.connection.timeoutcom.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}
  • シン・クライアント・プロキシー・サポートに関する次のシン・クライアント・プロパティーを使用します。
    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);

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs2
ファイル名:twbs_jaxrs2.0_imp_thinclient_runningthinc.html