TableInterface
Table class interface.
since |
3.2 |
---|
Methods
bind
Method to bind an associative array or object to the TableInterface instance.
bind(mixed $src, mixed $ignore = array()) : boolean
This method only binds properties that are publicly accessible and optionally takes an array of properties to ignore when binding.
since |
3.2 |
---|---|
throws |
|
Arguments
- $src
mixed
An associative array or object to bind to the TableInterface instance.- $ignore
mixed
An optional array or space separated list of properties to ignore while binding.
Response
boolean
True on success.
check
Method to perform sanity checks on the TableInterface instance properties to ensure they are safe to store in the database.
check() : boolean
Implementations of this interface should use this method to make sure the data they are storing in the database is safe and as expected before storage.
since |
3.2 |
---|
Response
boolean
True if the instance is sane and able to be stored in the database.
delete
Method to delete a record.
delete(mixed $pk = null) : boolean
since |
3.2 |
---|---|
throws |
|
Arguments
- $pk
mixed
An optional primary key value to delete. If not set the instance property value is used.
Response
boolean
True on success.
getDbo
Method to get the \JDatabaseDriver object.
getDbo() : \JDatabaseDriver
getKeyName
Method to get the primary key field name for the table.
getKeyName() : string
since |
3.2 |
---|
Response
string
The name of the primary key for the table.
load
Method to load a row from the database by primary key and bind the fields to the TableInterface instance properties.
load(mixed $keys = null, boolean $reset = true) : boolean
since |
3.2 |
---|---|
throws |
|
Arguments
- $keys
mixed
An optional primary key value to load the row by, or an array of fields to match. If not set the instance property value is used.- $reset
boolean
True to reset the default values before loading the new row.
Response
boolean
True if successful. False if row not found.
reset
Method to reset class properties to the defaults set in the class definition.
reset() : void
It will ignore the primary key as well as any private class properties.
since |
3.2 |
---|
store
Method to store a row in the database from the TableInterface instance properties.
store(boolean $updateNulls = false) : boolean
If a primary key value is set the row with that primary key value will be updated with the instance property values. If no primary key value is set a new row will be inserted into the database with the properties from the TableInterface instance.
since |
3.2 |
---|
Arguments
- $updateNulls
boolean
True to update fields even if they are null.
Response
boolean
True on success.