プロジェクト

IDE では、つねにプロジェクトの内部で作業をします。IDE プロジェクトには、ソースファイルのほかに、クラスパスに属するものについてのメタデータや、プロジェクトの構築方法および実行方法などに関するメタデータが含まれています。IDE でプロジェクト情報が格納されるプロジェクトフォルダには、構築や実行の設定を制御する Ant 構築スクリプトとプロパティーファイル、および Ant ターゲットを IDE コマンドにマップする project.xml ファイルが含まれています。

注: デフォルトで、ソースディレクトリはプロジェクトフォルダ内に置かれますが、ソースディレクトリをプロジェクトフォルダ内に置くことは必須ではありません。

Ant

Apache Ant は Java 用構築ツールで、アプリケーション開発の構築および実行環境を標準化および自動化するために使用します。IDE のプロジェクトシステムは、直接 Ant に基づいています。「プロジェクトの生成物を削除して構築」や「デバッグ」などのプロジェクトコマンドはすべて、プロジェクトの Ant スクリプト内のターゲットを呼び出します。このため、IDE とまったく同様に IDE の外部でプロジェクトを構築、実行できます。

IDE で作業するために Ant について理解する必要はありません。基本的なコンパイルオプションと実行時オプションはすべて「プロジェクトプロパティー」ダイアログに設定可能で、IDE が、その設定に基づいてプロジェクトの Ant スクリプトを自動的に更新します。Ant に精通している場合は、標準プロジェクトの Ant スクリプトをカスタマイズしたり、プロジェクト用に独自の Ant スクリプトを記述したりできます。

Eclipse 作業スペースのインポート

Eclipse プロジェクトの場合は、「Eclipse プロジェクトのインポート」ウィザードを使用して、Eclipse 作業スペース内のプロジェクトから NetBeans プロジェクトを作成し、プロジェクトのクラスパスやその他の設定をインポートできます。「Eclipse プロジェクトのインポート」ウィザードを使用すると、NetBeans プロジェクトを手動で作成および構成する必要がありません。「ファイル」>「プロジェクトをインポート」>「Eclipse プロジェクト」を選択して、ウィザードを開きます。ウィザードの動作や、Eclipse プロジェクトと NetBeans プロジェクトで同時に作業する方法については、「Eclipse プロジェクトの NetBeans IDE へのインポート」を参照してください。

既存のソースに基づいた Java プロジェクトの設定

NetBeans 以外で開発されたその他の Java プロジェクトについては、「新規プロジェクト」ウィザードで「既存のソース」テンプレートを使用して、NetBeans プロジェクトを作成します。ウィザードで、ソースの場所を識別し、NetBeans プロジェクトメタデータの場所を指定します。そのあと、「プロジェクトプロパティー」ダイアログを使用してプロジェクトを構成します。

既存の Java アプリケーション用に NetBeans プロジェクトを設定するには、次の手順に従います。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。
2. 「Java」>「既存のソースを使用する Java プロジェクト」を選択します。「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、次の手順を実行します。
   • プロジェクト名を入力します。
   • (任意) プロジェクトフォルダの場所を変更します。
   • (任意) IDE で使用される構築スクリプトの名前を変更します。ソースの構築に使用される build.xml という名前の構築スクリプトがすでに存在する場合は、これを行うことが望ましいです。
   • (任意) 「ライブラリの格納用に専用フォルダを使用」チェックボックスを選択し、ライブラリフォルダの場所を指定します。このオプションの詳細は、「プロジェクトライブラリの共有」を参照してください。
   • (任意)「主プロジェクトとして設定」チェックボックスを選択します。このオプションを選択すると、「主プロジェクトを削除して構築」(Shift-F11) などのコマンドのキーボードショートカットが、このプロジェクトに適用されます。
4. 「次へ」をクリックして、ウィザードの「既存のソース」ページに進みます。
5. 「ソースパッケージフォルダ」区画で「フォルダを追加」をクリックします。次に、ソースに移動し、ソースルートを選択します。

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

6. (任意)「テストパッケージフォルダ」区画で「フォルダを追加」をクリックして、JUnit パッケージフォルダを含むフォルダを選択します。
7. (任意) ウィザードの「含める/除外する」ページで、プロジェクトに含めるファイル、またはプロジェクトから除外するファイルの、ファイル名パターンを入力します。デフォルトでは、ソースルートのすべてのファイルが含まれます。
8. 「完了」をクリックします。

   「プロジェクト」ウィンドウと「ファイル」ウィンドウの両方に、プロジェクトが表示されます。

既存のソースに基づいた JavaFX プロジェクトの設定

JavaFX プロジェクトは、NetBeans IDE 以外で開発された既存の JavaFX アプリケーションに基づいて作成できます。JavaFX プラグインをインストールしている場合や、IDE の JavaFX ダウンロードオプションを使用している場合は、このオプションが有効です。

既存の JavaFX アプリケーション用に NetBeans プロジェクトを設定するには、次の手順に従います。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。
2. 「JavaFX」>「JavaFX Script アプリケーション」を選択し、「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、次の手順を実行します。
   • プロジェクト名を入力します。
   • (任意) プロジェクトフォルダの場所を指定します。
   • 「ソースから」オプションボタンを選択します。
   • 「フォルダを追加」をクリックし、既存の JavaFX アプリケーションソースファイルを含むフォルダを指定します。
   • (任意)「主プロジェクトとして設定」チェックボックスを選択します。このオプションを選択すると、「主プロジェクトを削除して構築」(Shift-F11) などのコマンドのキーボードショートカットが、このプロジェクトに適用されます。
4. 「完了」をクリックします。

   「プロジェクト」ウィンドウと「ファイル」ウィンドウの両方に、JavaFX プロジェクトが表示されます。

既存のソースに基づいた Web プロジェクトの設定

NetBeans 以外で開発された Web プロジェクトについては、「新規プロジェクト」ウィザードで「既存のソース」テンプレートを使用して、NetBeans プロジェクトを作成します。ウィザードで、ソースの場所を識別し、NetBeans プロジェクトメタデータの場所を指定します。そのあと、「プロジェクトプロパティー」ダイアログを使用してプロジェクトを構成します。

注: プロジェクトが最初に Eclipse で開発された場合は、「新規プロジェクト」ウィザードの代わりに「Eclipse プロジェクトのインポート」ウィザードを使用することで時間を節約できる可能性があります。「Eclipse プロジェクトのインポート」ウィザードでは、複数のプロジェクトをそれらの構成も含めて同時にインポートできます。「Eclipse プロジェクトの NetBeans IDE へのインポート」を参照してください。

既存の Web アプリケーション用に NetBeans プロジェクトを設定するには、次の手順に従います。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。
2. 「Java Web」>「既存のソースを使用する Web アプリケーション」を選択します。「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、次の手順を実行します。
   • 「場所」フィールドに、Web アプリケーションのソースルートフォルダおよび Web ページフォルダを含むフォルダを入力します。
   • プロジェクト名を入力します。
   • (任意) プロジェクトフォルダの場所を変更します。
4. (任意) 「ライブラリの格納用に専用フォルダを使用」チェックボックスを選択し、ライブラリフォルダの場所を指定します。このオプションの詳細は、「NetBeans IDE でのプロジェクトライブラリの共有」を参照してください。
5. (任意)「主プロジェクトとして設定」チェックボックスを選択します。このオプションを選択すると、「主プロジェクトを削除して構築」(Shift-F11) などのコマンドのキーボードショートカットが、このプロジェクトに適用されます。
6. 「次へ」をクリックして、ウィザードの「サーバーと設定」ページに進みます。
7. (任意) プロジェクトを既存のエンタープライズアプリケーションに追加します。
8. 配備先のサーバーを選択します。目的のサーバーが表示されない場合は、「追加」をクリックしてそのサーバーを IDE に登録します。
9. (任意)「サーバー JAR ファイルの専用ライブラリフォルダを使用」チェックボックスを選択します。このオプションを使用できるのは、ウィザードの前のページで、専用ライブラリフォルダを指定した場合のみです。
10. ソースレベルを、アプリケーションを実行する Java のバージョンに設定します。
11. (任意) コンテキストパスを調整します。デフォルトでは、コンテキストパスはプロジェクト名に基づいています。
12. 「次へ」をクリックして、ウィザードの「既存のソースとライブラリ」ページに進みます。
13. 「Web ページフォルダ」や「ソースパッケージフォルダ」の値など、ページ上のすべてのフィールドを確認します。
14. 「完了」をクリックします。

    「プロジェクト」ウィンドウと「ファイル」ウィンドウの両方に、プロジェクトが表示されます。

自由形式プロジェクト

自由形式プロジェクト用のプロジェクトテンプレートもあります。自由形式プロジェクトの場合、IDE は既存の Ant スクリプト内のターゲットを使用して、アプリケーションの構築、実行、生成物削除、テスト、およびデバッグを行います。いずれかの機能に対応するターゲットが Ant スクリプトに含まれていない場合、それらの機能をプロジェクトで使用することはできません。それらの機能を実装するには、Ant スクリプトまたは二次 Ant スクリプト内にターゲットを記述します。

一般に、プロジェクトのインポートには標準の「既存のソースを使用する」プロジェクトテンプレートを使用することをお勧めします。Eclipse プロジェクトの場合は、標準のプロジェクトを作成および構成する、「プロジェクトをインポート」機能を使用するのが最適です。標準のプロジェクトのほうが、長期的に見れば管理が容易です。ただし、標準のプロジェクト内では複製できない、複雑または特有な構成を持つ Ant ベースの既存のプロジェクトがある場合は、自由形式プロジェクトのテンプレートが便利です。たとえば、クラスパスがそれぞれ異なる複数のソースルートを持つプロジェクトをインポートしており、それらのソースルートを別のプロジェクトに分割できないときには、自由形式プロジェクトのテンプレートを使用することが必要な場合があります。

このガイドでは、標準のプロジェクトに重点を置いています。自由形式プロジェクトの設定についての詳細は、「自由形式プロジェクトの詳細構成」を参照してください。

主プロジェクトの設定

多数のソースフォルダで構成される大規模なアプリケーションを開発する際には、コードを分割して独立した複数のプロジェクトにまとめることがあります。通常、これらのプロジェクトの 1 つは、アプリケーションのエントリポイントとして機能します。アプリケーションへの主なエントリポイントとなるプロジェクトを IDE に対して指定するには、そのプロジェクトを主プロジェクトとして設定します。主プロジェクトに関するコマンドは IDE で提供されています。たとえば、「主プロジェクトを削除して構築」コマンドを実行すると、主プロジェクトと、その必須プロジェクトのすべてが構築されます。

プロジェクトを主プロジェクトに設定するには、次の手順に従います。

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

主プロジェクトに指定できるプロジェクトは、一度に 1 つだけです。

プロジェクトにおけるターゲット JDK の設定

IDE では、複数の Java プラットフォームを登録できるほか、各プラットフォームに対し Javadoc やソースコードを添付できます。標準プロジェクト用のターゲット JDK を切り換えると、処理は次のように変更されます。

• コード補完の実行時には、新規 JDK のクラスが優先して使用されます。
• ターゲットの JDK のソースコードと Javadoc ドキュメントがある場合は、それらが表示されます。
• アプリケーションのコンパイルおよび実行に、ターゲット JDK の実行可能ファイル (javac および java) が使用されます。
• ターゲット JDK のライブラリを使用してソースコードをコンパイルします。

デフォルトでは、IDE は、IDE プロジェクト用のデフォルトの Java プラットフォームとして IDE そのものの実行に使用されている Java SE プラットフォーム (JDK) のバージョンを使用します。現在使用している JDK のバージョンを確認するには、「ヘルプ」>「製品について」を選択し、「詳細」タブをクリックします。「Java」フィールドに JDK のバージョンが表示されます。

別のバージョンの JDK で IDE を実行するには、次の手順に従います。

• 次のスイッチを使用して、コマンド行から IDE を起動します。

  --jdkhome jdk-home-dir

  または、IDE のインストールフォルダ内にある /etc/netbeans.conf ファイルで JDK を設定します。

新規 Java プラットフォームを登録するには、次の手順に従います。

1. メインメニューから「ツール」>「Java プラットフォームマネージャー」を選択します。
2. Java プラットフォームが含まれているフォルダと、デバッグに必要なソースおよび Javadoc を指定します。

標準プロジェクトのターゲット JDK を切り替えるには、次の手順に従います。

1. プロジェクトノードを右クリックし、「プロパティー」を選択します。
2. 「ライブラリ」パネルを選択します。
3. Java プラットフォームプロパティーを変更します。

プロジェクトのクラスパスの管理

プロジェクトのクラスパスに一群のクラスファイルを追加するということは、コンパイルおよび実行中にプロジェクトがアクセスすべきクラスを IDE に知らせることです。IDE はまた、クラスパスの設定を使用して、コード補完やコンパイルエラーの自動強調表示、リファクタリングを行えるようにします。既存のプロジェクトのクラスパス宣言は、「プロジェクトプロパティー」ダイアログで編集できます。

標準の Java プロジェクトでは、IDE が、プロジェクトのコンパイルと実行用のクラスパスと、Java SE アプリケーションの場合の JUnit テストのコンパイルと実行用のクラスパスを、個別に維持します。プロジェクトのコンパイル時に、クラスパスのすべてがプロジェクトの実行時クラスパスに自動的に追加されます。

プロジェクトのクラスパスは、次のいずれかの方法で変更できます。

• プロジェクトのノードを右クリックして「プロパティー」を選択し、「ライブラリ」カテゴリを選択して、表示されているクラスパスエントリを変更します。
• 「プロジェクト」ウィンドウで「ライブラリ」ノードを右クリックし、「プロジェクトを追加」、「ライブラリを追加」または「JAR/フォルダを追加」を選択します。

ライブラリマネージャー内の JAR ファイルに添付されている Javadoc およびソースファイルがある場合は、プロジェクトのクラスパスに JAR ファイルを登録することで自動的に Javadoc とソースファイルがプロジェクトに追加されます。これだけの設定で、クラスを表示してそのクラスの Javadoc ページを参照することもできます。

プロジェクト間の依存関係の管理

アプリケーションが複数のプロジェクトで構成されている場合は、プロジェクト間のクラスパス依存関係を設定する必要があります。通常は、プロジェクトの主クラスを含む 1 つの主プロジェクトを Java SE プロジェクトに作成し、さらにいくつかの必須プロジェクトを設定します。必須プロジェクトとは、別のプロジェクトのクラスパスに追加されているプロジェクトです。プロジェクトの生成物を削除して構築すると、その必須プロジェクトの生成物も削除され、構成されます。必須プロジェクトの Javadoc とソースは、受け側のプロジェクトからも利用できるようになります。

必須プロジェクトは、「プロジェクト」ウィンドウで「ライブラリ」ノードを右クリックするか、「プロジェクトプロパティー」ダイアログの「ライブラリ」タブで指定することによって、プロジェクトに追加できます。必須プロジェクトを追加するときは、クラスパスに追加する JAR ファイルを含むプロジェクトフォルダを選択します。ファイル選択用ダイアログには、IDE プロジェクトフォルダのアイコン () が表示されます。「プロジェクトプロパティー」ダイアログでプロジェクトを追加するときは、「クラスパス上のプロジェクトを構築」チェックボックスが選択されていることを確認します。

自由形式プロジェクトを標準プロジェクトのクラスパスに追加する場合は、自由形式プロジェクトの JAR ファイルを標準プロジェクトのクラスパスに追加する必要があります。これを行うには、まず自由形式プロジェクトのすべての出力ファイルを、自由形式プロジェクトの「プロジェクトプロパティー」ダイアログの「出力」パネルで宣言する必要があります。

プロジェクトライブラリの共有

NetBeans IDE のプロジェクトシステムは Ant ベースのため、NetBeans プロジェクトは IDE を使用しているかどうかに関わらず、異なるユーザー間ですでに一般的に移植できます。ただし、デフォルトでは、プロジェクトの構築スクリプトがライブラリを参照する方法は、特に「ライブラリマネージャー」ダイアログで定義されたライブラリの場合、ユーザーに固有の要素に依存します。

たとえば、通常は、プロジェクトを zip ファイルにして別のユーザーに渡し、そのユーザーがプロジェクトを展開して実行できます。しかし、「ライブラリマネージャー」ダイアログで指定したカスタムライブラリにプロジェクトが依存する場合は、カスタムライブラリへの参照が未解決のため、ほかのユーザーがプロジェクトを構築する際、最初に問題が発生する可能性があります。

そのほかに不都合を引き起こす可能性があるのは、どこが元になっているかによって、そのライブラリがさまざまな場所に保存されていることです。IDE に付属するライブラリは IDE のインストール場所内のさまざまなフォルダに保存されています。これらの例には、Swing レイアウト拡張、Beans Binding、およびデータベースドライバが含まれます。

これらの問題を解決するには、プロジェクトライブラリ用に専用フォルダを指定します。また、これらのライブラリを参照する場合に相対パスを使用するか絶対パスを使用するかを管理できます。

この柔軟性によって、次のような状況を簡単に処理できます。

• 作成したプロジェクトを、ほかのユーザーが使用したり、構築したりできるようにする場合。ほかのユーザーが IDE を使用していない場合もあります。ほかのユーザーは、バージョン管理のチェックアウト、または提供される zip ファイルの展開によって、プロジェクトにアクセスできる必要があります。また、追加の設定を行わずにアプリケーションを構築できる必要があります。
• 既存のプロジェクトで作業を開始し、プロジェクトライブラリの保存場所 (および構築スクリプトがライブラリを相対パスで参照するか、絶対パスで参照するか) について厳しい規則に従う必要がある場合。

標準の Java SE プロジェクト、Web プロジェクト、およびエンタープライズプロジェクト用に、専用のライブラリフォルダを設定できます。「新規プロジェクト」ウィザードでプロジェクトを作成したとき、またはそのあと「プロジェクトプロパティー」ダイアログの「ライブラリ」タブで、ライブラリフォルダを設定できます。

プロジェクトの作成時に一般的な Java プロジェクトのライブラリを共有可能にする

1. 「ファイル」>「新規プロジェクト」を選択します。
2. ウィザードの「Java」カテゴリで、標準テンプレートを 1 つ選択します。「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、「ライブラリの共有用に専用フォルダを使用」チェックボックスを選択します。
4. 「ライブラリ」フィールドで、ライブラリを保存する場所を選択します。

   ライブラリがすでに IDE に含まれる場合、これらのライブラリは指定したフォルダにコピーされます。

プロジェクト作成時に Web プロジェクトまたは Java EE プロジェクトのライブラリを共有可能にする

1. 「ファイル」>「新規プロジェクト」を選択します。
2. ウィザードの「Web」カテゴリで、標準テンプレートを 1 つ選択します。「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、「ライブラリの共有用に専用フォルダを使用」チェックボックスを選択します。
4. 「ライブラリ」フィールドで、ライブラリを保存する場所を選択します。

   ライブラリがすでに IDE に含まれる場合、これらのライブラリは指定したフォルダにコピーされます。

5. (任意)「サーバーと設定」ページで「サーバー JAR ファイルの専用ライブラリフォルダを使用」ラジオボタンを選択します。

既存のプロジェクトのライブラリを共有可能にする

1. プロジェクトノードを右クリックし、「プロパティー」を選択します。
2. 「プロジェクトプロパティー」ダイアログで「ライブラリ」ノードを選択します。
3. 「ライブラリ」パネルで「参照」をクリックして「新規ライブラリフォルダ」ウィザードを開きます。
4. ウィザードの「ライブラリフォルダ」ページでライブラリの場所を入力し、「次へ」をクリックします。

   場所は、相対パスまたは絶対パスとして入力できます。

5. ウィザードの「アクション」パネルで、リストされた各ライブラリに選択されているアクションを確認します。ほとんどの場合、各ライブラリに最適なアクションが IDE によって検出されます。

   次のアクションがあります。

   • ライブラリ JAR ファイルを新規ライブラリフォルダにコピー。このオプションは、選択したフォルダ内にライブラリがなく、ライブラリの JAR ファイルをこのフォルダに配置する場合に使用します。
   • ライブラリ JAR ファイルの相対パスを使用。このオプションは、ライブラリがライブラリフォルダ内になく、相対パスを使用して既存の場所にあるライブラリにアクセスする場合に使用します。ライブラリフォルダの nblibraries.properties ファイルに、相対パスによるライブラリへの参照が追加されます。
   • ライブラリ JAR ファイルの絶対パスを使用。このオプションは、ライブラリがライブラリフォルダ内になく、絶対パスを使用して既存の場所にあるライブラリにアクセスする場合に使用します。ライブラリフォルダの nblibraries.properties ファイルに、絶対パスによるライブラリへの参照が追加されます。
   • ライブラリフォルダ内の既存のライブラリを使用。このオプションは、ライブラリフォルダにライブラリのコピーがすでに存在し、このコピーを使用する場合に使用します。
6. 「完了」をクリックして「プロジェクトを共有可能にする」ウィザードを終了します。
7. 「了解」をクリックして、「プロジェクトプロパティー」ダイアログを終了します。

注: 「プロジェクトプロパティー」ダイアログの「ライブラリ」ノードを使用して、ライブラリフォルダの場所を変更することもできます。ライブラリフォルダをすでに指定してある場合は、「参照」をクリックしたときに「新規ライブラリフォルダ」ウィザードではなくファイル選択用ダイアログが表示されます。

IDE で使用可能な Javadoc の作成

NetBeans IDE で JavaSE API のドキュメントを参照するには、「ソース」>「ドキュメントを表示」コマンドを使用するか、メインメニューから「ウィンドウ」>「その他」>「Javadoc」を選択して、別のウィンドウで API のドキュメントを表示します。

ただし、いくつかの他社製のライブラリには、API ドキュメントを使用できません。その場合、Javadoc リソースを手動で IDE に関連付ける必要があります。

Javadoc を表示コマンドで使用可能な Javadoc API ドキュメントを作成する

1. Javadoc API ドキュメントのソースをダウンロードします。
2. 「ツール」>「ライブラリ」を選択します。
3. ライブラリリストで、プロジェクトが使用しているライブラリを選択します。
4. 「Javadoc」タブをクリックします。
5. 「ZIP/フォルダを追加」ボタンをクリックし、システム上の Javadoc API ドキュメントを含む ZIP ファイルまたはフォルダに移動します。ZIP ファイルまたはフォルダを選択し、「ZIP/フォルダを追加」ボタンをクリックします。
6. 「閉じる」をクリックします。

アプリケーションの Java Web Start の有効化

IDE で Java Web Start をステップ実行するように、アプリケーションを構成できます。これを行うには、「プロジェクトプロパティー」ウィンドウの「Java Web Start」カテゴリを使用します。Java Web Start を有効化する方法に関する詳細は、「NetBeans IDE での Java Web Start の有効化」チュートリアルを参照してください。

アプリケーションの Java Web Start を構成するには、次の手順に従います。

1. プロジェクトノードを右クリックし、「プロパティー」を選択します。
2. 「プロジェクトプロパティー」ダイアログで、「アプリケーション」>「Web Start」ノードを選択します。
3. 「Web Start を有効化」チェックボックスを選択し、「NetBeans IDE での Java Web Start の有効化」の説明に従って Java Web Start 設定を構成します。

 

プロジェクト、パッケージ、およびファイルの構築

IDE でのコンパイルは簡単に実行できます。プロジェクトのコンパイル時クラスパスが正しく設定されていれば、コンパイルするプロジェクト、パッケージ、またはファイルを選択し、「実行」メニューから適切な構築コマンドまたはコンパイルコマンドを選択するだけで済みます。これにより、ファイルがコンパイルされます。

Java プロジェクト用に「保存時にコンパイル」機能が有効化されている場合や、Java Web プロジェクトやエンタープライズプロジェクト用に「保存時に配備」機能が有効化されている場合は、保存時にファイルが自動的にコンパイルされます。詳細は、以降の「保存時にコンパイル」を参照してください。

配備用にアプリケーションを構築するには、次の手順に従います。

• 「実行」>「プロジェクトの生成物を削除して構築」を選択します。

  以前にコンパイルされたファイルや、JAR ファイルなどの配布可能な出力がすべて削除されます。次に、ファイルが再コンパイルされ、新しい出力が生成されます。コンパイルされたクラスを保持するための build フォルダが作成されます。JAR ファイルや Javadoc ドキュメントを格納するための dist が生成されます。「ファイル」ウィンドウを開いて、構築出力を確認できます。

コンパイルコマンドを実行するたびに、以降の「コンパイルエラーの修正」で説明するように、発生したコンパイルエラーを含む出力が「出力」ウィンドウに表示されます。

保存時にコンパイル

IDE の「保存時にコンパイル」機能を使用すると、IDE でプロジェクトを実行およびデバッグする際の時間が短縮されます。プロジェクト用に「保存時にコンパイル」機能が有効化されている場合は、ファイルの保存時にそれらのファイルがコンパイルされます。コンパイルされたファイルは、IDE でプロジェクトを実行、テスト、デバッグ、およびプロファイルするときに使用されるキャッシュに格納されます。このため、アプリケーションのテストおよびデバッグを行うとき、最初にアプリケーションが構築されるまで待つ必要がありません。

「保存時にコンパイル」機能を有効にすると、次のような効果があります。

• 保存時にファイルがコンパイルされるため、プロジェクトは常に実行可能またはデバッグ可能な状態になります。
• 構築コマンドが無効になります。「生成物を削除して構築」コマンドを使用せずに JAR ファイルを再構築する場合は、「保存時にコンパイル」機能を無効にする必要があります。
• 実行、デバッグ、プロファイル、またはテストのコマンドを使用する際に、プロジェクトの Ant スクリプトは使用されません。これらのいずれかのコマンド用に構築スクリプトをカスタマイズした場合、そのカスタマイズ内容は無視されます。
• ファイルに加えた変更を保存するときに、プロジェクトから構築された JAR ファイルは最新の状態に変更されません。JAR ファイルを構築または再構築するには、「生成物を削除して構築」コマンドを使用する必要があります。「保存時にコンパイル」機能が有効になっているかどうかに関係なく、「生成物を削除して構築」コマンドでは、常にプロジェクトの Ant スクリプトが使用されます。

デフォルトでは、プロジェクトを新たに作成する場合は「保存時にコンパイル」機能が有効化されます。既存のプロジェクトの場合は、「保存時にコンパイル」機能が無効になります。

Java プロジェクトで「保存時にコンパイル」機能を有効または無効にするには、次の手順に従います。

1. プロジェクトノードを右クリックし、「プロパティー」を選択します。
2. 「コンパイル」ノードを選択し、「保存時にコンパイル」プロパティーを設定します。

同様に、IDE には、Java Web アプリケーションおよびエンタープライズアプリケーション用に「保存時に配備」機能も用意されています。プロジェクトの「保存時に配備」機能が有効化されていて、そのプロジェクトが IDE を介してサーバーに配備されている場合、変更されたファイルはすぐにそのサーバーに再配備されます。「保存時に配備」が GlassFish V2 で機能するには、Glassfish インスタンスで「ディレクトリ配備有効」オプションが選択されている必要があります。

Java Web またはエンタープライズプロジェクトで「保存時に配備」機能を有効または無効にするには、次の手順に従います。

1. プロジェクトノードを右クリックし、「プロパティー」を選択します。
2. 「実行」ノードを選択し、「保存時に配備」プロパティーを設定します。

ディレクトリ配備 Glassfish V2 を有効化するには、次の手順に従います。

1. 「ツール」>「サーバー」を選択します。
2. サーバーを選択します。
3. 「オプション」タブを選択します。
4. 「ディレクトリ配備有効」オプションを選択します。

コンパイルエラーの修正

IDE では、出力メッセージとコンパイルエラーが「出力」ウィンドウに表示されます。複数のタブを持つこのウィンドウは、コンパイルエラーの生成時、プログラムのデバッグ時、Javadoc ドキュメントの生成時などに自動的に表示されます。このウィンドウは「ウィンドウ」>「出力」(Ctrl-4) を選択して手動で表示することもできます。

また、コンパイルエラーは、「タスク」ウィンドウにも表示され、ソースエディタでマークされます。

「出力」ウィンドウの重要な機能の 1 つは、プログラムのコンパイル中に見つかったエラーを通知することです。次の図に示すように、エラーメッセージは青い下線付きの文字で表示され、ソースコード内のエラーを起こした行にリンクされています。「出力」ウィンドウには、Ant 構築スクリプトを実行したときに見つかったエラーへのリンクもあります。「出力」ウィンドウでエラーリンクをクリックすると、ソースエディタは、そのエラーが含まれている行に自動的に移動します。F12 キーでファイル内の次のエラーへ、Shift-F12 キーで前のエラーに移動することもできます。

ファイルのコンパイルや実行、デバッグなどの、Ant スクリプトが実行するすべてのアクションの出力は、同じ「出力」ウィンドウのタブに送信されます。「出力」ウィンドウに表示されたメッセージを保存する必要がある場合は、そのメッセージを別のファイルにコピー＆ペーストできます。新しいターゲットそれぞれのコマンド出力を新しい「出力」ウィンドウタブに出力するように Ant を設定することもできます。これを行うには、「ツール」>「オプション」を選択し、「その他」カテゴリを選択し、「Ant」タブをクリックし、「終了したプロセスの出力タブを再利用」プロパティーのチェックボックスを選択解除します。

出力ファイルのフィルタリング

JAR ファイルや WAR ファイルを作成するときには、通常、コンパイルされた .class ファイルと、リソースバンドルや XML ドキュメントなど、ソースディレクトリに置かれているその他のリソースファイルだけを含めます。デフォルトのフィルタは、出力ファイルからすべての .java ファイル、.nbattrs ファイル、および .form ファイルを除外することで、自動的にこの処理を行います。

正規表現を使用して追加のフィルタを作成し、出力ファイルを制御できます。除外するファイルを指定するには、「プロジェクト」ウィンドウでプロジェクトを右クリックし、「プロパティー」を選択して「プロジェクトプロパティー」ダイアログを表示します。左側の区画で、「パッケージング」をクリックします。右側の区画でテキストボックスに正規表現を入力して、JAR ファイルまたは WAR ファイルのパッケージング時に除外するファイルを指定します。デフォルトの式に加えて、使用可能な正規表現がいくつかあります。

正規表現	説明
\.html$	すべての HTML ファイルを除外
\.java$	すべての Java ファイルを除外
(\.html$)|(\.java$)	すべての HTML ファイルおよび Java ファイルを除外
(Key)|(\.gif$)	すべての GIF ファイルと、名前に Key が含まれるすべてのファイルを除外

正規表現の構文については、jakarta.apache.org を参照してください。

プロジェクトおよびファイルの実行

Java プロジェクトの場合は、通常、プログラムの主クラスを含むプロジェクトを主プロジェクトとして設定します。Web プロジェクトの場合、主プロジェクトは最初に配備されたプロジェクトです。プロジェクト、パッケージ、またはファイルを実行するには、次のいずれかを選択します。

• メインメニューで「実行」>「主プロジェクトを実行」(F6) を選択して、主プロジェクトを実行します。また、ツールバーの「主プロジェクトを実行」ボタンを使用することもできます。
• 「プロジェクト」ウィンドウでプロジェクトを右クリックし、「プロジェクトを実行」を選択してプロジェクトを実行します。Java プロジェクトの場合は、プロジェクトに主クラスが必要です。
• 「プロジェクト」ウィンドウでファイルを右クリックし、「ファイルを実行」(Shift+F6) を選択してファイルを実行します。または、メインメニューで「実行」>「ファイルを実行」>「<ファイル名> を実行」(Shift+F6) を選択して、実行可能なクラスを実行します。

プロジェクトを実行すると、コンパイルエラーと出力が「出力」ウィンドウに表示されます。詳細は、「コンパイルエラーの修正」を参照してください。

注: プロジェクトで「保存時にコンパイル」が有効化されている場合、「プロジェクトを実行」コマンドは、これらのファイルを保存したときに作成されたクラスファイルに対して作用します。Ant 構築スクリプトは使用されません。構築スクリプトでカスタム手順を定義した場合、それらの手順には従われません。「プロジェクトを実行」、「プロジェクトをデバッグ」、または「プロジェクトをプロファイル」を使用するときに、すべての構築プロセスを実行するには、「保存時にコンパイル」を無効にします。

実行時オプションのカスタマイズ

デフォルトでは、IDE で主クラス、実行時引数、または JVM 引数は指定されません。各標準プロジェクトの実行時クラスパスには、プロジェクトのコンパイル済みクラスと、プロジェクトのコンパイル時クラスパスにあるすべての生成物が含まれます。プロジェクトのコンパイル時クラスパスを表示するには、「プロジェクトプロパティー」ダイアログを表示し、「カテゴリ」区画で「ライブラリ」ノードを選択してから、右の区画で「コンパイル」タブをクリックします。

プロジェクト実行時オプションを変更するには、「プロジェクト」ウィンドウでプロジェクトのノードを右クリックして「プロパティー」を選択し、「プロジェクトプロパティー」ダイアログを表示します。次に、「カテゴリ」区画で「ライブラリ」ノードを選択し、ダイアログの右の区画で「実行」タブをクリックします。主クラスの設定、プログラム引数、プログラム実行用の作業ディレクトリ、および VM オプションにアクセスするには、「実行」ノードを選択する必要があります。次の節では、実行時クラスパスの構成方法について詳しく見て行きます。

実行時クラスパスの設定

プロジェクト、ライブラリ、JAR ファイル、およびフォルダをプロジェクトの実行時クラスパスに追加するには、「プロジェクトプロパティー」ダイアログ内の「実行時ライブラリ」リストの右側にあるボタンを使用します。

プロジェクトが、間接インタフェースまたはリフレクションを使用して、実行時に動的に特殊なライブラリ (JDBC ドライバあるいは JAXP 実装など) を使用する場合は、それらのライブラリを実行時クラスパスに追加してください。また、プロジェクト間の実行時の依存関係が、コンパイル時の依存関係と異なる場合も、実行時クラスパスを調整する必要があります。たとえば、プロジェクト A がプロジェクト B を基にコンパイルされ、プロジェクト B がプロジェクト C を基にコンパイルされるが、プロジェクト A はプロジェクト C を基にコンパイルされないと仮定します。このことは、プロジェクト A の実行時クラスパスには、プロジェクト B のみ存在することを意味します。実行中の プロジェクト A がプロジェクト B と C の両方を必要とする場合は、プロジェクト A の実行時クラスパスにプロジェクト C を追加する必要があります。

主クラスと実行時引数の設定

プロジェクトの主クラスを設定するには、「プロジェクトプロパティー」ダイアログの「カテゴリ」区画で「実行」ノードを選択し、完全修飾名を「主クラス」フィールドに入力します。たとえば、「org.myCompany.myLib.MyLibClass」と入力します。主クラスは、プロジェクト内か、プロジェクトの実行時クラスパスにある JAR ファイルまたはライブラリのいずれかに存在する必要があります。その後、必要な実行時引数を「引数」フィールドに入力します。

「参照」ボタンを使用してプロジェクトの主クラスを選択すると、ファイル選択用ダイアログが開き、プロジェクトのソースディレクトリ内のクラスのみ表示されます。クラスパス上にあるライブラリにあるクラスを指定する場合は、「主クラス」フィールドにそのクラスの完全修飾名を入力する必要があります。

JVM 引数の設定

プロジェクトの JVM 引数は、「プロジェクトプロパティー」ダイアログで指定できます。「プロジェクトプロパティー」ダイアログを表示し、「カテゴリ」区画で「実行」をクリックしてから、「VM オプション」フィールドに空白文字区切りの JVM 引数のリストを入力します。

「VM オプション」フィールドで次を入力することによって、システムプロパティーを設定することができます。

-Dname=value

<target name="jar" />

Ant スクリプトの編集および実行

IDE は自動的に Ant スクリプトを認識し、それらのスクリプトを、通常の XML ファイルではなく Ant スクリプトノード () として表示します。「プロジェクト」ウィンドウ、「ファイル」ウィンドウ、または「お気に入り」ウィンドウで Ant スクリプトを右クリックして、コマンドのポップアップメニューにアクセスできます。また、Ant スクリプトノードを展開して、Ant スクリプトのターゲットを表すサブノードのアルファベット順のリストを表示することもできます。これらのサブノードのそれぞれには、コマンドのポップアップメニューもあります。

「プロジェクト」ウィンドウ、「ファイル」ウィンドウ、および「お気に入り」ウィンドウでは、Ant スクリプトのサブノードが次のように表示されます。

アイコン	意味
	強調された Ant ターゲット。これらのターゲットには、ツールチップとして表示される説明属性が含まれています。ターゲットの説明属性は、ソースエディタで定義します。
	通常の Ant ターゲット。説明属性を持たないターゲットです。

Ant スクリプトのサブノードをダブルクリックすることにより、ソースエディタ内のそのターゲットの場所まで移動できます。すべての通常の XML 検索ツール、選択ツール、およびキーボードショートカットを使用して、Ant スクリプトを編集できます。また、IDE では、すべての標準的 Ant タスクについて、コード補完機能が動作します。

コマンド行から実行するターゲットを作成するときには、そのターゲットに説明属性を設定してください。ターゲットの名前や機能を忘れた場合は、ant -projecthelp <script> コマンドをコマンド行から実行できます。このコマンドを実行すると、Ant は、説明属性を持つターゲットだけを、それらの説明とともにリストします。特に、Ant 構築スクリプト内に多数のターゲットがある場合、一部のターゲットを強調し、その他のターゲットは強調しないことによって、頻繁に使用するターゲットとそうでないターゲットを簡単に区別できます。

「プロジェクト」、「ファイル」、および「お気に入り」の各ウィンドウに表示されるサブノードのラベルのフォントスタイルは、次の状態を示します。

• 通常。現在の Ant スクリプト内で定義されているターゲットです。
• イタリック。別の Ant スクリプトからインポートされたターゲットです。
• 灰色表示。直接には実行できない内部ターゲットです。内部ターゲットには、「-」で始まる名前が付けられています。
• ボールド。存在する場合は、スクリプトのデフォルトターゲットです。デフォルトターゲットは、プロジェクトの属性として、プロジェクト名など、プロジェクトのその他の属性とともに宣言されます。プロジェクトのデフォルト属性は、ソースエディタで定義します。

別のスクリプトからインポートされたが、インポートスクリプトでオーバーライドされたターゲットは、リストされません。オーバーライドしたターゲットだけがリストされます。

Ant スクリプト内のターゲットは、「プロジェクト」ウィンドウ、「ファイル」ウィンドウ、または「お気に入り」ウィンドウで Ant スクリプトのノードから実行できます。これを行うには、Ant スクリプトノードを右クリックし、「ターゲット実行」サブメニューからターゲットを選択します。ターゲットはアルファベット順にソートされます。強調されたターゲットだけがリストされます。説明属性で強調されていないターゲットを実行するには、「その他のターゲット」を選択します。内部ターゲットは別個に実行することができないため、リストから除外されます。

Ant スクリプトノードのポップアップメニューを使用してターゲットを実行する代わりに、そのターゲットのノードを右クリックし、「ターゲット実行」を選択して実行することもできます。

カスタム Ant タスクの書き込み

カスタム Ant タスクを使用して、Ant の組み込みタスクで提供される機能を拡張できます。カスタムタスクは、プロパティーの定義、入れ子にされた要素の作成、または addText メソッドを使用したタグ間でのテキストの直接書き込みにしばしば使用されます。

IDE でカスタム Ant タスクを作成するには、次の手順に従います。

1. タスクを配置するパッケージを右クリックし、「新規」>「その他」を選択します。
2. 「その他」カテゴリと、ファイルの種類「カスタム Ant タスク」を選択します。
3. ウィザードを終了します。

カスタム Ant タスクのファイルを作成するときには、ソースエディタでテンプレートが開きます。このテンプレートには、Ant タスクで実行される多くの一般的な操作のためのサンプルコードが含まれています。テンプレートでは、コードの各セクションのあとに、そのタスクを Ant スクリプトで使用する方法も示されています。