Migración de componentes de aplicaciones web de WebSphere Application Server Version 5.x

No es necesario migrar las aplicaciones web desplegadas en las versiones anteriores de WebSphere Application Server. Las versiones 2.2 y posteriores de la especificación de Java™ Servlet y las versiones 1.2 y 1.4 de las especificaciones JSP (JavaServer Pages) siguen estando soportadas salvo que se haya cambiado el comportamiento en las especificaciones de Servlet 3.1 o de JSP 2.3. Estos cambios normalmente están disponibles en más detalle en su especificación correspondiente.

Acerca de esta tarea

La migración del servlet puede ser un punto a tener en los siguientes casos:

  • Implementa un servlet interno de WebSphere Application Server para omitir una restricción de vía de acceso de aplicación individual de WebSphere Application Server Versión 4.x
  • Amplía un PageListServlet que se basa en la información de configuración del archivo XML de configuración de servlet
  • Llama al método response.sendRedirect para un servlet utilizando la función encodeRedirectURL o iniciándose dentro de una raíz sin contexto
  • Depende de una cabecera de respuesta Content-Type predeterminada que se está estableciendo o del comportamiento de una llamada setContentType, después de realizar una llamada getWriter. El comportamiento es establecido por el nivel de versión de WebSphere Application Server utilizando la propiedad personalizada del contenedor web com.ibm.ws.webcontainer.contenttypecompatibility con un valor de V4, V5, V6 o V7. En la Tabla 1 se describe el comportamiento para cada versión.
    Tabla 1. Propiedades personalizadas del contenedor web.. Describe el comportamiento de cada versión.
      Versión 4 Versión 5 Versión 6 Versión 7
    Content-Type predeterminado text/html text/html; charset=<codificación_predeterminada> ninguno ninguno
    Adjuntar charset en getWriter, si la propiedad no existe en Content-Type

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

    text/html text/html text/xml; charset=UTF-8 text/xml; charset=UTF-8
    Eliminar el charset de la propiedad Content-Type, si la propiedad setContentType se llama después de getWriter con una parte ";charset="

    Ejemplo: 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]La migración de JSP puede ser un problema si la aplicación hace referencia a clases de implementación de páginas JSP de paquetes sin nombre o si instala los archivos EAR de WebSphere Application Server Versión 4.x (desplegados en la Versión 4.x con la opción Precompile de JSP) en la Versión 5.x. Tiene que volver a compilar todas las páginas JSP al migrar desde WebSphere Application Server Versión 5.x.

[z/OS]La migración de JSP puede ser un problema si la aplicación hace referencia a clases de implementación de páginas JSP en paquetes sin nombre o si instala los archivos EAR de WebSphere Application Server Versión 4.0.1.x (desplegados en la Versión 4.0.1.x con la opción Precompile de JSP) en la Versión 5.x. Tiene que volver a compilar todas las páginas JSP al migrar desde WebSphere Application Server Versión 5.x.

Supported configurations Supported configurations: Para los archivos de enlace y extensión de IBM®, la extensión del nombre de archivo .xmi o .xml es diferente en función de si se utiliza una aplicación o módulo previo a Java EE 5 o una aplicación o módulo Java EE 5 o posterior. Un archivo de enlace o extensión de IBM se denomina ibm-*-ext.xmi o ibm-*-bnd.xmi donde * es el tipo de archivo de extensión o enlace como app, application, ejb-jar o web. Se aplican las condiciones siguientes:
  • En el caso de una aplicación o módulo que utilice una Java EE anterior a la versión 5, la extensión del archivo debe ser .xmi.
  • En el caso de una aplicación que utilice Java EE versión 5 o posterior, la extensión del archivo debe ser .xml. Si los archivos .xmi se incluyen con la aplicación o el módulo, el producto ignora los archivos .xmi.

No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.

Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.

sptcfg

Siga estos pasos si los asuntos de migración afectan a su aplicación web:

Procedimiento

  1. Los servlets internos de IBM se utilizan para permitir un comportamiento especial como el servicio de archivos y el servicio de servlets por nombre de clase. Si una aplicación migrada hace referencia a servlets internos, se aconseja habilitar o inhabilitar la funcionalidad mediante el archivo XMI de extensiones de IBM WebSphere, ibm-web-ext.xmi, ubicado en cada directorio WEB-INF de módulo web o utilizando una herramienta de ensamblaje.
  2. Si estas opciones de configuración no es viable, verifique que los nombres de paquete para los siguientes servlets internos coinciden con los que se utilizan en el descriptor de despliegue web de la versión 7.
    Característica Opción de configuración Clase de servlet
    Examen de directorios directoryBrowsingEnabled="true" com.ibm.ws.webcontainer.servlet.DirectoryBrowsingServlet
    Correlación automática de vías de acceso de servlets serveServletsByClassnameEnabled="true: com.ibm.ws.webcontainer.servlet.SimpleFileServlet
    Servicio de archivos fileServingEnabled="true" com.ibm.ws.webcontainer.servlet.FilterProxyServlet
  3. [z/OS]Migre los servlets que amplían PageListServlet y se basan en la información de configuración de un archivo de configuración de servlet XML asociado. En la versión 4.0.1, el archivo de configuración de servlet XML proporciona datos de información para las listas de páginas y amplían la información de configuración del servlet. Este archivo se llama nombre_de_clase_servlet.servlet o nombre_servlet.servlet, y se almacena en el mismo directorio que el archivo de clase de servlet.
  4. Añada la propiedad personalizada del contenedor web, com.ibm.ws.webcontainer.contenttypecompatibility, con un valor de V4, V5, V6, V7 y así sucesivamente. El valor lo determina la versión de la que depende la aplicación. Consulte el tema Modificación de la configuración de contenedor web predeterminada para obtener más detalles sobre cómo modificar esta propiedad personalizada. Puesto que esta propiedad es un valor global, debe considerar la repercusión en otras aplicaciones.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_migrate2
File name: tweb_migrate2.html