Utilización de Java para escribir un manejador de eventos

Crear un manejador de eventos Java es ligeramente más complejo que crear un manejador de eventos JavaScript. No puede simplemente escribir código Java directamente en el Diseñador de informes BIRT.

Para crear una clase de manejador de eventos Java, debe compilar el fuente de la clase Java y asegurarse de que la clase sea visible para BIRT. Sin embargo, la creación de un manejador de eventos Java para BIRT se simplifica por el hecho de que Eclipse es un entorno sólido de desarrollo Java y da soporte a la integración de un proyecto Java con un proyecto BIRT.

Cómo crear una clase de manejador de eventos y cómo añadirla al proyecto Java

Esta sección describe el proceso para utilizar el entorno de desarrollo Java de Eclipse para crear una clase de manejador de eventos para un elemento BIRT codificable.

1	Añada org.eclipse.birt.report.engine_<versión>.jar al proyecto Java, tal como se describe en los pasos siguientes:

1	Seleccione el proyecto Java y seleccione Archivo→Propiedades→Vía de construcción Java→Bibliotecas. Aparecerá Vía de construcción Java, tal como se muestra en la Figura 23‑1.

Figura 23‑1

Adición de un archivo JAR a la vía de acceso de clases del compilador

2	Seleccione Añadir JAR externos. Aparecerá Selección de JAR.

3	Navegue hasta el directorio /plugins de Eclipse. En una instalación de Eclipse predeterminada, este directorio se encuentra en la siguiente ubicación:

<ECLIPSE_INSTALL>\eclipse\plugins

4	Seleccione org.eclipse.birt.report.engine_<versión>.jar. Seleccione Abrir. Aparece de nuevo Vía de acceso de compilación Java.

5	Seleccione Aceptar.

2	Seleccione el proyecto Java y seleccione Archivo→Nuevo→Otro. Aparecerá Seleccionar un asistente.

3	Expanda Java y seleccione Clase, tal como se muestra en la Figura 23‑2.

Figura 23‑2

El diálogo Seleccionar un asistente

Seleccione Siguiente. Aparecerá Clase Java nueva, tal como se muestra en la Figura 23‑3.

Figura 23‑3

Clase Java nueva

4	Navegue hasta la carpeta donde desee que resida el archivo fuente Java. Para ello seleccione el botón Examinar situado junto a Carpeta fuente.

5	Si la clase Java nueva forma parte de un paquete, escriba el nombre completo del paquete en Paquete.

6	En Nombre, escriba un nombre para la clase.

7	En Modificadores, seleccione Público.

8	Seleccione el botón Examinar situado junto a Superclase. Aparecerá Selección de superclase, tal como se muestra en la Figura 23‑4.

Figura 23‑4

Selección de superclase

9	En Elegir un tipo, escriba el nombre de la clase de adaptador para el elemento ROM. Por ejemplo, escriba Label EventAdapter para el elemento Label. Seleccione Aceptar. Reaparecerá Clase Java nueva.

10	Seleccione Generar comentarios. Seleccione Finalizar. Aparecerá una vista de editor Java, similar a la que se muestra en la Figura 23‑5.

Figura 23‑5

El editor Java

11	Añada el método del manejador de eventos para la nueva clase de manejador de eventos. La Figura 23‑6 muestra la adición de un método onPrepare( ) que establece el color de fondo de la etiqueta en rojo.

Figura 23‑6

El método onPrepare(  ) en el editor Java

Cómo asociar una clase Java a un elemento de informe

El ejemplo mostrado en este procedimiento da por supuesto lo siguiente:

n	El diseño de informe incluye un elemento de informe codificable, tal como una etiqueta.

n	Una clase Java que contiene métodos de manejador de eventos para el elemento de informe codificable es visible para BIRT.

1	En Esquema, seleccione el elemento de informe para el que una clase de manejador de eventos es visible para BIRT, tal como se muestra en la Figura 23‑7.

Figura 23‑7

Selección de un elemento de informe

2	En el Editor de propiedades para el elemento de informe seleccionado, seleccione Manejador de eventos y escriba el nombre completo de la clase del manejador de eventos, tal como se muestra en la Figura 23‑8.

Figura 23‑8

El nombre de clase del manejador de eventos