com.nokia.mid.pim
Class SocialPIM

java.lang.Object
  com.nokia.mid.pim.SocialPIM

public final class SocialPIM
extends java.lang.Object

This class contains extensions to the JSR75 PIM.

Field Summary

static int	MAX_LIST_COUNT_FOR_EACH_TYPE_PER_SUITE Max list count for each pim list type per suite
static int	MAX_MIME_LENGTH Max MIME length

Constructor Summary

SocialPIM()

Method Summary

static void

createSocialPIMList(int pimListType, java.lang.String mime) create a social pim list with mime as unified id of the list. After creating, PIM.getInstance().openPIMList() can be used to open the list. The items stored to this list are not visible to other MIDlets. When the MIDlet is removed from the system, the items contained by the lists opened by it will be automatically removed.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAX_LIST_COUNT_FOR_EACH_TYPE_PER_SUITE

public static final int MAX_LIST_COUNT_FOR_EACH_TYPE_PER_SUITE

Max list count for each pim list type per suite

See Also:

Constant Field Values

MAX_MIME_LENGTH

public static final int MAX_MIME_LENGTH

Max MIME length

See Also:

Constant Field Values

Constructor Detail

SocialPIM

public SocialPIM()

Method Detail

createSocialPIMList

public static void createSocialPIMList(int pimListType,
                                       java.lang.String mime)
                                throws SocialPIMException

create a social pim list with mime as unified id of the list.
After creating, PIM.getInstance().openPIMList() can be used to open the list.
The items stored to this list are not visible to other MIDlets.
When the MIDlet is removed from the system, the items contained by the lists opened by it will be automatically removed.

Example code:
SocialPIM.createSocialPIMList(PIM.CONTACT_LIST, mime);
SocialContactList scList = (SocialContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, mime);

Parameters:

pimListType - type of the list to be created (only ContactList type supported)

mime - the MIME type of the list that is used to identify this particular list. The MIDlet developer should take care that the MIME type used to identify the list is unique, because that is used when linking back to the MIDlet from the rest of the system using JSR 211 invocations. The developer should also do appropriate JSR 211 registrations so that the system can invoke this MIDlet. Platform will not check the content of mime, but will check the length of mime. If the duplicated mime in one suite happens, just ignore the request, no error will be reported.

Throws:

javax.microedition.pim.PIMException - If too many pim lists for one suite has been created or if system pim list resource is run out.

java.lang.SecurityException - If the application is not given permission for read/write.

java.lang.IllegalArgumentException - If mime is null or if mime exceeds MAX_MIME_LENGTH or if pimListType is not a valid PIM list type.

SocialPIMException