✒️ABAP / La definición de Clases, Atributos, Métodos y Eventos Por Victor Levi

2° Definición de Clases, Atributos, Métodos y Eventos

1- Clases Locales y Globales

Las Clases en ABAP se pueden declarar en forma Global o Local.

• Clases Globales
• Se definen a través de la Trx SE24 (Generador de Clases).
• Son almacenadas en el Class Pools en la Librería de Clases en el Repositorio R/3.
• Todos los programas ABAP en un sistema R/3 pueden accederlas.
• Deben estar preparadas para ser usadas en cualquier parte.
• Clases Locales
• Se definen en un programa ABAP
• Solo pueden ser invocadas desde el programa en el que se han definido.
• Son recomendadas cuando se van a utilizar en un solo programa.
• Diferencias y Similitudes
• Cuando se usa una Clase en un programa ABAP, el sistema primero la busca como Clase Local dentro del programa. Si no encuentra, entonces la busca como Clase Global.
• Las diferencias entre ambas están en la forma de crearlas y la Visibilidad.
• El uso es el mismo.

2- Definición de Clases Locales

Una definición completa de una Clase constará de una Parte Declarativa y de una Parte de Implementación.

• Declarativa o Definición
• Contiene la Declaración de todos los componentes de la Clase (Atributos, Métodos y Eventos)
• Al pertenecer a los Datos Globales del programa se deben situar al principio del mismo

CLASS counter DEFINITION.

PUBLIC SECTION.

METHODS: set IMPORTING value(set_value) TYPE i,

increment,

get EXPORTING value(get_value) TYPE i.

PRIVATE SECTION.

DATA count TYPE i.

ENDCLASS.

• Implementación
• Se debe incluir si se declaran Métodos en la parte Declarativa
• Contiene la Implementación de todos los Métodos de la Clase.
• Actúa como un bloque (una sección de código que no esté en el bloque no será accesible).

CLASS counter IMPLEMENTATION.

METHOD set.

count = set_value.

ENDMETHOD.

3- Estructura y Componentes de una Clase

- Estructura de una Clase

• Una Clase contiene Componentes
• Cada Componente se asigna a una Sección de Visibilidad (Público, Protegido o Privado).
• Las Clases implementan Métodos.

- Componentes de una Clase

• Son declarados en la Parte Declarativa de la Clase.
• Representan los contenidos de la Clase
• Definen los Atributos de los Objetos de una Clase.
• Cada uno es asignado a alguna de las 3 Secciones de Visibilidad
• Todos son visibles dentro de la Clase.
• Todos comparten el mismo espacio, por lo que sus nombres deben ser únicos.
• Tipos de Componentes
• - Dependientes de Instancia: Existen separadamente para cada Objeto de una Clase
• - Independientes de Instancia o Estáticos: Existen una sola vez para la Clase entera.

En los Objetos ABAP, las Clases pueden definir los siguientes Componentes:

• Atributos
• Métodos
• Eventos

4- Atributos

Son los Campos de Datos Internos de una Clase y pueden tener cualquier Tipo de Datos ABAP.

El Estado de un Objeto está determinado por el contenido de sus Atributos.

Un Tipo de Atributos son las Variables Referenciadas que permiten crear y acceder a los Objetos, de manera que, si se definen en una Clase permiten acceder a otros Objetos desde dentro de la Clase.

• Tipos de Atributos
• Dependientes de Instancia:
• El contenido es específico de cada Objeto.
• Se declaran con la sentencia DATA.
• Independientes de Instancia o Estáticos:
• El contenido define el Estado de la Clase
• Es válido para todas las Instancias de la Clase.
• Se declaran con la sentencia CLASS-DATA.
• Son accesibles desde todo el entorno de ejecución de la Clase.
• Todos los Objetos de una Clase tienen acceso a ellos.
• Si se cambia en un Objeto, el cambio es visible en todos los Objetos de la Clase.

Modificamos la Clase count definida anteriormente agregándole un Atributo Independiente de Instancia

CLASS counter DEFINITION.

PUBLIC SECTION.

METHODS: set IMPORTING value(set_value) TYPE i,

increment,

get EXPORTING value(get_value) TYPE i.

PRIVATE SECTION.

DATA count TYPE i. "Atributo Dependiente de Instancia

CLASS-DATA v_suma TYPE i. "Atributo Independiente de Instancia

ENDCLASS.

• Pueden acceder a todos los Atributos de una Clase pudiendo cambiar su contenido.
• Poseen una interfaz con Parámetros de Entrada y de Salida.
• Los Atributos Privados solo pueden ser cambiados por Métodos de la misma Clase.
• Se definen en la Parte Declarativa y se implementan en la Parte Implementación.
• Se pueden declarar Tipos de Datos y Objetos en los Métodos como en cualquier procedimiento ABAP.
• Se los invoca mediante la sentencia CALL METHOD.

• Tipos de Métodos
• Dependientes de Instancia:
• Se declaran con la sentencia METHODS.
• Pueden acceder a todos los Atributos de una Clase
• Pueden desencadenar todos los Eventos de una Clase
• Independientes de Instancia o Estáticos:
• Se declaran con la sentencia CLASS-METHODS.
• Sólo pueden acceder a los Atributos Estáticos
• Sólo pueden desencadenar Eventos Estáticos
• Especiales:
• CONSTRUCTOR: Son llamados automáticamente cuando se crea un Objeto
• CLASS_CONSTRUCTOR: Son llamados cuando se accede por primera vez a los Componentes de la Clase.

6- Eventos

Son Acontecimientos o Sucesos que utilizan los Objetos o las Clases para desencadenar la ejecución de un Método en otroObjeto o Clase.

Estos Métodos se llaman Métodos que Manejan Eventos (Event Handler Methods).

• El Método puede ser llamado por cualquier número de usuarios
• Cuando un Evento es desencadenado, cualquier número de Métodos puede ser llamado
• La unión entre el Método disparador del Evento (Trigger) y el Método Manejador del Evento (Handler) se establece en el entorno de ejecución, usando la sentencia SET HANDLER.
• El programa que llama determina los Métodos a los que quiere llamar, los cuales deben existir.
• El Manejador de Eventos determina los Eventos a los cuales tiene que reaccionar. Puede llamar a cualquiera.
• Los Eventos de una Clase pueden ser desencadenados en los Métodos de la misma Clase con RAISE EVENT.
• Para declarar a un Método (de cualquier Clase) como Manejador de Eventos se agrega FOR EVENT OF.
• Los Eventos tienen una interface de Parámetros (sólo de Salida) similar a la de los Métodos, que son pasados por elTrigger al Handler (mediante la sentencia RAISE EVENT) el cual los recibe como de Entrada.
• El Trigger y el Handler pueden ser Objetos o Clases, dependiendo de si tenemos Eventos Dependientes de Instanciao Eventos Estáticos y Métodos Manejadores de Eventos.
• Cuando un Evento es disparado, el correspondiente Handler es ejecutado en todas las Clases registradas para él

• Tipos de Eventos
• Dependientes de Instancia:
• Se declaran con la sentencia EVENTS.
• Sólo pueden ser desencadenados en un Método Dependiente de Instancia.
• Independientes de Instancia o Estáticos:
• Se declaran con la sentencia CLASS-EVENTS.
• Un Evento Estático puede ser desencadenado por cualquier Tipo de Método, pero un Método Estático puede desencadenar sólo Eventos Estáticos

CLASS handler DEFINITION.

PUBLIC SECTION.

METHODS handle_excess FOR EVENT critical_value OF counter

IMPORTING excess.

CLASS handler IMPLEMENTATION.

METHOD handle_excess.

WRITE: / 'Excess is' , excess.

ENDMETHOD.

• Tipos de Datos
• Se pueden definir Tipos de Datos ABAP dentro de una Clase con la sentencia TYPES.
• Los Tipos de Datos no son específicos de cada Instancia
• Existen una sola vez para todos los Objetos de la Clase.

• Constantes
• Son un Tipo Especial de Atributos Estáticos.
• Su valor se fija cuando son declaradas y no puede ser cambiado.
• Se declaran usando la sentencia CONSTANTS.
• Existen una sola vez para todos los Objetos de la Clase

CLASS vehiculo DEFINITION.

PUBLIC SECTION.

CONSTANS: pos_1 TYPE i VALUE 30.

TYPES: BEGIN OF ty_planta,

planta TYPE plant,

pais TYPE country,

region TYPE region.

NOTA: Cuando se definen Tipos de Datos dentro de la Definición de una Clase, podemos utilizar la adición READ ONLYluego de escribir el Tipo de la Variable, lo cual significará que el Atributo Público que fue declarado con la sentencia DATA,podrá ser leído desde afuera de la Clase pero solo podrá ser modificado por Métodos de la misma Clase. La adición READ ONLY solo puede ser utilizada dentro de la Sección Pública de la declaración de una Clase.

8- Visibilidad de una Clase

La Parte Declarativa o Definición de una Clase se divide en tres áreas de distinta visibilidad, las cuales definen la Visibilidad Externa de los Componentes de la Clase, esto es la Interface entre la Clase y el Usuario.

• PUBLIC SECTION (Parte Pública)
• Todos los Componentes son accesibles para todos los Usuarios de la Clase y para todos los Métodos de la Clase y de cualquier Clase que herede de ella.
• Los Componentes Públicos conforman la Interface entre la Clase y el Usuario
• PROTECTED SECTION (Parte Protegida)
• Todos los Componentes son accesibles para todos los Métodos de la Clase y de cualquier Clase que herede de ella.
• Los Componentes Protegidos conforman la Interface entre la Clase y todas sus Subclases.
• PRIVATE SECTION (Parte Privada)
• Todos los Componentes son visibles en los Métodos de la misma Clase.
• Los Componentes Privados no forman parte de la Interface externa de la Clase.

AUDIO:

• Los Atributos de una Clase a los que un Usuario Externo puede acceder directamente son los Atributos Públicos.
• Los Componentes Públicos de una Clase es lo que se conoce como la Interfaz de la Clase.
• A la Sección Privada se la conoce como la Ocultación de la Información o Encapsulación, esto es para proteger al Usuario de una Clase ya que se supone que los Componentes Privados de una Clase se modificarán en algún momento pero su Interfaz será siempre la misma. Todos los Usuarios Externos solo pueden acceder a sus Componentes a través de la Interfaz de la Clase, por lo que se continuará trabajando con la Clase como de costumbre después de realizado el cambio. El Usuario no se dará cuenta del cambio ya que solo la Implementación Interna fue modificada.
• Si los Componentes Públicos de una Clase son modificados de una manera incompatible, cada Usuario Externo debería tomar en cuenta estos cambios, por lo que se recomienda tener sumo cuidado cuando se modifican los Atributos Públicos y de ser posible evitar los cambios de los Componentes Públicos de nuestras Clases.