FileConnection API

On a real device, the FileConnection API typically provides access to files stored in the device’s memory or on a memory card.

In the Java ME Platform SDK emulator, the FileConnection API enables MIDlets to access files stored on your computer’s hard disk.

The files that can be accessed using FileConnection are stored in the following subdirectory:

Windows

Documents and Settings\User\Application Support\javame-sdk\3.0\work\emulator-instance\appdb\filesystem

Mac OS

User/Application Support/javame-sdk/3.0/work/emulator-instance/appdb/filesystem

For example, the DefaultCldcPhone1 emulator instance comes with a root directory installed called root1, which contains a Readme file and an empty directory named photos.

Each subdirectory of filesystem is called a root. The Java ME Platform SDK provides a mechanism for managing roots. While the emulator is running, choose View > External Events Generator from the emulator window’s menu. A utility window opens. Click the File Connection tab.

In the File Connection panel you can mount, unmount, or delete filesystem roots. Mounted roots are displayed in the top list, and unmounted roots are moved to the bottom list. Mounted root directories and their subdirectories are available to applications using the FileConnection API. Unmounted roots can be remounted in the future.

• To add a new empty filesystem root directory, click Mount Empty and fill in a name for the directory.

• To mount a copy of an existing directory, click Mount Copy, and browse to choose a directory you want to copy. When the File System Root Entry dialog opens, enter the name for this root. A deep copy of the selected directory is placed into the emulator’s filesystem with the specified root name.

• To make a directory inaccessible to the FileConnection API, select it in the list and click Unmount. The selected root is unmounted and moved to the Unmounted roots list.

• To completely remove a mounted directory, select it and click Unmount & Delete.

• To remount an unmounted directory, select it and click Remount. The root is moved to the mounted roots list.

• To delete an unmounted directory, select it and click Delete. The selected root is removed from the list.