次の手順で waitscreenexample サンプルアプリケーションをインストールします。

1. WaitScreenExample.zip をダウンロードします。
2. ファイルを展開します。
3. IDE で、「ファイル」>「プロジェクトを開く」を選択し、展開したファイルがあるフォルダを選択します。
4. 「プロジェクトを開く」をクリックします。
   「プロジェクト」ビューは次のように表示されるはずです。

   

5. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「実行」を選択します (または F6 キーを押す)。アプリケーションが実行されると、エミュレータウィンドウが開き、デフォルトのデバイスエミュレータでアプリケーションが実行されるところが表示されます。
6. 「エミュレータ」ウィンドウで「起動」の下のボタンをクリックします。エミュレータに NetBeans Web サイトの URL アドレスである http://netbeans.org が表示されます。
7. 「OK」の下のボタンをクリックします。通信時間を使用してよいかどうかを尋ねる画面が表示されます。
8. 「Yes」の下のボタンをクリックして続行します。エミュレータで Web サイトへの接続が試行され、待機画面が表示されます。

   

9. エミュレータを接続したら、アプリケーションを閉じます。

待機画面コンポーネントが動作するところを確認できたので、最初に戻ってこのアプリケーションを作成します。アプリケーションを作成するには、次の手順を実行します。

1. WaitScreenExample プロジェクトの作成
2. MyWaitScreen プロジェクトへのパッケージとビジュアル MIDlet の追加
3. MyWaitScreenMIDlet へのコンポーネントの追加
4. 画像リソースの追加
5. 了解コマンド、戻るコマンド、および終了コマンドをテキストボックスコンポーネントと待機画面コンポーネントに追加
6. アプリケーションフローを作成
7. 待機画面のバックグラウンドタスクの作成
8. プロジェクトを実行する

注: このプロジェクトを作成する前に、前の手順で実行した WaitScreenExample のサンプルプロジェクトを必ず終了または削除してください。NetBeans IDE では、同じ名前のプロジェクトを同時に開くことはできません。

WaitScreenExample プロジェクトの作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」から「Java ME」を選択します。「プロジェクト」で「モバイルアプリケーション」を選択して、「次へ」をクリックします。
2. 「プロジェクト名」フィールドに「WaitScreenExample」と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。このディレクトリを $PROJECTHOME とします。
3. 「Hello MIDlet を作成」チェックボックスの選択を解除します。「次へ」をクリックします。
4. 「エミュレータプラットフォーム」は、「Sun Java Wireless Toolkit 2.5.2」を選択したままにしておきます。「完了」をクリックします。

WaitScreenExample プロジェクトへのパッケージとビジュアル MIDlet の追加

1. 「プロジェクト」ウィンドウで WaitScreenExample プロジェクトを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」から「Java」を選択します。「ファイルの種類」として「Java パッケージ」を選択します。「次へ」をクリックします。
2. 「パッケージ名」フィールドに「waitscreenexample」と入力します。「完了」をクリックします。
3. 「プロジェクト」ウィンドウで waitscreenexample パッケージを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」にある「MIDP」を選択します。「ファイルの種類」として「ビジュアル MIDIlet」を選択します。「次へ」をクリックします。
4. 「MIDlet 名」フィールドと「MIDP クラス名」フィールドに「MyWaitScreenMidlet」と入力します。「完了」をクリックします。

MyWaitScreenMidlet へのコンポーネントの追加

「ビジュアル MIDlet」を選択してビジュアルモバイルデザイナ (VMD) を開きます。VMD ウィンドウ最上部の「フロー」ビューをクリックしてフローデザイナを開き、ここでアプリケーションフローを設計します。

1. ビジュアル MIDlet を「フロー」ビューに切り替えます。次の画面コンポーネントをコンポーネントパレットからドラッグし、フローデザイナにドロップします。
   • テキストボックス
   • 待機画面
   • リスト
   • 警告
2. 「textBox」を選択します。コンポーネントパレットの下の「プロパティー」ウィンドウで、「タイトル」プロパティーを「Text Box」に変更します。
3. 次のコンポーネントに対し、同じ操作を実行してタイトルを変更します。
   • waitScreen を「Wait Screen」に変更
   • list を「List」に変更
   • alert を「Alert」に変更
4. 次の各コンポーネントに対して、プロパティーの値を使用します。
   • textBox のテキストプロパティーを「http://netbeans.org」に変更
   • alert の文字列プロパティーを「Connection Failed」に変更
   • WaitScreen のテキストプロパティーを「Please Wait...」に変更

「フロー」ビューは、次の画像のように表示されるはずです。

画像リソースの追加

このセクションでは、待機画面と警告画面に使用する画像を追加します。

1. alert.png ファイルと sandglass.png ファイルをダウンロードして $PROJECTHOME/src/waitscreenexample フォルダにコピーします。
2. alert コンポーネントを右クリックし、ポップアップメニューから「プロパティー」を選択します。
3. 「プロパティー」ダイアログボックスで、「画像」プロパティーの省略符号ボタン () をクリックします。
4. 「画像」ダイアログで「追加」をクリックします。
   image1 コンポーネントが追加されます。
5. 「参照」をクリックし、「開く」ダイアログボックスで、コピーされた alert.png ファイルへのパスを指定します。
6. 「開く」をクリックします。
   画像が追加されます。
7. 「了解」をクリックして「画像」ダイアログボックスを閉じます。
8. 「閉じる」をクリックして「プロパティー」ダイアログボックスを閉じます。
   alert.png の画像は alert コンポーネントにバインドされます。
9. waitScreen コンポーネントについて、手順 2 から 8 を繰り返し、sandglass.png を image2 として追加し、これをコンポーネントにバインドします。

了解コマンド、戻るコマンド、および終了コマンドをテキストボックスコンポーネントと待機画面コンポーネントに追加

1. パレットの「コマンド」セクションで了解コマンドを選択します。これを textBox にドラッグ＆ドロップします。
2. パレットの「コマンド」セクションで戻るコマンドを選択します。これを list にドラッグ＆ドロップします。
3. パレットの「コマンド」セクションで終了コマンドを選択します。これを list にドラッグ＆ドロップします。

アプリケーションフローの作成

これで、アプリケーションフローを作成する準備ができました。

1. 「フロー」ビューで、モバイルデバイスの「起動」をクリックし、それを textBox コンポーネントまでドラッグします。
2. 同様に、次の図に示すようにコンポーネントを接続します。

   

待機画面のバックグラウンドタスクの作成

1. 「フロー」ビューで、waitScreen コンポーネントを右クリックし、ポップアップメニューから「プロパティー」を選択します。
2. 「プロパティー」ダイアログボックスで、「タスク」ドロップダウンメニューから <NewCancellableTask> を選択し、「閉じる」をクリックします。
   これで、simpleCancellableTask が waitScreen コンポーネントのバックグラウンドタスクになりました。
3. ビジュアルモバイルデザイナの最上部にある「ソース」ボタンをクリックして、アプリケーションのソースコードに切り替えます。
4. MyWaitScreenMIDlet ソースコードの public void destroyapp(boolean unconditional) { } のあとに次のコードをペーストすることによって、バックグラウンドタスク用のメソッドを追加します。

         private void getServerInfo() throws IOException {
         String url = textBox.getString();
         list.deleteAll();
         /**
         * HttpConnection を開く
         */ 
         HttpConnection hc = (HttpConnection) Connector.open(url);
   
         /**
         * 索引でヘッダーフィールドキーとヘッダーフィールドを
         * 取得し、list に挿入する。
         */
         list.setTitle(hc.getURL());   
         for (int i=0;hc.getHeaderFieldKey(i)!=null; i++){
         list.insert(i,hc.getHeaderFieldKey(i)+" :"+hc.getHeaderField(i),null);       
         }     
         /**
         * 終了時 ...
         */
         hc.close();
         } 
   

5. ソースコードを右クリックし、ポップアップメニューで「インポートを修正」を選択します (または、Ctrl+Shift+I キーを押します)。
6. public class MyWaitScreenMidlet extends MIDlet implements CommandListener { 文字列 (18 行目) を見つけ、final を挿入すると、次のようになります。

    public final class MyWaitScreenMidlet extends MIDlet implements CommandListener {

7. ソースコードから public MyWaitScreenMidlet() メソッドを見つけ (38 行目)、public MyWaitScreenMidlet() { のあとに次のコードを挿入します。
   

    List list1 = getList();

8. 「画面」をクリックして「画面」ビューに切り替え、SimpleCancellableTask を選択します。
9. 「プロパティー」ウィンドウで、「実行可能コード」プロパティーの省略符号ボタン () をクリックします。
10. 「実行可能コード」ダイアログボックスで「ソースへ移動」をクリックします。
11. ソースコードから getSimpleCancellableTask() メソッドを見つけ (328 行目)、public void execute() throws Exception { のあとの // write task-execution user code here という場所に次のコードを挿入します。
    

     getServerInfo();

プロジェクトの実行

F6 キーを押して主プロジェクトを実行します。

「実行」>「主プロジェクトを実行」を選択する方法もあります。

待機画面コンポーネントと簡易取消可能タスクコンポーネントの Javadoc

NetBeans IDE には、VMD で使用できるほかのコンポーネントと同様に、待機画面コンポーネントや簡易取消可能タスクコンポーネントに関する API Javadoc が用意されています。待機画面コンポーネントおよび簡易取消可能タスクコンポーネントの Javadoc を表示するには、次の手順を実行します。

1. ソースコードの待機画面コンポーネントまたは簡易取消可能タスクコンポーネントにカーソルを合わせ、Ctr-Shift- スペースキーを押します (または「ソース」>「ドキュメントを表示」を選択します)。
   この要素の Javadoc がポップアップウィンドウに表示されます。
2. ポップアップウィンドウで「外部 Web ブラウザにドキュメントを表示」アイコン () をクリックすると、待機画面コンポーネントまたは簡易取消可能タスクコンポーネントについての詳細な情報がブラウザに表示されます。