JAX-RPC Web サービス |
|
![]() |
Ant を使用したビルド | JAX-RPC Web サービス・サンプル |
始めに |
サンプル・ビルドのディレクトリー構造の識別 |
WebServicesSamples.ear ファイルの再ビルドおよび再インストール |
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 ファイルを生成するために使用されます。 このディレクトリーは、このサンプルの再ビルド後に作成されます。 |
JAX-RPC Web サービス・サンプルのエンタープライズ・アーカイブ (EAR) ファイルは、
WebSphere アプリケーション・サーバーのインストール時に提供されます。
使用前にサンプルをビルドする必要はありません。以下の指示では、サンプルを再ビルドするためのステップを、変更するための追加情報とともに説明します。
サンプル・ビルド・スクリプトの実行 |
WebServicesSamples.ear ファイルの除去および再インストール |
このサンプルを再ビルドするには、<profile_root>/bin が PATH 環境変数に指定されていることを確認します。以下のステップに従って、サンプルを再ビルドするサンプル・ビルド・スクリプトを実行します。
これで、サンプルがビルドされました。
<profile_root>/samples/bin/WebServicesSamples ディレクトリーにある buildWebServicesSamples.bat および buildWebServicesSamples.sh スクリプトにより、適切なクラス・パス情報が設定され、Ant ビルド・ユーティリティーが実行されます。 Ant は、サンプルのビルド方法が記述されている build.xml ファイルを読み取ります。Ant の追加ドキュメンテーションについては、Jakarta Web サイトを 参照してください。
以下の手順で File Transfer Protocol (FTP) を使用して バイナリー EAR ファイルを z/OS サーバーに転送します。
JAX-RPC Web サービス・サンプルは、デフォルトでは、<profile_root>/installedApps/<cell
name> ディレクトリーにインストールされます。<cell name> は、アプリケーションがインストールされているセル名です。
次の手順で、サンプルを再インストールします。
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')"
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> はサンプルをインストールするサーバーの名前です。
これで、JAX-RPC の Web サービス・サンプル・アプリケーションが再ビルドされ、再インストールされました。 Address Book および Stock Quote サンプル・クライアントを構成および実行できます。