MIDP/CLDC アプリケーションの作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。 「カテゴリ」で「モバイル」を選択します。 「プロジェクト」で「モバイルアプリケーション」を選択し、「次へ」をクリックします。
2. 「プロジェクト名」フィールドに MyHello と入力します。 「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。 以降、この例では、このディレクトリを $PROJECTHOME とします。
3. 「主プロジェクトとして設定」と「Hello MIDlet を作成」の各チェックボックスを選択します (どちらもデフォルトで選択されています)。 「次へ」をクリックします。
4. 「エミュレータプラットフォーム」は、「J2ME Wireless Toolkit」を選択したままにしておきます。
5. 「完了」をクリックします。 $PROJECTHOME/MyHello プロジェクトフォルダが作成されます。 このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。
   アプリケーション自体はビジュアルモバイルデザイナーの「フローデザイン」ウィンドウに表示されます。

Java ソースコードの編集

ここで、MIDlet によって表示されるテキストを編集します。

1. 「スクリーンデザイン」をクリックします。
   「スクリーンデザイナ」ウィンドウが開き、アプリケーションの唯一の画面である「helloForm[フォーム]」画面が表示されます。
2. 「Hello world!」というテキストをダブルクリックし、新しく別のテキストを入力します。

プロジェクトのコンパイルと実行

1. 「実行」メニューから「実行」>「主プロジェクトを実行」(F6) を選択します。 出力がすべて見えるように、「出力」ウィンドウをダブルクリックして最大化します。 HelloMIDlet.java ファイルが構築されてから実行されます。 デバイスエミュレータが開いて、MIDlet の実行結果が表示されます。 デフォルトのデバイスエミュレータは DefaultColorPhone です。
2. デバイスエミュレータのウィンドウで、「選択」の下のボタンをクリックします。 デバイスエミュレータが MIDlet を起動し、ソースコードに入力されたテキストを表示します。
3. 「Exit」の下のボタンをクリックして、MIDlet を閉じます。 デバイスの右上隅のボタンをクリックして、エミュレータのウィンドウを閉じます。

Java ME MIDP プロジェクトの新規作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。 「カテゴリ」で「モバイル」を選択します。 「プロジェクト」で「モバイルアプリケーション」を選択し、「次へ」をクリックします。
2. 「プロジェクト名」フィールドに MyHelloMIDlet と入力します。 「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。 以降、この例では、このディレクトリを $PROJECTHOME とします。
3. 「主プロジェクトとして設定」チェックボックスを選択し、「Hello MIDlet を作成」チェックボックスを選択解除します。 「次へ」をクリックします。
4. 「エミュレータプラットフォーム」は、「J2ME Wireless Toolkit」を選択したままにしておきます。
5. 「完了」をクリックします。 $PROJECTHOME/MyHelloMIDlet プロジェクトフォルダが作成されます。 このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。
6. エクスプローラウィンドウで「MyHelloMIDlet」ノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。
7. 「カテゴリ」で「MIDP」を選択します。 「ファイルの種類」で「MIDlet」を選択します。 「次へ」をクリックします。
8. MIDlet 名として HelloMIDlet と入力します。 「完了」をクリックします。 HelloMIDlet.java ファイルが作成されます。
9. HelloMIDlet.java ファイルをダブルクリックしてエディタにソースコードを表示します。
10. ソースエディタ内をクリックして、次の部分を
    

    public class HelloMIDlet extends MIDlet

    
    次のように変更します。
    

    public class HelloMIDlet
                  extends MIDlet implements javax.microedition.lcdui.CommandListener
                  {

11. startApp() メソッドの前に次のテキストを追加します。
    

    public HelloMIDlet() {
    }
    private void initialize() {
      javax.microedition.lcdui.Display.getDisplay(this).setCurrent(get_helloTextBox());
    }
    
    public void commandAction(javax.microedition.lcdui.Command command, javax.microedition.lcdui.Displayable displayable) {
      
       if (displayable == helloTextBox) {
          if (command == exitCommand) {
             javax.microedition.lcdui.Display.getDisplay(this).setCurrent(null);
             destroyApp(true);
             notifyDestroyed();
          }
       }
    
    }
    
    private javax.microedition.lcdui.TextBox get_helloTextBox() {
       if (helloTextBox == null) {
           helloTextBox = new javax.microedition.lcdui.TextBox(null, "Test String", 120, 0x0);
           helloTextBox.addCommand(get_exitCommand());
           helloTextBox.setCommandListener(this);
       }
       return helloTextBox;
    }
    
    private javax.microedition.lcdui.Command get_exitCommand() {
       if (exitCommand == null) {
           exitCommand = new javax.microedition.lcdui.Command("Exit", javax.microedition.lcdui.Command.EXIT, 1);
      1);
       }
       return exitCommand;
    }
    
    javax.microedition.lcdui.TextBox helloTextBox;
    javax.microedition.lcdui.Command exitCommand;

12. 次のように startApp() メソッドに initialize(); 行を追加します。

      Public void startApp() {
       initialize();
        }

Java ソースコードの編集

MIDlet で表示するテキストを追加してみます。

1. get_helloTextBox() メソッドの「Test String」コードを任意のテキストに置き換えます。 たとえば、「Hello World」に置き換えます。

プロジェクトのコンパイルと実行

1. 「実行」メニューから「実行」>「主プロジェクトを実行」(F6) を選択します。 出力がすべて見えるように、「出力」ウィンドウをダブルクリックして最大化します。 HelloMIDlet.java ファイルが構築されてから実行されます。 デバイスエミュレータが開いて、MIDlet の実行結果が表示されます。 デフォルトのデバイスエミュレータは DefaultColorPhone です。
2. デバイスエミュレータのウィンドウで、「選択」の下のボタンをクリックします。 デバイスエミュレータが MIDlet を起動し、ソースコードに入力されたテキストを表示します。
3. 「Exit」の下のボタンをクリックして、MIDlet を閉じます。 デバイスの右上隅のボタンをクリックして、エミュレータのウィンドウを閉じます。

デフォルトのエミュレータデバイスの変更

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。 「プロパティー」ダイアログのカテゴリにある「プラットフォーム」ノードを選択します。 デフォルト構成のデバイスを変更できます。
2. 「デバイス」ドロップダウンリストをクリックして、「QwertyDevice」を選択します。 「了解」をクリックします。
3. 再びアプリケーションを実行すると、アプリケーションは QwertyDevice エミュレータで実行されます。

新しいエミュレータプラットフォームの追加

1. メインツールバーから「ツール」>「Java プラットフォームマネージャー」を選択します。
2. 「Java プラットフォームマネージャー」ダイアログで「プラットフォームを追加」ボタンをクリックします。
3. 「プラットフォームの種類を選択」ページで、「Java Micro Edition プラットフォームエミュレータ」を選択します。 「次へ」をクリックします。
   「プラットフォームのフォルダ」ページで、使用可能なすべての Java ME プラットフォームが IDE によって検索され、ウィンドウ内に一覧表示されます。 UEI (Unified Emulator Interface) 標準に準拠しているプラットフォームは、準拠していることが確認されると、プラットフォーム名の横にあるチェックボックスが選択された状態で表示されます。 UEI に準拠していないプラットフォーム、またはそれ以外の理由でインストールできない可能性のあるプラットフォームは、赤色で示されます。 このウィザードでは、すでにインストールされているプラットフォームも識別されます。
   
   注: UEI に準拠していないプラットフォームをインストールするには、「戻る」ボタンをクリックし、「カスタムの Java Micro Edition プラットフォームエミュレータ」を選択します。
4. 「プラットフォームのフォルダ」ページで、インストールするプラットフォームエミュレータの横のチェックボックスを選択します。 「完了」をクリックします。 「閉じる」をクリックします。
   選択したプラットフォームがインストールされます。
5. 「ファイル」>「"MyHello" プロパティー」を選択します。
6. 「プラットフォーム」ノードを選択し、「エミュレータプラットフォーム」ドロップダウンメニューから新しいエミュレータの名前 (J2ME Wireless Toolkit 2.2 など) を選択して、 「了解」をクリックします。

構成の追加

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。 「プロパティー」ダイアログにある「プロジェクト構成」ドロップダウンリストから「構成を追加」を選択します。 「プロジェクト構成の追加」ダイアログが開きます。
2. 「新規構成名」フィールドに、追加する構成の名前を入力します。 この構成用に作成する JAR/JAD の配備先のプラットフォームが分かる名前の使用を推奨します。 たとえば BlackWhiteDisplay を入力して、「了解」をクリックします。 これで、新しい構成が作成されます。
3. 構成は、「プロパティー」ダイアログにある「構成を管理」ボタンを使用して追加することもできます。 このボタンをクリックすると、構成を追加、削除、および複製するためのオプションを含む、「プロジェクト構成マネージャー」ダイアログが開きます。

構成のカスタマイズ

プロジェクトには、いくつでも構成を追加できます。 追加した個々の構成の設定は、「プロジェクトプロパティー」ダイアログで変更できます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。 「プロパティー」ダイアログのカテゴリにある「プラットフォーム」ノードを選択します。 「J2ME MIDP 構成」ダイアログが開きます。
2. 「プロパティー」ダイアログの一番上の「プロジェクト構成」コンボボックスから「BlackWhiteDisplay」構成を選択します。
3. 「プラットフォーム」ダイアログのコンポーネントはすべて無効になっています。 これは、現在のところ、この構成が、このパネル用の「デフォルト」構成の使用する値を採用しているためです。 パネルの一番上にある「"DefaultConfiguration" の値を使用」オプションを選択解除します。 これで、このパネルのすべてのコンポーネントが編集可能になります。
4. 「デバイス」オプションを「DefaultGrayPhone」に変更します。
5. 「プロパティー」ダイアログの一番上にある「プロジェクト構成」を切り替え、現在選択されている構成に基づいて「デバイス」オプションが変わることを確認します。 この構成のカスタマイズ方法は、ダイアログのすべてのパネル (「一般」パネルを除く) で機能します。 「了解」をクリックして、構成の変更を保存し、「プロパティー」ダイアログを閉じます。

アビリティーの作成

アビリティーを作成するときは、特定の属性または属性セットをサポートする 1 つ以上のプロジェクト構成に、そのアビリティーを関連付けます。 次に、属性をサポートする 1 つ以上のコードブロックに、そのアビリティーを関連付けることができます。 あとで構成を追加または削除する必要がある場合は、すべてのコードを調べてその構成を各コードブロックに関連付ける必要はありません。 代わりに、構成をアビリティーに関連付けるだけです。 それにより、構成は、アビリティーに関連付けられているすべてのコードブロックに自動的に関連付けられます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。
2. 「カテゴリ」メニューツリーから「アビリティー」ページを選択します。
3. 「プロジェクト構成」ドロップダウンメニューから構成を選択します。 この構成に、アビリティーが関連付けられます。
4. 必要に応じて、「"DefaultConfiguration" の値を使用」チェックボックスを選択解除します。
5. 「追加」ボタンをクリックします。
   「アビリティーの追加」ダイアログが開きます。
6. 「アビリティーの追加」ダイアログで、アビリティーの名前を入力するか、ドロップダウンメニューからアビリティーを選択します。 必要に応じて、アビリティーの値を入力します。
   「了解」をクリックして、「アビリティーの追加」ダイアログを閉じます。 これで、アビリティーが選択したプロジェクト構成に関連付けられました。

アビリティーをほかの構成に関連付けるには、「プロジェクト構成」メニューから別の構成を選択し、「追加」ボタンをクリックします。

構成別コード (プリプロセッサコード) の追加

プリプロセッサブロックを使用して、1 つ以上のプロジェクト構成またはアビリティーに固有のコードを作成、管理、および追跡できます。 コードは、指定した構成またはアビリティーに関してのみ有効 (または無効) になります。

1. HelloMIDlet.java のエディタウィンドウで、TextBox がインスタンス化されているソースコード行 (helloTextBox = new javax.microedition.lcdui.TextBox(null, "Hello, World", 120, 0x0);) を右クリックします。
2. 行を右クリックし、「プリプロセッサブロック」>「If / Else ブロックを作成」を選択します。 最初のピンクのセクションの「Hello World」文字列のあとに「Color」という単語を追加します。 2 つ目のグレーのセクションの「Hello World」文字列のあとに「Gray」という単語を追加します。
3. //#if プリプロセッサ指示でマークされたコードは、有効な構成が指示の値 (この場合は DefaultConfiguration) に一致するときに有効になります。 //#else プリプロセッサ指示で囲まれたコードは、有効な構成がプリプロセッサの値に一致しないときに使用されます。
   
   言い替えると、エミュレータは、有効なプラットフォームが「DefaultConfiguration」の場合は「Hello World Color」と表示し、有効なプラットフォームがほかのエミュレータプラットフォームの場合は「Hello World Gray」と表示します。 //#endif プリプロセッサ指示がプリプロセッサブロックの終わりです。

プリプロセッサコードをテストするには、エミュレータプラットフォームの変更で説明されているように、さまざまなエミュレータデバイスを使用して MIDlet を実行します。

構成の実行

構成は個別に構築、実行することも、まとめて構築、実行することもできます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロジェクトを実行」を選択します。
2. MyHelloMIDlet プロジェクトのノードを右クリックし、「有効なプロジェクト構成を設定」を選択して、別の構成を選択することによって、異なる構成を有効にします。 これは、各テキストエディタにある構成コンボボックスを使って行うこともできます。 プロジェクトを再実行します。
3. Color と Gray の 2 つのエミュレータが表示されます。 Gray エミュレータは「Hello World Gray」を表示し、Color エミュレータは「Hello World Color」を表示します。

Java ME Web サービス (JSR-172)
クライアントの作成

1. プロジェクトノードを右クリックし、「新規ファイル/フォルダ」を選択します。
   
2. 「新規ファイル」ウィザードで、「カテゴリ」の下の「MIDP」を選択します。 「ファイルの種類」で「J2ME Web サービスクライアント」を選択します。
   
3. プロジェクトに追加する Web サービスの WSDL ファイルの場所を指定します。
• WSDL サービスが Web 上にある場合は、次の手順に従います。
  1. 「実行中の Web サービス」を選択し、 WSDL ファイルの URL と、取得した .wsdl ファイルに付けるローカルファイル名を入力します。
  2. ファイアウォールを使用している場合は、「プロキシ設定」をクリックして、適切な HTTP ホストとポートを指定します。
  3. 「WSDL を取得」をクリックして、WSDL ファイルのローカルコピーを作成します。 IDE によって WSDL ファイルがダウンロードされます。
• 使用している環境内に WSDL ファイルが存在する場合は、「既存の WSDL ファイル」を選択し、ファイル名を入力します。
  
4. WSDL ファイルが読み出され、そのファイル名から得られるデフォルト名を使用して、ページ上のほかのフィールドが埋められます。
   
5. 「完了」をクリックします。
   IDE により、開かれた設定ファイルが作成され、クライアントスタブが生成されます。

• 状況によっては、CLDC 1.1 から CLDC 1.0 への型の変換が必要になることがあります。これは、Float 型および Double 型が String 型変数に変換されることを意味します。 変換を行うには、設定ファイルで「浮動小数点を文字列に変換」チェックボックスを選択して、「スタブを生成」ボタンをクリックします。
  
• ファイアウォールを使用している場合、NetBeans には HTTPS プロキシ用に使用できる公開設定はありません。 この問題を回避するには、コマンド -J-DhttpsProxy.host および -J-DhttpsProxy.port を使用して、コマンド行から IDE を実行するか、/etc/netbeans.conf ファイルにプロキシ設定を追加します。
• 生成されたファイルは、編集しないでください。 ファイルに加えた変更は、ファイルを再生成すると失われます。

アプリケーションのローカライズ

ローカリゼーションは、ソフトウェアを技術的に変更せずにさまざまな言語および地域に合わせる (ローカライズする) ことができるように、ソフトウェアをデザインするプロセスです。 アプリケーションのローカライズを行うときは、アプリケーションの各要素 (画面テキスト、メニュー、アイコンなど) に、代替言語の値を指定します。

ローカライゼーションサポートの追加

1. ローカリゼーションサポートおよびメッセージプロパティーファイルを初期化する Java クラスを作成します。
   1. MyHelloMIDlet プロジェクトのノードを右クリックし、「新規」>「ファイル / フォルダ」を選択します。
   2. 「カテゴリ」にある「MIDP」を選択します。 「ファイルの種類」で「地域対応クラス」を選択します。 「次へ」をクリックします。
   3. 「完了」をクリックします。デフォルト値が使用されます。 これで、LocalizationSupport.java および messages.properties というファイルが作成されます。
2. 「国際化文字列フォーマット」および「国際化検索フォーマット」を変更します。
   1. 「ツール」>「オプション」を選択し、「詳細オプション」ボタンをクリックします。
   2. 「オプション」メニューツリーで「国際化」ノードを選択します。
   3. 「プロパティー」ウィンドウで次のことを行います。
      • 「国際化文字列フォーマット」プロパティーの値を「LocalizationSupport.getMessage("{key}")」に変更します。
      • 「国際化検索フォーマット」プロパティーの値を「(getString|getBundle|getMessage)[:space:]*\([:space:]*{hardString}|//NOI18N」に変更します。
3. 地域対応キーとその値を追加します。
   1. 「ツール」>「国際化」>「国際化ウィザード」を選択します。 国際化ウィザードが開きます。
   2. 国際化するソースファイルとして HelloMIDlet MIDlet を選択します。 「次へ」をクリックします。
   3. 国際化した文字列の値を保存するファイルとして messages.properties のリソースファイルを選択します。 「次へ」をクリックします。
   4. HelloMIDlet MIDlet の各キーの「値」フィールドを変更します。
   5. すべての文字列を messages.properties ファイルに追加したあと、次の手順に従って新しいロケールにそれぞれ値を追加してください。
      1. プロジェクトビューでファイルのノードを右クリックし、「追加ロケール」を選択します。
      2. サポートするロケールを「事前定義ロケール」リストボックスから選択するか、フォームの一番上にあるコンボボックスを使用して新しいロケールを定義します。
      3. プロジェクトビューで「message.properties」ノードを展開し、新規に追加したロケールをダブルクリックします。
      4. すべてのプロパティーを適切な言語に翻訳します。
4. コードを追加すると、地域対応が初期化されます。
   1. MIDlet 内でキーをローカライズする部分に、次の文字列を入力します。
      LocalizationSupport.getMessage("Key");
      たとえば、LocalizationSupport.getMessage("LAB_NextButton"); とします。

モバイルアプリケーションは、microedition.locale 属性を使用して、使用する messages.properties ファイルのバージョンを決定します。