superwaba.ext.palm.io.builtin.pimal
Class PalmAddressBook

java.lang.Object
  |
  +--superwaba.ext.palm.io.builtin.pimal.PalmAddressBook

public class PalmAddressBook

extends java.lang.Object

implements AddressBook

Implementation of the AddressBook interface for PalmOS

Constructor Summary

PalmAddressBook()

Method Summary

void	addCategory(java.lang.String category) Adds a category
AddressRecord	createAddressRecord() Creates a new AddressRecord
void	deleteAddressRecord(AddressRecord addressRecord) Deletes an AddressRecord from the device
RecordList	getAddressRecords() Reads stored AddressRecords from the device.
Vector	getCategories()
void	removeCategory(java.lang.String category) Removes a category
void	renameCategory(java.lang.String oldName, java.lang.String newName) Renames a category

Methods inherited from class java.lang.Object

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

Constructor Detail

PalmAddressBook

public PalmAddressBook()

Method Detail

getAddressRecords

public RecordList getAddressRecords()

Description copied from interface: AddressBook

Reads stored AddressRecords from the device. The returned Vector will be adapted, when records are deleted or created later on.

Specified by:

getAddressRecords in interface AddressBook

Tags copied from interface: AddressBook

Returns:

RecordList of AddressRecords stored on this device

createAddressRecord

public AddressRecord createAddressRecord()
                                  throws NotSupportedByDeviceException

Description copied from interface: AddressBook

Creates a new AddressRecord

Specified by:

createAddressRecord in interface AddressBook

Tags copied from interface: AddressBook

Returns:

The created AddressRecord

Throws:

NotSupportedByDeviceException - when no/no more records can be created on the given device

getCategories

public Vector getCategories()
                     throws NotSupportedByDeviceException

Specified by:

getCategories in interface AddressBook

Tags copied from interface: AddressBook

Returns:

A Vector if Strings containing the category name

Throws:

NotSupportedByDeviceException - when the given device doesn't support categories

addCategory

public void addCategory(java.lang.String category)
                 throws NotSupportedByDeviceException

Description copied from interface: AddressBook

Adds a category

Specified by:

addCategory in interface AddressBook

Tags copied from interface: AddressBook

Parameters:

category - Category to add

Throws:

NotSupportedByDeviceException - when the given device doesn't support categories or doesn't support more categories

removeCategory

public void removeCategory(java.lang.String category)
                    throws NotSupportedByDeviceException

Description copied from interface: AddressBook

Removes a category

Specified by:

removeCategory in interface AddressBook

Tags copied from interface: AddressBook

Parameters:

category - the name of the category to remove

Throws:

NotSupportedByDeviceException - when the given device doesn't support categories

renameCategory

public void renameCategory(java.lang.String oldName,
                           java.lang.String newName)
                    throws NotSupportedByDeviceException

Description copied from interface: AddressBook

Renames a category

Specified by:

renameCategory in interface AddressBook

Tags copied from interface: AddressBook

Parameters:

oldName - old name of the category

newName - new name of the category

Throws:

NotSupportedByDeviceException - when the given device doesn't support categories

deleteAddressRecord

public void deleteAddressRecord(AddressRecord addressRecord)

Description copied from interface: AddressBook

Deletes an AddressRecord from the device

Specified by:

deleteAddressRecord in interface AddressBook

Tags copied from interface: AddressBook

Parameters:

addressRecord - AddressRecord to delete