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