Ant ビルド・ツールを使用した JAX-RPC の Web サービス・サンプルのビルド


J2EE ポータビリティー
このギャラリーで出荷されているサンプルの再ビルド
始めに
サンプル・ビルドのディレクトリー構造の識別
WebServicesSamples.ear ファイルの再ビルドおよび再インストール

J2EE ポータビリティー

J2EE プラットフォームでのアプリケーション開発の最も大きな利点の 1 つは ポータビリティーです。 サンプル・ギャラリー内のすべてのサンプル・プログラムは ワークステーションで開発され、Java コードを 1 行も変更することなく z/OS システムで実行されます 。 J2EE アプリケーションを Intel または UNIX システムで ビルドすることにより、開発者は EBCDIC から ASCII、または ASCII から EBCDIC ファイル への変換の必要性を除去することができます。 ツールの可用性により、 開発者は開発ワークステーション上で容易に作成とテストを行い、 enterprise archive (EAR) ファイルを z/OS システムにインストールすることができます。

このギャラリーで出荷されているサンプルの再ビルド

すべての WebSphere Application Server (Application Server) for z/OS カスタマーはマルチプラットフォームにアプリケーション・サーバー・メディアを 使用することができます。WebSphere Application Server の基本製品と サンプルをこのパッケージでサポートされているプラットフォームの 1 つにインストールすると、 同じギャラリーが表示されます。1 つの例外は、 sample_name >「Ant を使用したビルド」> プラットフォーム >「sample.ear ファイルの再ビルドとインストール」 をクリックしたときに、そのプラットフォームで EAR ファイルを再ビルドするための説明が表示される点です。  EAR ファイル (XML、xmi、JavaServer Pages (JSP) ファイルなど) 内の テキスト・ファイルは ASCII 形式でなければならないため、これらのファイルは ASCII マシン上で 編集した方が簡単です。ASCII マシンで変更を行った場合は、その後 EBCDIC から ASCII への変換を行わずに、 結果の EAR ファイルを z/OS プラットフォームに再インストールすることができます。 

始めに

WebSphere Application Server を、自分の選択した分散プラットフォームに インストールして、Application Server サンプルもインストールするように指示します。

サンプルを変更または再ビルドする前に、<profile_root>/samples/src/WebServicesSamples ディレクトリーのバックアップ・コピーを行います。

サンプル・ビルドのディレクトリー構造の識別

サンプルは、以下のディレクトリーにインストールされています。

<profile_root>/samples/src/WebServicesSamples AddressBook および株価サンプルのサンプル・ソース・コードが含まれています。
<profile_root>/samples/lib/WebServicesSamples サンプル用の Web アーカイブ (WAR) ファイル、Java アーカイブ (JAR) ファイル、および最終 WebServicesSamples.ear ファイルが入っています。 このディレクトリーは、サンプルの再ビルド後に作成されます。
<profile_root>/samples/javadoc/WebServicesSamples サンプル Javadoc ドキュメンテーションが入っています。 このディレクトリーは、サンプルの再ビルド後に作成されます。
<profile_root>/samples/bld/WebServicesSamples 生成されたクラス・ファイルが含まれています。これらのクラス・ファイルは、最終 WebServicesSamples.ear ファイルを生成するために使用されます。 このディレクトリーは、このサンプルの再ビルド後に作成されます。

WebServicesSamples.ear ファイルの再ビルドおよび再インストール

JAX-RPC Web サービス・サンプルのエンタープライズ・アーカイブ (EAR) ファイルは、 WebSphere アプリケーション・サーバーのインストール時に提供されます。 使用前にサンプルをビルドする必要はありません。以下の指示では、サンプルを再ビルドするためのステップを、変更するための追加情報とともに説明します。

サンプル・ビルド・スクリプトの実行

再ビルドされた WebServicesSamples.ear ファイルの転送
WebServicesSamples.ear ファイルの除去および再インストール

サンプル・ビルド・スクリプトの実行

このサンプルを再ビルドするには、<profile_root>/bin が PATH 環境変数に指定されていることを確認します。以下のステップに従って、サンプルを再ビルドするサンプル・ビルド・スクリプトを実行します。

  1. コマンド・プロンプトを開く。
  2. コマンド行で、<profile_root>/samples/src/WebServicesSamples ディレクトリーに変更する。
  3. サンプル・ビルド・スクリプトを実行する。
  4. コマンド行に buildWebServiceSamples と入力します。
    • Windows 開発プラットフォームでは、 コマンド行に buildWebServiceSamples と入力します。
    • UNIX および Linux 開発プラットフォームでは、コマンド行に buildWebServiceSamples.sh と入力します。

これで、サンプルがビルドされました。

<profile_root>/samples/bin/WebServicesSamples ディレクトリーにある buildWebServicesSamples.bat および buildWebServicesSamples.sh スクリプトにより、適切なクラス・パス情報が設定され、Ant ビルド・ユーティリティーが実行されます。 Ant は、サンプルのビルド方法が記述されている build.xml ファイルを読み取ります。Ant の追加ドキュメンテーションについては、Jakarta Web サイトを 参照してください。

重要情報 ビルド処理中、変更があるクラス・ファイルだけが再ビルドされます。 残りのクラス・ファイルは、新しい EAR ファイルに再パッケージされます。

再ビルドされた WebServicesSamples.ear ファイルの転送

以下の手順で File Transfer Protocol (FTP) を使用して バイナリー EAR ファイルを z/OS サーバーに転送します。

  1. <profile_root>/samples/lib/WebServicesSamples ディレクトリーに ある再ビルド EAR ファイルを確認します。
  2. 開発プラットフォームから WebSphere Application Server for z/OS に対する FTP セッションをオープンします。
  3. ディレクトリーを <profile_root>/samples/lib/WebServicesSamples に変更します。
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

WebServicesSamples.ear ファイルの除去および再インストール

JAX-RPC Web サービス・サンプルは、デフォルトでは、<profile_root>/installedApps/<cell name> ディレクトリーにインストールされます。<cell name> は、アプリケーションがインストールされているセル名です。 次の手順で、サンプルを再インストールします。

  1. アプリケーション・サーバーを停止する。
  2. JAX-RPC Web サービス・サンプル EAR ファイルを除去する。
    1. 以下のコマンドを入力する。

      cd <profile_root>¥bin
      setupCmdLine

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine

      ここで <profile_root> はプロファイルのインストール・ディレクトリーです。
    2. 以下のコマンドを入力して、アプリケーションをアンインストールする (<profile_root>/bin が PATH になければなりません)。

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')" 

  3. サンプルを再インストールする。
    • <profile_root>/samples/lib/WebServicesSamples ディレクトリーに変更する。
    • WebServicesSamples.ear ファイルを見つける。
    • 以下のように入力する。

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>', '-deployejb' ] )"
                
      ここで、<node> はノード名、<server> はサンプルをインストールするサーバーの名前です。

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>', '-deployejb' ] )"
                
      ここで、<node> はノード名、<server> はサンプルをインストールするサーバーの名前です。

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>', '-deployejb' ] )"
                
      ここで、<node> はノード名、<server> はサンプルをインストールするサーバーの名前です。
      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>', '-deployejb' ] )"
                
      ここで、<node> はノード名、<server> はサンプルをインストールするサーバーの名前です。
  4. アプリケーション・サーバーを始動する。

これで、JAX-RPC の Web サービス・サンプル・アプリケーションが再ビルドされ、再インストールされました。 Address Book および Stock Quote サンプル・クライアントを構成および実行できます。