AutoCarga de Objetos KumbiaPHP

De KumbiaPHP Framework Wiki
{{#if:Information icon4.png |}}

{{#if:

|}}


Sobre la AutoCarga de Objetos[editar]

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 Framework implementa la AutoCarga de Objeto la cual siguiendo una convención mínima model.field donde el model es "menus", es decir 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 tenga que recoger cada uno de los valores enviado por POST.

Para este caso haremos en los helpers:

text_field_tag(array('menus.titulo'))

En la Beta2

Form::text('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í.

La Vista (create.phtml)[editar]

<?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() ?>

En la Beta2

<?php View::content(); ?>
<?php echo Form::open('menus/create/') ?>
<table>
    <tr>
        <td>Nombre:</td>
        <td><?php echo Form::text('menus.nombre') ?></td>
    </tr>
    <tr>
        <td>Titulo:</td>
        <td><?php echo Form::text('menus.titulo') ?></td>
    </tr>   
    <tr>
        <td>&nbsp;</td>
        <td><?php echo Form::submit('Agregar') ?></td>
    </tr>
</table>
<?php echo Form::close() ?>

El Modelo Menus (menus.php)[editar]

<?php

    class Menus extends ActiveRecord{
        
    }

?>

AutoCarga en el Controller (menus_controller.php)[editar]

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

 <?php
 /**
     * Crea un Controlador para el menu
     *
     */
    Load::model('menus');
      
class MenusController extends ApplicationController
{
    
    public function create ()
    {
        /**
         * Se verifica si el usuario envio el form (submit) y si ademas 
         * dentro del array POST existe uno llamado "menus"
         * el cual aplica la autocarga de objeto para guardar los 
         * datos enviado por POST utilizando autocarga de objeto
         */
        if($this->has_post('menus')){
            /**
             * 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
             */
            $menu = new Menus($this->post('menus'));
            //En caso que falle la operación de guardar
            if(!$menu->save()){
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->menus = $this->post('menus');
                /**
                 * 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 "menus" y quedaria $this->menus
                 */
            }
        }
        else
        {
           Flash::success('Operación exitosa: datos Guardado');
        }
    }
}
?>

Para la Beta2

 <?php
 /**
     * Crea un Controlador para el menu
     *
     */
    Load::model('menus');
      
class MenusController extends ApplicationController
{
    
    public function create ()
    {
        /**
         * Se verifica si el usuario envio el form (submit) y si ademas 
         * dentro del array POST existe uno llamado "menus"
         * el cual aplica la autocarga de objeto para guardar los 
         * datos enviado por POST utilizando autocarga de objeto
         */
        if(Input::hasPost('menus')){
            /**
             * 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
             */
            $menu = new Menus(Input::post('menus'));
            //En caso que falle la operación de guardar
            if(!$menu->save()){
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->menus = Input::post('menus');
                /**
                 * 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 "menus" y quedaria $this->menus
                 */
            }
        }
        else
        {
           Flash::success('Operación exitosa: datos Guardado');
        }
    }
}
?>

Descarga este ejemplo[editar]

Descarga: app_autocarga_objetos.zip para el core del beta1