DataObjectInterface
interface DataObjectInterface (View source)
DataObjectInterface is an interface that other data systems in your application can implement in order to behave in a manner similar to DataObject.
In addition to the methods defined below, the data of the object should be directly accessible as fields.
Methods
Create a new data object, not yet in the database. To load an object into the database, a null object should be constructed, its fields set, and the write() method called.
Write the current object back to the database. It should know whether this is a new object, in which case this would be an insert command, or if this is an existing object queried from the database, in which case thes would be
Remove this object from the database. Doesn't do anything if this object isn't in the database.
Details
__construct()
Create a new data object, not yet in the database. To load an object into the database, a null object should be constructed, its fields set, and the write() method called.
write()
Write the current object back to the database. It should know whether this is a new object, in which case this would be an insert command, or if this is an existing object queried from the database, in which case thes would be
delete()
Remove this object from the database. Doesn't do anything if this object isn't in the database.
__get($fieldName)
Get the named field.
This function is sometimes called explicitly by the form system, so you need to define it, even if you use the default field system.
setCastedField($fieldName, $val)
Save content from a form into a field on this data object.
Since the data comes straight from a form it can't be trusted and will need to be validated / escaped.'