Parent ABSTRACT class of all persistent objects. This class should not be instantiated, only used for subclasses. This cannot be enforced, but please follow it!

Documentation/Instructions: A child class should run the follwing in its constructor:

$new = parent::PersistentObject('tablename', array('uniquestring'=>$value, 'uniqueid'=>$uniqueid));

where 'tablename' is the name of the database table to use for this object type, and array('uniquestring'=>$value, ...) defines a unique set of columns (keys) and their current values which uniquely identifies a single record in that database table for this object. The return value of the constructor (stored in $new in the above example) will be (=== TRUE) if a new record was created, and (=== FALSE) if an existing record was updated. This can then be used to set() default values for NEW objects and save() them.

Note: This is a persistable model that does not save automatically. You MUST call $this->save(); explicitly to persist the data in child classes.

****************************************************************************** ****************************************************************************