Edición de «AutoCarga de Objetos KumbiaPHP»

{{cleanupbox
|image=[[Archivo:Information_icon4.png|45px]]
|texto ='''Este Artículo cumple con todos los quererimientos de los Kumbieros.'''<br />
}}
== Sobre la AutoCarga de Objetos ==
En [http://www.kumbiaphp.com 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.

[http://www.kumbiaphp.com 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'':

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

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:
<pre>
text_field_tag(array('menus.titulo'))
</pre>
En la Beta2
<pre>
Form::text('menus.titulo')
</pre>

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) ==

<source lang="php" line>
<?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() ?>
</source>

En la Beta2

<source lang="php" line>
<?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() ?>
</source>

== El Modelo Menus (menus.php) ==
<source lang=php>
<?php

    class Menus extends ActiveRecord{
        
    }

?>
</source>

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

<source lang="php" line>
 <?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');
        }
    }
}
?></source>

== Descarga este ejemplo ==
Descarga: [http://dl.dropbox.com/u/2807704/kumbiaPHP/v1_b1/app_autocarga_objetos.zip app_autocarga_objetos.zip] para el '''core''' del beta1

[[Categoría:Tutoriales KumbiaPHP]]