可视 Mobile 设计器自定义组件：PIM 浏览器

由 Karol Harezlak 创建

可视 Mobile 设计器(VMD) 是 NetBeans Mobility 包中的图形界面，允许您使用拖放组件来设计移动应用程序。VMD 允许使用 Mobility 包提供的组件或您自己设计的组件来定义应用程序流程和设计 GUI。VMD 包含许多标准 User Interface (UI) 组件，可用于创建 Lists、Alerts、Forms 和 Images 等应用程序。它还包括一些自定义组件，可用于简化一些比较复杂的功能的创建，比如等待屏幕、启动屏幕、表格项目等。

PIM 浏览器是自定义组件，提供了对日历、地址簿或任务列表等标准移动设备功能的方便访问。可以使用PIM 浏览器组件以允许移动 Java 应用程序访问本地存储的个人信息数据库。此组件使用 PIM（个人信息管理）API，此 API 是 JSR-75 规范 中用于 Java ME Platform 的 PDA Optional Packages 的一部分。JSR-75 不是 MIDP 2.0 规范的一部分，它在定义上属于自定义组件，因此只能与支持 JSR-75 的设备一起使用。

应用程序概述

本例显示如何在支持 JSR-75 的设备的移动应用程序中使用PIM 浏览器组件。它阐述了组件的基本功能，比如浏览设备的联系人数据库、日历或待办事项列表的内容。除了PIM 浏览器之外，我们还需要使用其他三个组件：启动屏幕、文本框和报警。

软件需求

开始之前，需要在您的计算机中安装以下软件：

• 带有 Mobility 包的 NetBeans IDE 6.0（下载）
• Java Standard Development Kit (JDK) 版本 6.0（下载）。

如果您不了解 NetBeans Mobility Pack，则应在继续之前先阅读 NetBeans 6.0 Mobility CLDC/MIDP 快速入门指南。

安装和运行示例应用程序

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

执行以下步骤安装 PIMBrowserExample 应用程序：

1. 下载 pimbrowserexample.zip
2. 解压文件。
3. 在 IDE 中，选择“文件”>“打开项目”并浏览包含已解压文件的文件夹。
4. 打开“项目”和“导航”窗口。它应如下所示：


5. 在“项目”窗口中，右键单击项目节点并选择“运行项目”选项（也可以按 F6 键）。在应用程序运行时，一个仿真程序窗口将打开并显示正在默认设备仿真程序中运行的应用程序。
6. 在“仿真器”窗口中，单击“启动”下方的按钮。
   仿真程序显示启动屏幕组件，之后是 PIM 浏览器组件，如下所示：
   
7. 联系人详细信息
   
   

• 上下移动鼠标以浏览可用位置。
• 单击“返回”下的按钮返回到联系人列表。
• 单击“退出”下方的按钮以关闭应用程序。

使用 PIM 浏览器自定义组件创建应用程序

既然已经看到了正在运行的 PIM 浏览器组件，让我们返回起点创建此应用程序。要创建应用程序，请执行以下操作：

1. 创建 PIMBrowserExamplee 项目
2. 将软件包和可视 MIDlet 添加到 PIMBrowserExample 项目中
3. 将组件添加到 PIMBrowserExample 中
4. 将命令添加到 PIM 浏览器组件中
5. 连接组件以创建应用程序流程
6. 将联系人添加到无线工具包（Wireless Toolkit）联系人数据库中
7. 运行项目

创建 PIMBrowserExample 项目

1. 选择“文件”>“新建项目”（Ctrl-Shift-N）。在“类别列表”中，选择“移动”选项。在“项目”列表中，选择“MIDP 应用程序”选项并单击“下一步”按钮。
2. 在“项目名称”字段中输入 PIMBrowserExample。将“项目位置”更改为您系统上的任意目录。从现在开始，让我们将此目录称为 $PROJECTHOME。
3. 取消选中“创建 Hello MIDlet”复选框。单击“下一步”按钮。
4. 保留 Java ME 无线工具包为选中的“目标平台”。单击“下一步”按钮。
5. 单击“完成”按钮。
   项目文件夹包含所有源码和项目元数据，比如项目 Ant 脚本。应用程序本身将显示在可视 Mobile 设计器的“流设计”窗口中。

将软件包和可视 MIDlet 添加到 PIMBrowserExample 项目中

1. 在“项目”窗口中选择 PIMBrowserExample 项目，然后选择“文件”>新建文件（Ctrl-N）。在“类别列表”中，选择“Java 类”选项。在“文件类型”列表中，选择“Java 包”选项。单击“下一步”按钮。
2. 在“项目名称”字段中输入 pimbrowserexample。单击“完成”按钮。
3. 在“项目”窗口中选择 filebrowserexample 软件包，然后选择“文件”>新建文件（Ctrl-N）。在“类别列表”中，选择 MIDP 选项。在“文件类型”列表中，选择“ 可视 MIDlet”选项。单击“下一步”按钮。
4. 在“MIDlet 名称”和“MIDP 类名”字段中输入 PIMBrowserExample。单击“完成”按钮。

将组件添加到 PIMBrowserExample 中

1. 将“ 可视 MIDlet”切换到“流设计器”窗口。将“组件面板”中的以下组件拖放至“流设计器”中：
• 启动屏幕
• 报警
• IM 浏览器
2. 单击 splashScreen，并在“属性”窗口中将属性“文本”的值从 null 更改为 PIM Brower Example。
3. 单击 alert 组件，并在“属性”窗口中将属性“字符串”的值更改为 Contact selected。

将命令添加到 PIMBrowserExample 中

1. 打开“流设计器”窗口。
2. 从“组件面板”的“命令”部分中选择“退出命令”选项。将其拖放至“流设计器”窗口（pimBrowser 组件）中。

连接组件

1. 在 Flow 设计窗口中，单击“移动设备”上的“开始点”并将其拖放至 splashScreen 组件中。以同样的方式将组件连接到一起，如下图所示。

将联系人添加到无线工具包联系人数据库中

 

将 示例联系人 添加到 WTK 文件夹 $WTKHOME/appdb/DefaultColorPhone/pim/contacts/Contacts/ 中。此文件夹默认为空，所以必须至少复制一个文件（联系人）以测试PIM 浏览器示例。

有关 WTK Persistent Storage 的更多信息可以从 Sun Java Wireless Toolkit for CLDC 用户指南（节：4.3.2.1 Persistent Storage）使用仿真程序 中获得。

运行项目

1. 按 <F6> 运行主项目或选择“运行”>“运行主项目”。

了解有关PIM 浏览器组件的更多信息

NetBeans IDE 为PIM 浏览器组件以及可以在 VMD 中使用的其他组件提供了 API Javadocs。要阅读PIM 浏览器组件的 Javadocs，请执行以下操作：

1. 选择“帮助”> Javadoc References > org.netbeans.microediton.lcdui.pda。文件在 web 浏览器中打开。
2. 单击 org.netbeans.microedition.lcdui.pda 以查看组件信息的链接。

相关教程

• 可视 Mobile 设计器自定义组件：SMS 设计程序
• 可视 Mobile 设计器自定义组件：文件浏览器
• 可视 Mobile 设计器自定义组件：登录屏幕