J2EE Deployment API Specification (JSR-88) を使用して
、Java 2 Platform, Enterprise Edition (J2EE) モジュールを
、WebSphere Application Server 製品によって提供されたアプリケーション・サーバー上にインストールできます。
このタスクについて
JSR-88 は、ツール・プロバイダーとプラットフォームの間の規約を定義します。
JSR-88 により、複数のベンダーのツールを使用して、任意の J2EE 製品プラットフォーム上で
アプリケーションを構成、デプロイ、および管理できるようにします。ツール・プロバイダーは通常
、J2EE アプリケーション・モジュールの開発およびアセンブリー用に
ソフトウェア・ツールおよび統合開発環境 (IDE) を提供します。J2EE プラットフォームは、J2EE アプリケーションをデプロイ、アンデプロイ、開始、停止、または管理するためのアプリケーション管理機能を提供します。
WebSphere Application Server は、JSR-88 API をインプリメントする J2EE 1.4 仕様に準拠するプラットフォームです。
以下のステップを実行して、WebSphere Application Server プラットフォームによって
提供されるアプリケーション・サーバー上に J2EE モジュールをデプロイ (インストール) します。
プロシージャー
- 本製品の JSR-88 DeploymentManager
クラスにアクセス可能な Java プログラムをコーディングします。
- JAR マニフェスト・ファイル・キー J2EE-DeploymentFactory-Implementation-Class を検索するコードを記述します。
JSR-88 下で、コードは JAR マニフェスト・ファイル・キー J2EE-DeploymentFactory-Implementation-Class を使用して DeploymentFactory を検索します。
このキーを含み、
サポートを提供するアプリケーション管理 JAR ファイルは、app_server_root/lib/wjmxapp.jar です。
コードが DeploymentFactory を検索した後、
デプロイメント・ツールは WebSphere DeploymentFactory のインスタンスを作成し
、DeploymentFactoryManager を使用してそのインスタンスを登録できます。
コード例は後に続きます。コード例では、
本製品に添付された開発キットを使用するか、スタンドアロン・モジュールのデプロイメント用プラグ可能クライアントを使用する必要があります。
サポートされた開発キットについて詳しくは、
WebSphere Application Server detailed system requirements (アクセス先: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921)
を参照してください。
import javax.enterprise.deploy.shared.factories.DeploymentFactoryManager;
import javax.enterprise.deploy.spi.DeploymentManager;
import javax.enterprise.deploy.spi.factories.DeploymentFactory;
import java.util.jar.JarFile;
// Get the DeploymentFactory implementation class from the MANIFEST.MF file.
JarFile wjmxappJar = new JarFile(new File(wasHome + "/lib/wjmxapp.jar"));
java.util.jar.Manifest manifestFile = wjmxappJar.getManifest();
Attributes attributes = manifestFile.getMainAttributes();
String key = "J2EE-DeploymentFactory-Implementation-Class";
String className = attributes.getValue(key);
// Get an instance of the DeploymentFactoryManager
DeploymentFactoryManager dfm = DeploymentFactoryManager.getInstance();
// Create an instance of the WebSphere Application Server DeploymentFactory.
Class deploymentFactory = Class.forName(className);
DeploymentFactory deploymentFactoryInstance =
(DeploymentFactory) deploymentFactory.newInstance();
// Register the DeploymentFactory instance with the DeploymentFactoryManager.
dfm.registerDeploymentFactory(deploymentFactoryInstance);
// Provide WebSphere Application Server URL, user ID, and password.
// For more information, see the step that follows.
wsDM = dfm.getDeploymentManager(
"deployer:WebSphere:myserver:8880", null, null);
- 本製品の DeploymentManager インスタンスに
アクセスするコードを作成します。 デプロイメント用の本製品の URL は、以下のフォーマットを使用します。
"deployer:WebSphere:host:port"
前のステップの
例で使用した "deployer:WebSphere:myserver:8880" は、デフォルトの SOAP コネクターを使用して
ポート 8880 でホスト myserver への接続を試行します。
デプロイメント用の URL は、オプショナル・パラメーター connectorType を取ることができます。例えば、RMI コネクターを使用して myserver にアクセスするには、以下のように URL をコード化します。
"deployer:WebSphere:myserver:2809?connectorType=RMI"
- オプション: 本製品によって提供される、
JSR-88 サポートを使用して J2EE アプリケーションまたはモジュールをカスタマイズ、あるいはデプロイすることができる Java プログラムをコーディングします。
- アプリケーションまたはモジュールを開始するのに使用される JSR-88 API を用いて、
デプロイ済み J2EE アプリケーションまたはスタンドアロン J2EE モジュールを開始します。
次の作業
デプロイ済みアプリケーションまたはモジュールをテストします。例えば、デプロイ済みのアプリケーションの URL を Web ブラウザーで参照し、
アプリケーションのパフォーマンスを調べます。
必要に応じて、アプリケーションを更新してください。