Item methods
Last updated
Was this helpful?
version 0.x
Last updated
Was this helpful?
setup An optional hash array with the following possible setup keys:
loadMethod If specified, it loads the Item from the database using the given method, from one of the following available loading methods:
fromDatabaseRow Loads the item from the given object data passed in the databaseRow setup key.
fromId Loads the item identified by the id given in the id setup key.
fromData Loads the item using the data passed in the data setup key.
databaseRow The object to load the Item from when the fromDatabaseRow loadMethod is specified.
id The id on the database of the item to load, when the fromId loadMethod is specified.
data A hash array containing the data of the item to load, when the fromData loadMethod is specified, where each key is the field name, and its value the field value.
Throws: An Exception if the item could not be constructed or loaded.
Magic method to return the Item's data corresponding to the given key
key The key of the data to get, matches the database field name.
Returns: The data, or null if key didn't exist.
Magic method to check whether the given key exists in the item.
key The key of the data to check, matches the database field name.
Returns: true if the key exists, false if not.
Magic method to set the item data with the given key to the given value
key The key of the data to set, matches the database field name.
value The value
Removes this Item from the cache. Can be overloaded if more additional things have to be cleared from cache in relation to the Item.
Returns: true on success, false on failure.
Deletes this item from the database.
Returns: true on success, false on failure.
Loads the item with the given data.
Returns: true on success, false on failure.
Returns: true on success, false on failure.
Loads the item identified by the given id from the database.
id The id
queryDatabaseCache Load the item from the database using cache.
queryDatabase Load the item from the database without using cache.
Returns: true if the item was found and loaded successfully, false otherwise.
Loads the item when no loadMethod has been provided on construction. Intended to be overloaded when needed.
data A hash array with the data. Default: false
Returns: true on success, false on error.
Updates the data on the database for this Item with the passed data, or with the data stored on the object if no data is passed.
data An optional hash array where each key is the field name to update, and each value the new data to store on that field for this item. If not passed or left to false, the current data stored in the object is used. Default: false
Returns: true on success, false on failure.
fieldNames An optional array of field names that have been used to query items by index, so those queries will be cleared from cache. and other field names commonly used by this object are automatically added to this array and cleared from cache.
data A hash array containing the data of the item, where each key is the field name as defined in the property, and each value is the field value.
Loads the item from the given .
databaseRow A object containing the data of the item.
fieldName The name of the field containing the id, as defined in the property. Should be a field that uniquely identifies a row on the database.
method The loading method to use. If not specified, it uses the default . One of the following values:
For multilanguage fields, a hash array must be passed as the value, where each key is one of the available constants and the value is the value in that language. If a non-array value is passed the currently detected language will be used.