HiperGalaxia

Introducción.

• Son objetos escritos basados en una especificación.
• Heredan de la clase CComponent.
• Es posible acceder y modificar sus propiedades así como lanzar y manejar sus eventos.

Propiedades.

• Son atributos públicos de lectura y escritura.
• Pueden definirse de dos maneras.
  • Declarando un atributo público en el componente.
    • En este caso el nombre de la propiedad es sensible a mayúsculas.
  • Definiendo los métodos setter y getter correspondientes.
    • En este caso el nombre de la propiedad no es sensible a mayúsculas.
    • Para implementar la propiedad imageType es necesario implementar los siguientes métodos.

      public function getImageType()
      {
          return $this -> _imageType;
      }
      
      public function setImageType($value)
      {
          $this -> _imageType = $value;
      }

    • Este método es mas flexible ya que permite definir una lógica del negocio que condicione el acceso a las propiedades.
    • De igual manera es posible implementar propiedades de sólo lectura (sin setter) o de sólo escritura (sin getter).

Eventos.

• Los eventos del componente son propiedades que toman referencias a métodos (event handlers) como valores.
• Estos métodos son invocados automáticamente cuando sucede el evento asociado.
• Un evento del componente es definido por la implementación de un método cuyo nombre empieza por on y termina con el nombre del evento asociado (no es sensible a mayúsculas).
  • Para el evento click -> el método deberá ser entonces: onClicked.

    public function onClicked($event)
    {
        // ...
    }

• Los eventos ($event) son instancias de la clase CEvent.
• Los manejadores de evento se asginan de la siguiente manera.

  $component -> onClicked = $callback;

  • $callback deberá ser una referencia válida en PHP según las siguientes opciones.
    • El nombre de una función global.
    • Un método de una clase, para este caso deberá ser de la forma array($objeto, 'nombreMétodo').
• Varios manejadores de evento pueden asociarse a un mismo evento, estos se ejecutarán en el orden en que fueron creados.
• Un manejador de eventos puede evitar que se invoquen los demás manejadores de eventos al realizar la siguiente modificación.

  $event -> handled = true;

Comportamientos.

• Un comportamiento es un objeto cuyos métodos pueden ser transferidos a los componentes que se le agreguen.
• Es decir, reune funcionalidades en lugar de realizar una especialización como lo hace la herencia convencional.
• Es posible agregar múltiples comportamientos lo que se asemeja a la herencia múltiple.
• Son análogos a los mixins que incluyen otros lenguajes orientados a objetos (como Ruby) o que implementan otros frameworks (como Symfony).
• Existen varias maneras de implementar un comportamiento.
  • Como una clase que implementa a la interfaz IBehaviour.
  • Como una clase que hereda de CBehaviour.
  • Si va a ser agregado a un modelo puede ser una clase que herede de CModelBehaviour o CActiveRecordBehaviour según corresponda.
• Para utilizar un comportamiento primero debe ser agregado a un componente.

  $comportamiento -> attach($nombre, $componente);
  $componente -> métodoDelComportamiento();

• Los comportamientos pueden ser activados y desactivados según se desee en cada componente.

  $componente -> enableBehaviour($nombre);
  $componente -> disableBehaviour($nombre);

• Si dos o mas comportamientos agregados a un componente entran en conflicto porque tienen métodos con igual nombre, la precedencia la tendrá el comportamiento que haya sido agregado primero.

Enlaces.

• Yii Web Programming Framework.
  http://www.yiiframework.com/
• Yii Documentation.
  http://www.yiiframework.com/doc/

Introducción.

• Son unidades autocontenidas de software.
• Tienen sus propios modelos, vistas, controladores y demás componentes de soporte.
• Se asemejan a una aplicación pero no pueden ser desplegados individualmente, deben residir como parte de  una aplicación.
• Los usuarios acceeden a los controladores de los módulos de la misma forma como se acceden los controladores convencionales.
• Son útiles para dividir el desarrollo y mantenimiento de aplicaciones muy grandes en módulos independientes.
• Facilitan la reutilización de código a alto nivel.
• Se utilizan para implementar funcionalidades como autenticación, manejo de usuarios, manejo de comentarios, etc.

Estructura.

• Cada módulo tiene una clase principal que hereda de CWebModule.
• El nombre de la clase se determina de la siguiente manera: ucfirst(IdentificadorMódulo) . 'Module'.
  • Ejemplo, la clase del módulo gallery debe llamarse GalleryModule.
• Esta clase se utiliza para almacenar información y características que son comúnes a todo el módulo.
  • CWebModule::params almacena los parámetros del módulo.
  • CWebModule:: components comparte componentes de aplicación a nivel del módulo.

Creación.

Utilizando yiic.

yiic permite crear fácilmente un esqueleto básico del módulo para empezar a trabajar sobre él.

$ cd WebRoot/MiAplicacion
$ protected/yiic shell

Yii Interactive Tool v1.0
Please type 'help' for help.  Type 'exito' to quit.

>> module gallery

Uso.

• Copie el directorio del módulo en el directorio modules de la aplicación.
• Declare el módulo (con su identificador) en la propiedad modules de la configuración de la aplicación de la siguiente manera.

  return array (
      // ...
      'modules' => array('gallery', /* ... */),
      // ...
  );

• Es posible especificar valores iniciales para las propiedades del módulo de la siguiente manera.

  return array (
      // ...
      'modules' => array(
          'gallery' => array(
              'fileType' => 'png',
              'rows' => 10,
              'cols' => 3
          ),
          /* ... */
       ),
      // ...
  );

• La instancia del módulo puede ser accedida a través de la propiedad module del controlador acrivo.

  $rows = Yii::app() -> controller -> module -> rows;

• Los módulos se acceden con la ruta módulo/controlador/acción.
  • Para el ejemplo, gallery/image/add corresponderá entonces con el URL http://www.servidor.com/index.php?r=gallery/image/add.
• Un módulo puede contener a su vez a otros módulos los cuales pueden ser accedidos de manera similar: móduloPadre/móduloHijo/controlador/acción.

Enlaces.

• Yii Web Programming Framework.
  http://www.yiiframework.com/
• Yii Documentation.
  http://www.yiiframework.com/doc/