HOME / Docs & Support / NetBeans 5.5

ファイルの作成と編集

Java ソースコードの作成と編集は、IDE が提供するもっとも重要な機能です。開発者が 1 日のほとんどを費やす部分です。NetBeans IDE には、開発者が手動ですべてをコーディングするか、あるいはコードのかなりの部分を IDE に自動的に生成させるかどうかに関係なく、開発者各自の開発スタイルに役立つ広範囲のツールが用意されています。

ここでは、次の内容を取り上げています。

Java ファイルの作成

NetBeans IDE には、Java ソースファイルから XML ドキュメント、リソースバンドルまであらゆる種類のソースファイルの作成に利用できるテンプレートとウィザードが付属しています。

プロジェクトの作成後、ファイルを作成するもっとも簡単な方法は、「プロジェクト」ウィンドウで、ファイルを作成するプロジェクトのプロジェクトノードを右クリックする方法です。プロジェクトノードを右クリックして表示される「新規」ポップアップメニューから、希望するファイルの種類を選択します。「新規」サブメニューには、よく使われるテンプレートへのショートカットと、「新規ファイル」ウィザードを開いたり、すべての NetBeans テンプレートにアクセスしたりできる「ファイル/フォルダ」コマンドが含まれています。

「新規」メニューからのテンプレートの選択

「新規ファイル」ウィザードを使用すると、IDE のデフォルトのファイルテンプレートから新規ファイルを作成できます。ファイルテンプレートは、種類ごとにグループ化されています。デフォルトのファイルテンプレートだけでなく、ファイルを作成するために IDE で使用するテンプレートをカスタマイズしたり、独自のテンプレートを作成したりすることができます。特定のファイルの種類で標準要素を必要とする場合、またはほかの要素の生成方法を変更する場合は、独自のテンプレートを使用するというオプションが役立つことがあります。独自のテンプレートを作成すると、「新規ファイル」ウィザードでそれらのテンプレートを利用できます。

ファイルテンプレートの使用

新規テンプレートを変更および作成するには、メインメニューから「ツール」を選択し、「テンプレートマネージャー」を選択して、テンプレートマネージャーを使用します。新規テンプレートを作成するには、既存のテンプレートをコピーしたあとに、「エディタで編集」をクリックします。たとえば、新規 Java クラステンプレートを作成するには、既存の Java クラステンプレートを複製し、その新規クラスを選択して「エディタで開く」をクリックします。これで、ソースエディタでクラスを変更し、保存することができます。この新規クラスは「新規ファイル」ウィザードで利用できるようになります。

既存テンプレートを IDE に追加するには、「追加」をクリックし、システム上のファイルを選択します。このファイルは「新規ファイル」ウィザードでテンプレートとして利用できるようになります。

GUI テンプレートの使用

IDE の GUI ビルダーを使用し Java GUI フォームをグラフィカルに編集する場合は、IDE の Java GUI フォームのテンプレートを使用してフォームのソースファイルを作成する必要があります。このテンプレートグループには、AWT および Swing フォームのテンプレートが含まれています。たとえば、通常の Java クラスファイルを作成してから、JPanel を拡張するための変更を加え、GUI ビルダーで編集することはできません。

Java GUI の作成については、次のドキュメントを参照してください。

NetBeans IDE 5.5 における GUI 構築

ソースエディタにおける Java ファイルの編集

ソースエディタは、ソースコードを編集するための第一のツールです。ソースエディタには、コード補完やコンパイルエラーの強調表示、コード要素の構文強調表示、先進のフォーマットおよび検索機能など、コードの記述を簡略化し、コーディング時間を短縮する広範囲の機能が用意されています。

ソースエディタは、IDE の 1 つのコンポーネントとして考えることができますが、実際にはエディタの集合です。1 つの種類のソースファイルには、異なる機能を提供する専用のエディタがあります。この節では、Java エディタを取り上げますが、説明の多くはほかのエディタにも当てはまります。ソースエディタで Java ソースファイルを開くには、「プロジェクト」または「ファイル」ウィンドウでファイルのノードをダブルクリックします。

IDE には各種のコードを生成する多くの機構が用意されています。よく使われる機構の例を次に示します。

コード補完 (Ctrl-スペース、または Ctrl-\)。コードの入力時に、コード補完ボックスを開くためのショートカットを使用できます。コード補完ボックスには、状況依存のリストがあり、現在入力している文を補完するオプションが表示されます。文字をさらに入力していくと、コード補完ボックスに表示されるオプションの数が絞り込まれます。
コードテンプレート。よく使われるコードの多くでは、コード全体を入力するのではなく、複数のキー入力による省略名を使用できます。スペースキーを押すと、省略名が完全なコードに展開されます。
エディタヒント (Alt-Enter)。コードの欠落などのエラーが検出されると、IDE ではエラーの修正に必要な欠落しているコードを提示し、そのコードを必要な場所に挿入することができます。エラーがあることが認識された行に挿入ポイントがある場合、余白部分に電球のアイコンが表示され、修正案があることがわかります。修正案を表示するには、キーボードショートカットを使用するか、電球アイコンをクリックします。コードに修正を加えるには、使用するヒントを選択し、Enter キーを押します。

以降の項目で、これらの機能の大部分の利用方法を示します。

コード補完

ソースエディタに Java 識別子を入力する場合は、IDE のコード補完ボックスを使用して式を完成させることができます。コード補完ボックスが表示されると、Javadoc ドキュメントのボックスも表示され、コード補完ボックスで現在選択されている項目のドキュメントが表示されます。「オプション」ウィンドウでは、Javadoc ボックスを無効にすることができます。

コード補完の例

コード補完ボックスを使用して、次のような場合にさまざまなコードを生成することができます。

必要なインポート文のほかに、クラスおよびクラスメンバーの名前を入力するとき。
利用可能なクラスの Javadoc ドキュメントを参照するとき。
動的なコードテンプレートからコードの全体を生成するとき。コードテンプレートをカスタマイズして、新規のコードテンプレートを作成できます。詳細は、このあとの「エディタの設定」を参照してください。
取得メソッドと設定メソッドを生成するとき。

コード補完ボックスを開くには、式の先頭の数文字を入力し、次に Ctrl- スペースキー、または Ctrl-\ キーを押します。または式でピリオド (.) を入力後、少し待つことで、コード補完ボックスを開くこともできます。コード補完ボックスには、それまでに入力した内容と一致する可能性のある選択肢が表示されます。式の文字を入力し続けることで、コード補完ボックスに表示される選択肢を絞り込むことができます。

コード補完ボックスを使用して式を完成するには、入力し続けて残りの選択肢が 1 つだけになったら Enter キーを押すか、またはリストをスクロールして使用するオプションを選択して、Enter キーを押します。何も選択せずにコード補完ボックスを閉じるには、Esc キーを押します。ソースエディタでコード補完ボックスを無効にする方法は、「エディタの設定」を参照してください。

IDE は、コンパイル時クラスパス上のクラスを使用し、コード補完やその他機能で提案を行います。コード補完では、ターゲット JDK バージョンのクラス、およびサーブレットや JSP、JSTL、XML API などのほかのよく使われるプロジェクト別の API、さらにはクラスパスに手動で追加したソースを利用することができます。詳細は、「プロジェクトのクラスパスの管理」を参照してください。

コードテンプレート

コードテンプレートを使用すると、よく使用される一連の予約語や一般的なコードパターン (for ループやフィールド宣言など) をすばやく入力できます。IDE にはテンプレートのセットが付属しているため、「オプション」ウィンドウで独自のコードテンプレートを作成することができます。ソースエディタでのコードテンプレートの実装方法を設定する方法は、「エディタの設定」を参照してください。独自のコードテンプレートの作成に使用する構文については、「特殊なコードテンプレート構文」を参照してください。

コードテンプレートは、よく使用されるテキストの断片を組み合わせて構成できるほか、より動的にすることで、スケルトンを生成し、そのスケルトン内でタブキーを押して可変テキストを入力することができます。コードで識別子 (インスタンス宣言のオブジェクト名など) を繰り返す場合は、識別子名を 1 回入力するだけで済みます。

たとえば forc と入力してスペースキーを押すと、次のように展開されます。

for (Iterator it = collection.iterator(); it.hasNext();) {
       Object elem = (Object) it.next();
}

ソースエディタでコードが展開されると、タブキーを押すだけで、コードの次の可変部分に移動できます。

省略名が入力するテキストと同じであるために別のコードに展開する必要がない場合は、Shift キーを押しながらスペースキーを押して展開しないようにします。

コードテンプレートにアクセスするには、ソースエディタで次の操作を行います。

コードの先頭の数文字を入力し、または Ctrl- スペースキーを押し、次にコード補完ボックスのリストからテンプレートを選択します。Javadoc ボックスに、テンプレートのテキスト全体が表示されます。
ソースエディタでコードテンプレートの省略名を直接入力し、スペースキーを押します。組み込みの Java コードテンプレートの省略名を検索するには、「オプション」ウィンドウでエディタの設定を開き、「コードテンプレート」タブを選択します。

特殊なコードテンプレート構文

コードテンプレートを作成するときは、コードテンプレートの動作方法をカスタマイズするために使用できる構造体が複数あります。これらの構造体のうち、有用性の高い構造体の一覧は「特殊なコードテンプレート構文」にあります。ソースエディタで Java ファイルに使用可能な省略名にある、省略名 fori、forc、および newo に対するデフォルトの IDE コードテンプレートを参照して、それらの構造体の使用方法を確認できます。

エディタヒント

エラーが検出され、それに修正案がある場合は、その行の左余白部分に電球アイコンが表示されます。電球アイコンをクリックするか、Alt-Enter キーを押すと、修正案を表示できます。適切な修正案がある場合は、その修正案を選択して Enter キーを押すことで、コードを修正できます。

「エラー」には、コードの誤りというわけではなく、余裕がなかったためにコードがまだ入力されていない状態である場合がよくあります。そのような場合、エディタヒントを使用すると、特定の種類のコードの入力を自動化できます。

リファクタリング

リファクタリングは、若干の変換を行いながらコードを再構成する機能です。この結果によって、プログラムの動作が変更を受けることはありません。式を分解することでわかりやすくしたり、変更しやすくしたりするのと同様に、コードを構成要素単位に分解することで読みやすくしたり、わかりやすくしたりできるほか、更新も早くできるようになります。リファクタリングされた表現は同じ結果を生成するものでなくてはならないため、リファクタリングされたプログラムは元のソースと機能的に同等なものでなくてはなりません。

コードのリファクタリングには、主に次の目的があります。

コードの変更を容易にし、新機能を追加しやすくする
複雑さを解消して理解しやすくする
不必要な繰り返し文を減らす
同じコードを別の目的に使用したり、汎用的に使用できるようにする

ほとんどのリファクタリングコマンドは、メインメニューバーの「リファクタリング」メニューからアクセスできます。ソースエディタで右クリックするか、「プロジェクト」ウィンドウでクラスノードを右クリックし、「リファクタリング」サブメニューからコマンドを選択します。リファクタリングの影響を受けたすべてのファイルに対するすべての変更は、「元に戻す」コマンドを使用してロールバックできます。

IDE には、コードのリファクタリングを容易にするための次の機能があります。

コマンド	説明
使用状況を検索	指定したクラス、メソッド、またはフィールドの名前に一致する文字列をすべて検索します。
名前を変更	クラスや変数、メソッドに一致する文字列をすべてより分かりやすい名前に変更できます。また、プロジェクトのソースコードすべてについて、新しい名前で参照するように更新します。
安全な削除	その要素に対する参照がないかどうかを確認したあとで、コード要素を削除します。
メソッドパラメータを変更	当該メソッドのパラメータおよびアクセス修飾子を変更できます。
フィールドをカプセル化	フィールドの複数のアクセス用メソッド (取得メソッドおよび設定メソッド) を生成します。また、オプションで、参照しているすべてのコードを更新し、取得メソッドおよび設定メソッドを使用してそのフィールドにアクセスできるようにします。
クラスを移動	別のクラスまたは別のパッケージにクラスを移動したり、あるクラスから別のクラスに静的フィールドまたは静的メソッドを移動したりすることができます。また、プロジェクト内のソースコード全体を更新して新しい場所の要素が参照されるようにします。
プルアップ	メソッドをクラスのスーパークラスに移動します。このコマンドを使用すると、そのメソッド定義は現在のクラスに保持したままで、スーパークラスでメソッドを宣言することもできます。
プッシュダウン	メソッドをクラスのサブクラスに移動します。このコマンドを使用すると、メソッド宣言を現在のクラスに保持したままで、メソッド定義をサブクラスに移動することもできます。
メソッドを抽出	選択したクラスでコードの選択部分を基に新規メソッドを作成したり、抽出された文を新規メソッドの呼び出しで置き換えたりすることができます。
インタフェースを抽出	選択したクラスでメソッドの選択部分を基に新規インタフェースを作成したり、新規インタフェースをクラスの implements 句に追加したりすることができます。
スーパークラスを抽出	選択したクラスでメソッドの選択部分を基に新規スーパークラスを作成します。メソッド宣言だけでクラスを作成したり、メソッド定義全体を新規クラスに移動したりすることができます。
可能な場合はスーパータイプを使用	サブクラスのオブジェクトではなく、スーパークラス (またはその他の種類) のオブジェクトを参照するようにコードを変更します。
内部レベルを外部レベルに移動	クラスを 1 レベル上に移動します。クラスが最上位の内部クラスである場合は、外部クラスになり、専用のソースファイルに移動されます。内部クラス、メソッド、または変数のスコープ内でクラスが入れ子になっている場合、そのクラスはそのスコープと同じレベルまで上に移動します。
匿名クラスを内部に変換	匿名内部クラスを名前付き内部クラスに変換します。

インポート文の処理

IDE には、Java クラスに必要なインポート文がすべて存在することを確認する方法が複数あります。

ファイル全体の場合は、挿入ポイントがソースエディタ内のファイルにあるときに Alt-Shift-F キー (「インポートを修正」) を押します。
個別クラスの場合、挿入ポイントがコード内の参照されているクラス名内にあるときに Alt-Shift-I キー (「高速インポート」) を押します。
クラス名の入力にコード補完を使用する場合は、必要なインポート文が自動的に追加されます。カスタマイズされたコードテンプレートを使用するために、コード補完を使用することもできます。カスタムコードテンプレートの変数を変更し、そのテンプレートの使用時に必須のインポート文を追加できます。
IDE のエディタヒントとして提案された場合は、余白の電球アイコンをクリックすることで、提案されたインポート文を追加できます。

IDE の「インポートを修正」コマンドを使用すると、コードに必要なインポート文が追加され、不要なインポート文が削除されます。ただし、このコマンドでは、コードから完全限定クラス名が削除され、インポート文に置き換えられることはありません。これに対し、「高速インポート」コマンドでは、コードでのインポートの処理方法を選択することができます。

IDE の「高速インポート」コマンドでは、次の処理が可能です。

クラスのインポート文を生成する。
パッケージのインポート文を生成する。
コードに完全修飾名を生成する。

Java ソースコードのフォーマット

IDE は、コードの入力が行われると、自動的にフォーマットします。コードの特定の行またはファイル全体を再フォーマットすることもできます。次の表は、一般的なフォーマットコマンドをまとめたものです。

キーボードショートカット	コマンドの説明
Ctrl-Shift-F	ファイル全体またはソースエディタで選択されているテキストを再フォーマットします。
Ctrl-T	現在の行または選択をタブ 1 個分、右にシフトします。
Ctrl-D	現在の行または選択をタブ 1 個分、左にシフトします。
Ctrl-E	現在の行を削除します。
Ctrl-Shift-T	行コメント ("//") を使用し、現在の行または選択されているすべての行をコメントアウトします。
Ctrl-Shift-D	コメントを削除します。このコマンドは、行コメント ("//") で始まる行にのみ作用します。

ソースエディタのナビゲーション

大量のファイルを扱う場合は、生産性の点で、ソースファイル内やソースファイル間をすばやく移動する機能が不可欠です。ソースエディタでドキュメントを処理しているときは、ドキュメント間のジャンプと同様に、現在選択している要素に応じてドキュメント内の要素にすばやくジャンプできるコマンドが「ナビゲート」メニューにあります。

Java ファイル内のナビゲーション

IDE には、指定された Java ファイルを簡単に表示および移動できる次の複数の機能が用意されています。

「ナビゲータ」ウィンドウ。「ナビゲータ」ウィンドウは、「プロジェクト」ウィンドウの下で、現在選択されている Java ファイル内のメンバー (コンストラクタ、フィールド、メソッドなど) のリストを表示します。要素をクリックすると、ソースエディタでその要素が含まれる行に挿入ポイントが配置されます。
ブックマーク。ファイルの特定位置に簡単にジャンプできるように、ソースファイルでブックマークを作成できます。ブックマークのオン/オフを切り替えるには、ファイルの余白部分でその行を右クリックするか、「ナビゲート」メニューの「ブックマークの切り替え」(Ctrl-F2) を選択します。以前に挿入ポイントが置かれた位置へ移動することができます。移動するには、キーボードショートカットの Alt-K キーまたは Alt-L キーを使用するか、「ナビゲート」メニューの「戻る」または「進む」を選択します。
「ナビゲート」メニュー。コード内の要素間をすばやく移動するためのコマンドにアクセスするには、「ナビゲート」メニューを使用します。

次の表は、「ナビゲート」メニューにある一部のコマンドのショートカットをまとめています。

キーボードショートカット	コマンドの説明
Alt-Shift-O	クラスへ移動。すばやくファイルを開くことが可能な「クラスへ移動」ダイアログを開きます。ダイアログでクラス名の入力を開始すると、接頭辞としてその文字列を持つすべてのファイルが表示されます。
Alt-O	ソースへ。現在選択されているクラス、メソッド、またはフィールドのソースが利用可能な場合は、そのソースコードに移動します。Ctrl キーを押しながら、マウスポインタを識別子の上に移動し、識別子に青色の下線が表示されたらクリックする方法もあります。
Alt-G	宣言へ移動。直前のショートカットに似ていますが、これは、挿入ポイント位置の変数が宣言されているファイルを開きます。
Ctrl-B	スーパークラスの実装へ移動。現在選択されているメソッドのスーパークラスの実装に移動します (選択されたメソッドが別のクラスからのメソッドをオーバーライドする場合、またはインタフェースで定義されたメソッドの実装である場合)。
Alt-L	進む。現在選択されているファイルのジャンプリスト内の次の位置に移動します。ジャンプリストとは、エディタで変更したすべての位置の履歴です。
Alt-K	戻る。現在選択されているファイルのジャンプリスト内の前の位置に移動します。
Ctrl-G	行へ移動。現在のファイルの任意の行番号を入力して Enter キーを押すと、その行にジャンプします。
Ctrl-F2	ブックマークの切り替え。挿入ポイントが現在置かれているコード行にブックマーク (ブックマークのアイコン) を追加します。その行にすでにブックマークが含まれている場合は、そのブックマークが削除されます。
F2	次のブックマーク。次のブックマークに移動します。
Shift-F2	前のブックマーク。前のブックマークに移動します。
Alt-Shift-L	すべてのファイル (現在選択されているファイルは除く) で、ジャンプリスト内の次の位置に移動します。
Alt-Shift-K	すべてのファイル (現在選択されているファイルは除く) で、ジャンプリスト内の前の位置に移動します。

検索および選択ツール

次の表は、ソースエディタで利用できる検索および選択ツールを簡単にまとめたものです。

キーボードショートカット	コマンドの説明
Ctrl-Shift-0	「検索結果」ウィンドウに切り替えます。
Ctrl-Shift-P	プロジェクト内を検索。
Ctrl-F	現在選択されているファイルで文字列を検索します。ソースエディタは最初に一致した検索文字列にジャンプし、一致した文字列をすべて強調表示します。
Ctrl-H	現在選択されているファイルでテキストを置換します。
F3	検索した単語に一致する文字列を順方向に検索します。
Shift-F3	検索した単語に一致する文字列を逆方向に検索します。
Ctrl-F3	挿入ポイントが置かれている単語に一致する文字列を順方向に検索します。
Alt-Shift-H	検索結果の強調表示のオンとオフを切り替えます。

ドキュメント間のナビゲーション

ソースエディタでは、一度に開いた多数のドキュメントを容易に管理できます。IDE のツールバーのすぐ下の領域に、開いているドキュメントごとにタブがあります。これらのタブは、ドキュメントを開いた順序で表示されますが、タブの位置は、タブをつかんで別の位置にドラッグするだけで変更できます。右上隅の左および右ボタンを使用し、タブの並びをスクロールすることができます。

開かれているファイルを切り替えるには、次のいずれかを行います。

ソースエディタの右上のドロップダウンリストを使用します。このドロップダウンリストは、開かれているすべてのファイルのアルファベット順の一覧です。
Alt-Left キーまたは Alt-Right キーを押します。エディタのタブがそれぞれ左または右に移動します。
Ctrl-Tab キーを押し、IDE ウィンドウマネージャーを開きます。IDE ウィンドウマネージャーには、「プロジェクト」ウィンドウのような開かれているすべてのウィンドウだけでなく、ソースエディタで開かれているドキュメントのアイコンも含まれます。

IDE には、このほかにドキュメントを操作する次の便利な機能があります。

クラスへ移動。「ナビゲート」メニューの「クラスへ移動」を選択すると、名前でクラスをすばやく検索できるダイアログが開きます。クラスを選択すると、ソースエディタでソースファイルが開きます。
ソースエディタを最大化。ドキュメントのタブをダブルクリックするか、Shift-Escape キーを押すと、ほかのすべての IDE ウィンドウが隠されます。ソースエディタを分割していた場合は、最大化した区画のみ表示されます。
ドキュメントのクローン作成。ソースエディタ内でドキュメントのタブを右クリックし、「ドキュメントをクローン」を選択します。2 つの区画に同じドキュメントが表示されます。
ソースエディタの分割。ドキュメントのタブをつかんで、ソースエディタの左または下マージンにドラッグします。ドキュメントをドロップしたときに新しいソースエディタ区画が作成される場所が、赤いボックスで示されます。ソースエディタの区画も、何回でも分割できます。
ソースエディタ区画間のドキュメントの移動。ドキュメントのタブをつかんで、受け側区画のタブの並びにドラッグします。

エディタの設定

ソースエディタの設定は、「オプション」ウィンドウの左の区画で「エディタ」または「フォントと色」を選択して設定します。変更するエディタの設定を選択するには、タブを使用します。一部のエディタ設定は、ファイルの種類に応じて変更できます。ここでは、Java エディタの設定を取り上げますが、設定の多くはすべてのエディタに共通です。

ソースエディタに対する一般的なカスタマイズの概要を次に示します。

コードテンプレートの表示と変更。コードテンプレートを表示または変更するには、「オプション」ウィンドウの左区画で「エディタ」を選択し、次に「コードテンプレート」タブをクリックします。ドロップダウンメニューから言語を選択して、エディタを選択します。たとえば Java エディタで使用するコードテンプレートを変更するには、ドロップダウンメニューから「Java」を選択します。これで、Java ファイルの編集時に使用可能な省略名を追加、削除、または変更できます。コードテンプレートの省略名を変更するには、その省略名を選択し、「展開されるテキスト」フィールドのテキストを編集します。
記録された全マクロの表示と変更。「マクロ」タブをクリックして、マクロを追加、変更、および削除します。「マクロコード」領域にマクロのコードを入力します。
コードで使用する インデント設定の変更。「インデント設定」タブをクリックして、インデントのプロパティーを変更します。
コード補完の無効。コード補完を無効にするには、「オプション」ウィンドウの左区画で「エディタ」を選択し、次に「一般」タブをクリックして「補完ウィンドウの自動ポップアップ」プロパティーのチェックボックスを選択解除します。
フォントと色の変更。「オプション」ウィンドウを使用して、コードのフォントサイズと色を設定します。「オプション」ウィンドウの左区画で「フォントと色」を選択し、「構文」タブをクリックします。「言語」ドロップダウンメニューから「すべての言語」を選択し、要素の種類として「デフォルト」を選択し、「フォント」プロパティーを変更することで、ソースエディタ内のすべてのテキストに対するフォントのサイズを変更します。ドロップダウンメニューから特定の言語を選択することで、変更内容をその言語に限定したり、言語固有の設定を変更したりすることもできます。たとえば「言語」ドロップダウンメニューから「Java」を選択し、カテゴリを選択することで、各種の Java コード (メソッド名や文字列など) のフォントと色を変更できます。