Ejercicio 1.1: Puesta a punto

Antes de iniciar el desarrollo de portlet y de portal en esta guía de aprendizaje, debe seguir unos pasos de puesta a punto:

  1. Crear un proyecto e importar los recursos necesarios para el desarrollo de portlet.
  2. Instalar y configurar el entorno de prueba de WebSphere Portal v5.1 que nos permitirá probar la aplicación que estamos construyendo.
  3. Configurar un servidor de base de datos que proporcionará datos para ejecutarlos en la aplicación.

El primer paso consiste en importar los proyectos EJB y cliente EJB prefabricados en el proyecto de portlet que utilizaremos en la guía de aprendizaje. El AuctionPortletEAR creado al crear el proyecto de portlet contendrá los recursos importados. Estos proyectos proporcionan los servicios de componente de fondo que se utilizarán para crear el portlet incluido en el proyecto de portlet.

Crear un proyecto de portlet nuevo

Todo desarrollo de portlet se lleva a cabo en el contexto de un proyecto de portlet. Para crear el proyecto de portlet para el portlet UserAdmin, siga estos pasos:

  1. Abra Rational Software Development Platform.
  2. Seleccione Archivo > Nuevo > Proyecto.
  3. Seleccione la opción Proyecto de portlet. Esta opción generará recursos de proyecto que soporten la API de portlet de IBM, en lugar de la API de portlet de JSR 168. Pulse Siguiente.
  4. Pulse Aceptar en el diálogo Confirmar habilitación. Este diálogo verifica que desea habilitar las posibilidades de desarrollo de Portal. Las posibilidades son los elementos del entorno de desarrollo, junto con el conjunto de herramientas adecuado, que automatizan muchas de las posibilidades de los estándares de programación y generación de código necesarias para desarrollar aplicaciones Web basadas en portal que se ejecutarán en WebSphere Portal.
  5. Denomine el proyecto AuctionPortlet.
    Nota: cuando teclee el nombre del proyecto, fíjese en que (si pulsa el botón Mostrar avanzadas >>) el módulo para este proyecto se añade automáticamente a un proyecto EAR de nombre parecido.
  6. Tenga en cuenta que la versión de WebSphere Portal es 5.1 por omisión. Pulse Siguiente.
  7. Marque el botón de selección Faces Portlet, porque los portlets que se crearán en esta guía de aprendizaje potenciarán la velocidad y la flexibilidad proporcionadas por JavaServer Faces y las herramientas de portlet en la construcción de interfaces de usuario para aplicaciones Web. Pulse Siguiente.
  8. Pulse Siguiente otra vez.
  9. En la página Valores de Portlet, teclee Portlet UserAdmin en el campo Nombre de portlet y User Admin en el campo Título de portlet.
  10. Marque el recuadro de selección Cambiar opciones de generación de código. Teclee UserAdminPortlet en el campo Prefijo de clase.
  11. Pulse Siguiente.
  12. En la página Varios, fíjese en que el valor Página inicial del grupo Ver modalidad es /UserAdminView.jsp. Esta página por omisión se generará dentro del proyecto y servirá como página maestra del portlet UserAdmin. Añadiremos páginas adicionales en próximos ejercicios.
  13. Pulse Finalizar.

    Si se le pregunta si desea pasar a la perspectiva Web, pulse .

La página de vista de portlet por omisión, UserAdminView.jsp, se visualiza en el área de edición del área de trabajo.

Importar los recursos utilizados en este ejemplo

Para importar AuctionPortal.zip, que contiene todos los recursos de proyectos prefabricados necesarios para crear las interfaces y los accesos de datos descritos en la guía de aprendizaje, realice lo siguiente:

  1. En la barra de menús, seleccione Archivo > Importar. Aparece el diálogo Importar.
  2. En Seleccionar un origen de importación, pulse Intercambio de proyectos.
  3. Pulse Siguiente. Aparece el diálogo Importar contenido de intercambio de proyectos.
  4. Puesto que los distintos productos de Rational utilizan distintas ubicaciones destino de instalación, debe abandonar la interfaz de usuario del producto para localizar el conector que alberga el contenido de la base de datos. Utilice una herramienta de búsqueda de archivos para encontrar la carpeta del conector com.ibm.etools.portal.examples.application_6.0.0.1 bajo la vía de acceso de instalación del producto en el sistema de archivos local.
  5. Junto a De archivo zip, pulse Examinar y navegue hasta AuctionPortal.zip en la ubicación siguiente:
    x:\com.ibm.etools.portal.examples.application_6.0.0.1/samples
    donde x: es la vía de acceso absoluta que contiene el conector com.ibm.etools.portal.examples.application_6.0.0.1 en el sistema. Pulse Abrir.
  6. Marque los recuadros de selección AuctionEJB50 y AuctionEJB50Client.
  7. Pulse Finalizar.

    El asistente importa los proyectos en el área de trabajo.

  8. También puede añadir los proyectos importados como módulos al proyecto AuctionPortletEAR. En el Explorador de proyectos, expanda Aplicaciones de empresa > AuctionPortletEAR y efectúe una doble pulsación sobre Descriptor de despliegue: AuctionPortletEAR.
  9. Seleccione la pestaña Módulo.
  10. Pulse Añadir bajo Módulos. seleccione AuctionEJB50 y pulse Finalizar. Si en el diálogo Cambiar servidor destino se le pregunta si desea cambiar el servidor destino del módulo por el servidor destino EAR, pulse .
  11. Pulse Añadir bajo JAR de programa de utilidad. Seleccione AuctionEJB50Client y pulse Finalizar. Si en el diálogo Cambiar servidor destino se le pregunta si desea cambiar el servidor destino del módulo por el servidor destino EAR, pulse .
  12. Guarde y cierre el Descriptor de despliegue.

Instalar y configurar el entorno de prueba de WebSphere Portal v5.1

Aunque el entorno de prueba de WebSphere Portal v5.0 puede instalarse desde el launchpad del producto, los recursos de esta guía de aprendizaje están diseñados para ejecutarse en WebSphere Portal 5.1. Debe instalar el Entorno de prueba de WebSphere Portal 5.1 tal como se describe en la Guía de instalación del producto. Para la instalación es necesario utilizar el soporte de almacenamiento de WebSphere Portal proporcionado con las herramientas de Rational.

Después de instalar esta versión del entorno de prueba, también debe configurarla para ejecutarla en el área de trabajo:

  1. Seleccione Ventana > Preferencias en la barra de menús.
  2. Expanda la sección Servidor y pulse Tiempos de ejecución instalados.
  3. Pulse Apéndice de WebSphere Portal v5.1, marque el recuadro de selección y pulse Editar.
  4. Cambie el nombre por WebSphere Portal v5.1 y sobreescriba los valores Ubicación de WebSphere Portal y Ubicación de WebSphere Application Server con los directorios de instalación del entorno de prueba de WebSphere Portal 5.1 especificados al instalar el entorno de prueba.
  5. Pulse Finalizar.
  6. Pulse Aceptar en el recuadro de diálogo Preferencias.

Después de completar estos pasos, el servidor del entorno de prueba de WebSphere Portal v5.1 está disponible para probar, depurar o perfilar.

A continuación, debe configurar un servidor de base de datos que contenga los datos utilizados por las aplicaciones en esta guía de aprendizaje.

Crear y configurar un servidor que contiene una base de datos de aplicación de ejemplo

En este ejercicio debe importar y configurar una base de datos de Cloudscape para proporcionar datos para la aplicación AuctionPortal.

  1. Visualice la vista Servidores. Está ubicada junto a las vistas Propiedades y Edición rápida.
  2. Seleccione Nuevo > Servidor en el menú emergente de la vista.
  3. Seleccione Entorno de prueba de WebSphere Portal v5.1 en la lista de tipo de servidor.
  4. Pulse Finalizar.
  5. Efectúe una doble pulsación sobre WebSphere Portal v5.1 Test Environment en la vista Servidores.
  6. Seleccione la pestaña Orígenes de datos en el editor del servidor.
  7. En la sección Valor del servidor, pulse Añadir para añadir un listado a la lista de proveedores de JDBC.
  8. En la primera página del asistente Crear un proveedor JDBC, seleccione Cloudscape como Tipo de base de datos y Cloudscape JDBC Provider como Tipo de proveedor JDBC.
  9. Pulse Siguiente.
  10. Teclee Cloudscape JDBC Provider en el campo Nombre.
  11. Pulse Finalizar.
  12. Pulse el botón Añadir junto a la lista Origen de datos definido en el proveedor JDBC seleccionado arriba.
  13. En la primera página del asistente Crear un origen de datos, seleccione Cloudscape JDBC Provider y pulse Siguiente.
  14. Teclee Auction en el campo Nombre.
  15. Teclee jdbc/auction en el campo Nombre JNDI.
  16. Pulse Siguiente.
  17. Seleccione databaseName en la lista Propiedades de recurso.
  18. Puesto que los distintos productos de Rational utilizan distintas ubicaciones destino de instalación, debe abandonar la interfaz de usuario del producto para localizar el conector que alberga el contenido de la base de datos. Utilice una herramienta de búsqueda de archivos para encontrar la carpeta del conector com.ibm.etools.auction.sampledb_6.0.0 bajo la vía de acceso de instalación del producto en el sistema de archivos local.
  19. Vuelva al asistente Crear un origen de datos y teclee la vía de acceso siguiente en el campo Valor:
    x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
    donde x: es la vía de acceso absoluta que contiene el conector com.ibm.etools.auction.sampledb_6.0.0 en el sistema.
  20. Pulse Finalizar.
  21. Guarde y cierre el archivo de configuración del servidor.

Ahora podrá acceder a los datos de la base de datos AUCTION60 cuando pruebe los portlets en el proyecto AuctionPortlet, según se desarrollan en el Módulo 1.

Acerca de los archivos utilizados en esta guía de aprendizaje

Ahora puede examinar los archivos en los proyectos AuctionEJB50 y AuctionEJB50Client, lo que incluye los orígenes de datos y la lógica para las páginas de portlet. En la vista Explorador de proyectos, al expandir las carpetas, el contenido tiene el aspecto siguiente:
AuctionPortletEJB en la vista Navegador

Los recursos de este proyecto se utilizarán para crear las interfaces de usuario para los portlets que crearemos en esta guía de aprendizaje y para proporcionar acceso a los datos en la base de datos de ejemplo de Cloudscape. UserFacade y ListingFacade son los beans de sesión EJB que proporcionarán métodos que se llamarán desde los portlets creados en la guía de aprendizaje. RegistrationData y ItemData son beans de acceso que se utilizarán para llevar datos entre portlets y la base de datos de Cloudscape, utilizando beans de entidad. El proyecto EJB proporciona correlaciones de base de datos para los beans de entidad.

Ahora está preparado para iniciar el Ejercicio 1.2: Preparar el desarrollo del portlet y definir el flujo de la aplicación.

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