Detailed Description
DefaultPersistentObject is the base class of all persistent objects.
It mainly implements an unique identifier for each instance (ObjectId), tracking of the persistent state, methods for setting and getting values as well as callback methods for lifecycle events.
Definition at line 34 of file DefaultPersistentObject.php.
Public Member Functions | |
__construct (ObjectId $oid=null) | |
initialize (array $data) | |
getType () | |
getMapper () | |
getOID () | |
setOID (ObjectId $oid) | |
getState () | |
setState ($state) | |
delete () | |
__clone () | |
copyValues (PersistentObject $object, $copyPkValues=true) | |
mergeValues (PersistentObject $object) | |
clearValues () | |
afterCreate () | |
beforeInsert () | |
afterInsert () | |
afterLoad () | |
beforeUpdate () | |
afterUpdate () | |
beforeDelete () | |
afterDelete () | |
getValue ($name) | |
setValue ($name, $value, $forceSet=false, $trackChange=true) | |
hasValue ($name) | |
removeValue ($name) | |
validateValues (Message $message) | |
validateValue ($name, $value, Message $message) | |
getChangedValues () | |
getOriginalValues () | |
getIndispensableObjects () | |
getProperty ($name) | |
setProperty ($name, $value) | |
getPropertyNames () | |
getValueProperty ($name, $property) | |
setValueProperty ($name, $property, $value) | |
getValuePropertyNames ($name) | |
getValueNames ($excludeTransient=false) | |
getDisplayValue () | |
dump () | |
__toString () | |
serialize () | |
unserialize ($serialized) | |
Protected Member Functions | |
setOIDInternal (ObjectId $oid, $triggerListeners) | |
setValueInternal ($name, $value) | |
validateValueAgainstValidateType ($name, $value, Message $message) | |
Additional Inherited Members | |
Public Attributes inherited from PersistentObject | |
const | STATE_CLEAN = 0 |
const | STATE_DIRTY = 1 |
const | STATE_NEW = 2 |
const | STATE_DELETED = 3 |
Constructor & Destructor Documentation
__construct | ( | ObjectId | $oid = null | ) |
Constructor.
The object will be bound to the appropriate PersistenceMapper automatically, if the PersistenceFacade knows the type. The object id is needed to extract the type. If the id parameter of the object id is a dummy id, the object is supposed to be a newly created object (
- See also
- ObjectId::containsDummyIds()).
- Parameters
-
$oid ObjectId instance (optional)
Definition at line 58 of file DefaultPersistentObject.php.
Member Function Documentation
initialize | ( | array | $data | ) |
- See also
- PersistentObject::initialize()
Implements PersistentObject.
Definition at line 78 of file DefaultPersistentObject.php.
getType | ( | ) |
- See also
- PersistentObject::getType()
Implements PersistentObject.
Definition at line 106 of file DefaultPersistentObject.php.
getMapper | ( | ) |
- See also
- PersistentObject::getMapper()
Implements PersistentObject.
Definition at line 113 of file DefaultPersistentObject.php.
getOID | ( | ) |
- See also
- PersistentObject::getOID()
Implements PersistentObject.
Definition at line 123 of file DefaultPersistentObject.php.
setOID | ( | ObjectId | $oid | ) |
- See also
- PersistentObject::setOID()
Implements PersistentObject.
Definition at line 130 of file DefaultPersistentObject.php.
|
protected |
Set the object id of the PersistentObject.
- Parameters
-
$oid The PersistentObject's oid. $triggerListeners Boolean, whether value CahngeListeners should be notified or not
Definition at line 140 of file DefaultPersistentObject.php.
getState | ( | ) |
- See also
- PersistentObject::getState()
Implements PersistentObject.
Definition at line 159 of file DefaultPersistentObject.php.
setState | ( | $state | ) |
- See also
- PersistentObject::setState()
Implements PersistentObject.
Definition at line 166 of file DefaultPersistentObject.php.
delete | ( | ) |
- See also
- PersistentObject::delete()
Implements PersistentObject.
Definition at line 198 of file DefaultPersistentObject.php.
__clone | ( | ) |
- See also
- PersistentObject::__clone()
Implements PersistentObject.
Definition at line 206 of file DefaultPersistentObject.php.
copyValues | ( | PersistentObject | $object, |
$copyPkValues = true |
|||
) |
- See also
- PersistentObject::copyValues()
Implements PersistentObject.
Definition at line 222 of file DefaultPersistentObject.php.
mergeValues | ( | PersistentObject | $object | ) |
- See also
- PersistentObject::mergeValues()
Implements PersistentObject.
Definition at line 235 of file DefaultPersistentObject.php.
clearValues | ( | ) |
- See also
- PersistentObject::clearValues()
Implements PersistentObject.
Definition at line 247 of file DefaultPersistentObject.php.
afterCreate | ( | ) |
- See also
- PersistentObject::afterCreate()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 276 of file DefaultPersistentObject.php.
beforeInsert | ( | ) |
- See also
- PersistentObject::beforeInsert()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 282 of file DefaultPersistentObject.php.
afterInsert | ( | ) |
- See also
- PersistentObject::afterInsert()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 288 of file DefaultPersistentObject.php.
afterLoad | ( | ) |
- See also
- PersistentObject::afterLoad()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 294 of file DefaultPersistentObject.php.
beforeUpdate | ( | ) |
- See also
- PersistentObject::beforeUpdate()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 300 of file DefaultPersistentObject.php.
afterUpdate | ( | ) |
- See also
- PersistentObject::afterUpdate()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 306 of file DefaultPersistentObject.php.
beforeDelete | ( | ) |
- See also
- PersistentObject::beforeDelete()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 312 of file DefaultPersistentObject.php.
afterDelete | ( | ) |
- See also
- PersistentObject::afterDelete()
- Note
- The default implementation does nothing
Implements PersistentObject.
Definition at line 318 of file DefaultPersistentObject.php.
getValue | ( | $name | ) |
- See also
- PersistentObject::getValue()
Implements PersistentObject.
Definition at line 323 of file DefaultPersistentObject.php.
setValue | ( | $name, | |
$value, | |||
$forceSet = false , |
|||
$trackChange = true |
|||
) |
- See also
- PersistentObject::setValue()
Implements PersistentObject.
Definition at line 333 of file DefaultPersistentObject.php.
|
protected |
Internal (fast) version to set a value without any validation, state change, listener notification etc.
- Parameters
-
$name The name of the value $value The value
Definition at line 367 of file DefaultPersistentObject.php.
hasValue | ( | $name | ) |
- See also
- PersistentObject::hasValue()
Implements PersistentObject.
Definition at line 374 of file DefaultPersistentObject.php.
removeValue | ( | $name | ) |
- See also
- PersistentObject::removeValue()
Implements PersistentObject.
Definition at line 381 of file DefaultPersistentObject.php.
validateValues | ( | Message | $message | ) |
Implements PersistentObject.
Definition at line 390 of file DefaultPersistentObject.php.
validateValue | ( | $name, | |
$value, | |||
Message | $message | ||
) |
Implements PersistentObject.
Definition at line 410 of file DefaultPersistentObject.php.
|
protected |
Check a value's value against the validation type set on it.
This method uses the validateType property of the attribute definition. Throws a ValidationException if the valud is not valid.
- Parameters
-
$name The name of the item to set. $value The value of the item. $message The Message instance used to provide translations.
Definition at line 422 of file DefaultPersistentObject.php.
getChangedValues | ( | ) |
Implements PersistentObject.
Definition at line 447 of file DefaultPersistentObject.php.
getOriginalValues | ( | ) |
Implements PersistentObject.
Definition at line 454 of file DefaultPersistentObject.php.
getIndispensableObjects | ( | ) |
Implements PersistentObject.
Definition at line 461 of file DefaultPersistentObject.php.
getProperty | ( | $name | ) |
- See also
- PersistentObject::getProperty()
Implements PersistentObject.
Definition at line 468 of file DefaultPersistentObject.php.
setProperty | ( | $name, | |
$value | |||
) |
- See also
- PersistentObject::setProperty()
Implements PersistentObject.
Definition at line 485 of file DefaultPersistentObject.php.
getPropertyNames | ( | ) |
Implements PersistentObject.
Definition at line 495 of file DefaultPersistentObject.php.
getValueProperty | ( | $name, | |
$property | |||
) |
Implements PersistentObject.
Definition at line 503 of file DefaultPersistentObject.php.
setValueProperty | ( | $name, | |
$property, | |||
$value | |||
) |
Implements PersistentObject.
Definition at line 525 of file DefaultPersistentObject.php.
getValuePropertyNames | ( | $name | ) |
Implements PersistentObject.
Definition at line 535 of file DefaultPersistentObject.php.
getValueNames | ( | $excludeTransient = false | ) |
Implements PersistentObject.
Definition at line 550 of file DefaultPersistentObject.php.
getDisplayValue | ( | ) |
- Note
- Subclasses will override this for special application requirements
Implements PersistentObject.
Definition at line 569 of file DefaultPersistentObject.php.
dump | ( | ) |
- See also
- PersistentObject::dump()
Implements PersistentObject.
Definition at line 576 of file DefaultPersistentObject.php.
__toString | ( | ) |
Get a string representation of the PersistentObject.
- Returns
- String
Definition at line 620 of file DefaultPersistentObject.php.
serialize | ( | ) |
Definition at line 624 of file DefaultPersistentObject.php.
unserialize | ( | $serialized | ) |
Definition at line 629 of file DefaultPersistentObject.php.