✒️ABAP POO / Los Eventos Por Cristian Arteaga Diaz
ABAP Los Eventos
EVENTOS – LECCION 2-5
DISPARAR Y MANEJAR EVENTOS
El objeto ABAP hay ciertso 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 hablers son los métodos que se ejecutan cuando ocurre un evento
Para disparar un evento, una clase debe realizar dos acciones
- Declarar el evento en la parte de la declaración
- 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 <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 sicion 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 estaticos) 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
EVENTOS MANEJADORES
Los eventos se unas para ejecutar una serie de matodos.
- Estar definidos como eventos manejadores (handler) de ese evento
- Estar registrados en tiempo de ejecución para eventos
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 siguiente sentencia:
METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING… <ei>…
Para metodos estaticos se usa la misma sentencia con CLASS-METHODS en vez de METHODS
La interface de un método manejador de evento solo puede contener parámetros formales definidos en la declaración del evento. Los atributos de los parámetros también son adoptados por eventos
El método manejador de eventos no tiene por que usar todos los parámetros pasados en la sentencia RAISE EVENT
REGISTRO DE METODO MANEJADOR 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 reaccionar. Esto se hace con la siguiente sentencia
SET HANDLER… <hi>… [FOR]…
Esta sentencia relaciona los métodos manejadores de eventos con su correspondiente método
Hay cuatro tipos diferentes de eventos
- Eventos dependientes de instancia 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 una 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 adicion 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 pueden disparar el evento
SET HANDLER… <hi>… FOR ALL INSTANCES.
En este caso el registro se aplica incluso a las instancias que aun 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 has sido cargadas cuando el manejador se registra
COODINACION 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ónicos).
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 fuese a ejecutar todos simultáneamente
EJEMPLO DE MANEJADOR DE EVENTOS
El siguiente ejemplo muestra como se trabaja con eventos en los objetos ABAP
La clase CONTADOR implementa un contador. Se desencadena el evento valor_critico cuando el calor 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 ejecución para todas las variables referenciadas que apuntan al objeto.
Luego en el evento START-OF-SELECTION se declarará los siguiente
Y la salida por pantalla del programa será la que veremos a continuación
HANDLERS, los eventos se manejan utilizando métodos especiales. Para manejar un evento, un método debe:
- Ser definido como un método de controlador de eventos para ser evento
- Estar registrado en tiempo de ejecución para el evento
Para declarar un método de contolador de evento, se utiliza la instrucción
METHODS meth FOR EVENT evt OF cif IMPORTING e1 e2 ...
TRIGGERS, son métodos que disparan en evento
Para declarar eventos de instancia se utiliza la sentencia EVENTS evt EXPORTING... VALUE(e1 e2 ...) TYPE type [OPTIONAL]. Para declarar eventos estáticos se utiliza la sentencia CLASS-EVENTS evt.
- Disparar el evento en alguno de sus métodos con la sentencia RAISE EVENT
Escanear / Compartir
Sobre el autor
Publicación académica de Cristian Darwin Arteaga Diaz, en su ámbito de estudios para el Master ABAP Orientado a Objetos.
SAP Expert
Cristian Darwin Arteaga Diaz
Profesión: Abap Developer - Argentina - Legajo: GP81Q
✒️Autor de: 165 Publicaciones Académicas
🎓Cursando Actualmente: Master Funcional ABAP
🎓Egresado de los módulos:
- Master ABAP Orientado a Objetos
- Carrera Consultor ABAP Nivel Avanzado
- Carrera Consultor ABAP Nivel Inicial
Disponibilidad Laboral: FullTime
Presentación:
Me considero una persona responsable, siempre estoy investigando y capacitandome para adquirir nuevos conocimientos, tengo el gusto de iniciarme en el mundo de abap como desarrollador, es genial.
Certificación Académica de Cristian Arteaga
