Dicas para migrar aplicações Visual Web do NetBeans para NetBeans IDE 6.0
Contribuição da equipe de tutoriais do NetBeans
Dezembro de 2007 [Número da revisão: V6.0]
Esta publicação se aplica ao suporte Web do NetBeans IDE 6.0. |
|
|
Este tutorial o orienta pelo processo de importar um projeto do NetBeans Visusl Web Pack 5.5 para NetBeans IDE 6.0.
|
Conteúdo
Este documento o ajuda na migração das suas aplicações NetBeans Visual Web Pack para o suporte Web do NetBeans IDE.
Para usar este tutorial, você precisa instalar o NetBeans IDE 6.0 e escolher Web e Java EE ou a instalação completa.
Para obter mais informações sobre como trabalhar com o NetBeans IDE, consulte a página Suporte e documentação no site do NetBeans.
O Visual Web JSF Backwards Compatibility Kit fornece bibliotecas complementares que são necessárias ao Visual Web designer para suportar projetos que são baseados em J2SE 1.4 ou J2EE 1.4. Entre eles se incluem:
- JavaServer Faces 1.1 Reference Implementation (RI)
- RowSet Reference Implementation (RI)
- Bibliotecas JAX-RPC do JWSDP 1.6
Essas bibliotecas não são de código-fonte aberto e são, portanto, distribuídas como um plug-in separado do NetBeans.
Para instalar o plug-in, faça o seguinte:
-
Na barra de ferramentas principal, clique em Ferramentas > Plug-ins.
Isso abre o gerenciador de plug-ins.
- Na aba Plug-ins disponível, marque a caixa de verificação ao lado do Visual Web JSF Backwards Compatibility Kit, e clique em Instalar.
Migrando configurações do usuário
Feche todas as instâncias dos IDEs do NetBeans e do Java Studio Creator antes de iniciar o NetBeans IDE 6.0. Quando você instala a visualização a suporte a Web do NetBeans IDE 6.0, na primeira vez que executa o IDE,
você é solicitado a migrar suas configurações, como mostrado na Figura 1. Clique em Sim na caixa de diálogo Confirmar configurações de importação para migrar as configurações.
Figura 1: Caixa de diálogo Confirmar configurações de importação |
Se você quiser abrir um projeto que tenha desenvolvido em outra versão do IDE, e não tiver migrado as configurações do usuário dessa versão, então, adote esta solução alternativa:
- Feche o NetBeans IDE 6.0
- Renomeie o nome do diretório do usuário da versão do IDE que você não deseja migrar.
- Exclua o diretório de usuário do NetBeans IDE 6.0. Para a localização do diretório do usuário, escolha Ajuda > Sobre como mostrado na Figura 2 abaixo.
- Reinicie o NetBeans IDE 6.0.
- Na caixa de diálogo Confirmar importação, clique em Sim para migrar as configurações da versão que foi usada para criar o projeto.
Cada vez que você executa o IDE, o diretório do usuário é criado. O arquivo que você excluiu na Etapa 3 é gerado novamente.
Para ser avisado na próxima inicialização do NetBeans IDE 6.0, renomeie o diretório do usuário. Para a localização do diretório do usuário, escolha Ajuda > Sobre como mostrado na figura abaixo.
Figura 2: Detalhes da instalação |
Migrando códigos-fonte ao abrir um projeto
Sempre copie as pastas do projeto antes de abrir projetos no NetBeans IDE 6.0. Quando você abre um projeto criado no Visual Web Pack do NetBeans, não será possível reabrir esse projeto no IDE anterior.
Não há suporte para o compartilhamento de projetos entre o Visual Web Pack do NetBeans e o NetBeans IDE 6.0. Observação: há suporte limitado para EJBs e serviços Web desta vez.
Quando você abre uma aplicação Visual Web Pack pela primeira vez no NetBeans IDE 6.0 clicando em Arquivo > Abrir projeto, os códigos-fonte seguintes são migrados:
- Bibliotecas de componentes adicionadas ao IDE.
Uma caixa de diálogo aparece quando você abre um projeto no NetBeans IDE e informa-lhe que as complibs usadas no projeto estão sendo adicionadas a Paleta/Ferramentas > Gerenciador da biblioteca de componentes. Talvez você tenha que resolver manualmente uma referência de biblioteca. Consulte Resolvendo referências de bilbioteca para obter mais detalhes.
- Drivers e conexões JDBC não são importados quando o projeto é aberto. Isso acontece realmente quando o nó Projeto na aba Projeto é expandido e uma pequena barra de progresso é iniciada "Atualizando projeto legado. Simplesmente abrir um projeto não importa as configurações do bd.
- Observação: recomendamos que você exclua a pasta 'privada' na cópia do projeto que está sendo migrado. Esta pasta se localiza em myProject/nbproject/private.
Usando navegação de página
O editor de navegação de página usado no Visual Web Pack agora é o editor de fluxo de página no NetBeans IDE 6.0.
No VWP 5.5, 5.1, assim como no Java Studio Creator, os projetos tinham três arquivos de configuração do faces, cada um com finalidades separadas:
- managed-beans.xml. Para todas as entradas de beans gerenciados (incluindo beans de sessão, solicitação e aplicação).
- navigation.xml. Continha todas as regras de navegação.
- faces-config.xml. Este geralmente ficava vazio a menos que quaisquer entradas fossem feitas manualmente.
Ao contrário dos novos projetos no NetBeans 6.0, tudo fica em um único arquivo faces-config.xml por padrão, mas você tem a habilidade de adicionar novos arquivos de configuração do faces e adicionar suas próprias regras ou entradas neles.
O novo editor de fluxo de página pode ser usado com qualquer arquivo de configuração do faces.
O novo editor de fluxo de página fornece 3 visualizações diferentes nas quais você pode visualizar suas regras de navegação (você pode alternar as visualizações usando a lista suspensa ao lado do botão XML):
- Projeto. Esta é a visualização padrão e mostra todas as páginas do projeto (incluindo páginas JSF, html etc) junto com todas as regras de navegação desse arquivo de configuração específico do faces.
- Somente configurações do Faces. Semelhantemente nessa visualização, toda as regras do arquivo de configuração do faces são mostradas, mas somente as páginas relevantes são exibidas.
- Todas as configurações do Faces. Nessa visualização, as regras de navegação e os casos de todos os arquivos de configuração do faces são mesclados e mostrados com todas as páginas relevantes.
Para obter mais informações sobre o uso da navegação de página, consulte o tutorial do Visual Web Pack Navegando páginas em uma aplicação Web.
Este tutorial aborda os recursos de navegação de página do ambiente de desenvolvimento integrado do NetBeans 6.0.
Arquivos de configuração
Ao importar um projeto, os usuários verão três arquivos de configuração:
- faces-config.xml
- navigation.xml
- managed-beans.xml
É importante observar que todas as regras desses arquivos de configuração são mescladas quando o projeto é executado. Você poderá visualizar o editor de fluxo de página dos três arquivos, e adicionar regras de navegação neles, mas isso pode resultar em regras conflitantes nos arquivos diferentes. Uma regra de navegação conflitante pode surgir, caso você possua elementos from-view-id e from-outcome idênticos, mas elementos to-view-id distintos em arquivos diferentes. Os dois blocos de código abaixo ilustram um exemplo desse cenário:
<navigation-rule>
<from-view-id>*/Page1.jsp*</from-view-id>
<navigation-case>
<from-outcome>*case1*</from-outcome>
<to-view-id>*/Page2.jsp*</to-view-id>
</navigation-case>
</navigation-rule>
<navigation-rule>
<from-view-id>*/Page1.jsp*</from-view-id>
<navigation-case>
<from-outcome>*case1*</from-outcome>
<to-view-id>*/Page3.jsp*</to-view-id>
<redirect/>
</navigation-case>
</navigation-rule>
Se você só usa navigation.xml para
regras de navegação em projetos importados, não deverá haver problemas. As regras seguintes devem ajudá-lo a resolver tais conflitos:
- Se o conflito for entre o faces-config.xml e algum outro
arquivo, faces-config.xml sempre tem precedência.
- Se o conflito for entre dois outros arquivos de configuração, tais como navigation.xml e managed-beans.xml, então o arquivo listado pela última vez no parâmetro de contexto de web.xml (javax.faces.CONFIG_FILES) tem precedência.
Para visualizar as regras de todos os arquivos de configuração em uma visualização de forma que você possa remover qualquer redundância:
- Clique com o botão direito do mouse no Visual Designer e escolha Navegação de página na janela pop-up.
- Escolha Projeto na lista suspensa do escopo de configuração no editor de fluxo de página, como mostrado na figura abaixo.
|
Figura 3: Menu Escopo de configuração |
Observe que quando um projeto
é migrado, o IDE registra a entrada managed-bean de novas páginas em faces-config.xml, não em managed-beans.xml como era feito no Sun Java Studio Creator e no NetBeans 5.5.
Resolvendo referências de biblioteca
Se você receber uma mensagem de erro afirmando que existem referências de biblioteca não resolvidas, é necessário remover as referências. Seu projeto não está em risco quando você remove as referências de biblioteca.
- Clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Clique no nó Bilbiotecas e remova as entradas na janela Compilar que possuem um ícone com emblema amarelo ao lado da referência de biblioteca inválida.
- Expanda o nó Construir > Empacotamento e remova quaisquer referências de biblioteca inválidas.
Trabalhando com bancos de dados
Seguindo as etapas abaixo, talvez seja suficiente migrar um projeto que foi criado no mesmo computador e pelo mesmo usuário usando uma versão anterior do NetBeans ou do Sun Java Studio Creator.
Se o projeto foi criado em um computador diferente ou por um usuário diferente por meio de uma versão anterior do NetBeans ou do Sun Java Studio Creator, então, etapas adicionais são necessárias.
- Abra um projeto que foi criado no IDE do NetBeans Visual Web.
- Clique com o botão direito do mouse em Projeto > Referências de fonte de dados e escolha Resolver fontes de dados.
- Observação: para projetos criados no Java Studio Creator, feche e rebra o projeto.
- Na caixa de diálogo Adicionar conexão de banco de dados, adicione o driver JDBC, caso ele ainda não tenha sido registrado, ou defina o driver usando a lista suspensa e clique em OK.
- Repita a etapa 3, se o projeto usa várias conexões de banco de dados.
Além disso, verifique se o servidor da aplicação de destino foi registrado na aba Serviços. Por padrão, o servidor da aplicação Glassfish V2 é registrado.
Implantando aplicações migradas
Os instaladores do NetBeans IDE 6.0 Standard e Full incluem o servidor da aplicação Sun Java System, que é uma versão do servidor da aplicação Glassfish. Se o seu projeto migrado foi originalmente implantado no servidor da aplicação Sun Java System, então, você pode implantar o projeto no NetBeans IDE 6.0.
Se você implantou originalmente a sua aplicação migrada em um servidor diferente do servidor da aplicação Sun Java System, então, você precisa fazer modificações para implantar sua aplicação.
Para implantar seu projeto no Tomcat, você deve instalar o Tomcat, que baixou de tomcat.apache.org. As versões do Tomcat 5 e 6 são testadas com o NetBeans IDE 6.0. Para obter mais informações sobre a implantação no Tomcat, consulte as Perguntas freqüentes Add External Tomcat e Deployment of External Tomcat on NB6.
Obtendo assistência com a migração de projetos
Se você tiver mais perguntas sobre a migração de seus projetos do Visual Web Pack do NetBeans para NetBeans IDE 6.0, use o link de comentário no fim deste arquivo.
Veja também
Última modificação da página: 3 de dezembro de 2007
