Creación de proyectos de portlet Faces

Dependiendo de si prefiere crear recursos de portlet Faces basados en la API de portlet IBM o en la API de portlet JSR 168, debe elegir el asistente adecuado para crear el proyecto de portlet Faces.
En el proceso de creación del proyecto, se añadirá un portlet Faces por omisión. El asistente genera automáticamente los archivos de configuración del portlet, la estructura de directorios necesaria y las actualizaciones correspondientes al archivo web.xml.
  1. En la barra de menús, seleccione Archivo > Nuevo > Proyecto de portlet para crear un proyecto de portlet que contenga un portlet API de IBM. En la barra de menús, seleccione Archivo > Nuevo > Proyecto de portlet (JSR 168) para crear un proyecto de portlet que contenga un portlet API JSR 168. Se abrirá el asistente para el tipo de proyecto de portlet adecuado.
  2. Introduzca valores adecuados en los campos siguientes:
    Nombre de proyecto
    Nombre del proyecto de portlet nuevo.
    Ubicación del proyecto
    La ubicación en el sistema de archivos donde se va a crear el proyecto. Puede cambiar la ubicación del sistema de archivos mediante Examinar.
    Versión de WebSphere Portal
    Seleccione la versión adecuada de WebSphere Portal para su proyecto de portlet. Su selección establecerá el servlet adecuado y el servidor de destino correspondiente para el entorno de desarrollo.
    Crear un portlet
    Si no desea crear las definiciones de portlet iniciales en el proyecto, borre este recuadro de selección. Normalmente, no es necesario crear un portlet al importar un archivo WAR de portlet al proyecto.
    Para establecer los valores J2EE del proyecto, o para especificar el servidor de tiempo de ejecución de destino para el proyecto, pulse el botón Mostrar avanzados >> y especifique uno de los valores siguientes.
    Nota: si selecciona un valor de versión de WebSphere Portal, la versión de servlet y el servidor de destino se establecerán con los valores adecuados. No se recomienda editar estos dos campos.
    Versión de servlet
    Especifica la versión de servlet y las especificaciones JSP que deben incluirse en la aplicación de servlet. La versión 2.3 (valor por omisión) incluye un nivel de especificación de servlet 2.3 y un nivel de especificación JSP 1.2. Este valor por omisión deberá utilizarse para crear proyectos de portlet destinados a los servidores 5.0 o 5.1 de WebSphere Portal.

    Tenga en cuenta que la versión de servlet determinará la elección de los servidores de destino que aparezcan en la lista desplegable.

    Servidor de destino
    Seleccione la versión de WebSphere Portal en la que vaya a instalar su aplicación de portlet (WebSphere Portal v5.0 o v5.1).
    Nota: asegúrese de no seleccionar involuntariamente una de las opciones de WebSphere Application Server.
    Añadir un módulo a un proyecto EAR
    Deseleccione ese recuadro de selección únicamente si no tiene previsto desplegar el portlet.
    Proyecto EAR
    Nombre de proyecto de aplicación empresarial (proyecto EAR) con el que el proyecto de portlet debe asociarse para que se realice el despliegue. La información que se utilice para desplegar el proyecto de portlet en WebSphere Portal en el entorno de prueba se añadirá a este proyecto. Todas las aplicaciones de portlet asociada a un único proyecto EAR se ejecutarán en una única sesión en el entorno de prueba. Puede separar aplicaciones de portlet en varios proyectos EAR. Deberá utilizar el mismo proyecto EAR para otros proyectos relacionados.
    Directorio raíz de contexto
    Directorio raíz de contexto para el proyecto de portlet. Se utiliza como el directorio de nivel superior de la aplicación de portlet cuando se despliega en WebSphere Portal en el entorno de prueba. Debe ser distinto al de los otros proyectos.
    Añada soporte para las clases de Java anotadas
    Asegúrese de que este recuadro de selección está seleccionado si tiene previsto utilizar anotaciones de modelo para generar código en el proyecto.
  3. Pulse Siguiente.
  4. Pulse el botón de selección Portlet Faces. Si desea aceptar los valores por omisión asociados a un proyecto de portlet habilitado por Faces, pulse Finalizar. Si prefiere personalizar las opciones de proyecto, pulse Siguiente.
  5. El recuadro de selección Crear un diagrama Web para el proyecto está seleccionado por omisión para que pueda crearse un archivo de diagrama Web (.gph) en el proyecto. Para crear un proyecto de portlet que utilice los códigos de la Biblioteca de códigos estándar JSP, seleccione la Biblioteca de códigos estándar JSP en la lista Características de proyecto Web. Para obtener más información sobre la manera en que WebSphere Portal soporta el uso de códigos de la Biblioteca de códigos estándar JSP (JSTL), consulte la sección "Using JSTL tags in the portal JSPs" (Uso de códigos JSTL en los JSP de portal) en Information Center de WebSphere Portal.
  6. Actualice o añada valores generales de portlet de la página Valores de portlet. Pulse Siguiente.
  7. En la página Varios, especifique las modalidades adicionales que desee habilitar para el portlet del proyecto.

    Marque el recuadro de selección Crear subclase de portlet para crear una subclase de com.ibm.faces.webapp.WPFacesGenericPortlet (o com.ibm.faces.webapp.FacesGenericPortlet si el portlet utiliza la API JSR 168 API), mediante los prefijos de clase común y nombre de paquete definidos anteriormente en el asistente, e inserte stubs de método que llamen a la super implementación. Puede personalizar la clase de portlet como desee.

    La modalidad Vista está seleccionada por omisión al principio, pero se puede desactivar. Para cada modalidad que seleccione (incluyendo Vista), puede especificar una página Inicial distinta de la página por omisión, que se construye utilizando el nombre del proyecto. El campo Página inicial acepta una especificación de vía de acceso, relativa a la carpeta Web Content (por ejemplo, si escribe /folder/subfolder/TestView.jsp, TestView.jsp se creará en el directorio /WebContent/folder/subfolder. Las carpetas que no existan se crearán. La barra inicial /" es opcional.

    En la lista desplegable Modelo, puede seleccionar Portlet, para un archivo JSP de portlet Faces estándar, o Portlet con colocación en antememoria para datos en la parte del cliente para añadir la función de infraestructura cliente de Faces al proyecto, así como la directiva taglib apropiada en el archivo JSP.

    Se crean los archivos JSP iniciales especificados y los valores <config-param> correspondientes (para un portlet IBM) o <init-param> (para un portlet JSR 168) se generan automáticamente en portlet.xml al completarse el asistente. Para añadir modalidades adicionales después de crear el portlet, hay que especificar los parámetros de configuración utilizando el editor de descriptor de despliegue del portlet.
  8. Pulse Finalizar. Se crea un proyecto de portlet nuevo con la definición adecuada en el portlet Faces en los archivos web.xml y portlet.xml.

Conceptos relacionados
Creación de portlets y proyectos de Faces
Comunicación de portlets Faces

Tareas relacionadas
Creación de portlets Faces
Adición y actualización de modalidades de portlet Faces para los portlets IBM existentes
Adición y actualización de modalidades de portlet Faces para los portlets JSR 168 existentes
Creación de archivos JSP de portlet Faces
Creación de aplicaciones Faces - Visión general

Referencia relacionada
Referencia de componentes de Faces
Atributos para componentes de Faces

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