可视 Mobile 设计器定制组件:创建个人信息管理器应用程序
可视 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"(表项)等。
PIM 浏览器是一个定制组件,它可以用于轻松访问标准移动设备功能,如日历、通讯簿或任务列表。您可以使用 PIM 浏览器组件,使 Mobile Java 应用程序能够访问本地存储的个人信息数据库。该组件使用 PIM(个人信息管理)API,后者包含在 Java ME 平台的 JSR-75 规范的 PDA 可选包中。由于 JSR-75 不是 MIDP 2.0 规范的一部分,因此从定义上讲,它是一个定制组件,只能在支持 JSR-75 的设备上使用。
本教程介绍如何在支持 JSR-75 的设备的 Mobile 应用程序中使用 PIM 浏览器组件。它还介绍了该组件的基本功能,如浏览设备的 contact 数据库、日历或待做任务列表内容。除了 PIM 浏览器以外,我们还需要使用其他三个组件:"Splash Screen"(闪屏)、"Text Box"(文本框)和 "Alert"(警报)。
目录
要学习本教程,您需要具备下列软件和资源。
如果您对 NetBeans Mobility 不太熟悉,应先阅读 NetBeans Java ME MIDP 快速入门指南,然后再继续学习本教程。
安装并运行样例应用程序
开始之前,您可能希望查看本教程的最终结果。
请执行下列步骤以安装 PIMBrowserExample 应用程序:
- 下载 PIMBrowserExample.zip
- 解压缩该文件。
- 在 IDE 中,选择 "File"(文件)> "Open Project"(打开项目),然后浏览至包含 PIMBrowserExample 项目的解压缩文件的文件夹。
- 单击 "Open Project"(打开项目)。
"Projects"(项目)窗口应如下所示:
- 在 "Projects"(项目)窗口中,右键单击项目节点并选择 "Run Project"(运行项目)(或按 F6)。当应用程序运行时,将会打开一个仿真器窗口,其中显示了在缺省设备仿真器中运行的应用程序。
- 在仿真器窗口中,单击 "Launch" 下面的按钮。
仿真器将显示闪屏组件,然后显示 PIM 浏览器,如下所示:

- 单击仿真器右上方的按钮以显示菜单项,如下所示:

- 如果选中 "Details"(详细信息)项,请单击仿真器上的中心按钮,以显示联系人详细信息:

- 将光标上移或下移以在可用的位置中导航。
- 单击 "Back" 下方的按钮以返回到联系人列表。
- 单击 "Exit" 下面的按钮以关闭应用程序。
返回页首
使用 PIM 浏览器定制组件创建应用程序
现在,您已看到运行中的 PIM 浏览器组件,接下来让我们从头开始创建此应用程序。要创建该应用程序,请执行以下操作:
- 创建 PIMBrowserExample 项目
- 在项目中添加包和 Visual MIDlet
- 在项目中添加组件
- 在项目中添加命令
- 连接组件以创建应用程序流
- 在 Wireless Toolkit Contact 数据库中添加联系人
- 运行项目
创建 PIMBrowserExample 项目
- 选择 "File"(文件)> "New Project"(新建项目)(Ctrl-Shift-N 组合键)。在 "Categories"(类别)下,选择 "Java ME"。在 "Projects"(项目)下,选择 "Mobile Application"(Mobile 应用程序),然后单击 "Next"(下一步)。
- 在 "Project Name"(项目名称)字段中输入
PIMBrowserExample
。将Project Location(项目位置)更改为系统中的某个目录。从现在开始,我们将此目录称为 $PROJECTHOME。
- 取消选中 "Create Hello MIDlet"(创建 Hello MIDlet)复选框。单击 "Next"(下一步)。
- 将 "Java (TM) Platform Micro Edition SDK 3.0" 保留为选定的仿真器平台。单击 "Next"(下一步)。
- 在 "More Configurations Selection"(选择更多配置)中,单击 "Finish"(完成)。
注意:该项目文件夹中包含所有源代码和项目 meta 数据,如项目的 Ant 脚本。
在项目中添加包和 Visual MIDlet
- 在 "Project"(项目)视图中选择
PIMBrowserExample
项目,然后选择 "File"(文件)> "New File"(新建文件)(Ctrl-N 组合键)。在 "Categories"(类别)下,选择 "Java"。在 "File Types"(文件类型)下,选择 "Java Package"(Java 包)。单击 "Next"(下一步)。
- 在 "Package Name"(包名)字段中输入
pimbrowserexample
。单击 "Finish"(完成)。
- 在 "Project"(项目)视图中选择
pimbrowserexample
包,然后选择 "File"(文件)> "New File"(新建文件)(Ctrl-N 组合键)。在 "Categories"(类别)下,选择 "MIDP"。在 "File Types"(文件类型)下,选择 "Visual MIDlet"。单击 "Next"(下一步)。
- 在 "MIDlet Name"(MIDlet 名称)和 "MIDP Class Name"(MIDP 类名)字段中输入
PIMBrowserExample
。单击 "Finish"(完成)。
应用程序显示在可视 Mobile 设计器的 "Flow"(流)视图中。
在项目中添加组件
- 在 "Flow"(流)设计器中,从 "Component Palette"(组件面板)中拖放以下组件:
- Splash Screen(闪屏)
- Alert(警报)
- PIM Browser(PIM 浏览器)
- 单击 "splashScreen",然后在 "Properties"(属性)窗口中将 "Text"(文本)值从 null 更改为 PIM Browser Example。
- 单击 "alert",然后在 "Properties"(属性)窗口中将 "String"(字符串)属性值更改为 Contact selected。
在项目中添加命令
- 在 "Flow"(流)设计器中,从 "Component Palette"(组件面板)的 "Commands"(命令)类别中选择 "Exit Command"(退出命令)。
- 将其拖放至 pimBrowser 组件中。
连接组件以创建应用程序流
在 "Flow"(流)设计器中,单击 "Mobile Device"(移动设备)上的 "Started"(已启动),然后将其拖至 splashScreen 组件中。采用相同的方法,按照下图所示连接各个组件。

在 Wireless Toolkit Contact 数据库中添加联系人
将样例联系人复制到 $JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/ 用户目录的 javame-sdk 文件夹中。
缺省情况下,此文件夹中包含以下三个文件:
1.vcf
2.vcf
categories.txt
运行项目
按 F6 键以运行主项目,或者选择 "Run"(运行)> "Run Main Project"(运行主项目)。
返回页首
PIM 浏览器组件的 Javadoc
NetBeans IDE 提供了 PIMBrowser 组件以及可在 VMD 中使用的其他组件的 API Javadoc。要阅读 PIMBrowser 组件的 Javadoc,请执行以下操作:
- 将光标放在源代码中的 PIMBrowser 组件上,然后按 Ctr-Shift-空格组合键(或选择 "Source"(源)> "Show Documentation"(显示文档))。
此时将在弹出式窗口中显示该元素的 Javadoc。
- 在弹出式窗口中单击 "Show documentation in external web browser"(在外部 Web 浏览器中显示文档)图标 (
),以便在浏览器中查看有关 PIMBrowser 组件的详细信息。
返回页首
另请参见
返回页首