Creación y comprobación de aplicaciones de portlet Faces

JavaServer Faces (Faces) es una tecnología que permite construir páginas JSP que contengan componentes de interfaz de usuario preconstruidas (componentes Faces). Las páginas JSP que tienen componentes de Faces se pueden incluir en aplicaciones Web o portlets. Hay una biblioteca de códigos personalizados JSP para dar soporte al uso de los componentes Faces.

Rational Developer proporciona a los usuarios la posibilidad de arrastrar componentes de Faces a una página JSP y configurarlos para utilizarlos mediante la aplicación Web o el portlet. Para crear un probar un portlet JavaServer Faces, siga estos pasos:
Nota: para obtener instrucciones más detalladas, utilice los enlaces a temas proporcionados.
  1. Crear un proyecto de portlet Faces.
    1. Seleccione Archivo > Nuevo > Proyecto. A continuación, seleccione la opción Proyecto de portlet o Proyecto de portlet (JSR 168) de la derecha y pulse el botón Siguiente.
    2. Especifique un nombre y una ubicación para el proyecto. También puede pulsar el botón Mostrar avanzados para cambiar otros valores a nivel de proyecto.
    3. Active el botón de selección Portlet Faces.
    4. Puede pulsar Siguiente si desea:
      • Incluir características adicionales de Proyecto web, como la Biblioteca de códigos estándar JSP (JSTL).
      • Cambie el nombre de la aplicación o portlet.
      • Cambie el entorno local (idioma) y título por omisión.
      • Cambie el prefijo de clase o paquete.
      • Añada las modalidades Editar, Ayuda o Configurar al portlet (Ver se añade automáticamente, pero se puede quitar la selección).
    5. Pulse Finalizar. El asistente creará un proyecto de portlet y abrirá el Descriptor de despliegue de portlet, así como el archivo JSP para la modalidad Vista (por omisión). Si se incluyen las modalidades Editar, Ayuda o Configurar, también se creará un JSP para cada uno. Los nombres por omisión de estos JSP son projectNameView.jsp, projectNameEdit.jsp, projectNameHelp.jsp, projectNameConfigure.jsp, respectivamente.
  2. Crear archivos JSP de portlet Faces. Cree archivos JSP adicionales que se utilizarán como páginas de formulario de entrada y salida en la aplicación, por ejemplo.
    1. Seleccione Archivo > Nuevo > Archivo JSP de Faces en el menú de contexto del proyecto del Explorador de proyectos. Se abrirá el asistente Archivo JSP Faces nuevo.
    2. Especifique un nombre para el archivo JSP y el tipo de Modelo adecuado para el portlet.
    3. También puede marcar el recuadro de selección Configurar opciones avanzadas para añadir bibliotecas de códigos, especificar codificación, tipo de contenido e información sobre el tipo de documento, y para generar stubs de método para el archivo JSP.
    4. Pulse Finalizar. Se creará el archivo JSP con la marcación adecuada, y se abrirá automáticamente en el panel de edición de Page Designer.
  3. Añadir al portlet acceso a datos para componentes. En cada archivo JSP del portlet, realice una doble pulsación sobre el archivo en la vista Navegador de proyectos. Se abre el archivo JSP en Page Designer. Desde la bandeja Datos de la vista Paleta o la vista Datos de página, arrastre un componente hasta los archivos JSP de portlet y suéltelo.

    Por omisión, al archivo JSP también se añaden los componentes de Faces adecuados para los tipos de datos que se añaden. Estos componentes Faces se enlazan al origen de datos definido. Por ejemplo, una tabla de datos se puede añadir a una página portlet poniendo propiedades de bean desde la vista Datos de página.

    1. Puede añadir componentes de datos generales, como beans deJava y Servicios Web. Si desea utilizar beans de Java o servicios Web, arrastre estos elementos desde la vista Datos de página o desde la bandeja Datos y suéltelos en la Paleta; a continuación, complete los asistentes adecuados.
    2. Se puede añadir una tabla de componentes a una página de portlet si se utiliza un registro relacional. Cada campo de un registro relacional se representa por medio de una fila en la tabla. Los componentes que se encuentran dentro de cada fila dependen de los tipos de datos que se añaden y de la forma en que el usuario tiene pensado utilizar el registro relacional dentro de la página de portlet (es decir, para crear, actualizar o visualizar). Si desea añadir registros relacionales que utilicen WDO, hay dos componentes de Faces con los que puede trabajar:
      • Registro relacional - Este componente devuelve un único registro relacional y se puede enlazar a una tabla de datos u otro componente.
      • Lista de registros relacionales - Este componente devuelve una lista de registros relacionales y se puede enlazar a una tabla de datos u otro componente.
      La ventaja de utilizar registros relacionales y listas de registros relacionales es que se puede recuperar, crear, actualizar o suprimir información de una base de datos relacional y que, opcionalmente, esta información se puede enlazar para su visualización al usuario final.
      Nota: actualmente, el uso de los componentes Registro relacional y Lista de registros relacionales en los portlet Faces se proporciona sólo con el objetivo de hacer prototipos. Cuando se arrastra y suelta uno de estos componentes, se visualiza un mensaje de aviso que lo recuerda.
  4. Personalizar los portlets Faces. Puede arrastrar y soltar componentes reutilizables de la UI, como campos de entrada, botones de mandatos, hiperenlaces, paneles con pestañas y reproductores de medios a sus archivos JSP de portlet.
    Nota: en el entorno de edición de JSP (Page Designer), la mayoría de los pasos de desarrollo que implican añadir y configurar componentes de Faces son idénticos en los modelos de portlet Faces y Faces estándar.
    1. Si es necesario, abra los archivos JSP de su portlet realizando una doble pulsación sobre ellos en la vista Explorador de proyectos.
    2. Añadir componentes Faces. En la paleta de la parte derecha de la ventana de Page Designer aparece una bandeja que incluye Componentes Faces. Seleccione un componente y arrástrelo sobre la vista Origen o Diseño del archivo. El sistema de códigos que da soporte a dicho componente se añadirá al archivo JSP. Encontrará los detalles para añadir componentes específicos, en los temas siguientes:
    3. Configure los componentes de Faces.
      • Resalte el componente en la ventana de Page Designer.
      • En la vista Propiedades, asegúrese de que el componente que desee modificar se muestra en una de las vistas Propiedades. Los tipos de valores cambian, según el tipo de componente Faces que esté editando. En Atributos para componentes de Faces hallará una descripción de los atributos que puede establecer utilizando la vista Propiedades del componente.
    4. Adición de sucesos de script a páginas Web. Por ejemplo, puede asignar acciones a componentes Faces en las páginas JSP de Faces.
    5. Añada soporte para la mensajería entre portlets utilizando las instrucciones incluidas enDesarrollo de portlets de cooperación o en Mensajería de portlet directa de Faces si es necesario. También puede añadir soporte de reconocimiento de personas (consulte Adición de la función de reconocimiento de personas a los archivos JSP de portlet ) para ampliar las posibilidades de comunicación del portlet a las personas que forman parte de un entorno de colaboración.
    6. Añada soporte de texto e imágenes. Tras añadir y configurar los componentes de Faces, añada cualquier texto adicional e imágenes utilizando HTML u otro sistema de códigos JSP.
  5. Probar el portlet
    1. En la vista Explorador de proyectos, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Ejecutar > Ejecutar en servidor.
    2. En el asistente Selección de servidor, seleccione Entorno de prueba de WebSphere Portal.
    3. Pulse Finalizar. Se iniciará el entorno de prueba de WebSphere Portal y se visualizará el portlet en la ventana del navegador.

Conceptos relacionados
Desarrollo de portlets de cooperación

Tareas relacionadas
Adición de la función de reconocimiento de personas a los archivos JSP de portlet
Inserción de imágenes en archivos JSP portlet
Comprobación y depuración de portlets

(C) Copyright IBM Corporation 2002, 2005. Reservados todos los derechos.