System properties

On Nokia Asha software platform devices, the return value can vary and depends on whether there is a memory card present. By default, the memory card’s file system is used for all the common directories. However if the memory card is removed, the phone’s memory is used instead.

The table below contains the FileConnection API system properties that return the localized names of common directories and the URLs to the most common directories.

Note:

For information about the Nokia-specific com.nokia.dir.name:xxxx system property supported on Nokia Asha and Series 40 software platform devices, see section Nokia-specific system properties.

Table: FileConnection API system properties in Nokia Asha and Series 40 software platform devices

String

Description

Nokia Asha software platform 1.0 return value

Series 40 return value

microedition.io.file.FileConnection.version

Returns the version of FileConnection API supported by the device

1.0

fileconn.dir.photos.name

Localized name for the photo directory

Photos

/files/images/

fileconn.dir.videos.name

Localized name for the video directory

Videos

/files/videos/

fileconn.dir.graphics.name

Localized name for the graphic directory

Graphics

/files/graphics/

fileconn.dir.tones.name

Localized name for the sounds directory

Tones

/files/tones/

fileconn.dir.music.name

Localized name for the music directory

Music

/files/music files/

fileconn.dir.recordings.name

Localized name for the recordings directory

Recordings

/files/recordings/

fileconn.dir.memorycard.name

Localized UI name for the memory card of directory

Memory card

/files/memory card/

fileconn.dir.photos

The URL of the default storage directory for photos captured with the integrated camera and other images

file:///MemoryCard/_my_pictures/ Or file:///Phone/_my_pictures

file:///C:/predefgallery/predefphotos

fileconn.dir.videos

The URL of the default storage directory for video clips captured with the integrated camera or downloaded and saved

file:///MemoryCard/_my_videos Or file:///Phone/_my_videos/

file:///C:/predefgallery/predefvideos

fileconn.dir.graphics

The URL of the default storage directory for clip art graphics (caller group icons, background pictures, and other similar items)

file:///MemoryCard/_my_pictures/ Or file:///Phone/_my_pictures/

file:///C:/predefgallery/predefgraphics/

fileconn.dir.tones

The URL of the default storage directory for ring tones and other related audio files

file:///MemoryCard/_my_tones/ Or file:///Phone/_my_tones/

file:///C:/predefgallery/predeftones/

fileconn.dir.music

The URL of the default storage directory for music files (MP3, AAC, and others)

file:///MemoryCard/_my_music/ Or file:///Phone/_my_music/

file:///C:/predefgallery/predefmusic/

fileconn.dir.recordings

The URL of the default storage directory for voice recordings made with the device

file:///MemoryCard/_my_recordings/ Or file:///Phone/_my_recordings/

file:///C:/predefgallery/predefrecordings/

fileconn.dir.memorycard

Root directory of memory card

file:///MemoryCard/

file:///E:/

file.separator

Character used for separating directories in strings representing file and folder paths (as shown to the user).

Note:

Do not use the file.separator value to construct URIs, since this can result in invalid URIs. For valid URIs, the only allowed separator character is "/".

/

fileconn.dir.private.name

Localized name for the private work directory

Private

private

fileconn.dir.private

Private work directory of MIDlet suite

file:///Private/

file:///C:/DirectLoaded/RMSSimple_private/

fileconn.dir.roots.names

Localized names corresponding to roots returned by the FileSystemRegistry.listRoots() method. One localized name corresponds to each root returned by the method. Localized names are in the same order as returned by the method and are separated by a semicolon (;) character. If no localized name exists for the root, the non-localized (logical) name is returned in the property for this root. Root names returned through this property cannot contain the semicolon (;) character.

Note:

The localized names returned are meant to be shown to the user, not used in the File URIs.

Memory card;Phone memory;Private

phone;memory card;

fileconn.dir.themes.name

(Only in Series 40)

Localized name for the themes directory

null

/files/themes/

fileconn.dir.themes

(Only in Series 40)

The URL of the default storage directory for themes

null

file:///C:/predefgallery/predefthemes/

Example:

String url = System.getProperty("fileconn.dir.photos") + "myImage.jpg";

The content of the URL is file:///c:/data/Images/myImage.jpg