✒️ABAP POO Los Eventos

EVENTOS

DISPARAR Y MANEJAR EVENTOS

En objetos ABAP hay ciertos métodos que se conocen como disparadores (triggers) y otros que se conocen como manejadores (handlers).

Los triggers son los métodos que disparan un evento

Los handlers son los métodos que se ejecutan cuando ocurre un evento.

Para disparar un evento una clase tiene que:

· Declarar el evento en la parte declarativa

· Disparar el evento en uno de sus métodos.

Los eventos se declaran en la parte declarativa de una clase o en una interface.

Para declarar eventos:

dependientes de instancia se usa la siguiente sentencia:

EVENTS <evento> EXPORTING… VALUE (<ei> TYPE type [OPTIONAL]..

Eventos estáticos:

CLASS-EVENT <evento> EXPORTING …

EXPORTING: para especificar parámetros que se pasan al manejador de evento, estos siempre se pasan por valor.

Los eventos dependientes de instancia siempre contiene el parámetro implícito SENDER, el cual tiene el tipo de una referencia al tipo o a la interface en la cual el evento es declarado.

Los eventos dependientes de instancia solo pueden ser desencadenados en un método dependiente de instancia.

Todos los métodos (dependientes de instancia y estáticos) pueden desencadenar eventos estáticos.

Los eventos estáticos son el único tipo de eventos que puede ser desencadenado por un método estático.

Para disparar un evento en un método se usa la siguiente sentencia:

RAISE EVENT <evt> EXPORTING… <ei> = <f i>…

Por cada parámetro formal que no esté definido como opcional se tiene que pasar el correspondiente parámetro real en la adición EXPORTING. La referencia a si mismo ME es pasada automáticamente al parámetro implícito SENDER.

Nota: Estos eventos no son los mismos que en ABAP del entorno de ejecución tipo LOAD OF PROGRAM, INITIALIZTION, START-OF-SELECTION, END-OF-SELECTION, etc..

EVENTOS MANEJADORES

Los eventos se usan para ejecutar un serie de métodos. Estos métodos tienen que:

· Estar definidos como eventos manejadores (handler) de ese evento.

· Estar registrados en tiempo de ejecución para el evento.

Una clase puede contener métodos manejadores de eventos para eventos tanto de su propia clase como de otras clases.

Para declarar un método manejador de eventos:

Dependientes de instancia:

METHODS <método> FOR EVENT <evento> OF <cif> IMPORTING <ei>..

Para métodos estáticos

CLASS-METHODS <método> FOR EVENT <evento> OF <cif> IMPORTING <ei>..

La interface de un método manejador de eventos solo puede contener parámetros formales definidos en la declaración del evento.

Los atributos de los parámetros también son adoptados por el evento.

El método manejador de eventos no tiene por qué usar todos los parámetros pasados en la sentencia RAISE EVENT.

REGISTRO DE METODOS MANEJADORES DE EVENTO

Para permitir a un método manejador de eventos reaccionar a un evento, se tiene que determinar en tiempo de ejecución el disparador al cual va a reaccionar. Esto se hace con la sentencia:

SET HANDLER …<hi>..[FOR]…

Esta relación los métodos manejadores de eventos con su correspondientes métodos.

Hay cuatro tipos diferentes de eventos:

· Eventos dependientes de instancia declarados en una clase.

· Eventos dependientes de instancia declarados en una interface.

· Eventos estáticos declarados en una clase.

· Eventos estáticos declarados en una interface.

La sintaxis y el efecto de la sentencia SET HANDELR depende de cuál de los cuatro casos qué detallamos tenga lugar.

Para evento dependiente de instancia se tiene que usar la adición FOR para especificar la instancia para la cual se quiere registrar el manejador.

Se puede especificar una sola instancia como disparador usando una variable referenciada:

SET HANDLER … <hi>…FOR <ref>.

O se puede registrar el manejador para todas las instancias que puedan disparar el evento:

SET HANDLER …<hi>. .FOR ALL INSTANCES.

En este caso el registro se aplica incluso a las instancias que aún no han sido creadas cuando se registra el manejador.

No se puede usar la adición FOR para los eventos estáticos:

SET HANDLER.. <hi>..

El registro se aplica automáticamente a la clase entera o a todas las clases que implementan la interface que contiene el evento estático.

En el caso de las interfaces, el registro también se aplica a las clases que aún no han sido cargadas cuando el manejador se registra.

COORDINACIÓN EN EL MANEJO DE EVENTOS

Después de la sentencia RAISE EVENT, todos los métodos manejadores registrados son ejecutados antes de que la siguiente sentencia sea procesada (manejador de eventos sincrónico).

Si un método manejador de eventos desencadena eventos, los correspondientes métodos manejadores de eventos son ejecutados antes que el método manejador original continúe.

Para evitar la posibilidad de un bucle infinito, actualmente los eventos solo se pueden anidar 64 niveles.

NOTA: Los métodos manejadores de eventos son ejecutados en el orden en el que son registrados.

Debido a que los manejadores de eventos son registrados dinámicamente, no se puede saber el orden en el que serán procesados. Por esto se deben programar todos los manejadores de eventos como si se fuesen a ejecutar todos simultáneamente.

Los eventos están sujetos a la misma visibilidad que los demás componentes de una clase PUBLICO, PROTEGIDO o PRIVADO

Los métodos manejadores de evento también tienen atributos de visibilidad, esta determina quien está autorizado para controlar o manejar el evento.

· Los PUBLICOS: por cualquier

· Los PROTEGIDOS: dentro de la clase o subclase

· Los PRIVADOS: dentro de la clase.

La visibilidad de un método manejador de evento determina quien está autorizado para registrar el metido, en qué lugares podremos usar la sentencia SET HANDLER.

· Los PUBLICOS en cualquier lugar

· Los PROTEGIDOS: dentro de la clase y sus subclases

· Los PRIVADOS: dentro de la clase.

Los métodos manejadores de eventos pueden tener la misma visibilidad o más restringida de aquello eventos a los que se refieren.

EJEMPLO DE LOS MANEJADORES DE EVENTOS

La clase CONTADOR implementa un contador.

Se desencadena el evento valor_critico cuando el valor umbral es excedido y se visualiza la diferencia.

La clase MANEJADOR puede manejar las excepciones en la clase CONTADOR. El manejado es regiostrado en tiempo de ejecucin para todas las variables referenciadas que apunten al objeto.

CLASS contador DEFINITION.

…PUBLIC SECTION.

……METHODS incrementar_contador.

……EVENTS valor_critico EXPORTING value(exces) TYPE i.

…PRIVATE SECTION.

……DATA: cuenta TYPE i, umbral TYPE i VALUE 10.

ENDCLASS

CLASS contador IMPLEMENTATION.

…METHOD incrementar_contador.

……DATA direrencia TYPE i.

……ADD 1 TO cuenta.

……IF cuenta > umbral.

……..diferencia = cuenta – umbral.

……..RIASE EVENT valor_critico EXPORTING exceso = diferencia.

……ENDIF.

…ENDMETHOD.

ENDCLASS.

CLASS manejador DEFINTION.

…PUBLIC SECTION.

……METHODS manejar_exceso FOR EVENT valor_critico OF contador IMPORTING exceso.

ENDCLASS.

CLASS manejador IMPLEMENTATION.

…METHOD manejar_exceso.

……WRITE / ‘El Exceso es: ‘, exceso.

…ENDMETHOD

ENDCLASS.

Después en el evento START-OF-SELECTION se declara esto:

DATA: cuenta TYPE REF TO contador, manejador TYPE REF TO manejador.

START-OF-SELECTION.

…CREATE OBJECT: cuenta, manejador.

…SET HANDELR manejador->manejar_exceso FOR ALL INSTANCES.

…DO 20 TIMES.

……CALL METHOD cuenta->incrementar_contador.

…ENDDO.