AutoCarga de Objetos KumbiaPHP

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 "controllers" si vamos a la BD se vera que existe una tabla llamada "controllers" y field (campo) serán los campos de esa tabla.

Veamos la estructura de tabla controllers:

CREATE TABLE controllers
(
 id           int            unique not null auto_increment,
 nombre       varchar(100),
 url          varchar(100)   not null,
 status       char(1)        not null,
 perfiles_id  int            not null,
 menu_id      int            not null,
 primary key(id),
 foreign key(perfiles_id) references perfiles(id),
 foreign key(menu_id) references menus(id)
)

En concordancia con los fields (campos) de la tabla "controllers" 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('controllers.url'))

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

<?php View::content(); ?>
<?php echo form_tag('controllers/create') ?>
<table>
	<tr>
		<td>Perfil</td>
		<td><?php echo select_tag(array('controllers.perfiles_id',
                                        $perfiles, 'option' => 'nombre',
                                        'include_blank' => 'Seleccione...')) ?>
        </td>
	</tr>
	<tr>
		<td>Menú</td>
		<td><?php echo select_tag(array('controllers.menu_id', 
                                        $menus, 'option' => 'nombre',
                                        'include_blank' => 'Seleccione...')) ?>
        </td>
	</tr>
	<tr>
		<td>URL</td>
		<td><?php echo text_field_tag(array('controllers.url')) ?></td>
	</tr>
	<tr>
		<td>Nombre a mostrar</td>
		<td><?php echo text_field_tag(array('controllers.nombre')) ?></td>
	</tr>	
	<tr>
		<td>Estado</td>
		<td><?php echo select_tag(array('controllers.status', 
                                        array('A'=>'Activo','D'=>'Desactivado'), 
                                        'include_blank' => 'Seleccione...'))?>
        </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"
                 */
            }
        }
    }