AutoCarga de Objetos KumbiaPHP

De KumbiaPHP Framework Wiki

Sobre la AutoCarga de Objetos

En KumbiaPHP Framework existe una implementación que ahorra muchísimo trabajo y como la intención es aprovechar al máximo las bondades del framework, en este sentido tenemos la AutoCarga de Objeto, la cual como su nombre indica asocia un campo de formulario (form) a una tabla y campo de la BD.

KumbiaPHP implementa la autocarga de objeto la cual siguiendo la convencion model.field en este caso el model es "menus" si vamos a la BD se vera que existe una tabla llamada "menus" y field (campo) serán los campos de esa tabla.

Veamos la estructura de tabla menus:

CREATE TABLE menus
(
 id           int            unique not null auto_increment,
 nombre       varchar(100),
 titulo       varchar(100)   not null,
 primary key(id),
)

En concordancia con los fields (campos) de la tabla "menus" se indica el comportamiento de la AutoCarga de Objeto para que el controller no tener que recoger cada uno de los valores enviado por POST.

Para este caso haremos en los helpers:

text_field_tag(array('menus.titulo'))

Automáticamente cuando ese valor vaya al action menus/create KumbiaPHP interpreta que existe una tabla "menus" con un campo "titulo" y si vemos la estructura de la tabla es así.

<?php View::content(); ?>
<?php echo form_tag('menus/create/') ?>
<table>
    <tr>
        <td>Nombre</td>
        <td><?php echo text_field_tag(array('menus.nombre')) ?></td>
    </tr>
    <tr>
        <td>Titulo</td>
        <td><?php echo text_field_tag(array('menus.titulo')) ?></td>
    </tr>   
    <tr>
        <td>&nbsp;</td>
        <td><?php echo submit_tag('Agregar') ?></td>
    </tr>
</table>
<?php echo end_form_tag() ?>

AutoCarga en el Controller

Ahora vemos el código que se utiliza en controllers/controllers_controller.php en su acción create().

    /**
     * Crea un Controlador para el menu
     *
     */
    public function create ()
    {
        //Datos del select
        $this->perfiles = $this->Perfiles->find('order: nombre');
        $this->menus = $this->Menus->find('order: nombre');
        /**
         * Se verifica si el usuario envio el form (submit) y si ademas 
         * dentro del array POST existe uno llamado "controllers"
         * el cual aplica la autocarga de objeto para guardar los 
         * datos enviado por POST utilizando autocarga de objeto
         */
        if ($this->has_post('controllers')) {
            /**
             * se le pasa al modelo por constructor los datos del form y ActiveRecord recoge esos datos
             * y los asocia al campo correspondiente siempre y cuando se utilice la convención
             * model.campo
             */
            $controller = new Controllers($this->post('controllers'));
            //En caso que falle la operación
            if (!$controller->save()) {
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->controllers = $this->post('controllers');
                /**
                 * NOTA: para que la autocarga aplique de forma correcta, es necesario que llame a la variable de instancia
                 * igual como esta el model de la vista, en este caso el model es "controllers"
                 */
            }
        }
    }