Migrando componentes de aplicativos da web a partir do WebSphere Application Server Versão 5.x

Não é necessária a migração de aplicativos da web que são implementados em versões anteriores do WebSphere Application Server. As versões 2.2 e posterior da especificação Java™ Servlet e as versões 1.2 e 1.4 das especificações JavaServer Pages (JSP) ainda são suportadas, a não ser que o comportamento tenha sido mudado nas especificações Servlet 3.1 ou JSP 2.3. Estas mudanças estão geralmente disponíveis em mais detalhes em suas especificações correspondentes.

Sobre Esta Tarefa

A migração do servlet pode ser uma preocupação nos seguintes casos:

  • Implementa um servlet interno do WebSphere Application Server para ignorar uma única restrição do caminho de aplicativos do WebSphere Application Server Versão 4.x
  • Estende um PageListServlet que conta com as informações de configuração do arquivo XML de configuração do servlet
  • Chama o método response.sendRedirect para um servlet utilizando a função encodeRedirectURL ou iniciando dentro de uma raiz sem contexto
  • Depende de um cabeçalho de resposta do Tipo de conteúdo padrão que está sendo configurado ou do comportamento de uma chamada setContentType após fazer uma chamada getWriter. O comportamento é configurado pelo nível de versão do WebSphere Application Server usando a propriedade customizada do contêiner da web com.ibm.ws.webcontainer.contenttypecompatibility com um valor de V4, V5, V6 ou V7. O comportamento para cada versão é descrito na Tabela 1.
    Tabela 1. Propriedades customizadas do contêiner de Web.. Descreve o comportamento de cada versão.
      Versão 4 Versão 5 Versão 6 Versão 7
    Content-Type padrão text/html text/html; charset=<default_encoding> none Nenhum
    Anexar Charset em getWriter se a propriedade não existir em Content-Type

    Exemplo: response.setCharacterEncoding("UTF-8"); response.setContentType("text/xml"); response.getWriter();

    text/html text/html text/xml; charset=UTF-8 text/xml; charset=UTF-8
    Remover charset da propriedade Content-Type se a propriedade setContentType for chamada após getWriter com uma parte ";charset="

    Exemplo: setContentType("text/html;charset=ISO-8859-7"); getWriter(); setContentType("text/xml;charset=UTF-8");

    text/html text/html text/html text/xml; charset=ISO-8859-7

[AIX Solaris HP-UX Linux Windows][IBM i]A migração JSP poderá ser uma preocupação se seu aplicativo fizer referência a classes de implementação de página JSP em pacotes não nomeados, ou se você instalar arquivos EAR do WebSphere Application Server Versão 4.x (implementados na Versão 4.x com a opção Pré-compilar JSP), na Versão 5.x. É necessário recompilar todas as páginas JSP ao migrar do WebSphere Application Server Versão 5.x.

[z/OS]A migração poderá ser um problema se seu aplicativo referenciar classes de implementação da página em pacotes não nomeados, ou se você instalar arquivos EAR do WebSphere Application Server Versão 4.0.1 (implementados na Versão 4.0.1 com a opção Pré-compilar JSP), na Versão 5.x. É necessário recompilar todas as páginas JSP ao migrar do WebSphere Application Server Versão 5.x.

Configurações suportadas Configurações suportadas: Para arquivos de extensão e de ligação IBM®, a extensão do nome do arquivo .xmi ou .xml é diferente dependendo de você estar utilizando um aplicativo pré-Java EE 5 ou um módulo ou um aplicativo ou módulo Java EE 5 ou posterior. Um arquivo de extensão ou de ligação IBM é denominado ibm-*-ext.xmi ou ibm-*-bnd.xmi em que * é o tipo de arquivo de extensão ou de ligação como app, aplicativo, ejb-jar ou web. As seguintes condições se aplicam:
  • Para um aplicativo ou módulo que usa um Java EE versão anterior à versão 5, a extensão do arquivo deverá ser .xmi.
  • Para um aplicativo ou módulo que usa Java EE 5 ou posterior, a extensão do arquivo deve ser .xml. Se os arquivos .xmi forem incluídos no aplicativo ou módulo, o produto ignorará os arquivos .xmi.

No entanto, um módulo Java EE 5 ou posterior pode existir dentro de um aplicativo que inclui arquivos pré-Java EE 5 e usa a extensão do nome do arquivo .xmi.

Os arquivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, e ibm-portlet-ext.xmi continuam a usar as extensões de arquivo .xmi.

sptcfg

Siga estas etapas se problemas de migração se aplicarem ao seu aplicativo da Web:

Procedimento

  1. Os servlets internos da IBM são utilizados para permitir comportamento especial, como serviço de arquivos e servlets de serviço por nome de classe. Se um aplicativo migrado referenciar servlets internos, a melhor prática será ativar ou desativar a funcionalidade por meio do arquivo XMI de extensões IBM WebSphere, ibm-web-ext.xmi, localizado em cada diretório WEB-INF do módulo da Web ou usando uma ferramenta de montagem.
  2. Se o uso dessas opções de configuração não for viável, verifique se os nomes dos pacotes dos servlets internos a seguir correspondem aos que são usados no seu descritor de implementação da web versão 7.
    Recurso Opção de Configuração Classe do Servlet
    Navegação em Diretório directoryBrowsingEnabled="true" com.ibm.ws.webcontainer.servlet.DirectoryBrowsingServlet
    Mapeamento Automático de Caminhos de Servlet serveServletsByClassnameEnabled="true: com.ibm.ws.webcontainer.servlet.SimpleFileServlet
    Serviço de Arquivos fileServingEnabled="true" com.ibm.ws.webcontainer.servlet.FilterProxyServlet
  3. [z/OS]Migre os servlets que estendem PageListServlet e dependem das informações de configuração no arquivo de configuração de servlet XML associado. Na Versão 4.0.1. o arquivo de configuração do servlet XML fornece dados de configuração para listas de páginas e aumenta as informações de configuração do servlet. Esse arquivo é denominado servlet_class_name.servlet ou servlet_name.servlet e é armazenado no mesmo diretório que o arquivo de classe do servlet.
  4. Inclua a propriedade customizada do contêiner da Web, com.ibm.ws.webcontainer.contenttypecompatibility, com um valor de V4, V5, V6, V7 e assim por diante. O valor será determinado pela versão da qual o aplicativo depende. Consulte os tópicos Modificando a configuração padrão do contêiner da Web para obter detalhes sobre como modificar essa propriedade customizada. Como essa propriedade é uma configuração global, você deve considerar o efeito sobre outros aplicativos.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_migrate2
Nome do arquivo: tweb_migrate2.html