NetBeans IDE 4.0 クイックスタートガイド (Web アプリケーション)
| サンプルプロジェクト |
| IDE には、Web アプリケーションおよび J2SE のサンプルプロジェクトが用意されています。IDE で「ファイル」>「新規プロジェクト」を選択して、「サンプル」フォルダを参照してください。 |
このドキュメントでは、NetBeans IDE 4.0 を使用して Web アプリケーションを開発する基本的な手順を学ぶことができます。このドキュメントは、できるだけ素早く作業を進められるように作られています。NetBeans IDE の使用に関する詳細は、NetBeans Web サイトの「Support and Docs」ページをご覧ください。
単純な Web アプリケーションを作成、配備、実行します。このアプリケーションは JavaServer Pages[tm] ページを使用して、名前の入力を求めます。続いて、JavaBeans[tm] コンポーネントを使用して、HTTP セッション中その名前を維持し、別の JavaServer Pages ページにその名前を繰り返します。
プロジェクトの作成と準備
| Web アプリケーションの新規作成 |
- 「ファイル」>「新規プロジェクト」を選択します。「カテゴリ」で「Web」を選択します。「プロジェクト」で「Web アプリケーション」を選択して、「次へ」をクリックします。
- 「プロジェクト名」に HelloWeb と入力します。「プロジェクトの場所」を使用コンピュータ上の任意のフォルダに変更します。以降、このドキュメントでは、このディレクトリを $PROJECTHOME と表記します。
- 「主プロジェクトとして設定」チェックボックスがすでに選択されていることを確認します。「コンテキストパス」が /HelloWeb になっていることに注意してください。
- 「完了」をクリックします。これで、$PROJECTHOME/HelloWeb プロジェクトフォルダが作成されます。このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれています。IDE で HellowWeb プロジェクトが開きます。「プロパティ」ウィンドウでプロジェクトの論理構造、「ファイル」ウィンドウでそのファイル構造を見ることができます。
|
Java ソースコードの作成と編集
| Java パッケージと JavaBean コンポーネントの作成 |
- 「HelloWeb」プロジェクトノード、「ソースパッケージ」ノードを順に展開します。「ソースパッケージ」ノードには、空のデフォルトパッケージノードだけ含まれていることに注意してください。
- 「ソースパッケージ」ノードを右クリックして、「新規」>「ファイル / フォルダ」を選択します。「カテゴリ」で「JavaBeans オブジェクト」を選択します。「ファイルの種類」で「JavaBeans コンポーネント」を選択して、「次へ」をクリックします。「クラス名」テキストボックスに NameHandler と入力し、「パッケージ」コンボボックスに org.me.hello と入力して、「完了」をクリックします。
|
|
JavaBean コンポーネントの編集
|
- 「NameHandler.java」ノードを展開して、「NameHandler」クラスノードをダブルクリックします。ソースエディタで、このクラス宣言の次の部分を削除します。
extends Object implements Serializable
- 「NameHandler」クラスノード、「フィールド」ノードを順に展開します。3 つのデフォルトフィールドが提供されています。「PROP_SAMPLE_PROPERTY」フィールドを右クリックし、コンテキストメニューから「削除」を選択します。残りの 2 つのフィールドについても同じことを繰り返します。ソースエディタで、削除したフィールドを使用しているコードの行に下線が付いていることに注意してください。
- 「メソッド」ノードを展開して、すべてのデフォルトメソッドを削除します。
- ソースエディタで、クラス宣言のすぐ下の行 16 の位置に次のコードを入力します。
String name;
- 「コンストラクタ」ノードを展開して、NameHandler コンストラクタをダブルクリックします。ソースエディタで、行 18 の位置にある、NameHandler() コンストラクタのデフォルトコード (propertySupport = new PropertyChangeSupport(this);) を次の行に置き換えます。
name = null;
- ソースエディタで Alt-Shift-F キーを押して、インポート文を更新します。必要なものの指定だけコードに残ります。
|
リファクタリング
| フィールド名の変更 |
- フィールド宣言の行 15 の位置にある単語 name を右クリックして、「リファクタリング」>「名前を変更」を選択します。
- 「新しい名前」フィールドに username と入力し、「次へ」をクリックします。
「リファクタリング」ウィンドウに、新しい名前をしたフィールドを指し示すように変更されるすべての参照が表示されます。任意の参照をダブルクリックすると、ソースエディタ内の該当する場所にジャンプします。参照のチェックボックスを選択解除することによって、その参照をリファクタリング対象から除外することもできます。
- 「リファクタリングの実行」をクリックします。選択されているすべてのフィールド参照の名前が変更されます。
|
| 取得メソッドと設定メソッドの生成 |
- フィールド宣言の行 15 の位置にある単語 username を右クリックして、「リファクタリング」>「フィールドをカプセル化」を選択します。「次へ」をクリックして、デフォルトのオプションでコマンドを実行します。
- 「リファクタリングの実行」をクリックします。「username」フィールド用の取得および設定メソッドが生成され、そのアクセスレベルが private に変更されます。これで、JavaBean コンポーネントは以下のようになります。
package org.me.hello;
public class NameHandler {
private String username;
public NameHandler() {
setUsername(null);
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
}
|
JavaServer Pages ファイルの作成と編集
| デフォルトの JavaServer Pages ファイルの編集 |
- 「HelloWeb」プロジェクトノード、「Web ページ」ノードを順に展開します。IDE によって、デフォルトの JavaServer Pages ページ index.jsp が自動的に作成されていることに注意してください。
- index.jsp をダブルクリックします。ソースエディタにファイルの内容が表示されます。
- index.jsp の本体に次のコードを入力またはコピーして、デフォルトの <body> タグとその内容を置き換えます。
<body>
<form method="post" action="response.jsp">
Enter your name: <input type="text" name="username">
<br>
<input type="submit" value="Ok">
</form>
</body>
|
| JavaServer Pages ファイルの作成 |
- 「HelloWeb」プロジェクトノード、「Web ページ」ノードを順に展開します。
- 「Web ページ」ノードを右クリックして、「新規」>「JSP」を選択し、JavaServer Pages ファイルに response という名前を指定して、「完了」をクリックします。ソースエディタに response.jsp が表示されます。
- <body> タグの下の行 6 の位置に <jsp:u と入力します。しばらくするとコード補完ボックスが現れます。ポップアップ形式の Javadoc で <jsp:useBean> 構文を確認します。ボックスが表示されない場合は、Ctrl キーを押しながらスペースキーを押します。Enter キーを押します。
- スペースキーを押します。<jsp:useBean> に適用可能なすべての変数が表示されます。id を選択して、引用符の間に mybean と入力します。
- 最後の引用符の後でスペースキーを押して、class を選択します。引用符の間で Ctrl キーを押しながら、スペースキーを押して、コード補完ボックスを開きます。プロジェクトのコンパイル時クラスパス上にあるすべてのパッケージおよびクラスについてコード補完を利用できます。org を選択して Enter キーを押します。
- org の後にピリオドを 1 つ入力し、Ctrl キーを押しながら、スペースキーを押します。再びコード補完ボックスが開きます。me を選択して、コード補完を利用しながら、行が次のようになるまで編集を続けます。
<jsp:useBean id="mybean" class="org.me.hello.NameHandler" />
- response.jsp 本体にある <jsp:useBean> タグのすぐ下に次のコードを入力またはコピーします。
<jsp:setProperty name="mybean" property="*" />
<h1>Hello, <jsp:getProperty name="mybean" property="username" />!</h1>
|
プロジェクトのコンパイルと実行
| プロジェクトの構築 |
- 「構築」>「主プロジェクトを構築」(F11) を選択します。HelloWeb プロジェクトが構築されます。
|
|
主プロジェクトの実行
|
- 「実行」メニューから「実行」>「主プロジェクトを実行」(F6) を選択します。すべての出力が見られるように、「出力」ウィンドウのタイトルバーをダブルクリックして最大表示にします。Ant によって HelloWeb.war がまず構築され、その後で、そのファイルを使用する HelloWeb がコンパイルされることに注意してください。最終的には、この Web アプリケーションは、デフォルトサーバーに配備されます。「出力」ウィンドウのタイトルバーを再びダブルクリックして、アイコン化します。
- 配備された index.jsp ページのテキストボックスに自分の名前を入力して、「OK」をクリックします。 response.jsp ページが開いて、挨拶メッセージが表示されます。
- 「ファイル」ウィンドウを選択して、「HelloWeb」プロジェクトノードを展開します。構築で作成されたクラスファイルは build フォルダにあります。構築で作成された WAR ファイルは dist フォルダにあります。
- F6 キーを押して、プログラムを再実行します。新しくコンパイルする必要があるものは何もなく、単にプログラムが実行されます。
|
| Javadoc の生成 |
- プロジェクトのノードを右クリックして、「プロジェクトの Javadoc を生成」を選択します。「出力」ウィンドウに Javadoc 出力が表示され、Web ブラウザが開いて Javadoc が表示されます。
|
プロジェクトのデバッグ
| プロジェクトのデバッグ |
- ソースエディタで「NameHandler.java」タブを選択し、NameHandler コンストラクタにある setUsername(null); 内にキャレット置いて、Alt-G キーを押します。キャレットが setUsername メソッドにジャンプします。
setUsername メソッドにある this.username=username; 内の任意の場所にキャレットを置き、Ctrl-F8 キーを押すことによって、ブレークポイントを設定します。- 「実行」>「主プロジェクトをデバッグ」(F5) を選択します。デバッガのウィンドウが開きます。
- 自分の名前を入力します。ブレークポイントに達するまで、デバッガでプロジェクトが実行されます。
- ツールバーで「継続」(Ctrl-F5) を選択してプログラムをステップ実行し、形成される名前を観察します。プログラムが終了するとデバッガウィンドウが閉じます。
|
構築プロセスのカスタマイズ
| Ant プロパティの設定変更 |
- 「ファイル」ウィンドウで「HellowWeb」プロジェクトノード、「nbproject」フォルダを順に展開します。
- project.properties をダブルクリックして、プロジェクト用に IDE が生成したすべての Ant プロパティを表示します。
- build.dir=build が含まれている行をコピーします。このプロパティは、コンパイルされたクラスの出力ディレクトリの設定です。
- 「ファイル」ウィンドウで「private」フォルダを展開して、private.properties をダブルクリックします。
- build.dir=build プロパティをファイルにペーストします。プロパティが build.dir=build/production に変更されます。
- 「構築」>「主プロジェクトの生成物を削除して構築」(Shift-F11) を選択します。構築で作成されたクラスは build/production フォルダに作成されます。
|
|
VM 引数の設定
|
- private.properties ファイルを開きます。
- ファイル内の任意の場所に新しい行を挿入し、run.jvmargs=-J-Xms24m -J-Xmx160m と入力して、「ファイル」>「保存」を選択します。指定されたヒープサイズと最大メモリーサイズでプロジェクトが実行されます。
|
| Ant ターゲットの追加 |
- 「ファイル」ウィンドウで HelloWeb プロジェクトの「nbproject」フォルダに移動します。
- build-impl.xml をダブルクリックすることによって、ソースエディタでファイルを開きます。このファイルには、IDE によって生成されたすべての Ant ターゲットが含まれています。1 つのターゲットには、-pre ターゲットと -post ターゲットが 1 つずつあり、これらのターゲットを使用して、そのターゲットを実行する前または後に IDE が実行する処理命令を追加することができます。このファイル内のターゲットは変更しないでください。このファイルは IDE によって自動的に生成され、変更してもその変更内容はすべて失われます。
- 「ファイル」ウィンドウで「HelloWeb」プロジェクトフォルダに移動し、build.xml をダブルクリックします。build-impl.xml にあるターゲットの設定変更は、このファイルで行います。
|
次のステップ
| Coin Flip Tutorial |
このチュートリアルは、JavaServer Pages ページと JavaBean コンポーネント、Java サーブレット間で対話を行う Web アプリケーションを作成する方法を学ぶことができます。
|
| Midnight Cookie Company チュートリアル |
このチュートリアルでは、JavaServer Pages ページと Java サーブレットを含み、JSTL タグライブラリのタグを使用する Web アプリケーションを構築、配備、実行する方法を学ぶことができます。また、HTTP モニターを利用して、サーバーと Web ブラウザ間の要求と応答を表示する方法も紹介しています。
|
