Creación de proyectos de portlet (JSR 168)

Puede crear y mantener los recursos de las aplicaciones de portlet utilizando la API de portlet JSR 168 en un proyecto de portlet (JSR 168). Los proyectos de portlet se pueden añadir a un proyecto de aplicación empresarial nuevo o existente.

Consulte los temas siguientes para obtener información detallada sobre cómo crear portlets especializados.
En los proyectos de portlet JSR 168 existen las limitaciones siguientes:
  • Algunos códigos personalizados de la API de portlet JSR 168 <namespace>, <actionURL>, etc.) no pueden utilizarse en el código <view> de un archivo JSP de portlet Faces. Después del código <view>, deben insertarse fragmentos de la vista Fragmentos para archivos JSP de portlet Faces.
  • El cambio de modalidad de portlet utilizando el atributo 'portletMode' de <actionURL> provoca que el portlet Faces no pueda almacenar datos ni invocar una acción. Como alternativa, utilice ActionResponse#setPortletMode() en la acción Faces para cambiar la modalidad de portlet.

Para crear un proyecto portlet JSR 168 nuevo, siga estos pasos:

  1. Seleccione Archivo > Nuevo > Proyecto. A continuación, seleccione la opción Proyecto deportlet (JSR 168) de la derecha, y pulse el botón Siguiente. Se abre el asistente Proyecto de portlet nuevo.
  2. Introduzca valores adecuados en los campos siguientes:
    Nombre de proyecto
    Nombre del nuevo proyecto de portlet.
    Ubicación del proyecto
    Ubicación en el sistema de archivos donde se 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 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 >>.
    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.
    Introduzca uno de los valores siguientes:
    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 predeterminado) incluye un nivel de especificación de servlet 2.3 y un nivel de especificación JSP 1.2. Este valor predeterminado 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 inadvertidamente 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 del 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 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 a los que se utilizan en 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.

    Si desea aceptar los valores predeterminados asociados a un proyecto portlet JSR 168 básico, pulse Finalizar. Si prefiere personalizar las opciones de proyecto o desea crear un proyecto que esté habilitado para un tipo de portlet distinto, pulse Siguiente.

  3. Seleccione el tipo de portlet adecuado para el proyecto portlet. Para obtener más información sobre los tipos de portlet, consulte Creación de portlets y proyectos de portlet.
    Portlet vacío
    Crea una aplicación de portlet que amplía la clase GenericPortlet, con un código mínimo incluido. ConsultePersonalización de proyectos de portlet vacíos si crea una aplicación de portlet nueva empezando de cero.
    Portlet básico
    Crea una aplicación de portlet básica que extiende la clase PortletAdapter. Se trata de una aplicación completa con un portlet concreto y una aplicación de portlet concreta. Contiene una clase de portlet que amplía la clase PortletAdapter, los archivos JSP de ejemplo que se utilizan para representar el portlet y un bean Java de ejemplo. Además de estos recursos básicos, puede añadir código de ejemplo al proyecto para las funciones que las aplicaciones de portlet utilizan con frecuencia a medida que especifica opciones de asistente adicionales.
    Portlet Faces
    Crea una aplicación de portlet Faces. Para obtener información más detallada, consulte Creación de proyectos de portlet Faces.
    Portlet Struts
    Crea una aplicación de portlet Struts. Para obtener información más detallada, consulte Creación de proyectos de portlet Struts.
  4. Seleccione una o varias características de proyecto Web. Deseleccione el recuadro de selección Diagrama Web si va a crear un portlet básico o vacío. 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 InfoCenter de WebSphere Portal (consulte la documentación del producto WebSphere Portal).
  5. Pulse Siguiente.
  6. Actualice o añada los valores generales de portlet en la página Valores de portlet y pulse Siguiente. ConsulteCreación de proyectos de portlet (API de IBM) para obtener más detalles sobre estas opciones. En la creación de un Portlet vacío, cuando pulse Siguiente, saltará inmediatamente a la página Varios del asistente. Si pulsa Finalizar para crear un portlet vacío, el asistente creará un contenedor de proyecto vacío cargado con la estructura de carpetas apropiada, junto con un descriptor de despliegue. Para completar la aplicación de portlet, debe personalizar el nuevo proyecto portlet vacío. Consulte Personalización de proyectos de portlet JSR 168 vacíos.
  7. En la página Acción y preferencias, defina el manejo de acción y preferencias del portlet.
    Añadir manejador de petición de acción
    Esta opción implementa el método processAction para manejar peticiones de acción. Se invoca el manejador de peticiones de acción cuando al recibirse una petición HTTP asociada a una acción de portlet.
    Añadir ejemplo de formulario
    Esta opción añade un ejemplo de formulario en el panel de vista.
    Añadir manejo de preferencias
    Esta opción muestra las preferencias en el panel de vista. También proporciona un panel de edición para modificar las preferencias del portlet. Las preferencias de portlet se almacenan como datos persistentes y se pueden utilizar para preferencias personalizadas.
    Añadir validador de preferencias
    Esta opción añade una clase validadora de preferencias para validar las preferencias.
  8. Pulse Siguiente.
  9. Si ha seleccionado anteriormente WebSphere Portal v5.1 como servidor de destino, puede añadir código de ejemplo para soportar el manejo de almacenamiento de credenciales en la página Inicio de sesión único. Esto permite a los usuarios y administradores almacenar de forma segura la credenciales para la autenticación. Para obtener más información sobre el manejo de almacenamiento de credenciales, consulte la sección "Portlet authentication" (Autenticación de portlets) en Information Center de WebSphere Portal.
    Añadir manejo de almacenamiento de credenciales
    Seleccione esta opción para dar soporte al manejo de almacenamiento de credenciales. WebSphere Portal soporta la utilización de un almacenamiento de credenciales donde los usuarios y administradores pueden almacenar de forma segura credenciales para la autenticación. Los portlets escritos para extraer las credenciales del usuario del almacenamiento pueden ocultar la recusación de inicio de sesión del usuario. Seleccione uno de los tipos siguientes de ranuras de almacenamiento.
    Utilizar una ranura de almacenamiento de credenciales privada de portlet
    Una ranura privada de portlet almacena las credenciales de usuario que no se comparten entre los portlets.
    Utilizar una ranura de almacenamiento de credenciales compartida
    Una ranura compartida almacena credenciales de usuario que se comparten entre los portlets del usuario.
    Utilizar una ranura de almacenamiento de credenciales de administración
    Una ranura de administración permite que cada usuario almacene su información confidencial para acceder a los recursos definidos por el administrador (por ejemplo, Lotus Notes).
    Utilizar una ranura de almacenamiento de credenciales de sistema
    Una ranura de sistema almacena credenciales de sistema en la que todos los usuarios y portlets comparten información confidencial real.
    Nombre de ranura
    Define el nombre de la ranura de almacenamiento de credenciales para almacenar y recuperar credenciales de usuario.
    Mostrar contraseña
    Seleccione esta opción para mostrar la contraseña en la pantalla en modalidad de vista.
    Pulse Siguiente.
  10. En la página Varios, especifique las marcaciones y modalidades adicionales que desee habilitar para el portlet en el proyecto.
    • La marcación HTML, que debe tener soporte en todas las aplicaciones de portlet, siempre la genera el asistente.
    • El asistente generará un proyecto portlet utilizando una extensión de IBM: wps.markup, que permitirá al portlet mayores distinciones en la marcación, que vayan más allá del tipo MIME. Para obtener más información sobre esta extensión de IBM, consulte Desarrollo de portlets utilizando JSR 168 y WebSphere Portal V5.02.
    • La modalidad de vista siempre está seleccionada.
    • La modalidad de edición se añade automáticamente al portlet generado si se ha seleccionado la opción Añadir manejo de preferencias en la página Acción y preferencias.
  11. Pulse Finalizar para crear el proyecto portlet nuevo.
  12. Pulse Si si se muestra el recuadro de diálogo Confirmar cambio de perspectiva. Si no desea que se muestre esta solicitud, marque el recuadro de selección No mostrar este mensaje de nuevo.
  13. A algunos de los parámetros de configuración del portlet se les asigna valores predeterminados. Para volver a configurar estos valores mediante la edición del descriptor de despliegue de portlet, consulte Personalización de portlets JSR 168. Según lo que seleccione, se generarán portlet/s de ejemplo con archivos JSP de muestra. Para añadir portlets adicionales a un proyecto portlet, consulte el apartado Creación de portlets. Para añadir archivos JSP de portlet, consulte Creación de archivos JSP de portlet.
Conceptos relacionados
Creación de portlets y proyectos de portlet
Trabajo con descriptores de despliegue de portlet
Lenguajes de marcación
Tareas relacionadas
Personalización de portlets JSR 168
Creación de portlets
Creación de archivos JSP de portlet
Personalización de proyectos de portlet JSR 168 vacíos

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