Atualizando Recursos de Tempo de Execução Faces em um Projeto de Portlet

Os recursos de tempo de execução JavaServer Faces fornecidos originalmente no WebSphere Studio Site Developer V5.1.2 foram atualizados para o Rational Application Developer V6.0.1. Se você quiser continuar o desenvolvimento em projetos de portlet criados com o Portal Toolkit 5.0.2.2 para essa versão anterior do produto, recomendamos a atualização dos recursos de tempo de execução Faces para os níveis mais recentes.

No Rational Application Developer V6.0.1, as atualizações dos recursos de tempo de execução Faces ocorrem automaticamente quando um projeto de portlet é importado ou um espaço de trabalho, que contém recursos desatualizados, é aberto. Depois de importar um projeto de portlet criado com o Portal Toolkit 5.0.2.2 para WebSphere Studio Site Developer V5.1.x para o Rational Application Developer V6.0.1, você receberá um aviso para atualizar os recursos de tempo de execução Faces para os níveis mais recentes.

Atualizando automaticamente os recursos de tempo de execução

Para atualizar os recursos de tempo de execução automaticamente para um projeto de portlet:
  1. Importe um projeto de portlet com conteúdo do Faces do WebSphere Studio Site Developer V5.1.x. A janela Project Migration (Migração de Projetos) é aberta.
    Nota: Se a janela Project Migration (Migração de Projetos) não for aberta, sua configuração de preferência automática de construção será provavelmente desativada. No Explorer do Projeto, clique com o botão direito do mouse no projeto de portlet e selecione Build (Construir) > Project (Projeto); o processo de reconstrução de um projeto abre a janela Project Migration (Migração de Projetos).
  2. Se você tiver outros projetos de portlet com conteúdo do Faces no espaço de trabalho, marque Apply this choice to any other projects that need to be upgraded (Aplicar essa opção a todos os projetos dos quais é preciso fazer upgrade para que todos os projetos de portlet sejam atualizados.
  3. Clique em um dos seguintes:
    • Yes (Sim) para concluir a atualização automaticamente.
    • Later (Mais Tarde) para adiar a atualização. Para atualizar os recursos de tempo de execução automaticamente depois de selecionar Later (Mais Tarde), você deve fechar e reabrir o projeto da portlet ou reiniciar o workbench antes de reconstruir o projeto de portlet. Se você desativou as construções automáticas, clique com o botão direito do mouse no projeto de portlet e selecione Build Project (Construir Projeto).
    • Never (Nunca) para manter os recursos de tempo de execução no nível anterior. Se você escolher Never (Nunca) e intencionalmente ficar com os recursos de tempo de execução do nível anterior, não receberá nenhum outro aviso de atualização. No futuro, você terá que atualizar os recursos de tempo de execução manualmente se precisar deles.
  4. Para atualizar os recursos de tempo de execução Faces específicos do portlet, jsf-portlet.jar e jsf-wp.jar, você precisa seguir as etapas de atualização manual abaixo.
Nota: Se você criou Faces JSPs que contêm componentes Faces Client, deverá atualizar separadamente os recursos do tempo de execução dos componentes Faces Client para os níveis mais recentes. Consulte Atualizando Recursos de Tempo de Execução Faces Client em um Projeto da Web.

Atualizando manualmente os recursos de tempo de execução

Para atualizar os recursos de tempo de execução Faces manualmente para um projeto de portlet:
  1. Importe um projeto de portlet existente com conteúdo do Faces para um espaço de trabalho Rational Application Developer V6.0.1.
  2. Crie um novo projeto de portlet denominado JSFP601 com a opção Faces portlet (Portlet Faces) selecionada na segunda página. Você utilizará esse projeto somente como uma origem para os recursos de tempo de execução mais recentes; ele pode ser excluído após a conclusão da atualização.
  3. No Explorer do Projeto, clique com o botão direito do mouse no projeto JSFP601 e selecione Properties (Propriedades) no menu.
  4. Clique em Web Project Features (Recursos do Projeto da Web) e selecione Add Faces Client Framework for Portlet Project (Incluir Estrutura do Faces Client no Projeto de Portlet) e, em seguida, clique em OK.
  5. Para cada projeto Faces existente que deseja atualizar, faça o seguinte:
    1. No Explorer do Projeto, expanda um projeto existente para mostrar os arquivos na pasta WebContent/WEB-INF/lib/. Localize e exclua quaisquer dos seguintes arquivos JAR neste diretório:
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • jsf-portlet.jar
      • odc-jsf.jar
    2. Localize e abra o arquivo WebContent/WEB-INF/faces-config.xml. Inclua os seguintes elementos nesse arquivo de configuração se ainda não estiverem presentes:
      	<lifecycle>
      		<phase-listener>com.ibm.faces.webapp.ValueResourcePhaseListener</phase-listener>
      	</lifecycle>
      	
      	<application>
      		<variable-resolver>com.ibm.faces.databind.SelectItemsVarResolver</variable-resolver>
      		<variable-resolver>com.ibm.faces.application.WPPortletVariableResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
      Nota: Se o projeto do portlet estiver utilizando a API JSR 168, especifique com.ibm.faces.application.PortletVariableResolver em vez de com.ibm.faces.application.WPPortletVariableResolver.
    3. Para qualquer arquivo JAR excluído, copie o arquivo JAR do mesmo nome no diretório WebContent/WEB-INF/lib do projeto JSFP601 e cole-o no projeto original no mesmo local. Algumas configurações não exigem que todos esses arquivos JAR estejam presentes no projeto; não copie um determinado arquivo JAR se ele não estiver no projeto original.
      • Se o projeto de portlet utilizar a API de portlet da IBM ou o componente do link de pessoa, copie o arquivo jsf-wp.jar no projeto original.
      • Se você copiar o arquivo odc-jsf.jar, copie também o arquivo odc-jsf-portlet.jar.
    4. Abra o descritor de implementação web.xml no projeto original e inclua o seguinte na configuração:
      	<context-param>
      		<param-name>com.ibm.ws.jsf.JSP_UPDATE_CHECK</param-name>
      		<param-value>true</param-value>
      	</context-param>	<context-param>
      		<param-name>com.ibm.ws.jsf.LOAD_FACES_CONFIG_AT_STARTUP</param-name>
      		<param-value>true</param-value>
      	</context-param>
  6. Exclua o projeto de portlet JSFP601.
Conceitos relacionados
Compatibilidade com o WebSphere Studio V5.1.x
Referências relacionadas
Alterações do Depurador na V6.0
Migração do WDO para o SDO
Palavras Reservadas do EGL na V6.0
Feedback
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.