superwaba.ext.xplat.io.pimal
Class PIMFactory

java.lang.Object
  |
  +--superwaba.ext.xplat.io.pimal.PIMFactory

Direct Known Subclasses:

PalmPIMFactory, PocketPCPIMFactory

public abstract class PIMFactory

extends java.lang.Object

PIMFactory is the class to connect to first, when writing an application using the pimAL framework. Use getInstance() to receive an instance you can work with. Then call create*(), according to the application you want to access.

Constructor Summary

PIMFactory()

Method Summary

abstract AddressBook	createAddressBook()
abstract DateBook	createDateBook()
abstract MemoBook	createMemoBook()
abstract ToDoBook	createToDoBook()
static PIMFactory	getInstance() Controls the creation of instances by making sure, only one instance is created.

Methods inherited from class java.lang.Object

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

Constructor Detail

PIMFactory

public PIMFactory()

Method Detail

getInstance

public static PIMFactory getInstance()
                              throws NotSupportedByDeviceException

Controls the creation of instances by making sure, only one instance is created. (Singleton)
Checks on which device the framework is currently running on and returns the corresponding PIMFactory. (Factory)

Returns:

the one and only instance of PIMFactory

Throws:

NotSupportedByDeviceException - when no PIM applications are supported on this device

createAddressBook

public abstract AddressBook createAddressBook()
                                       throws NotSupportedByDeviceException

Returns:

An interface to the device's address book

Throws:

NotSupportedByDeviceException - when device doesn't provide an address book

createDateBook

public abstract DateBook createDateBook()
                                 throws NotSupportedByDeviceException

Returns:

An interface to the device's date book

Throws:

NotSupportedByDeviceException - when device doesn't provide a date book

createToDoBook

public abstract ToDoBook createToDoBook()
                                 throws NotSupportedByDeviceException

Returns:

An interface to the device's todo book

Throws:

NotSupportedByDeviceException - when device doesn't provide a todo book

createMemoBook

public abstract MemoBook createMemoBook()
                                 throws NotSupportedByDeviceException

Returns:

An interface to the device's memo book

Throws:

NotSupportedByDeviceException - when device doesn't provide a memo book