第 10 章

使用 PIM 和 FileConnection API

Sun Java^TM Wireless Toolkit for CLDC 支持 PDA Optional Packages (PDAP) for the J2ME Platform (JSR 75)。JSR 75 包括两个独立的 API：

FileConnection 可选包允许 MIDlet 访问本地设备文件系统。

个人信息管理 (Personal Information Management, PIM) 可选包包括用于操纵联系人列表（通讯录）、日历以及任务列表的 API。

本章介绍 Sun Java^TM Wireless Toolkit for CLDC 如何实现 FileConnection 和 PIM API。

10.1 FileConnection API

在真实设备上，FileConnection API 通常会提供对存储在设备内存或内存卡上文件的访问权限。

在 Sun Java^TM Wireless Toolkit for CLDC 仿真器中，FileConnection API 允许 MIDlet 访问存储在台式机硬盘中的文件。

可以使用存储在 workdir\appdb\skin\filesystem 的子目录下的 FileConnection 访问这些文件。例如，DefaultColorPhone 仿真器样机附带了一个已安装的名为 root1 的根目录，该目录包含一个名为 Readme 的文件和一个名为 photos 的空目录。文件的完整路径为：

对于 Windows 系统：	workdir`\appdb\`skin`\filesystem\root1\photos`
对于 Linux 系统：	workdir`/appdb/`skin`/filesystem/root1/photos`

注 - 如果同时运行同一个仿真器样机的多个实例，Sun Java^TM Wireless Toolkit for CLDC 将为每个实例生成唯一的文件路径。例如，第一个目录被命名为 DefaultColorPhone，第二个实例被命名为 DefaultColorPhone1。

filesystem 的每个子目录称为 root。Sun Java^TM Wireless Toolkit for CLDC 提供了根管理机制。当仿真器运行时，从仿真器窗口菜单中选择 "MIDlet" >“外部事件”。将显示用于添加和删除根的实用程序窗口。

图 10-1 管理文件系统根目录

选择了“文件连接”选项卡的“外部事件生成器”窗口

使用 FileConnection API，应用程序可以访问已安装的根目录及其内容。

要添加新的根目录，请单击“安装新项目”，然后填写目录名。要使 FileConnection API 不能访问某个目录，请在列表中选中该目录，然后单击“卸载”。

10.2 PIM API

Sun Java^TM Wireless Toolkit for CLDC 仿真器将联系人、日历以及任务信息以标准文件格式存储在您的台式机硬盘上。所有信息都存储在 workdir\appdb\skin\pim 中。该目录由所有运行中的仿真器共享。列表分别存储在 contacts、events 和 todo 目录的子目录中。例如，名为 Contacts 的联系人列表包含在：

对于 Windows 系统：	workdir`\appdb\`skin`\pim\contacts\Contacts`
对于 Linux 系统：	workdir`/appdb/`skin`/pim/contacts/Contacts`

在列表目录内部，各项都存储为 vCard (.vcs) 或 vCalendar (.vcf) 格式（请参见 http://www.imc.org/pdi/）。联系人存储为 vCard 格式，而日历和任务项都存储为 vCalendar 格式。