✒️ABAP POO / Los Eventos Por Jeferson Pena Curvelo
ABAP Los 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, mientras que 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.
EVENTS <evt> EXPORTING…VALUE(<ei>) TYPE type [OPTIONAL]…
Para declarar eventos estáticos se usa la siguiente sentencia:
CLASS-EVENTS <evt>…
Cuando se declara un evento se puede usar la adición EXPORTING para especificar parámetros que se pasan al manejador del evento. Los parámetros se pasan siempre por valor.
Los eventos dependientes de instancia siempre contienen 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 este 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.
Es importante no confundir este concepto de evento en la programación orientada a objeto (POO) con los eventos de ejecución ABAP como lo son los eventos: LOAD OF PROGRAM, INITIALITATION, START OF SELECTION, END OF SELECTION. Debe quedar claro que son eventos diferentes.
Los Eventos Manejadores: se usan para ejecutar una serie de métodos. Estos métodos tienen que:
- Estar definidos como eventos manejadoras (handler) de ese evento.
- Estar registrados en un 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 dependiente de instancia se usa la sentencia:
METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING… <ei>…
Para métodos estáticos se usa la misma sentencia con CLASS-METHODS en vez de METHODS.
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 evento no tiene por qué usar todos los parámetros pasados en la sentencia RAISE EVENT.
El registro de métodos manejadores de eventos: Para permitir a un método manejador de eventos reaccionar a un eventos, 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 sentencia relaciona los métodos manejadores de eventos con sus 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 HANDLER depende de cuál de los cuatros casos tenga lugar.
Para un evento dependiente de instancia se tiene que usar la adición FOR para especificar la instancia para la cual se requiere registrar el manejador. Se puede especificar una sola instancia como disparador usando una variable referenciada:
SET HANDLER… <hi>…FOR <ref>.
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.
La 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 síncrono).
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 continue.
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 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 quien está autorizado para controlar o manejar el evento. Los eventos que son públicos pueden ser utilizados por cualquiera. Los eventos que son protegidos solo pueden ser utilizados por usuarios dentro de la clase o subclases. Y los eventos que son privados solo pueden ser utilizados dentro de la clase. La visibilidad de un método manejador de evento determina quien está 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 que son protegidos pueden ser utilizados por el usuario dentro de la clase o su subclase. Y los métodos manejadores de eventos que son privados solo pueden ser utilizados por el usuario dentro de la clase. Los métodos manejadores de eventos pueden tener la misma visibilidad o más restringida de aquellos eventos de los que se refiere.
Escanear / Compartir
Sobre el autor
Publicación académica de Jeferson Jos Pena Curvelo, en su ámbito de estudios para el Master ABAP Orientado a Objetos.
SAP Expert
Jeferson Jos Pena Curvelo
Chile - Legajo: PD49W
✒️Autor de: 180 Publicaciones Académicas
🎓Egresado de los módulos:
- Master ABAP Orientado a Objetos
- Master ABAP for HANA
- Carrera Consultor ABAP Nivel Avanzado
- Carrera Consultor ABAP Nivel Inicial
Disponibilidad Laboral: FullTime
