J2EE アプリケーションを開発する際、J2EE プロジェクトのサーバー・ランタイム環境を指定できます。 ターゲット・サーバーは、プロジェクトの作成およびインポート時に指定しますが、プロジェクト・プロパティーにおいて変更できます。 ターゲット・サーバー設定は、J2EE プロジェクトのクラスパスを設定するためにデフォルト・メカニズムです。
Java™ ランタイム 環境 (JRE) について、それぞれが異なる JDK レベルを使用する 複数のアプリケーション・サーバーをサポートするためには、 ワークベンチでは各 J2EE プロジェクトのための ターゲット・サーバー設定が求められます。例えば、JDK 1.4.2 の機能を利用する場合、ご使用のアプリケーションで、ワークベンチの以前の バージョンで使用したものとは異なるクラスパス・エントリーが必要です。ワークベンチでは、 ユーザーにターゲット・サーバーの指定を求めることで、 選択したサーバーで稼働するために必要なエントリーが追加されるようになっています。
ご使用の プロジェクトに、複数のターゲット・サーバーを追加することもできます。この場合、 すべてのターゲット・サーバーにサポートされないファセットは、 ワークベンチによって追加できないようになっています。複数のターゲット・サーバーを追加する場合、 その中の 1 つはプライマリー・サーバーである必要があります。 プライマリー・サーバーは、プロジェクトのクラスパスを提供します。
プロジェクトが作成されると、プロジェクトのクラスパスが 2 つのクラスパス・コンテナーで更新されます。コンテナーの 1 つは JDK コンテナーで、もう 1 つはサーバー・コンテナーです。JDK コンテナーは、JDK バージョンをサポートするのに必要な JAR ファイルを含むディレクトリーをポイントします。 サーバー・コンテナーは、選択したサーバーで使用できる複数のパブリック JAR ファイルを含むディレクトリーをポイントします。プロジェクトはその後、これらのフォルダーに存在する必要な JAR ファイルに基づいてコンパイルされます。開発中にサーバーからのその他の JAR ファイルを追加することについて気にする必要はありません。プロジェクトがコンパイルされると、JAR ファイルはクラスパスに組み込まれます。クラスパスに独自の JAR ファイルを追加することもできます。
ターゲット ・ランタイム環境は、プロジェクトの .settings フォルダー内に ある org.eclipse.wst.common.project.facet.core.xml ファイルで指定されます。こ のファイルは手動で編集しないでください。 その代わり、このトピックで説明しているように「プロパティー」ウィンドウを使用します。
す べての J2EE プロジェクトの作成およびインポートのウィザードでは、 結果プロジェクトのターゲット・サーバーを指定するように求められます。 選択できるターゲット・サーバーのリストは、インストール済みランタイム、アプリケーションの J2EE レベル、および J2EE モジュール・タイプを基にフィルター操作できます。例えば、EJB プロジェクトの場合は、Enterprise JavaBeans™ をサポートするアプリケーション・サーバーのみが表示されます。単一 EAR ファイル内のすべてのプロジェクトは、同じサーバーをターゲットとしていなくてはなりません。 新規プロジェクトを作成して、その際にそのプロジェクトを既存の EAR プロジェクトに追加した場合、そのプロジェクトは EAR プロジェクトのターゲット・サーバー設定を継承します。
既存プロジェクトのターゲット・ランタイムおよびデフォルト・サーバーを変更する方法は、次のとおりです。