ビジュアルモバイルデザイナのカスタムコンポーネント: モバイルデバイスのファイルブラウザの作成
ビジュアルモバイルデザイナ (VMD) は NetBeans Mobility に含まれるグラフィカルインタフェースで、コンポーネントのドラッグ＆ドロップを使用することでモバイルアプリケーションをデザインできます。VMD を使用すると、IDE に含まれるコンポーネントまたは独自にデザインしたコンポーネントを使用して、アプリケーションフローを定義し、GUI をデザインできます。VMD には、リスト、警告、フォーム、画像など、アプリケーションの作成に使用できる標準のユーザーインタフェース (UI) コンポーネントが多数含まれます。また、待機画面、スプラッシュ画面、表項目など、より複雑な機能を簡単に作成できるカスタムコンポーネントも含まれます。
ファイルブラウザは、デバイスのファイルシステムを操作するためのユーザーインタフェースを備えたカスタムコンポーネントです。デバイスの記憶領域の内容を表示するための基本的な機能を備えています。このコンポーネントでは、JSR-75 (PDA Optional Packages for the Java ME Platform) 仕様の一部である FileConnection API が使用されます。JSR-75 は MIDP 2.0 仕様の一部ではないので、このカスタムコンポーネントは JSR-75 対応のデバイスだけに使用できます。
このチュートリアルでは、JSR-75 対応デバイス用モバイルアプリケーションでファイルブラウザコンポーネントを使用する方法を示します。各コンポーネントの基本機能、デバイスの記憶領域の内容を参照する方法、および選択されたテキストファイルの内容を表示する方法を学びます。「ファイルブラウザ」カスタムコンポーネントのほかに、スプラッシュ画面とテキストボックスの 2 つの MIDP コンポーネントを使用します。
目次
このチュートリアルに従うには、次に示すソフトウェアとリソースが必要です。
サンプルアプリケーションのインストールと実行
始める前に、チュートリアルの最終結果を確認します。
次の手順で FileBrowserExample アプリケーションをインストールします。
- filebrowserexample.zip をダウンロードします。
- ファイルを展開します。
- IDE で、「ファイル」>「プロジェクトを開く」を選択し、FileBrowserExample プロジェクトの展開したファイルがあるフォルダを参照します。
- 「プロジェクトを開く」をクリックします。
「プロジェクト」ウィンドウは次のようになります。
- 「プロジェクト」ウィンドウで、プロジェクトノードを右クリックし、「プロジェクトを実行」を選択します (または F6 キーを押す)。アプリケーションが実行されると、エミュレータウィンドウが開き、デフォルトのデバイスエミュレータでアプリケーションが実行されるところが表示されます。
- 「エミュレータ」ウィンドウで「起動」の下のボタンをクリックします。
エミュレータにスプラッシュ画面コンポーネントが表示されてから、次に示すファイルブラウザが表示されます。
- 使用可能なファイルやフォルダ間を移動するにはカーソルを上下に移動します。
- フォルダまたはファイルを開くには、「Select」の下のボタンをクリックします。
- アプリケーションを終了するには、「Exit」の下のボタンをクリックします。
ページの先頭へ
「ファイルブラウザ」カスタムコンポーネントを使用したアプリケーションの作成
ファイルブラウザコンポーネントが実際に動作するところを確認できたので、最初に戻ってこのアプリケーションを作成します。アプリケーションを作成するには、次の手順を実行します。
- FileBrowserExample プロジェクトを作成する
- FileBrowserExample プロジェクトにパッケージとビジュアル MIDlet を追加する
- FileBrowserExample にコンポーネントを追加する
- テキストボックスとファイルブラウザの各コンポーネントにコマンドを追加する
- コンポーネントを接続してアプリケーションフローを作成
- メソッド loadTextFile をソースコードに挿入する
- プロジェクトを実行する
FileBrowserExample プロジェクトの作成
- 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」で「JavaME」を選択します。「プロジェクト」で「モバイルアプリケーション」を選択して、「次へ」をクリックします。
- 「プロジェクト名」フィールドに
FileBrowserExample と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。以降、このディレクトリを $PROJECTHOME とします。
- 「Hello MIDlet を作成」チェックボックスの選択を解除します。「次へ」をクリックします。
- 「エミュレータプラットフォーム」は、「Sun Java Wireless Toolkit」を選択したままにしておきます。「次へ」をクリックします。
- 「完了」をクリックします。
注: このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。アプリケーション自体はビジュアルモバイルデザイナの「フローデザイン」ウィンドウに表示されます。
FileBrowserExample プロジェクトへのパッケージとビジュアル MIDlet の追加
- 「プロジェクト」ウィンドウで
FileBrowserExample プロジェクトを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」から「Java クラス」を選択します。「ファイルの種類」として「Java パッケージ」を選択します。「次へ」をクリックします。
- 「パッケージ名」フィールドに
filebrowserexample と入力します。「完了」をクリックします。
- 「プロジェクト」ウィンドウで
filebrowserexample パッケージを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」にある「MIDP」を選択します。「ファイルの種類」として「ビジュアル MIDIlet」を選択します。「次へ」をクリックします。
- 「MIDlet 名」フィールドと「MIDP クラス名」フィールドに
FileBrowserExample と入力します。「完了」をクリックします。
FileBrowserExample へのコンポーネントの追加
- ビジュアル MIDlet を「フローデザイナ」ウィンドウに切り替えます。次のコンポーネントをコンポーネントパレットからドラッグし、フローデザイナにドロップします。
- スプラッシュ画面
- テキストボックス
- ファイルブラウザ
- splashScreen をクリックし、「プロパティー」ウィンドウで「テキスト」プロパティーの値を「null」から「File Browser Example」に変更します。
FileBrowserExample へのコマンドの追加
- 「フローデザイナ」ウィンドウを開きます。
- コンポーネントパレットの「コマンド」セクションで終了コマンドを選択します。このコマンドをドラッグし、「フローデザイナ」ウィンドウ (fileBrowser コンポーネント) にドロップします。
- コンポーネントパレットの「コマンド」セクションで戻るコマンドを選択し、textBox コンポーネントにドラッグ＆ドロップします。
コンポーネントを接続してアプリケーションフローを作成する
「フロー」デザインウィンドウで、モバイルデバイスの「起動」をクリックし、splashScreen コンポーネントまでドラッグします。同様に、次の図に示すようにコンポーネントを接続します。
ソースコードへのアクション前コードの挿入
- 「ソース」ウィンドウに切り替えます。
-
ソースコードの末尾に次のコードを挿入します。このメソッドは、選択されたファイルを読み取ります。
/**
* Read file
*/
private void readFile() {
try {
FileConnection textFile = fileBrowser.getSelectedFile();
getTextBox().setString("");
InputStream fis = textFile.openInputStream();
byte[] b = new byte[1024];
int length = fis.read(b, 0, 1024);
fis.close();
if (length > 0) {
textBox.setString(new String(b, 0, length));
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
ソースコード内で commandAction メソッドを探します。
readFile(); を、FileBrowser.SELECT_FILE_COMMAND のアクション前セクション (if (command == FileBrowser.SELECT_FILE_COMMAND) の直後の //write pre-action code here とある箇所) に挿入します。
プロジェクトの実行
F6 キーを押して主プロジェクトを実行するか、「実行」>「主プロジェクトを実行」を選択します。
ページの先頭へ
ファイルブラウザコンポーネントの Javadoc
NetBeans IDE には、ファイルブラウザコンポーネントや、VMD で使用できるその他のコンポーネントに関する API Javadoc が用意されています。ファイルブラウザコンポーネントの Javadoc を表示するには、次の手順を実行します。
- ソースコードの FileBrowser コンポーネントにカーソルを合わせ、Ctr-Shift- スペースキーを押します (または「ソース」>「ドキュメントを表示」を選択します)。
この要素の Javadoc がポップアップウィンドウに表示されます。
- ポップアップウィンドウで「外部 Web ブラウザにドキュメントを表示」アイコン (
) をクリックすると、FileBrowser コンポーネントについての詳細な情報がブラウザに表示されます。
ページの先頭へ
関連項目
ページの先頭へ
