✒️ABAP / Los Eventos Por David Campillo Martinez
ABAP Los Eventos
1. DISPARAR Y MANEJAR EVENTOS
Métodos Disparadores (TRIGGERS) y Métodos Manejadores (HANDLERS).
Los Triggers disparan un Evento y los Handlers se ejecutan cuando ocurre un Evento.
Para disparar un Evento una clase debe:
- Declarar el evento en la parte declarativa: EVENTS <evt> EXPORTING ... VALUE(<ei>) TYPE type [OPTIONAL].. Si el evento es Estático se declara así: CLASS-EVENTS <evt> Si añadimos EXPORTING a la declaración del Evento es para pasar parámetros al Manejador del Evento: se pasan siempre por valor. Los eventos no estáticos tienen el parámetro implícito SENDER que apunta al tipo o a la interface donde se declara el evento.
- Disparar el evento en uno de sus métodos. Un evento no estático puede dispararse por cualquier método de la clase. Los eventos estáticos son disparados por métodos estáticos. Disparar Evento: RAISE EVENT <evt> EXPORTING ...<ei> = <f i>...
Por cada parámetro formal no definido como opcional se tiene que pasar el correspondiente parámetro real en la adición EXPORTING. La referencia ME (a sí mismo) se pasa al parámetro SENDER.
2. EVENTOS MANEJADORES
Los handlers se usan para ejecutar una serie de métodos que tienen que:
- Estar definidos como 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 de su propia clase y para eventos de otras clases.
- Declaración de método handler dependiente de instancia:
METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING ... <ei>..
- Declaración de método handler estático:
CLASS-METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING ... <ei>..
La interfase de un método handler sólo puede contener parámetros formales definidos en la declaración del evento. El método handler no tiene por qué usar todos los parámetros pasados en la sentencia RAISE EVENT.
3. REGISTRO DE MÉTODOS MANEJADORES DE EVENTOS
Para que un método handler pueda reaccionar a un evento se tiene que determinar qué le va a disparar en tiempo de ejecución:
SET HANDLER ... <hi> ... [FOR]...
Esta sentencia relaciona los métodos handler con sus correspondientes métodos.
Hay 4 tipos diferentes de eventos:
- Dependientes de instancia declarados en una clase
- Dependientes de instancia declarados en una interface
- Estáticos declarados en una clase
- Estáticos declarados en una interface
La sintaxis de la sentencia SET HANDLER depende del tipo de evento (4 tipos):
- Para los eventos dependientes de instancia: Se tiene que usar la adición FOR para especificar la instancia para la que se quiere registrar el handler: SET HANDLER ... <hi> ... FOR <ref>. O bien registrar el handler para todas las instancias que puedan disparar el evento: SET HANDLER .. <hi> ... FOR ALL INSTANCES. Esto aplica incluso a las instancias aún no creadas cuando registramos.
- Para los eventos estáticos no se puede usar FOR: SET HANDLER ... <hi>...
4. COORDINACIÓN EN EL MANEJO DE EVENTOS
Después de la sentencia RAISE EVENT, todos los métodos handler registrados son ejecutados antes de que sea procesada la siguiente sentencia (Eventos Sincrónicos). Tb aplica si 1 evento desencadena 1 ó eventos. El evento original esperará a que se ejecuten los métodos de sus "hijos". Eso sí, hay un máximo en la anidación de eventos: 64 niveles.
Los métodos handler se ejecutan en el orden en que fueron registrados. PERO, como se registran dinámicamente, no se puede saber el orden en que serán procesados.
Los métodos handler tienen la misma visibilidad (Pública, Privada, Protegida) o más restringida que los eventos a los que se refieren.
5. EJEMPLO DEL MANEJO DE EVENTOS
Ejemplo de eventos: Clase CONTADOR implementa un contador. Se lanza el evento VALOR_CRITICO cuando el valor UMBRAL es excedido y se visualiza la diferencia (parámetro exceso). 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 apunten al objeto.
Escanear / Compartir
Sobre el autor
Publicación académica de David Campillo Martinez, en su ámbito de estudios para la Carrera Consultor ABAP Nivel Avanzado.
SAP Senior
David Campillo Martinez
Profesión: Administrador de Sistemas - España - Legajo: PC32Z
✒️Autor de: 56 Publicaciones Académicas
🎓Egresado del módulo:
Certificación Académica de David Campillo
Disponibilidad Laboral: FullTime 
