< Anterior | Siguiente >

Lección 3: Crear un cliente de servicio EGL

El paso siguiente consiste en crear un proyecto de cliente para utilizar el servicio. Mientras que el cliente que crea en esta guía de aprendizaje está en el mismo espacio de trabajo, puede imaginar que está en una ubicación completamente aparte o en una plataforma diferente. Puesto que no es necesario que los servicios y los clientes estén escritos en el mismo lenguaje de códigos, también puede imaginar que esta aplicación de cliente está escrita en un lenguaje diferente o que se ha creado con un conjunto de herramientas completamente distinto.

Mostrar

  1. Pulse Archivo > Nuevo > Proyecto.
  2. Expanda EGL y pulse Proyecto EGL.
  3. Pulse Siguiente.
  4. Denomine al proyecto EGL nuevo EGLClient.
  5. Pulse Proyecto Web.
  6. Pulse Siguiente.
  7. Asegúrese de que la opción Crear un descriptor de construcción nuevo está seleccionada. No hace falta que cambie los valores avanzados, a menos que emplee WAS y haya cambiado anteriormente los valores predeterminados que inhabilitan la opción de añadir el proyecto a un EAR.
  8. Es posible que vea una ventana que le pregunte si desea pasar a la perspectiva J2EE. Si ve esta ventana, pulse No.

Crear la página web del cliente

Para utilizar el servicio creará una página web en el cliente para recuperar entrada, pasar esa entrada al servicio y visualizar la salida del servicio. Empezará creando un manejador JSF, un tipo de componente lógico EGL que controla una página web y a continuación, EGL creará una página web que vaya con este manejador JSF.
  1. En la vista Explorador de proyectos, pulse el proyecto EGLClient para seleccionarlo.
  2. Pulse Archivo > Nuevo > Otros.
  3. Expanda EGL y pulse Manejador JSF.
  4. Pulse Siguiente.
  5. En la ventana Manejador JSF EGL nuevo, asegúrese de que el campo Carpeta fuente esté establecido en la carpeta EGLSource del proyecto:
    EGLClient\EGLSource
  6. En el campo Paquete, escriba este nombre:
    jsfhandlers
  7. En el campo Nombre de archivo fuente EGL, teclee este nombre:
    ClientPage
    La ventana tiene el aspecto siguiente:
    Ventana Manejador JSF EGL nuevo
  8. Pulse Finalizar. El Manejador JSF nuevo se abre en el editor.

    No guarde el archivo hasta que estas instrucciones le indiquen que lo haga. Cuando guarda un manejador JSF, EGL comprueba si la página web a la que se hace referencia en la propiedad view existe o no. Si no existe, EGL crea el archivo y añade campos automáticamente basándose en las variables del manejador JSF y las propiedades de DisplayUse de esas variables. Si guarda el archivo antes de haber añadido todas las variables, la página web nueva no incluirá todas las variables. Si esto ocurre, puede suprimir el archivo JSP (no el archivo manejador JSF) y volver a generar el manejador JSF para obtener una página web nueva.

  9. Elimine el código de ejemplo del manejador JSF nuevo de modo que todo lo que quede sea lo siguiente:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. Establezca el valor de la propiedad view en ClientPage.jsp, como en este ejemplo:
    {view = "ClientPage.jsp"}
  11. En el manejador JSF, cree las variables siguientes:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. Bajo las variables, añada esta función:
    function getHello()
    
    end
    Posteriormente añadirá código a esta función. El manejador JSF tiene el aspecto siguiente:
    El código en el manejador JSF
  13. Guarde el archivo. Cuando guarda el archivo, EGL crea automáticamente una página web del archivo. Este archivo se denomina con el valor de la propiedad view, ClientPage.jsp, y el archivo se coloca en la carpeta WebContent del proyecto.
    Si no obtuvo un archivo JSP, es que EGL no está configurado para generar automáticamente componentes de manejador JSF. Genere manualmente el manejador JSF pulsándolo con el botón derecho del ratón en la vista Explorador de proyectos o en el editor EGL y después pulsando Generar. A continuación, siga estos pasos adicionales para configurar la generación automática de manejadores JSF
    1. Pulse Ventana > Preferencias.
    2. En la ventana Preferencias, expanda EGL y pulse Generación.
    3. En la página Generación, marque el recuadro de selección Manejador.
    4. Pulse Aceptar.

    Ahora los manejadores JSF se generarán automáticamente cuando los guarde.

  14. Abra el archivo ClientPage.jsp en el editor. Esta página tiene campos basados en las variables creadas en el manejador JSF. Estos campos están preenlazados con las variables. De esta forma, cuando los valores de estos campos cambian en la página, las variables cambian para coincidir con ellos. Del mismo modo,cuando los valores de las variables del manejador JSF cambian, los valores de los campos de la página cambiarán para coincidir con ellos.

    Esta página también tiene varios campos de mensaje de error. Esto no significa que la página tenga errores; estos campos mostrarán errores en la página si es que se produce alguno al ejecutarla.

  15. Busque la vista Datos de página. Si no puede encontrar esta vista, pulse Ventana > Mostrar vista > Datos de página. Esta vista muestra los datos disponibles para la página, incluyendo las variables creadas en el manejador JSF. También muestra funciones en el manejador JSF.
  16. En la vista Datos de página, expanda Manejador JSF > Acciones y localice la función getHello().
  17. Arrastre la función getHello() de la vista Datos de página directamente al final de la página. En la página aparece un botón enlazado a la función. Cuando el usuario pulsa el botón en la página, en tiempo de ejecución, se ejecuta la función del manejador JSF.
  18. Guarde la página.
La página tiene el aspecto siguiente:
Aspecto de la página web del cliente

Ahora tiene una página web lista para utilizar el servicio web. En la próxima lección configurará el proyecto para actuar como cliente para el servicio a través de esta página web.

< Anterior | Siguiente >