NetBeans IDE 4.0: 既存のアプリケーションのインポート (詳細)

プロジェクトの種類の比較

ソースフォルダ

ソースコードを含むフォルダの追加では、パッケージツリーの最上位のフォルダを含むフォルダを追加する必要があります。たとえば com.jcardshark.blackjack.ui パッケージの場合は、com フォルダを含むフォルダを追加します。

標準。1 つのプロジェクトにソースフォルダ 1 つと JUnit テストフォルダ 1 つを含めることができます。複数のソースフォルダを扱うには、ソースフォルダごとにプロジェクトを作成し、必要に応じて他のプロジェクトのクラスパスにプロジェクトを追加します。

自由形式。複数のソースフォルダを作成して、フォルダ間の複雑なクラスパス関係を定義できます。ソースフォルダはディスク上に任意の場所に存在することができ、プロジェクトの作成後に追加あるいは削除できます。

プロジェクトフォルダ

プロジェクトフォルダには、プロジェクトの構築および実行方法を制御する Ant スクリプトとプロパティファイルが含まれます。

標準。プロジェクトフォルダには、次の 2 つの Ant スクリプトが含まれます。

• nbproject/build-impl.xml。プロジェクトの処理に関する命令が含まれます。IDE によって生成されるファイルで、編集しないでください。
• build.xml:build-impl.xml からターゲットがインポートされます。このファイルを編集して、既存のターゲットを無効にしたり、新しいターゲットを作成したりできます。

プロジェクトフォルダには、コンパイル済みクラスと JAR ファイル (J2SE プロジェクトの場合) か WAR ファイル (Web プロジェクトの場合)、Javadoc 用の出力フォルダも含まれます。

自由形式。自由形式のプロジェクトで「場所」を指定する場合、その場所は必ずしも Ant スクリプトを含むフォルダでなくてもかまいません。たとえばソースパッケージフォルダのすべてを 1 つのフォルダにまとめている場合は、Ant 構築スクリプトが含まれていなくても、そのフォルダをプロジェクトの場所として設定することができます。出力フォルダの場所は、Ant スクリプトの設定によって異なります。

Web モジュールのルート

Web モジュールのルートとは、Web アプリケーションの最上位のフォルダのことです。このフォルダには、JSP ページやクライアント側クラスとアーカイブ、画像などの静的 Web リソースが格納されます。下図は、一般的な Web アプリケーションのソース構造を示しています。

主プロジェクト

1 つのアプリケーションを複数のプロジェクトに分けている場合は、主プロジェクトがアプリケーションへの入り口の働きをします。通常、主プロジェクトには、そのアプリケーションを起動する主クラスが含まれます。「実行」、「構築」などのメニューコマンドの多くには、主プロジェクトに対するキーボードショートカットが用意されています。「プロパティ」ウィンドウで個別プロジェクトのプロジェクトノードを右クリックすることによって、そのプロジェクトのすべてのコマンドにアクセスすることができます。

プロジェクトを主プロジェクトにするには、「プロジェクト」ウィンドウでプロジェクトのノードを右クリックして、「主プロジェクトとして設定」を選択します。

Ant ターゲットへのコマンドの関連付け

自由形式のプロジェクトでは、Ant スクリプトを使用して、次のようなすべての IDE アクションに対するターゲットを提供します。

• 構築
• 生成物の削除
• プロジェクトのコンパイル
• 個別ファイルのコンパイル
• JavaServer Pages ファイルのコンパイル
• プロジェクトの実行
• 個別ファイルの実行
• Javadoc の生成
• JUnit テストの実行
• デバッガでのプロジェクトの実行
• デバッガでの個別ファイルの実行
• 修正継続
• Web プロジェクトの再配備

これらのアクション用のターゲットが Ant スクリプトに含まれていない場合は、IDE でそのアクションコマンドを使用することはできません。これらのコマンド用のターゲットは、簡単に作成し、プロジェクトの「プロジェクトプロパティ」ダイアログでコマンドに関連付けることができます。

Ant スクリプトに新しいターゲットを追加できない場合は、2 つ目の Ant スクリプトを作成して、そこにターゲットを含めることができます。詳細は、 高度な自由形式プロジェクトの構成を参照してください。

「プロジェクト」ウィンドウと「ファイル」ウィンドウ

「プロジェクト」ウィンドウは、プロジェクトのパッケージに基づくビューです。プロジェクトのノードを右クリックして、そのプロジェクトにコマンドを実行することができます。プロジェクトのノードを右クリックし、「プロパティ」を選択すると、そのプロジェクトのオプションを設定できます。

「ファイル」ウィンドウは、ディスク上でのプロジェクトファイルの物理的な配置を示します。プロジェクトごとにプロジェクトフォルダ 1 つとすべてのソースフォルダが表示されます。nbproject フォルダには、プロジェクトのプロジェクトメタデータが含まれます。

クラスパスの設定

標準。プロジェクトのクラスパスにクラスを追加すると、IDE のコード補完およびリファクタリングでそれらのクラスが利用できるようになります。プロジェクトには、次の種類のクラスパス要素を追加することができます。

• JAR ファイル。J2SE プロジェクト専用のコンパイル済み Java クラスをパッケージ化したライブラリ。
• WAR ファイル。Web プロジェクト専用のコンパイル済み Web クラスをパッケージ化したライブラリ。
• ライブラリ。コンパイル済みクラス (JAR/WAR ファイル) とデバッグ用のソースコード、Javadoc を 1 つにまとめたもの。メインウィンドウで「ツール」>「ライブラリマネージャ」を選択することによって、ライブラリを作成することができます。
• プロジェクト。別の NetBeans IDE プロジェクトから得られた構築出力 (JAR/WAR ファイル)、デバッグ用のソースコード、Javadoc。プロジェクトに必須プロジェクトを追加して、主プロジェクトを構築すると、両方のプロジェクト用 JAR/WAR ファイルすべてが作成されます。(J2SE のサンプルで BlackJackUI を構築すると、必須プロジェクトの BlackJackLib が作成されます。)

自由形式。Ant スクリプトで、コンパイル時および実行時のクラスパス要素を明示的に処理する必要があります。プロジェクトを作成するときに入力されたクラスパスの設定値を使用して、プロジェクトのコード補完やエラーの強調表示、リファクタリングが使用できるようになります。これらのクラスパス設定は、Ant スクリプト内のクラスパスの定義に一致している必要があります。プロジェクト全体にクラスパスを 1 つ設定することも、プロジェクト内のソースフォルダごとにクラスパスを設定することもできます。既存の自由形式のプロジェクトに対してクラスパスを宣言するには、「プロジェクト」ウィンドウでそのプロジェクトのノードを右クリックして、「プロパティ」を選択します。次に、「クラスパス」をクリックして、ソースのルートごとにクラスパスを設定します。

コンテキストパスの設定

コンテキストは、同じサーバーインスタンス上に配備されている Web アプリケーションの間でリソースを識別するための手段です。

Web アプリケーションのコンテンツの URL 名前空間は、そのアプリケーションのコンテキストによって決まります。Web アプリケーションのコンテキストプロパティ値を設定すると、http://hostname:port/context/servlet_or_jsp でその Web アプリケーションにアクセスできます。たとえば、プロパティ値を /HelloWeb に設定した場合は、http://hostname:port/HelloWeb/index.jsp で Web アプリケーションにアクセスできます。