FeaturesPluginsDocs & SupportCommunityPartners

NetBeans IDE 3.6 から 4.0 への移行

Contributed and maintained by

NetBeans IDE 4.0 は、その製品の歴史の中で大きな前進です。Ant を利用した新しいプロジェクトシステムを導入することによって、クラスパスの管理の厳密性、構築および実行オプションの汎用性が増し、市場のどの IDE よりも密な Ant との統合が実現されています。また、NetBeans IDE 3.6 の「マウント」方式のシステムに慣れたユーザーにとっては、作業の流れに大きな変化があります。

このドキュメントは、NetBeans IDE 3.6 から NetBeans IDE 4.0 へのアプリケーションおよび IDE 設定の移行方法だけでなく、NetBeans IDE プロジェクトシステムでさらに生産性を高める方法も紹介しています。

目次

Ant に基づくプロジェクトシステム

NetBeans IDE 4.0 には、Apache Ant を直接利用したまったく新しいプロジェクトシステムがあります。NetBeans IDE プロジェクトシステムは、Ant 構築スクリプトを使用して、アプリケーションをコンパイル、実行、テストし、プロジェクトに関するすべてのメタデータを保持します。

Ant についての深い知識や経験は必要ありません。また、Ant を使用して、NetBeans IDE 内でプロジェクトを扱う方法を知っている必要さえありません。IDE には、アプリケーションの開発に必要なすべてを含む標準のプロジェクトテンプレートが用意されています。プロジェクトの GUI で基本的なコンパイル時および実行時オプションのすべてを設定できます。

上級の Ant ユーザーは Ant の機能を全面的に利用し、構築プロセスをカスタマイズできます。Ant ターゲットを書き換えることによって、標準プロジェクトの構築スクリプトを拡張することができます。IDE には、自由形式のプロジェクトテンプレート も付属しており、これらのテンプレートで独自の Ant スクリプトを作成し、プロジェクトの実行およびコンパイルを制御できます。

ページ先頭に戻る

NetBeans IDE 3.6 との比較

NetBeans IDE 4.0 では、ソースパッケージのルートごとに標準のプロジェクトを 1 つ作成し、それらプロジェクト間のクラスパス依存関係を設定します。各プロジェクト内で、アプリケーションのコンパイル、実行、テストそれぞれに専用のクラスパスを設定することができます。独自の Ant スクリプトを使用してプロジェクトを構築、実行する場合は、自由形式のプロジェクトを作成し、そのプロジェクト内で複数のソースフォルダを作成し、それぞれにクラスパスを持たせることができます。

次の表に、NetBeans IDE 3.6 と 4.0 の主な相違点をまとめます。

NetBeans IDE 3.6 NetBeans IDE 4.0
ソースフォルダ
1 つのプロジェクトに、複数のソースフォルダおよび Java ソースパッケージルートを含むことができます。 1 つの標準プロジェクトは、Java ソースパッケージルートを含むソースフォルダを 1 つだけ含むことができます (J2SE プロジェクトの場合は、ソースフォルダ 1 つに加えて JUnit テストパッケージフォルダ 1 つ)。

自由形式のプロジェクトの場合は、Ant スクリプトにソースフォルダに関する情報があり、それに従ってクラスパスが処理されるかぎり、複数のソースフォルダを含むことができます。

クラスパス
プロジェクト 1 つにクラスパスは 1 つだけです。このクラスパスは、エクスプローラの「ファイルシステム」ウィンドウにマウントされているすべてで構成されます。 標準プロジェクトの場合は、プロジェクト 1 つにクラスパス 1 つですが、テスト、実行、デバッグのそれぞれに異なるバージョンのクラスパスを設定することができます。

自由形式のプロジェクトのクラスパスは、Ant スクリプトで制御するため複雑になることがあります。

ファイルおよびプロジェクトビューへのアクセス
利用するすべてのフォルダをマウントする必要があります。「ファイルシステム」ウィンドウは、ソース内容のフォルダビューを提供するだけです。個別ファイルは、「プロジェクト」ウィンドウに追加できます。 「プロジェクト」ウィンドウが、論理的な形式で Java ソースおよび Web アプリケーションのビューを提供します。「ソースパッケージ」ノードには、パッケージ別にソースが表示されます。「ファイル」ウィンドウは、ディスク上でのプロジェクトフォルダの物理的な配置を示します。「お気に入り」ウィンドウでは、使用コンピュータ上の任意の場所にアクセスできます。
出力ファイルの生成
「ファイルシステム」ウィンドウで 「JAR (または WAR) レシピ」ノードを作成し、そのノードのプロパティおよびコンテキストメニューを使用して、JAR または WAR ファイルを生成します。 JAR ファイルは、標準の J2SE プロジェクトを構築するたびに 1 つ生成されます。WAR ファイルは、Web プロジェクトを構築するたびに 1 つ生成されます。J2SE プロジェクトの場合は、「プロジェクトプロパティ」ダイアログの「JAR を生成」ページ、Web プロジェクトの場合は「プロジェクトプロパティ」ダイアログボックスの「プロジェクトのパッケージ化」ページでフィルタおよび圧縮オプションを設定します。標準の J2SE および Web プロジェクトは、プロジェクトごとに出力ファイルを 1 つ生成します。

自由形式のプロジェクトの場合、出力ファイルの生成は Ant スクリプトで制御します。

プロジェクトの共有
開発者の間でプロジェクトおよびプロジェクト設定を共有することはできません。 プロジェクトメタデータのすべてが、Ant スクリプトと Ant プロパティファイル、いくつかの XML ファイルの形式でプロジェクトフォルダに格納されます。このメタデータをバージョン管理対象にして、自分のシステムに専用の設定を指定することができます。
オプションの設定
「オプション」ウィンドウですべてのオプションを設定します。プロジェクトまたは個別ファイルに割り当てたサービスの種類を使用して、実行、デバッグ、コンパイルの設定を管理します。

「プロジェクトプロパティ」ダイアログでクラスパスやコンパイル設定、実行時引数などのプロジェクト関係のオプションを設定します。プロジェクトの Ant スクリプトおよび Ant プロパティファイルを編集することによって、さらにオプションを設定できます。

「オプション」ウィンドウでは、構文の色分けや Web ブラウザ設定、システム設定などの IDE 全体の一般的なオプションを設定します。

Web アプリケーション
利用するすべてのフォルダをマウントする必要があります。「ファイルシステム」ウィンドウは、ソース内容のフォルダビューを提供するだけです。個別ファイルは、「プロジェクト」ウィンドウに追加できます。JSP 1.2 および 2.0 仕様がサポートされています。IDE によって JSP がコンパイルされることはありませんが、妥当性の検査は行われます。Tomcat サーバー 5.0.19 が NetBeans と統合されています。 J2SE プロジェクト同様、Web プロジェクトも、Ant がサポートする新しいプロジェクトシステムを使用して開発します。Web プロジェクトでは、WEB-INF/classes 以外の場所にある Web クラスや WEB-INF/lib 以外の場所にあるライブラリなどの、複数のフォルダにあるソースを利用できます。Web プロジェクトが Java クラスライブラリに依存している場合は、そのライブラリを独立したプロジェクトとして扱うことができます。JSP 2.0 仕様に対するサポートが強化され、タグハンドラやタグファイル用のウィザード、タグライブラリ記述子に対するコード補完機能があります。JSP コンパイルが再導入され、Ant によって処理されます。NetBeans IDE 4.0 では、Tomcat サーバー 5.0.27 が統合されています。

ページ先頭に戻る

標準のプロジェクトと自由形式のプロジェクト

次の表に、NetBeans IDE 4.0 における標準プロジェクトと自由形式プロジェクトの主な相違点をまとめます。

標準のプロジェクト 自由形式のプロジェクト
NetBeans 生成の Ant 構築スクリプトを使用して、アプリケーションを構築、実行、生成部の削除、テスト、デバッグを行います。 既存の Ant スクリプト内のターゲットを使用して、アプリケーションの構築、実行、生成物の削除、テスト、デバッグを行います。Ant スクリプトに、これらの機能のターゲットが含まれていない場合、その機能は使用できません。Ant スクリプトまたは補助的な Ant スクリプトで、そうした機能を実現するターゲットを作成することができます。
1 つのプロジェクトに、ソースフォルダを 1 つだけ含むことができます (J2SE プロジェクトの場合は、ソースフォルダに加えてテストフォルダ 1つ)。複数のソースフォルダを使用するには、ソースフォルダごとに別途、プロジェクトを作成し、プロジェクト間の依存関係を作成する必要があります。 プロジェクトのソースフォルダ数の制限はありません。プロジェクトを作成した後、ソースフォルダを追加したり、削除したりできます。また、他の NetBeans プロジェクトとの依存関係を作成することもできます。
プロジェクトのクラスパスは、「プロジェクトプロパティ」ダイアログボックスの「ソースのコンパイル」ページでオプションを設定することによって制御します。 あらゆる変更が、ただちに IDE 生成の Ant スクリプトに記録されます。 プロジェクトのクラスパスは、Ant スクリプトで制御します。「プロジェクトプロパティ」ダイアログボックスの「クラスパス」ページのクラスパスの設定は、コード補完およびリファクタリングに使用できるクラスを IDE に伝えるだけです。Ant スクリプト内のクラスパス設定を変更した場合は、プロジェクトのプロパティの設定を更新する必要があります。
構築プロセスは、「プロジェクトプロパティ」ダイアログボックスで基本的なオプションを設定するか、NetBeans 生成の Ant スクリプト内のターゲットを書き換えることによってカスタマイズします。 コンパイル時および実行時オプションはすべて、Ant 構築スクリプトで設定します。
ソースフォルダ全体で JAR ファイル (J2SE プロジェクトの場合) または WAR ファイル (Web プロジェクトの場合) が 1 つだけ作成されます。 プロジェクトの Ant スクリプトに指定されている個数の構築物が生成されます。

ページ先頭に戻る

NetBeans IDE 3.6 のソースコードのインポート

NetBeans 4.0 のプロジェクト構造は以前のバージョンとかなり異なるため、NetBeans IDE 3.6 プロジェクトの自動インポートは実装されていません。(NetBeans 3.6 でアプリケーションに必要なリソースのすべてにアクセスするには同じフォルダを何回もマウントする必要があるため、IDE はマウントポイントのどれが実際のソースフォルダかを判別できません。)

バージョン 3.6 で扱ったソースコードをインポートするには、ソースパッケージのルートごとに新しいプロジェクトを 1 つ作成します (専用の Ant スクリプトがある場合は、アプリケーション全体で自由形式のプロジェクトを 1 つ作成)。NetBeans IDE 4.0 へのソースコードのインポートの詳細は、次のドキュメントを参照してください。


ページ先頭に戻る

NetBeans IDE 3.6 の設定のインポート

マウントしたフォルダおよびそれらフォルダに関係する設定を NetBeans IDE 3.6 からインポートすることはできませんが、一般的な IDE 設定の多くは、初めて NetBeans IDE 4.0 を実行したときにインポートされます。ただし、3.6 より前のバージョンの設定はインポートできません。

NetBeans IDE 3.6 からインポートされる設定は、次の表に示すとおりです。

インポートされる設定 IDE 内の場所
Java およびソースエディタの設定
すべてのファイルの種類に共通のエディタ設定 「ツール」>「オプション」>「編集」>「エディタ設定」>「<mime-type> エディタ」
ソースエディタの注釈設定 「ツール」>「オプション」>「編集」>「注釈の種類」
プリンタの設定 「ツール」>「オプション」>「IDE 構成」>「システム」>「印刷設定」
インデント設定エンジンの設定 「ツール」>「オプション」>「インデント設定エンジン」
一般的な Java ソース設定 「ツール」>「オプション」>「編集」>「Java ソース」
「ツール」>「オプション」>「編集」>「ソースの同期化」
「ツール」>「オプション」>「IDE 構成」>「Look & Feel」>「Java 要素」
フォームエディタの設定 「ツール」>「オプション」>「編集」>「フォームエディタ設定」
国際化の設定 「ツール」>「オプション」>「編集」>「国際化」
テンプレートの設定とカスタムテンプレート 「ツール」>「オプション」>「ソースの作成と管理」>「テンプレート」
取得および設定メソッドの生成 「ツール」>「オプション」>「編集」>「Beans プロパティ」
システムの設定
プロキシ情報や優先ブラウザなどのシステム設定 「ツール」>「オプション」>「システム」
全般的なキーボードショットカット 「ツール」>「キーボードショートカット」
相違の設定 「ツール」>「オプション」>「IDE 構成」>「サーバーと外部ツールの設定」>「相違とマージのタイプ」
外部ブラウザの設定 「ツール」>「オプション」>「IDE 構成」>「サーバーと外部ツールの設定」> 「Web ブラウザ」(「IDE オプション」ダイアログ)
HTTP サーバーの設定 「ウィンドウ」>「実行時」>「HTTP サーバー」
保存された HTTP モニタートランザクション 「ウィンドウ」>「HTTP モニター」>「保存されたレコード」
サーバーレジストリの設定 「ウィンドウ」>「実行時」>「サーバーレジストリ」
VCS の設定
全般的な VCS 設定
「ツール」>「オプション」>「ソースの作成と管理」>「バージョン管理設定」
VCS グループの設定
「ツール」>「オプション」>「ソースの作成と管理」>「バージョン管理設定」>「VCS Groups Settings」
データベースの設定
登録された JDBC ドライバ 「ウィンドウ」>「実行時」>「データベース」>「ドライバ」
データベース接続とモジュールの設定 「ツール」>「オプション」>「IDE 構成」>「サーバーと外部ツールの設定」>「データベースエクスプローラ」

ページ先頭に戻る

一般的なプロジェクト作業

次の表は、NetBeans 4.0 で一般的なプロジェクト作業を行う方法を説明しています。

行う作業 手順

既存のソースから標準プロジェクトを作成する。

  1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。
  2. 「Web」>「既存のソースを使用する Web プロジェクト」または「一般」>「既存のソースを使用する Java プロジェクト」を選択します。
  3. ウィザードの指示に従って操作を進めます。

既存のソースおよび Ant スクリプトから自由形式のプロジェクトを作成する。

  1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。
  2. 「Web」>「既存の Ant スクリプトを使用する Web プロジェクト」または「一般」>「既存の Ant スクリプトを使用する Java プロジェクト」を選択します。
  3. ウィザードの指示に従って操作を進めます。

標準プロジェクトのクラスパスに JAR ファイルを追加する。

  1. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロパティ」を選択します。
  2. 「ソースのコンパイル」をクリックします。
  3. 「JAR/ フォルダを追加」をクリックし、ファイル選択用ダイアログボックスで JAR ファイルを選択します。

プロジェクト間のコンパイル時依存関係を設定する。

  1. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロパティ」を選択します。
  2. 「ソースのコンパイル」をクリックします。
  3. 「プロジェクトを追加」をクリックして、プロジェクトのクラスパスに追加するプロジェクトのプロジェクトフォルダを選択します。
    注: 自由形式のプロジェクトの場合は、単にプロジェクトの出力 JAR ファイルをクラスパスに追加します。

クラスパス上の JAR ファイルに Javadoc マニュアルとソースコードを追加する。

  1. メインウィンドウで「ツール」>「ライブラリマネージャ」を選択します。
  2. JAR ファイルがライブラリマネージャにまだ登録されていない場合は、「ライブラリを追加」ボタンを使って空のライブラリを新規作成します。
  3. ライブラリマネージャの左パネルでライブラリを選択します。
  4. 「クラスパス」タブで「JAR/ フォルダを追加」をクリックし、コンパイル済みクラスファイルを含む JAR ファイルの場所を指定します。1 つのライブラリに、複数の JAR ファイルを含むことができます。
  5. 「ソース」タブと「Javadoc」タブを使用して、ソースコードとマニュアルを含むフォルダまたはアーカイブファイルを追加します。
  6. 「了解」をクリックして、ライブラリマネージャを終了します。
  7. JAR ファイルがプロジェクトのコンパイル時クラスパス上にまだない場合は、上記の手順でクラスパスに追加します。

プロジェクトの主クラスと実行時引数、実行時作業用ディレクトリ、VM の引数を設定する。

  1. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロパティ」を選択します。
  2. 「プロジェクトの実行」をクリックして、適切な情報を入力します。
構築プロセスをカスタマイズする。
  1. 「ファイル」ウィンドウでプロジェクトフォルダを展開し、nbproject/build-impl.xml および nbproject/project.properties を開きます。build-impl.xml には、プロジェクトに対するすべての処理命令が含まれています。このファイルは編集しないでください。変更しても、IDE によってすべて上書きされます。
  2. 変更する構築プロセスを制御する構築ターゲットおよびプロパティを探します。主な構築ターゲットのどれにも、pre および post ターゲットが 1 つずつあり、これらターゲットを書き換えることによって、そのターゲットを実行する前および後に命令を追加することができます。、
  3. プロジェクトフォルダにある build.xml をダブルクリックし、必要に応じて、build-impl.xml から得られたターゲットを書き換えます。
  4. 必要に応じて、project.properties 内の構築プロパティを編集します。プロジェクトのメタデータを共有している場合で、共有しない設定がある場合は、代わりに nbproject/private/private.properties 内の設定をオーバーライドします。

構築出力フォルダを設定する。

  1. 「ファイル」ウィンドウで、プロジェクトフォルダにある「nbproject」ノードを展開します。
  2. project.properties」をダブルクリックし、ソースエディタで開きます。
  3. build.dir」プロパティに構築出力フォルダを設定します。プロジェクトフォルダ以外の場所に構築出力フォルダを設定した場合、「ファイル」ウィンドウでアクセスすることはできません。
    注: 構築出力フォルダは、プロジェクトの生成物を削除するたびに削除されます。このため、ソースフォルダを構築出力フォルダに設定しないでください。

ページ先頭に戻る

Bookmark this page

del.icio.us furl simpy slashdot technorati digg
Companion
Projects:
MySQL Database Server   Open JDK: an Open SourceJDK   GlassFish Community: an Open Source Application Server    Mobile & Embedded Community    Open Solaris   java.net - The Source for Java Technology Collaboration   Virtual Box - full virtualizer  Open ESB - The Open Enterprise Service Bus Powered by