学步园

创建 MIDP/CLDC 应用程序

1. 选择“文件”>“新建项目”(Ctrl-Shift-N)。分别在“类别”下选择 "Mobile"，在“项目”下选择“Mobile 应用程序”，然后单击“下一步”。
2. 在“项目名称”字段中输入 MyHello。将项目位置更改为系统上的任意目录。从现在起，我们将该目录称为 $PROJECTHOME。
3. 选中“设置为主项目”和“创建 Hello MIDlet”复选框（缺省情况下，这两个复选框均处于选中状态）。单击“下一步”。
4. 将 J2ME Wireless Toolkit 作为选定的目标平台。
5. 单击“完成”。此时 IDE 创建了 $PROJECTHOME/MyHello 项目文件夹。该项目文件夹包含了所有源代码和项目元数据，如项目 Ant 脚本。
   应用程序本身会显示在可视 Mobile 设计器的“流设计”窗口中。

编辑 Java 源代码

现在，让我们编辑 MIDlet 所显示的文本。

1. 单击“屏幕设计”。
   这将打开“屏幕设计器”窗口并显示 helloForm[Form] 屏幕，这是应用程序中唯一可用的屏幕。
2. 双击 "Hello world!" 文本并键入某些新文本。

编译并运行项目

1. 从“运行”菜单中选择“运行”>“运行主项目”(F6)。双击“输出”窗口将其最大化，以便查看所有输出内容。请注意，HelloMIDlet.java 文件是在执行之前构建的。这样便会打开一个设备仿真器以显示执行的 MIDlet 结果。缺省设备仿真器为 DefaultColorPhone。
2. 在设备仿真器窗口中，单击“启动”命令下面的按钮。设备仿真器将启动 MIDlet，并显示在源代码中输入的文本。
3. 单击 "Exit" 下面的按钮关闭 MIDlet，然后，单击设备右上角的按钮关闭仿真器窗口。

创建新的 Java ME MIDP 项目

1. 选择“文件”>“新建项目”(Ctrl-Shift-N)。分别在“类别”下选择 "Mobile"，在“项目”下选择“Mobile 应用程序”，然后单击“下一步”。
2. 在“项目名称”字段中输入 MyHelloMIDlet。将项目位置更改为系统上的任意目录。从现在起，我们将该目录称为 $PROJECTHOME。
3. 选中“设置为主项目”复选框，并取消选中“创建 Hello MIDlet”复选框。单击“下一步”。
4. 将 J2ME Wireless Toolkit 作为选定的目标平台。
5. 单击“完成”。此时 IDE 创建了 $PROJECTHOME/MyHelloMIDlet 项目文件夹。该项目文件夹包含了所有源代码和项目元数据，如项目 Ant 脚本。
6. 在“项目”窗口中右键单击 MyHelloMIDlet 节点，然后选择“新建”>“文件/文件夹”。
7. 分别在“类别”下选择 "MIDP"，在“文件类型”下选择 "MIDlet"，单击“下一步”。
8. 输入 HelloMIDlet 作为 MIDlet 名称。单击“完成”。将创建 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);
       }
       return exitCommand;
    }
    
    javax.microedition.lcdui.TextBox helloTextBox;
    javax.microedition.lcdui.Command exitCommand;

12. 将 initialize(); 一行添加到 startApp() 方法中，如下所示：

      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. 右键单击 "MyHello" 项目节点，然后选择“属性”。在“属性”对话框中，选择“平台”节点。可以在其中更改缺省配置的设备。
2. 单击“设备”下拉列表，然后选择 "QwertyDevice"。单击“确定”。
3. 重新运行应用程序，此时该应用程序在 QwertyDevice 仿真器中运行。

添加新的仿真器平台

1. 从主工具栏中选择“工具”>“Java 平台管理器”。
2. 在“Java 平台管理器”对话框中，单击“添加平台”按钮。
3. 在“选择平台类型”页中，选择“Java Micro Edition 平台仿真器”。单击“下一步”。
   在“平台”页中，IDE 会搜索所有可用的 Java ME 平台并将它们列在窗口中。IDE 将验证符合统一仿真器接口 (Unified Emulator Interface, UEI) 标准的平台，并且在这些平台名称旁边的复选框中会出现复选标记。不符合 UEI 的平台或因其他原因而无法安装的平台将以红色标记列出。该向导还可以标识已安装的平台。

   注意：要安装不符合 UEI 的平台，请单击“上一步”按钮，然后选择“定制 Java Micro Edition 平台仿真器”。

4. 在“平台”页中，选中要安装的任何平台仿真器旁边的复选框，单击“完成”。然后单击“关闭”。
   系统将安装选定的一个平台或多个平台。
5. 选择“文件”>“'MyHello' 属性”。
6. 选择“平台”节点，然后从“仿真器平台”下拉菜单中选择新仿真器的名称（例如，J2ME Wireless Toolkit 2.2）。单击“确定”。

添加配置

1. 右键单击 "MyHello" 项目节点，然后选择“属性”。在“属性”对话框中，从“项目配置”下拉列表中选择“添加配置”。这将打开“添加配置”对话框。
2. 在“配置名称”字段中为配置输入一个名称。该名称会标识一个目标平台，您将在该目标平台上部署为此配置创建的 JAR/JAD。例如，输入 BlackWhiteDisplay，然后单击“确定”。至此，您就创建了一个新的配置。
3. 也可以通过单击“属性”对话框中的“管理配置”按钮来添加配置。这将打开“项目配置管理器”对话框，该对话框包含用于添加、删除或复制配置的选项。

定制配置

您可以根据需要在项目中添加任意数量的配置。然后，可以在“项目属性”对话框中修改已添加的每个配置的设置。

1. 右键单击 "MyHello" 项目节点，然后选择“属性”。在“属性”对话框中，选择“平台”节点。这将打开“J2ME MIDP 配置”对话框。
2. 从“属性”对话框顶部的配置组合框中选择 BlackWhiteDisplay 配置。
3. “平台”对话框中的所有组件将被禁用。这是因为，该配置当前采用此面板中缺省配置所使用的值。取消选中面板底部的“使用 "DefaultConfiguration" 中的值”选项。现在就可以编辑此面板上的所有组件了。
4. 将“设备”选项更改为 "DefaultGrayPhone"。
5. 切换“属性”对话框顶部的“项目配置”对话框，并观察“设备”选项随当前选定配置的变化而变化的情况。此配置定制方法适用于对话框中的每个面板（常规面板除外）。单击“确定”可保存配置更改并退出“属性”对话框。

创建性能

在创建某个性能时，可以将其与一个或多个支持某个特定属性或属性集合的项目配置相关联。然后，可以将此性能与一个或多个支持该属性的代码块相关联。如果之后需要添加或删除配置，则无需检查所有代码，也无需将此配置与每个代码块相关联，只需将此配置与某个性能相关联即可。该配置会自动与此性能关联的任意代码块相关联。

1. 右键单击 "MyHello" 项目节点，然后选择“属性”。
2. 从“类别”菜单树中选择“性能”页。
3. 从“项目配置”下拉菜单中选择一个配置。这是与该性能关联的配置。
4. 如有必要，请取消选中“使用 "DefaultConfiguration" 中的值”复选框。
5. 单击“添加”按钮。
   这将打开“添加性能”对话框。
6. 在“添加性能”对话框中输入性能的名称，或者从下拉菜单中选择一个性能。（可选）为该性能输入一个值。
   单击“确定”关闭“添加性能”对话框。现在，此性能将与选定的项目配置相关联。

可以使用以下方法将此性能与其他配置相关联：从“项目配置”菜单中选择一个不同的配置，然后单击“添加”按钮。

添加特定于配置的代码（预处理程序代码）

可以使用预处理程序块来创建、管理和跟踪特定于一个或多个项目配置或性能的代码。预处理程序块将只根据您指定的配置或性能启用（或禁用）代码。

1. 在 HelloMIDlet.java 编辑器窗口中，右键单击要实例化 TextBox 的源代码行 (helloTextBox = new javax.microedition.lcdui.TextBox(null, "Hello, World",120, 0x0);)。
2. 右键单击该行，然后选择“预处理程序块”>“创建 If/Else 程序块”。在第一个粉红色部分，将 "Color" 字样附加到 "Hello World" 字符串的后面。在第二个灰色部分，将 "Gray" 添加到 "Hello World" 字符串的后面。
3. 每当活动配置与指令值（此处为 DefaultConfiguration）匹配时，//#if 预处理程序指令标记的代码将生效。每当活动配置与预处理程序值不匹配时，将使用 //#else 预处理程序指令标记的代码。

   换句话说，每当活动平台为 "DefaultConfiguration" 时，仿真器将显示 "Hello World Color"；如果活动平台是任何其他仿真器平台，则显示 "Hello World Gray"。//#endif 预处理程序指令将完成预处理程序块。

   可以通过使用不同的仿真器设备运行 MIDlet 来测试预处理程序代码，如更改仿真器平台中所述。

运行配置

既可以单独生成并运行配置，也可以同时生成并运行配置。

1. 右键单击 "MyHello" 项目节点，然后选择“运行”。
2. 可以通过以下方法激活不同的配置：右键单击 "MyHello" 项目节点，选择“设置活动项目配置”，然后选择一个不同的配置。也可以使用每个文本编辑器中的配置组合框来执行此操作。重新运行项目。
3. 将会出现两个仿真器，一个为彩色，一个为灰色。灰色仿真器显示 "Hello World Gray"；彩色仿真器显示 "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”以获取 WDSL 文件的本地副本。IDE 将下载 WSDL 文件。
   • 如果环境中包含 WSDL 文件，请选择“现有的 WSDL 文件”并输入文件名。
4. 将检索该 WSDL 文件，并使用从 WSDL 文件名获取的缺省名称来填充页面上的其余字段。
5. 按“完成”。
   IDE 将创建一个打开的设置文件并生成客户端桩模块。

• 在极少数的情况下，您可能需要将 CLDC 1.1 类型转换为 CLDC 1.0 类型，这意味着浮点和双精度类型会转换为字符串变量。要进行转换，请在设置文件中选中“将浮点转换为字符串”复选框，然后单击“生成桩模块”按钮。
• 如果您处于防火墙的保护下，则在 NetBeans 中没有可供 HTTPS 代理使用的公共设置。要解决此问题，请在命令行中使用命令 -J-DhttpsProxy.host 和 -J-DhttpsProxy.port 运行 IDE，或将代理设置添加到 /etc/netbeans.conf 文件中。
• 请不要编辑生成的文件。在重新生成这些文件时，对其所做的任何更改将会丢失。

本地化应用程序

本地化是软件设计的一个过程，您无需对软件进行任何工程更改即可将其改编（本地化）为不同语言和区域的软件。当本地化应用程序时，会为应用程序中的每个元素（如屏幕文本、菜单和图标）提供替换的语言值。

添加本地化支持

1. 创建初始化本地化支持的 Java 类和消息属性文件。
   1. 右键单击 "MyHello" 项目节点，然后选择“新建”>“文件/文件夹”。
   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. 在需要对键（LocalizationSupport.getMessage("Key");）进行本地化的 MIDlet 中输入以下字符串：
      例如，LocalizationSupport.getMessage("LAB_NextButton");

Mobile 应用程序将使用 microedition.locale 属性来确定应使用的 messages.properties 文件版本。