10


使用 PIM 與 FileConnection API

Sun JavaTM Wireless Toolkit for CLDC 支援 PDA Optional Packages (PDAP) for the J2ME Platform:JSR 75。JSR 75 包含兩個獨立的 API:

這一章描述 Sun JavaTM Wireless Toolkit for CLDC 如何實作 FileConnection 與 PIM API。


10.1 FileConnection API

在實際裝置上,FileConnection API 讓應用程式可存取儲存在裝置的記憶體或記憶卡上的檔案。

在 Sun JavaTM Wireless Toolkit for CLDC 模擬器中,FileConnection API 讓 MIDlet 可存取桌上型電腦硬碟上儲存的檔案。

可用 FileConnection 存取的檔案儲存於 workdir\appdb\skin\filesystem 的子目錄中。例如,DefaultColorPhone 模擬器面板隨附一個 root1 根目錄,其中包含一個 Readme 檔案與一個名稱為 photos 的空目錄。該檔案的完整路徑為:


Windows:

workdir\appdb\skin\filesystem\root1\photos

Linux:

workdir/appdb/skin/filesystem/root1/photos


  

備註 - 如果同時執行同一個模擬器面板的多個實例,Sun JavaTM Wireless Toolkit for CLDC 會為每個實例產生唯一的檔案路徑。例如,將第一個目錄命名為 DefaultColorPhone,將第二個目錄命名為 DefaultColorPhone1



filesystem 的每個子目錄稱為一個根目錄。Sun JavaTM Wireless Toolkit for CLDC 提供管理根目錄的機制。當模擬器正在執行時,從模擬器的視窗功能表中,選擇 [MIDlet] > [外部事件]。將顯示用於增加或移除根的公用程式視窗。

圖 10-1 管理檔案系統根目錄

已選取 [檔案連線] 標籤的 [外部事件產生器] 視窗

使用 FileConnection API 可以存取已掛載的根目錄及其內容。

若要增加新的根目錄,請按一下 [掛載新項目],並填入目錄的名稱。若要讓 FileConnection API 無法存取目錄,請在清單中選取該目錄,再按一下 [卸載]。


10.2 PIM API

Sun JavaTM Wireless Toolkit for CLDC 模擬器將連絡人、行事曆及待辦資訊儲存成標準檔案,放在桌上型電腦的硬碟內。所有資訊會儲存於 workdir\appdb\skin\pim 中。此目錄由所有執行中的模擬器共用。清單分別儲存在 contactseventstodo 目錄的子目錄中。例如,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 格式。