<?php /* vim: set binary expandtab tabstop=4 shiftwidth=4 textwidth=80:
-------------------------------------------------------------------------------
- Ministerio de Economía
- meconlib
+ mlib
-------------------------------------------------------------------------------
-This file is part of meconlib.
+This file is part of mlib.
-meconlib is free software; you can redistribute it and/or modify it under
+mlib is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
-meconlib is distributed in the hope that it will be useful, but WITHOUT
+mlib is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
/**
* Indica que las condiciones deben concatenarse con <tt>OR</tt>.
*/
-define('MECON_DBO_OR', 'OR');
+define('MLIB_DBO_OR', 'OR');
/**
* Indica que las condiciones deben concatenarse con <tt>AND</tt>.
*/
-define('MECON_DBO_AND', 'AND');
+define('MLIB_DBO_AND', 'AND');
/**
* @example DBO.php
* para consulta.
*/
-// +X2C Class 16 :MECON_DBO
+// +X2C Class 16 :MLIB_DBO
/**
* Interfaz genérica para objetos que pueden ser guardados y/o operan con bases de datos.
Utilizando esta interfaz se pueden hacer objetos genericos que manejen DBO, como por ejemplo tablas para listarlos. La forma común de recorrer una serie de resultados de una búsqueda de DBO puede verse en el método buscar().
* @access public
* @abstract
*/
-class MECON_DBO {
+class MLIB_DBO {
// ~X2C
// +X2C Operation 17
Si hay un error, devuelve un PEAR_Error, si no devuelve la cantidad de objetos encontrados y carga el primero (si hay al menos un resultado).
En el caso típico, se setea la propiedad que es la clave de la base de datos (siendo el resto nulas). Por ejemplo:
@code
-class miDBO extends MECON_DBO {
+class miDBO extends MLIB_DBO {
// Definición...
}
$db = DB::connect('mi DSN');
Si alguna clave es <tt>null</tt>, generalmente se guarda un objeto nuevo autoincrementando la clave en <tt>null</tt>. Si todas las claves son distintas de <tt>null</tt> y existe un objeto con las mismas claves, se modifica del existente los campos que el objeto no tenga en <tt>null</tt>; si no existe da error a menos que se use el indicador <tt>\$nuevo</tt>, en cuyo caso se agrega como nuevo. Si hay un error, devuelve un PEAR_Error. Si se guardan los datos bien, devuelve <tt>true</tt>.
Por ejemplo:
@code
-class miDBO extends MECON_DBO {
+class miDBO extends MLIB_DBO {
// Definición...
}
$db = DB::connect('mi DSN');
Si hay un error, devuelve un PEAR_Error. Si no, devuelve la cantidad de objetos borrados de la base de datos.
Por ejemplo:
@code
-class miDBO extends MECON_DBO {
+class miDBO extends MLIB_DBO {
// Definición...
}
$db = DB::connect('mi DSN');
Si hay un error, devuelve un PEAR_Error. Si no, devuelve un DB_Result con los resultados de la búsqueda.
Por ejemplo:
@code
-class miDBO extends MECON_DBO {
+class miDBO extends MLIB_DBO {
// Definición...
}
$db = DB::connect('mi DSN');
$miDBO = new MiDBO();
$miDBO->nombre = 'rez';
-$res = $miDBO->buscar($db, MECON_DBO_AND, 'nombre ASC');
+$res = $miDBO->buscar($db, MLIB_DBO_AND, 'nombre ASC');
if (PEAR::isError($res)) {
echo 'Hubo un error.';
} else {
Es similar a cargar, ya que se hace un <tt>SELECT</tt> con un <tt>WHERE</tt> basado en los atributos no nulos pero puede concatenarse con <tt>AND</tt> u <tt>OR</tt> y se busca con <tt>LIKE</tt> para que dea más general.
*
* @param DB $db Base de datos a utilizar en la búsqueda.
- * @param int $operador Indica que operador se usa para la búsqueda. Puede ser MECON_DBO_AND o MECON_DBO_OR.
+ * @param int $operador Indica que operador se usa para la búsqueda. Puede ser MLIB_DBO_AND o MLIB_DBO_OR.
* @param mixed $orden Campos por los cuales ordenar. El formato es <tt>campo (ASC|DESC)</tt> (siedo <tt>ASC</tt> si se lo ordena de forma ascendente y <tt>DESC</tt> si se lo ordena de forma descendente). Puede pasarse un <em>string</em> o un <em>array</em> con varios <em>strings</em> con este formato para ordenarlo por más de un campo a la vez.
*
* @return mixed
* @access public
* @abstract
*/
- function buscar($db = null, $operador = MECON_DBO_OR, $orden = '') // ~X2C
+ function buscar($db = null, $operador = MLIB_DBO_OR, $orden = '') // ~X2C
{
trigger_error('Not implemented!', E_USER_WARNING);
}
// -X2C
-} // -X2C Class :MECON_DBO
+} // -X2C Class :MLIB_DBO
?>
\ No newline at end of file