< Anterior | Siguiente >

Lección 2: Configurar el espacio de trabajo

Antes de escribir la lógica, cree dos proyectos EGL e importe los ejemplos de Dojo.

Una aplicación EGL está organizada en uno o más proyectos, cada uno de los cuales es una carpeta física dentro del espacio de trabajo. Un proyecto contiene una carpeta fuente EGL que se proporciona automáticamente, y dicha carpeta contiene uno o más paquetes que, a su vez, contienen archivos fuente EGL. Esta jerarquía es básica para el trabajo en EGL: un proyecto, después una carpeta fuente EGL, y luego un paquete con archivos fuente EGL.

Los archivos fuente EGL incluyen componentes EGL, que son definiciones de tipos que crea el usuario. Por ejemplo, un componente Service contiene la lógica, y un componente Record puede ser la base de una variable que se declara en el componente Service.

Los paquetes son importantes porque separan los componentes en diferentes contextos o espacios de nombres:
  • Un nombre de componente puede duplicarse en dos paquetes distintos y cualquier código fuente EGL puede hacer referencia a cada componente de forma precisa. La principal ventaja de los espacios de nombres es que los diferentes equipos pueden desarrollar diferentes componentes EGL sin causar conflictos de nombres.
  • Cada nombre de componente de un determinado paquete es exclusivo dentro de dicho paquete:
    • Un componente de un paquete puede hacer referencia fácilmente a otro componente del mismo paquete especificando el nombre del componente. Por ejemplo, aquí se muestra una declaración de un registro que se basa en el componente Record MyRecordPart:
      myRecord MyRecordPart{};
    • Un componente de un paquete también puede hacer referencia a un componente de un segundo paquete proporcionando el nombre del paquete y el nombre del componente, o bien mediante un método abreviado que implique importar el componente. Esta guía de aprendizaje proporciona ejemplos.

Un proyecto puede hacer referencia a los componentes de un segundo proyecto, pero sólo si la vía de acceso de construcción EGL del proyecto de que hace referencia identifica el proyecto referenciado. Una vez más, esta guía de aprendizaje proporciona ejemplos. Sin embargo, en todos los casos, evite utilizar el mismo nombre de paquete en diferentes proyectos, ya que dicho uso puede causar problemas en la resolución de nombres.

La siguiente tarea de esta guía de aprendizaje es crear los siguientes proyectos:
MortgageServiceProject
Contiene el componente Service de EGL y las definiciones relacionadas
MortgageUIProject
Contiene los manejadores de IU enriquecida y las definiciones relacionadas

Puede incluir todo el código en un único proyecto, pero la separación que se muestra aquí le permite desplegar fácilmente los dos tipos de código de diferentes maneras.

Crear un proyecto de servicio EGL

  1. Si se encuentra en una perspectiva del entorno de trabajo que no es EGL, vaya a la perspectiva EGL pulsando Ventana > Abrir perspectiva > [Otra] > EGL. El icono de perspectiva se encuentra en la esquina superior derecha del entorno de trabajo.
    El icono EGL indica la perspectiva EGL y se visualiza en una pestaña que está debajo de los iconos de minimizar, maximizar y cerrar.
  2. Pulse Archivo > Nuevo > Proyecto EGL, o bien pulse el icono Proyecto EGL nuevo en la barra de menús.
    El icono de proyecto nuevo es el primero de cuatro en el segundo grupo de iconos de la barra de menús.
  3. En la ventana Proyecto EGL, especifique la siguiente información:
    1. En el campo Nombre de proyecto, escriba el nombre siguiente:
      MortgageServiceProject
    2. En la sección Tipos de proyectos EGL, pulse Proyecto general.
      La ventana Proyecto EGL nuevo con el nombre de proyecto “MortgageServiceProject”.
    3. Pulse Siguiente.
  4. En la segunda ventana Proyecto EGL, los valores predeterminados que proporciona EGL deberían ser correctos. Verifique la siguiente información:
    1. La Plataforma de tiempo de ejecución de destino es Java. Este valor indica que EGL genera el código fuente Java desde el componente Service de EGL.
    2. Bajo Opciones de descriptor de construcción, el botón Crear un descriptor de construcción está seleccionado. Los descriptores de construcción controlan el proceso de generación. Dado que está creando un proyecto independiente para el servicio, puede utilizar el descriptor de construcción predeterminado que EGL crea automáticamente.
  5. Pulse Finalizar.
EGL crea un proyecto denominado MortgageServiceProject. Observe las carpetas que hay dentro del directorio:
EGLSource
Coloque aquí los paquetes y los archivos fuente.
EGLGen/JavaSource
EGL coloca aquí los archivos Java que genera.
JavaSource
Coloque aquí los archivos fuente Java personalizados. Estos archivos no se sobrescriben durante el proceso de generación.
Biblioteca del sistema JRE
EGL utiliza esta carpeta para los archivos JAR que dan soporte a Java Runtime Environment.
La vista Explorador de proyectos muestra el nuevo proyecto y las carpetas.

Crear un proyecto de IU enriquecida de EGL

  1. Pulse el icono Proyecto EGL nuevo en la barra de menús.
  2. En la ventana Proyecto EGL nuevo, especifique la siguiente información:
    1. En el campo Nombre de proyecto, escriba el nombre siguiente:
      MortgageUIProject
    2. En la sección Tipos de proyectos EGL, pulse Proyecto de IU enriquecida.
      La ventana Proyecto EGL con el nombre de proyecto "MortgageUIProject".
    3. Pulse Siguiente.
  3. En la segunda ventana Proyecto EGL, los valores predeterminados que proporciona EGL deberían ser correctos. Verifique la siguiente información:
    1. La opción Utilizar la ubicación predeterminada para el proyecto está seleccionada.
    2. La lista Bibliotecas de widgets contiene los siguientes proyectos:
      • Widgets de IU enriquecida de EGL
      • Widgets EGL Dojo
    3. En el grupo Características de proyecto EGL, la opción Crear un descriptor de despliegue de EGL está seleccionada.
  4. Pulse Siguiente.
  5. En la página Valores de EGL, seleccione MortgageServiceProject. El proyecto de servicio se añadirá a la vía de acceso de construcción para el nuevo proyecto, de modo que el proyecto de IU podrá utilizar componentes que están definidos en el proyecto de servicio.
  6. Pulse Finalizar.
EGL crea un proyecto llamado MortgageUIProject y añade proyectos de soporte al espacio de trabajo para la IU enriquecida, los widgets Dojo y la biblioteca de tiempo de ejecución Dojo. Además de los directorios que EGL ha creado para el proyecto General, un proyecto de IU enriquecida incluye el siguiente directorio:
WebContent
Contiene archivos de soporte, como por ejemplo hojas de estilo en cascada (CSS) e imágenes.
La vista Explorador de proyectos muestra el nuevo proyecto y las carpetas.

Importar el ejemplo de widgets EGL Dojo

  1. En el menú superior del entorno de trabajo, pulse Ayuda > Contenido de la ayuda.
  2. En el contenido de la ayuda, expanda Ejemplos > Ejemplos de tecnología > EGL y pulse Widgets EGL Dojo.
    El menú Ejemplos ampliados.
  3. En el panel Contenido, pulse Obtener el ejemplo.
    El panel Contenido
  4. En la ventana Importar, los valores predeterminados son correctos. Pulse Finalizar.
La versión más reciente del proyecto com.ibm.egl.rui.dojo.samples se añade al espacio de trabajo.
El proyecto de ejemplos de Dojo en la vista Explorador de proyectos.

Cambiar la vía de acceso de construcción para MortgageUIProject

La vía de acceso de construcción de EGL determina los proyectos que EGL examina al intentar resolver referencias de la lógica. Para añadir el proyecto que acaba de importar:

  1. En la vista Explorador de proyectos, pulse con el botón derecho del ratón en MortgageUIProject y, a continuación, pulse Propiedades. En el lado izquierdo de la ventana Propiedades para MortgageUIProject, pulse Vía de acceso de construcción EGL. EGL muestra una lista de los proyectos que hay en el espacio de trabajo.
  2. Seleccione el proyecto com.ibm.egl.dojo.samples. No es necesario seleccionar el proyecto com.ibm.egl.dojo.widgets dado que ya se encuentra en la vía de acceso de construcción del proyecto com.ibm.egl.dojo.runtime.local. La ventana de la vía de acceso de construcción terminada debería parecerse a la siguiente imagen:
    Cuatro de cinco proyectos están seleccionados.
    Estas selecciones significan que cuando organice las sentencias de importación que proporcionan otros detalles a sus programas, EGL examinará todos los proyectos seleccionados para resolver las referencias.
  3. Pulse Aceptar.

Punto de comprobación de lección

En esta lección, ha llevado a cabo las siguientes tareas:
  • Ha creado un proyecto EGL para el servicio de hipoteca
  • Ha creado un proyecto EGL para la aplicación de IU enriquecida
  • Ha importado el proyecto de ejemplos de EGL Dojo
  • Ha ajustado la vía de acceso de construcción EGL para el segundo proyecto

En la siguiente lección, creará un servicio dedicado para calcular una cuota mensual de la hipoteca.

< Anterior | Siguiente >

Comentarios