✒️ABAP Los Eventos
ABAP Los Eventos
Eventos.
1.-Disparar y manejar eventos.
En objetos ABAP hay ciertos métodos que se conocen como:
- Disparadores (triggers). Disparan un evento.
- Manejadores (handlers). 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 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 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.
Un evento dependiente de instancia puede ser disparado por cualquier método en la clase. Los eventos estáticos son disparados por métodos estáticos. Para disparar un evento en un método se usa:
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: No confundir este concepto de eventos en la POO con los eventos del entorno de ejecución ABAP, tales como LOAD TO PROGRAM, INITIALIZATION, START OF SELECCTION, END OF SELECCTION.
2.-Eventos manejadores.
Los eventos se usan para ejecutar una 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 dependiente de instancia se usa:
METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING..<ei>..
Para métodos estáticos se usa:
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 del evento. 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.-Registros 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.
SET HANDLER.. <hi>.. [FOR] ..
Esta sentencia relaciona los métodos manejadores de eventos con sus correspondientes métodos.
Existen 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 dependen de cuál de los cuatro 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 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 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 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 métodos manejadores de eventos son ejecutados antes de que el método manejador original continúe.
Para evitar la posibilidad de un bucle infinito, actualmente los eventos solo se pueden anidad 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. Pos esto se deben programar todos los manejadores de eventos como si se fuesen a ejecutar todos simultáneamente.
NOTA: Los eventos están sujetos a la misma estructura de visibilidad de los demás componentes de una clase, públicos, protegidos, privados. Los métodos manejadores de eventos también tienen atributos de visibilidad. Los eventos públicos pueden ser utilizados por cualquiera. Los protegidos solo pueden ser usados por los usuarios de la clase o subclases y los privados solo pueden ser usados dentro de la clase.
5.-Ejemplo del manejo 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 manejador es registrado en tiempo de ejecución para todas las variables referenciadas que apunten al objeto.
CLASS contador DEFINITION. PUBLIC SECTION. METHODS incrementar_contador. EVENTS valor_critico EXPORTING value(exceso) TYPE i. PRIVATE SECTION. DATA: cuenta TYPE i, umbral TYPE i VALUE 10. ENDCLASS. "contador DEFINITION *-------------------------------------------------------------------* CLASS contador IMPLEMENTATION. METHOD incrementar_contador. DATA diferencia TYPE i. ADD 1 TO cuenta. IF cuenta > umbral. diferencia = cuenta - umbral. RAISE EVENT valor_critico EXPORTING exceso = diferencia. ENDIF. ENDMETHOD. "incrementar_contador ENDCLASS. "contador IMPLEMENTATION *-------------------------------------------------------------------* CLASS manejador DEFINITION. PUBLIC SECTION. METHODS manejar_exceso FOR EVENT valor_critico OF contador IMPORTING exceso. ENDCLASS. "manejador DEFINITION *-------------------------------------------------------------------* CLASS manejador IMPLEMENTATION. METHOD manejar_exceso. WRITE: / 'El Exceso es: ', exceso. ENDMETHOD. "manejar_exceso ENDCLASS. "manejador IMPLEMENTATION
En START-OF-SELECCTION lo siguiente:
DATA: cuenta TYPE REF TO contador, 
 
 
Sobre el autor
Publicación académica de Juan Hernández, en su ámbito de estudios para la Carrera Consultor ABAP.
Juan Hernández
Profesión: Programador Informático - España - Legajo: XQ15K
✒️Autor de: 125 Publicaciones Académicas
🎓Egresado de los módulos:
Disponibilidad Laboral: PartTime
Certificación Académica de Juan Hernández