uicc.contactmanager
Class ContactManager

java.lang.Object
  extended by uicc.contactmanager.ContactManager

public class ContactManager
extends java.lang.Object

The ContactManager class gives access to the contact manager information base.

A contact manager is composed of:

An application needs to first get a reference to the ContactManager instance using the getContactManager() method.
Then it can use the methods provided by this instance to create FieldDescriptorsListView, ContactsListView and GroupsListView instances that will allow it to access these collections.

The ContactManager instance is a Permanent JCRE EntryPoint object.


Constructor Summary
ContactManager()
           
 
Method Summary
 ContactsListView createContactsListViewInstance()
           Factory method that returns a ContactsListView instance that represents the contact manager's contacts list.
 FieldDescriptorsListView createFieldDescriptorsListViewInstance()
           Factory method that returns a FieldDescriptorsListView instance that represents the contact manager's field descriptors list.
 GroupsListView createGroupsListViewInstance()
           Factory method that returns a GroupsListView instance that represents the contact manager's groups list.
static ContactManager getContactManager()
          Returns the ContactManager singleton.
 
Methods inherited from class java.lang.Object
equals
 

Constructor Detail

ContactManager

public ContactManager()
Method Detail

getContactManager

public static ContactManager getContactManager()
Returns the ContactManager singleton.

This instance is a JCRE Permanent Entry Point Object.
This method should be called during application installation, and the reference stored for use during the application's lifetime.

Returns:
the ContactManager instance.

createContactsListViewInstance

public ContactsListView createContactsListViewInstance()

Factory method that returns a ContactsListView instance that represents the contact manager's contacts list.

The instance returned is owned by the calling application.

Successive calls to this method will return distinct instances. Although they may represent the same contacts list, each of them has its own state.
This particularly applies to the current enumeration progress, which is specific to each instance.

Returns:
the new ContactsListView instance

createFieldDescriptorsListViewInstance

public FieldDescriptorsListView createFieldDescriptorsListViewInstance()

Factory method that returns a FieldDescriptorsListView instance that represents the contact manager's field descriptors list.

The instance returned is owned by the calling application.

Successive calls to this method will return distinct instances. Although they may represent the same field descriptors list, each of them has its own state.
This particularly applies to the current enumeration progress, which is specific to each instance.

Returns:
the new FieldsDescriptorsList instance

createGroupsListViewInstance

public GroupsListView createGroupsListViewInstance()

Factory method that returns a GroupsListView instance that represents the contact manager's groups list.

The instance returned is owned by the calling application.

Successive calls to this method will return distinct instances. Although they may represent the same groups list, each of them has its own state.
This particularly applies to the current enumeration progress, which is specific to each instance.

Returns:
the new GroupsListView instance