Exercício 1.1: Configuração

Antes de iniciar o desenvolvimento do portlet e do portal neste tutorial, há uma série de etapas de configuração que você precisa executar:

  1. Criar um projeto e importar os recursos requeridos para o desenvolvimento do portlet.
  2. Instalar e configurar o ambiente de teste do WebSphere Portal v5.1, que permitirá testar o aplicativo que estiver sendo construído.
  3. Configurar um servidor de banco de dados que fornecerá dados para executar no aplicativo.

A primeira etapa é importar os projetos pré-construídos de EJB e de cliente EJB para o projeto de portlet que utilizaremos no tutorial. O AuctionPortletEAR criado durante a criação do projeto de portlet conterá os recursos importados. Esses projetos fornecem serviços de back-end que utilizaremos para criar o portlet incluído no projeto de portlet.

Criando um novo projeto de portlet

Todo o desenvolvimento do portlet é realizado no contexto de um projeto de portlet. Para criar o projeto de portlet para o portlet UserAdmin, siga estas etapas:

  1. Abra o Rational Software Development Platform.
  2. Selecione File (Arquivo) > New (Novo) > Project (Projeto).
  3. Selecione a opção Portlet Project (Projeto de Portlet). Esta opção gerará recursos de projeto que suportam a API de portlet IBM, em oposição à API de portlet JSR 168. Clique em Next (Avançar).
  4. Clique em OK no diálogo Confirm Enablement (Confirmar Ativação). Este diálogo verifica se você deseja ativar os recursos do Portal Development. Os recursos são os elementos do seu ambiente de desenvolvimento, juntamente com o conjunto de ferramentas apropriadas, que automatizam muitos dos padrões de programação e recursos de geração de código requeridos para desenvolvimento de aplicativos da Web com base em portal que serão executados no WebSphere Portal.
  5. Nomeie o projeto AuctionPortlet.
    Quando você digitar o nome do projeto, observe que (se você clicar no botão Show Advanced (Mostrar Avançado) >>) o módulo para esse projeto é automaticamente incluído em um projeto EAR de nome semelhante.
  6. Observe que a Versão do WebSphere Portal está padronizada como 5.1. Clique em Next (Avançar).
  7. Selecione o botão de opções Portlet Faces, porque os portlets que serão criados neste tutorial empregarão a velocidade e a flexibilidade fornecidas pelo JavaServer Faces e pelas ferramentas do portlet ao construir interfaces com usuário para aplicativos da Web. Clique em Next (Avançar).
  8. Clique novamente em Next (Avançar).
  9. Na página Configurações do Portlet, digite Portlet UserAdmin no campo Portlet name (Nome do Portlet) e User Admin (Admin de Usuários) no campo Portlet title (Título do Portlet).
  10. Selecione a caixa de opções Change code generation options (Alterar as opções de geração de código). Digite UserAdminPortlet no campo Class prefix (Prefixo da Classe).
  11. Clique em Next (Avançar).
  12. Na página Diversos, observe que o valor da Initial page (Página Inicial) no grupo View mode (Modo de Visualização) é /UserAdminView.jsp. Essa página padrão será gerada dentro do projeto e servirá como a página master do portlet UserAdmin. Incluiremos páginas adicionais em exercícios futuros.
  13. Clique em Finish (Concluir).

    Se for solicitado a você para comutar para a Perspectiva Web, clique em Yes (Sim).

A página de visualização do portlet padrão, UserAdminView.jsp, é exibida na área de edição de seu espaço de trabalho.

Importando os Recursos Utilizados Nesta Amostra

Para importar o AuctionPortal.zip, que contém todos os recursos do projeto pré-construído necessários para criar as interfaces e o acesso a dados descritos no tutorial:

  1. Na barra de menus, selecione File (Arquivo) > Import (Importar). O diálogo Importar é exibido.
  2. Em Select an import source (Selecionar uma origem de importação), clique em Project Interchange (Intercâmbio de Projeto).
  3. Clique em Next (Avançar). Aparece o diálogo Import Project Interchange Contents (Importar Conteúdo de Intercâmbio de Projeto).
  4. Como os diferentes produtos Rational utilizam locais de destino de instalação diferentes, você deve sair da interface com o usuário do produto para localizar o plug-in que contém o conteúdo do banco de dados. Utilize uma ferramenta de procura em arquivos para localizar a pasta plug-in com.ibm.etools.portal.examples.application_6.0.0.1 no caminho da instalação do produto em seu sistema de arquivos local.
  5. Próximo a From zip file (A partir de arquivo zip), clique em Browse (Procurar) e navegue pelo AuctionPortal.zip no seguinte local:
    x:\com.ibm.etools.portal.examples.application_6.0.0.1/samples
    em que x: é o caminho absoluto que contém o plug-in com.ibm.etools.portal.examples.application_6.0.0.1 em seu computador. Clique em Open (Abrir).
  6. Selecione as caixas de opções AuctionEJB50 e AuctionEJB50Client.
  7. Clique em Finish (Concluir).

    O assistente importa os projetos para seu espaço de trabalho.

  8. Você também deve incluir os projetos importados como módulos para o projeto AuctionPortletEAR. No Explorador de Projetos, expanda Enterprise Applications (Aplicativos Corporativos) > AuctionPortletEAR e dê um clique duplo Deployment Descriptor: AuctionPortletEAR (Descritor de Implementação: AuctionPortletEAR).
  9. Selecione a guia Module (Módulo).
  10. Clique em Add (Incluir) sob Module (Módulos). Selecione AuctionEJB50 e clique em Finish (Concluir). Se o diálogo Change Target Server (Alterar Servidor de Destino) solicitar para alterar o servidor de destino do módulo para o servidor de destino EAR, clique em Yes (Sim).
  11. Clique em Add (Incluir) sob os JARs de Utilitários do Projeto. Selecione AuctionEJB50Client e clique em Finish (Concluir). Se o diálogo Change Target Server (Alterar Servidor de Destino) solicitar para alterar o servidor de destino do módulo para o servidor de destino EAR, clique em Yes (Sim).
  12. Salve e feche o Descritor de Implementação.

Instalando e Configurando o Ambiente de Teste do WebSphere Portal v5.1

Embora o ambiente de teste do WebSphere Portal v5.0 seja instalável a partir da barra de lançamento do produto, os recursos neste tutorial são projetos para serem executados no WebSphere Portal 5.1. Você deve instalar o ambiente de teste do WebSphere Portal 5.1 conforme descrito no Guia de Instalação do Produto. A instalação requer que você utilize a mídia do WebSphere Portal que é fornecida com as ferramentas do Rational.

Após instalar esta versão do ambiente de teste, você também deve configurá-la para executar em seu espaço de trabalho:

  1. Selecione Window (Janela) > Preferences (Preferências) da barra de menus.
  2. Expanda a seção Server (Servidor) e clique em Installed Runtimes (Tempos de Execução Instalados).
  3. Clique em Stub do WebSphere Portal v5.1 selecione a caixa de opções e clique em Edit (Editar).
  4. Altere o nome para WebSphere Portal v5.1 e sobrescreva os valores do WebSphere Portal Location (Local do WebSphere Portal) e WebSphere Application Server Location (Local do WebSphere Application Server) com os diretórios de instalação do ambiente de teste do WebSphere Portal 5.1 que você especificou ao instalar o ambiente de teste.
  5. Clique em Finish (Concluir).
  6. Clique em OK na caixa de diálogo Preferências.

Após concluir essas etapas, o servidor do ambiente de teste do WebSphere Portal v5.1 estará disponível para teste, depuração ou definição de perfil.

Em seguida, você deve configurar um servidor de banco de dados que contenha os dados utilizados pelos aplicativos neste tutorial.

Criando e Configurando um Servidor que Contém um Banco de Dados de Aplicativo de Amostra

Neste exercício, você deve importar e configurar um banco de dados Cloudscape para fornecer dados para o aplicativo AuctionPortal.

  1. Exiba a visualização Servidores. Ela está localizada próxima às visualizações Properties (Propriedades) e Quick Edit (Edição Rápida).
  2. Selecione New (Novo) > Server (Servidor) no menu pop-up da visualização.
  3. Selecione WebSphere Portal v5.1 Test Environment (Ambiente de Teste do WebSphere Portal v5.1) da lista de tipos de servidores.
  4. Clique em Finish (Concluir).
  5. Dê um clique duplo em WebSphere Portal v5.1 Test Environment (Ambiente de Teste do WebSphere Portal v5.1) na visualização Servers (Servidores).
  6. Selecione a guia Data sources (Origens de Dados) no editor do servidor.
  7. Na seção Server Setting (Configuração do Servidor), clique em Add (Incluir) para incluir uma listagem na lista de fornecedores de JDBC.
  8. Na primeira página do assistente Criar um Fornecedor de JDBC, selecione Cloudscape como o Database type (Tipo de Banco de Dados) e Cloudscape JDBC Provider (Fornecedor de JDBC Cloudscape) como o JDBC provider type (Tipo de Fornecedor de JDBC).
  9. Clique em Next (Avançar).
  10. Digite Cloudscape JDBC Provider (Fornecedor de JDBC Cloudscape) no campo Name (Nome).
  11. Clique em Finish (Concluir).
  12. Clique no botão Add (Incluir) próximo à lista Data source defined in the JDBC provider selected above (Origem de dados definida no fornecedor de JDBC selecionado acima).
  13. Na primeira página do assistente para Criar uma Origem de Dados, selecione Cloudscape JDBC Provider (Fornecedor de JDBC Cloudscape) e clique em Next (Avançar).
  14. Digite Auction (Leilão) no campo Name (Nome).
  15. Digite jdbc/auction no campo JNDI name (Nome JNDI).
  16. Clique em Next (Avançar).
  17. Selecione databaseName da lista Resource Properties (Propriedades de Recurso).
  18. Como os diferentes produtos Rational utilizam locais de destino de instalação diferentes, você deve sair da interface com o usuário do produto para localizar o plug-in que contém o conteúdo do banco de dados. Utilize uma ferramenta de procura em arquivos para localizar a pasta plug-in com.ibm.etools.portal.auction.sampledb_6.0.0 no caminho da instalação do produto em seu sistema de arquivos local.
  19. Retorne para o assistente Criar uma Origem de Dados e digite o seguinte caminho no campo Value (Valor):
    x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
    onde x: é o caminho absoluto que contém o plug-in com.ibm.etools.auction.sampledb_6.0.0 em seu computador.
  20. Clique em Finish (Concluir).
  21. Salve e feche o arquivo de configuração do servidor.

Agora você poderá acessar os dados no banco de dados AUCTION60 quando testar os portlets no projeto AuctionPortlet, uma vez que eles são desenvolvidos no Módulo 1.

Sobre os Arquivos Utilizados Neste Tutorial

Você pode agora procurar os arquivos nos projetos AuctionEJB50 e AuctionEJB50Client, que incluem as origens de dados e a lógica para as páginas do portlet. Na visualização Explorador de Projetos, quando você expande as pastas, o conteúdo deve assemelhar-se ao seguinte:
AuctionPortletEJB na visualização Navigator

Os recursos neste projeto serão utilizados para criar as interfaces com o usuário para os portlets que criaremos neste tutorial e para fornecer acesso aos dados no banco de dados Cloudscape de amostra. UserFacade e ListingFacade são os beans de sessão EJB que fornecerão métodos que serão chamados a partir dos portlets criados no tutorial. RegistrationData e ItemData são beans de acesso a dados que serão utilizados para transportar dados entre os portlets e o banco de dados Cloudscape, utilizando beans de entidade. O projeto EJB fornece mapeamentos do banco de dados para os beans de entidade.

Agora você está pronto para começar o Exercício 1.2: Preparando para o Desenvolvimento do Portlet e Definindo o Fluxo do Aplicativo.

Feedback
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.