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 Series 40 and Nokia Asha software platform devices, see section Nokia-specific system properties.

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

String

Description

Series 40 return value

Nokia Asha software platform 1.0 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

/files/images/

Photos

fileconn.dir.videos.name

Localized name for the video directory

/files/videos/

Videos

fileconn.dir.graphics.name

Localized name for the graphic directory

/files/graphics/

Graphics

fileconn.dir.tones.name

Localized name for the sounds directory

/files/tones/

Tones

fileconn.dir.music.name

Localized name for the music directory

/files/music files/

Music

fileconn.dir.recordings.name

Localized name for the recordings directory

/files/recordings/

Recordings

fileconn.dir.memorycard.name

Localized UI name for the memory card of directory

/files/memory card/

Memory card

fileconn.dir.photos

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

file:///C:/predefgallery/predefphotos

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

fileconn.dir.videos

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

file:///C:/predefgallery/predefvideos

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

fileconn.dir.graphics

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

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

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

fileconn.dir.tones

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

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

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

fileconn.dir.music

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

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

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

fileconn.dir.recordings

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

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

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

fileconn.dir.memorycard

Root directory of memory card

file:///E:/

file:///MemoryCard/

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:///C:/DirectLoaded/RMSSimple_private/

file:///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.

phone;memory card;

Memory card;Phone memory;Private

fileconn.dir.themes.name

(Only in Series 40)

Localized name for the themes directory

/files/themes/

null

fileconn.dir.themes

(Only in Series 40)

The URL of the default storage directory for themes

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

null

Example:

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

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