superwaba.ext.xplat.io.pimal.datebook
Interface DateRecord

All Known Implementing Classes:

PalmDateRecord, PocketPCDateRecord

public interface DateRecord

extends VCalRecord

DateRecord describes the signature, a device specific implementation of a DateRecord has to fulfill. A DateRecord is one appointment. It's attributes are saved in it's DateFields When get*Fields() is called, the data must be read out directly from the device, new *Fields must be created from it and stored in a Vector. This is the place where you need some kind of "upward"-mapping of the datatypes (mapping the native data structure to the generic pimAL *Fields). Now we can understand why get*Records() does not have to read out the complete data from the device but only the ids: As soon as get*Fields() of a single *Record is called, the data will be read out anyway (it must only be found - thats where you need to device id for).

Method Summary

Vector	getFields() Reads DateFields from the device, maps them and stores them in DateFields and returns them.
java.lang.String	rawReadNote() Reads this DateRecord's note directly.
void	rawWriteNote(java.lang.String note) Writes this DateRecord's note directly
void	registerNotSupportedhandler(DateNotSupportedHandler nsh) Registeres a NotSupportedHandler that handle's DateFields this device cannot store
void	setFields(Vector fields) Reads information from the passed fields, maps them and writes them to the device.

Method Detail

getFields

public Vector getFields()

Reads DateFields from the device, maps them and stores them in DateFields and returns them.

Returns:

a Vector containing the contact information of this record in DateFields

setFields

public void setFields(Vector fields)

Reads information from the passed fields, maps them and writes them to the device. Passes not supported fields to a NotSupportedHandler

Parameters:

fields - the fields to write to the device

rawReadNote

public java.lang.String rawReadNote()

Reads this DateRecord's note directly.

Returns:

the note's text

rawWriteNote

public void rawWriteNote(java.lang.String note)

Writes this DateRecord's note directly

Parameters:

note - the text to write to the note

registerNotSupportedhandler

public void registerNotSupportedhandler(DateNotSupportedHandler nsh)

Registeres a NotSupportedHandler that handle's DateFields this device cannot store

Parameters:

nsh - the NotSupportedHandler to register