Clase que permite utilizar una tabla de la base de datos como si fuera un objeto.

Facilita métodos para recuperar, eliminar, actualizar e insertar registros.

package db
license MIT License
link http://jharo.net
author Juan Haro

 Methods

Devuelve el campo que su nombre coincida con el recibido como parámetro.

__get(string $fieldName) : \field

Si no encuentra ningún campo con ese nombre, creará un nuevo campo en el conjunto y devolverá el objeto creado.

Parameters

$fieldName

string

Returns

Elimina el registro de la tabla que coincida con el identificador contenido en el array $rowData.

delete(array $rowData) : \type

Parameters

$rowData

array

Returns

\type

Carga una nueva tabla de la base de datos y la guarda en una variable interna, o recupera una ya cargada.

get(string $tableName) : \self
Static

Parameters

$tableName

string

Returns

\self

Devuelve un array con los nombres de los campos que forman la tabla.

getFieldNames() : array

Alias de $this->getFields()->getFieldNames()

Returns

array

Devuelve el array de campos.

getFields(string $fieldName) : \fieldSet

Si recibe el nombre de un campo existente en la tabla, devuelve su objeto field.

Parameters

$fieldName

string

Exceptions

\dbTableException El campo no existe en la tabla.

Returns

\fieldSet| \field

Devuelve el campo identificador de la tabla.

getId() : \field

Returns

getTableName()

getTableName() 

Añade un nuevo registro en la tabla.

insert(array $rowData) : \type

Parameters

$rowData

array

Returns

\type

isNew()

isNew() 

Crea una tabla nueva con los campos que se han especificado.

save() 

Devuelve el conjunto de registros de la tabla que cumpla con las condiciones recibidas como parámetro.

selectAll(array $conditions) : \rowSet

Si no recibe condiciones, devolverá todos los registros de la tabla.

Parameters

$conditions

array

Returns

\rowSet| \tableRow

Devuelve el conjunto de registros de la tabla que cumpla con las condiciones recibidas como parámetro.

selectAllQuery(string $whereClause) : \rowSet

$whereClause debe ser una cadena de condiciones en lenguaje de consultas MySQL (p.ej., WHERE field = value and field2 = value2 or field3 = value3). Si no recibe condiciones, devolverá todos los registros de la tabla.

Parameters

$whereClause

string

Returns

\rowSet| \tableRow

Devuelve el registro de la tabla que coincida con el identificador recibido como parámetro.

selectOne(\type $id) : \tableRow

Parameters

$id

\type

Returns

Permite asignar un conjunto de campos a la variable $fields.

setFields(\fieldSet $fieldSet) 

Parameters

$fieldSet

\fieldSet

Elimina el objeto de tabla cargado en la variable $loadedTables

unsetTable() 

Actualiza los registros de la tabla con la información recibida.

update(array $rowData) : \type

Parameters

$rowData

array

Returns

\type

Crea un nuevo objeto dbTable.

__construct(string $tableName) 

Si recibe un nombre de tabla existente, cargará todos sus campos en el objeto de conjunto de campos $fields. Si el nombre de la tabla no coincide con ninguna tabla existente, creará un objeto de conjunto de campos vacío para la proceder a la creación de nueva tabla.

Parameters

$tableName

string

Recupera los campos de la tabla y los asigna al array de campos del objeto.

mapFields() 

Establece el campo identificador de la tabla.

setId(\field $id) 

Parameters

$id

\field

setTableName()

setTableName($tableName) 

Parameters

$tableName

 Properties

 

$loadedTables : array

Tras mapear una tabla, ésta se guarda en el array y puede ser recuperada posteriormente sin necesidad de crear un nuevo objeto.

 

$fields : \fieldSet
 

$id : \field
 

$tableName 
 

$newTable : \booean

Se utiliza en el modo de creación de tablas.

 

$rowSet : \rowSet

 Constants

 

SQL_NULL_FIELD

SQL_NULL_FIELD 
 

Identificador de clave primaria en MySQL.

SQL_PRIMARY_KEY