com.motorola.iden.udm
Class UDM

java.lang.Object
  com.motorola.iden.udm.UDM

public class UDM

extends java.lang.Object

Class for accessing the UDM databases on a device.

MOTOROLA and the Stylized M Logo are registered trademarks of Motorola, Inc. Reg. U.S. Pat. & Tm. Off.
© Copyright 2003 Motorola, Inc. All Rights Reserved.

Field Summary

static int	NAME_SORT NAME_SORT defines retrieving in name order sort.
static int	READ_ONLY READ_ONLY constant representing opening of a list in read only mode.
static int	READ_WRITE READ_WRITE constant representing opening of a list in read/write mode.
static int	SPEED_NUM_SORT SPEED_NUM_SORT defines retrieving in speed number sort.

Method Summary

static DateBook	openDateBook(int mode) Creates a DateBook and populates it with native DateBook data.
static PhoneBook	openPhoneBook(int mode) Creates a PhoneBook and populates it with native PhoneBook data.
static PhoneBook	openPhoneBook(int mode, int sort) Creates a PhoneBook and populates it with native PhoneBook data.

Methods inherited from class java.lang.Object

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

Field Detail

READ_ONLY

public static final int READ_ONLY

READ_ONLY constant representing opening of a list in read only mode.

Value 1 is assigned to READ_ONLY

See Also:

Constant Field Values

READ_WRITE

public static final int READ_WRITE

READ_WRITE constant representing opening of a list in read/write mode.

Value 2 is assigned to READ_WRITE

See Also:

Constant Field Values

NAME_SORT

public static final int NAME_SORT

NAME_SORT defines retrieving in name order sort. NAME_SORT is not supported on Gemini product.

Value 1 is assigned to NAME_SORT

See Also:

Constant Field Values

SPEED_NUM_SORT

public static final int SPEED_NUM_SORT

SPEED_NUM_SORT defines retrieving in speed number sort. SPEED_NUM_SORT is not supported on Gemini product.

Value 2 is assigned to SPEED_NUM_SORT

See Also:

Constant Field Values

Method Detail

openPhoneBook

public static PhoneBook openPhoneBook(int mode)
                               throws UDMException

Creates a PhoneBook and populates it with native PhoneBook data.

The PhoneBook is initially sorted by name.

Parameters:

mode - how to open the PhoneBook, either READ or READ_WRITE

Returns:

The default PhoneBookEntry list, "PhoneBook"

Throws:

UDMException - If the operation is unsupported or an error occurs.

java.lang.SecurityException - If the application is not given permission that matches the requested mode.

java.lang.IllegalArgumentException - If an invalid mode is provided as a parameter.

openPhoneBook

public static PhoneBook openPhoneBook(int mode,
                                      int sort)
                               throws UDMException

Creates a PhoneBook and populates it with native PhoneBook data. The sort order is not supported on Gemini product.

Parameters:

mode - how to open the PhoneBook, either READ or READ_WRITE

sort - specifies the sort order used to retrieved entries from the native database

Returns:

The default PhoneBookEntry list, "PhoneBook"

Throws:

UDMException - If the operation is unsupported or an error occurs.

java.lang.SecurityException - If the application is not given permission that matches the requested mode.

java.lang.IllegalArgumentException - If an invalid mode is provided as a parameter.

openDateBook

public static DateBook openDateBook(int mode)
                             throws UDMException

Creates a DateBook and populates it with native DateBook data.

Parameters:

mode - how to open the DateBook, either READ_ONLY or READ_WRITE

Returns:

The default DateBookEvent list, "DateBook"

Throws:

UDMException - If the operation is unsupported or an error occurs.

java.lang.SecurityException - If the application is not given permission that matches the requested mode.

java.lang.IllegalArgumentException - If an invalid mode is provided as a parameter.