corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

可视 Mobile 设计器定制组件：创建 SMS 编写器应用程序

可视 Mobile 设计器 (Visual Mobile Designer, VMD) 是 NetBeans Mobility 中的图形界面，您可以在该界面中使用拖放式组件设计 Mobile 应用程序。通过 VMD，您可以使用 IDE 提供的组件或您自己设计的组件定义应用程序流和设计 GUI。VMD 包含很多标准用户界面 (User Interface, UI) 组件，您可以使用这些组件创建应用程序，如 "Lists"（列表）、"Alerts"（警报）、"Forms"（表单）、"Images"（图像）。它还包含一些定制组件，用于简化创建较复杂功能的过程，例如 "Wait Screen"（等待屏幕）、"Splash Screens"（闪屏）和 "Table Items"（表项）等。

SMS 编写器是一个定制组件，它提供了相应机制和用户界面以使用短消息服务 (Short Message Service, SMS) 发送短消息。该组件使用 JSR-120 Wireless Messaging API。该 API 不是 MIDP 2.0 规范的一部分，因此，只能将该定制组件部署到具有内置 JSR-120 支持的设备上。

本教程介绍如何在支持 Wireless Messaging API (WMA) 的设备的 Mobile 应用程序中使用 SMS 编写器组件。您将了解该组件的基本功能，以及如何使用短消息服务发送消息。

除了 SMS 编写器定制组件以外，我们还需要使用其他两个 MIDP 组件："Splash Screen"（闪屏）和 "Alert"（警报）。

注意：如果使用的是 NetBeans IDE 6.8，请参阅在 NetBeans IDE 6.8 中创建 SMS 编写器应用程序教程。

目录

本页上的内容适用于 NetBeans IDE 6.9 及更高版本

要学习本教程，您需要具备下列软件和资源。

软件或资源 要求的版本
带有 Java ME 的 NetBeans Beans 版本 6.9 及更高版本
Java Development Kit (JDK) 版本 6 和版本 7

安装并运行样例应用程序

开始之前，您可能希望查看本教程的最终结果。

请执行下列步骤以安装 SMSComposerExample 应用程序：

  1. 下载 SMSComposerExample.zip。
  2. 解压缩该文件。
  3. 在 IDE 中，选择 "File"（文件）> "Open Project"（打开项目），然后浏览至包含 SMSComposerExample 项目的解压缩文件的文件夹。
  4. 单击 "Open Project"（打开项目）。
    "Projects"（项目）窗口应如下所示：

    打开了 SMS 编写器示例的 "Projects"（项目）窗口

  5. 在 "Projects"（项目）窗口中，右键单击该项目节点，然后选择 "Run Project"（运行项目）（或按 F6 键）。
    当应用程序运行时，将会打开一个仿真器窗口，其中显示了在缺省设备仿真器中运行的应用程序。
  6. 在仿真器窗口中，单击 "Launch" 下方的按钮。仿真器将显示闪屏组件，然后显示 SMS 编写器，如下所示：

    显示样例 SMS 编写器应用程序的 WTK 2.5 仿真器

  • 将光标上移或下移以在可用的选项中导航，如 "Phone Number" 或 "Message"。
  • 单击中心按钮以允许编辑选定的文本字段。
  • 单击 "Send" 下方的按钮以发送消息。
  • 单击 "Exit" 下面的按钮以关闭应用程序。

返回页首

使用 SMS 编写器定制组件创建应用程序

现在，您已看到运行中的 SMS 编写器组件，接下来让我们从头开始创建此应用程序。要创建该应用程序，请执行以下操作：

  1. 创建SMSComposerExample 项目
  2. 在项目中添加包和 Visual MIDlet
  3. 在项目中添加组件
  4. 在项目中添加命令
  5. 连接组件以创建应用程序流
  6. 修改 "Wait Screen"（等待屏幕）任务
  7. 运行项目

创建 SMSComposerExample 项目

  1. 选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键）。在 "Categories"（类别）下，选择 "JavaME"。在 "Projects"（项目）下，选择 "Mobile Application"（Mobile 应用程序），然后单击 "Next"（下一步）。
  2. 在 "Project Name"（项目名称）字段中输入 SMSComposerExample。将Project Location（项目位置）更改为系统中的某个目录。从现在开始，我们将此目录称为 $PROJECTHOME。
  3. 取消选中 "Create Hello MIDlet"（创建 Hello MIDlet）复选框。单击 "Next"（下一步）。
  4. 将 "Sun Java Wireless Toolkit" 保留为选定的仿真器平台。单击 "Next"（下一步）。
  5. 单击 "Finish"（完成）。

    6. 注意：该项目文件夹中包含所有源代码和项目 meta 数据，如项目的 Ant 脚本。

在项目中添加包和 Visual MIDlet

  1. 在 "Project"（项目）窗口中选择 SMSComposerExample 项目，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。在 "Categories"（类别）下，选择 "Java"。在 "File Types"（文件类型）下，选择 "Java Package"（Java 包）。单击 "Next"（下一步）。
  2. 在 "Package Name"（包名）字段中输入 smscomposerexample。单击 "Finish"（完成）。
  3. 在 "Project"（项目）窗口中选择 smscomposerexample 包，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。在 "Categories"（类别）下，选择 "MIDP"。在 "File Types"（文件类型）下，选择 "Visual MIDlet"。单击 "Next"（下一步）。
  4. 在 "MIDlet Name"（MIDlet 名称）和 "MIDP Class Name"（MIDP 类名）字段中输入 SMSComposerExample。单击 "Finish"（完成）。
    应用程序显示在可视 Mobile 设计器的 "Flow"（流）设计窗口中。

    5. 可视 Mobile 设计器中的 SMSComposerExample

在项目中添加组件

  1. 在 "Flow"（流）设计器窗口中，从 "Component Palette"（组件面板）中拖放以下组件：
    • Splash Screen（闪屏）
    • SMS 编写器
    • Wait Screen（等待屏幕）
    • Alert（警报） (x2)
  2. 单击 "splashScreen"，并在 "Properties"（属性）窗口中将 "Text"（文本）属性值从 null 更改为 SMS Composer Example，然后按 Enter 键。
  3. 单击 "alert"，然后在 "Properties（属性）窗口中，将 "Title"（标题）属性值从 alert 更改为 alertSent，与将 alert1 的 "Title"（标题）属性从 alert1 更改为 alertError 的方式相同。
  4. 单击 "alert"，然后在 "Properties"（属性）窗口中，将 "String"（字符串）属性值更改为 Message Sent，与将 alertError 组件的 "String"（字符串）属性更改为 Error 的方式相同。
  5. 单击 "smsComposer"，然后在 "Properties"（属性）窗口中，取消选中 "SMS Properties"（SMS 属性）类别中的 "Automatically Send"（自动发送）属性。

在项目中添加命令

  1. 打开 "Flow"（流）设计器。
  2. 从 "Component Palette"（组件面板）的 "Commands"（命令）类别中选择 "Exit Command"（退出命令）。将其拖放至 "Flow"（流）设计器内的 smsComposer 组件中。

连接组件以创建应用程序流

在 "Flow"（流）设计器窗口中，单击 "Mobile Device"（移动设备）上的“起点”并将其拖至 spalshScreen 组件中。采用相同的方法，按照下图所示连接各个组件。

显示包含由命令行连接的组件的 "Flow"（流）设计器

修改 "Wait Screen"（等待屏幕）任务

在 "Navigator"（导航）窗口的 "Resources"（资源）类别中，找到并右键单击 task 组件，然后从弹出式菜单中选择 "Go To Source"（转至源）。在 "Source"（源）窗口中，找到 // write task-execution user code here 部分并将其替换为 smsComposer.sendSMS();。

运行项目

按 F6 键运行主项目。此外，也可以选择 "Run"（运行）> "Run Main Project"（运行主项目）。

返回页首

SMS 编写器组件的 Javadoc

NetBeans IDE 提供了 SMSComposer 组件以及可在 VMD 中使用的其他组件的 API Javadoc。阅读 SMSComposer 组件的 Javadoc：

  1. 将光标放在源代码中的 SMSComposer 组件上，然后按 Ctr-Shift-空格组合键（或选择 "Source"（源）> "Show Documentation"（显示文档））。
    此时将在弹出式窗口中显示该元素的 Javadoc。
  2. 在弹出式窗口中单击 "Show documentation in external web browser"（在外部 Web 浏览器中显示文档）图标 ("Show documentation in external web browser"（在外部 Web 浏览器中显示文档）)，以便在浏览器中查看有关 SMSComposer 组件的详细信息。

返回页首


另请参见

返回页首