✒️ABAP / Los Eventos Por Gustavo Ramirez Franco

1.- Disparar y manejar eventos.

Hay ciertos métodos que se conocen como disparadores (triggers) y otros que se conocen como manejadores(handlers).

TRIGGERS: Son los métodos que disparán un evento.

HANDLERS: Son los métodos que se ejecutan cuando ocurre un evento.

Para ejecutar un TRIGGER en una clase necesitamos:

• 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 un interface.

• Sintaxis para declarar eventos dependientes de instancia.

EVENTS <evt> EXPORTING... VALUE(<el>) TYPE type [OPTIONAL]...

• Sintaxis utilizada para la declaración de eventos estáticos.

CLASS-EVENTS <evt>

EXPORTING: Este comando se puede utilizar cuando se declara un evento y sirve para especificar parámetros que se pasan al manejador del evento. Los parámetros siempre son pasados por el valor.

Eventos dependientes de instancia:

• Siempre contienen el parámetro implicito SENDER, el cual tiene el tipo de una referencia al tipo o a la interface en la cual el evento es declarado.
• En una clase puede ser disparado por cualquier método en la clase.

Los eventoes estáticos son disparados por métodos estáticos. Para disparar un evento en un método, se usa lo siguiente:

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

Por cada parámetro formal que NO ESTE DEFINIDO COMO OPCIONAL se tiene que pasar el correspondiente parámetro real en la adición EXPORTING. La referencia a sí mismo ME es pasada automáticamente al parámetro implicito SENDER.

Es importante no confundir el concepto de eventos en la POO, con los eventos del entorno de ejecución ABAP tales como son: LOAD-OF-PROGRAM, INITIALIZATION, START-OF-SELECTION ó END-OF-SELECTION debemos dejar claro que son conceptos totalmente diferentes.

2.- Eventos Manejadores.

Los eventos se utilizan para ejecutar una serie de métodos. Estos métodos necesitan estar:

• Definidos como eventos manejadores(handler) de ese evento.
• 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.
• Sintaxis utilizada para declarar un método manejador de eventos dependiente de instancia.

METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING.. <ei>..

• Para métodos estáticos se usa la siguiente sentencia:

CLASS-METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING.. <ei>..

• La interface de un método manejador de eventos sólo puede contener parámetros formales definidos en la declaración de eventos.
• Los atributos de los parámetros también son adoptados por el evento.
• El método manejador de eventos NO tiene por que usar todos los parámetros pasados en la sentencia RAISE EVENT.

3.- Registro de métodos manejadores de eventos.

• 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.
• Sintaxis utilizada para determinar el disparador que reaccionará aun evento.

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

Esta sentencia relaciona los métodos manejadores de eventos con sus correspondientes métodos.

Existen 4 tipos diferentes de eventos:

1. Eventos dependientes de instancia declarados en una clase.
2. Eventos dependientes de instancia declarados en una interface.
3. Eventos estáticos declarados en una clase.
4. Eventos estáticos declarados en una interface.

La sintaxis y el efecto de la sentencia SET HANDLER depende de cual de los cuatro casos que detallamos tenga lugar.

Para un evento dependiente de instancia se tiene que usar la adición FOR para especificar la instancia en la cual se quiere registrar el manejador. Podemos utilizar UNA sola INSTANCIA como disparador usando una variable referenciada.

• Sintaxis utilizada para determinar el disparador de eventos dependientes de instancia.

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

• Sintaxis utilizada para determinar el disparador de eventos para todas las instancias.

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

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

NO se puede USAR un FOR para los eventos ESTÁTICOS.

• Sintaxis utilizada para eventos estáticos.

SET HANDLER... <hi>......

• El registro se aplica autómaticamente 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 aun NO han sido CARGADAS cuando el MANEJADOR SE REGISTRA.

4.- 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 (manejo de eventos sincrónico).
• Si un método manejador de eventos desencadena eventos, los correspondientes(ó siguientes) métodos manejadores de eventos son ejecutados ANTES de que el método manejador original continué.
• Para evitar la posibilidad de un bucle infinito, actualmente los eventos sólo pueden ser anidados 64 níveles.
• 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 eso deben programarse TODOS los manejadores de eventos como si fuesen a ejecutarse todos SIMULTANEAMENTE.

Los EVENTOS están sujetos a la misma estructura de Visibilidad, de los demás componentes de una clase, por lo tanto pueden ser públicos, protegidos o privados, los MÉTODOS manejadores de eventos también tienen atributos de visibilidad, la visibilidad de un evento determina quién esta autorizado para controlar o manejar el evento.

• Los eventos que son públicos pueden ser utilizados por cualquiera.
• Los eventos que son protegidos sólo pueden ser utilizados por usuarios dentro de la clase o sus subclases.
• Los eventos privados sólo pueden ser utilizados dentro de la clase .
• La visibilidad de un método manejador de eventos, determina quién esta autorizado para registrar el método, es decir, en que lugares podremos utilizar la sentencia SET HANDLER.
• Los métodos manejadores de eventos que son públicos pueden ser utilizados en cualquier lugar.
• Los métodos manejadores de eventos que son protegidos pueden ser utilizados por el usuario dentro de la clase o sus subclases.
• Los métodos manejadores de eventos que son privados sólo pueden ser utilizados por el usuario dentro de la clase.
• Los métodos,manejadores de eventos pueden tener la misma visibilidad ó más restringida de aquellos eventos a los que se refieren.

5.- Ejemplo de manejo de eventos.

La clase CONTADOR implementa un contador. Se desencadna 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 manejador es registrado en tiempo de para todas las variables referenciadas que apunten al objeto,