WebSphere Application Server V5.x 迁移 Web 应用程序组件

不必迁移在 WebSphere® Application Server 先前版本中部署的 Web 应用程序。仍支持 Java™ Servlet 规范 V2.2 和更高版本以及 JavaServer Pages (JSP) 规范 V1.2 和 V1.4,除非在 Servlet 3.1 或 JSP 2.3 规范中更改了此行为。这些更改通常在其相应规范中作了更详细的描述。

关于此任务

在以下实例中,可能会考虑 Servlet 迁移:

  • 实现 WebSphere Application Server 内部 Servlet 以绕过 WebSphere Application Server V4.x 单个应用程序路径限制
  • 扩展依赖 Servlet 配置 XML 文件中配置信息的 PageListServlet
  • 使用 encodeRedirectURL 功能或在非上下文根中启动来调用 Servlet 的 response.sendRedirect 方法
  • 取决于要设置的缺省 Content-Type 响应头或者对 getWriter 进行调用后 setContentType 调用的行为。WebSphere Application Server 版本级别 V4、V5、V6 或 V7 使用 Web 容器定制属性 com.ibm.ws.webcontainer.contenttypecompatibility 来设置此行为。每一个版本的行为在“表 1”中进行了描述。
    表 1. Web 容器定制属性。. 描述每一个版本的版本行为。
      V4 V5 V6 V7
    缺省 Content-Type text/html text/html; charset=<default_encoding>
    如果 Content-Type 上不存在属性,那么将 Charset 追加到 getWriter

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

    text/html text/html text/xml; charset=UTF-8 text/xml; charset=UTF-8
    如果在 getWriter 后使用“;charset=”部分调用了 setContentType 属性,那么从 Content-Type 属性中除去 charset

    示例: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]如果应用程序引用了未命名包中的 JSP 页面实现类,或在 V5.x 中安装了 WebSphere Application Server V4.x EAR 文件(在 V4.x 中使用 JSP Precompile 选项部署),那么可能需要考虑 JSP 迁移。从 WebSphere Application Server V5.x 进行迁移时,需要重新编译所有 JSP 页面。

[z/OS]如果应用程序引用了未命名包中的 JSP 页面实现类,或在 V5.x 中安装了 WebSphere Application Server V4.0.1 EAR 文件(在 V4.0.1 中使用 JSP Precompile 选项部署),那么可能需要考虑 JSP 迁移。从 WebSphere Application Server V5.x 进行迁移时,需要重新编译所有 JSP 页面。

支持的配置 支持的配置: 对于 IBM® 扩展文件和绑定文件,根据您使用的是 Java EE 5 之前的应用程序或模块还是 Java EE 5 或之后的应用程序或模块,.xmi 或 .xml 文件扩展名有所不同。IBM 扩展文件或绑定文件将命名为 ibm-*-ext.xmi 或 ibm-*-bnd.xmi,其中 * 是扩展文件或绑定文件的类型,例如,app、application、ejb-jar 或 web。存在下列条件:
  • 对于使用 V5 之前的 Java EE 版本的应用程序或模块,文件扩展名必须是 .xmi。
  • 对于使用 Java EE 5 或更高版本的应用程序或模块,文件扩展名必须是 .xml。如果应用程序或模块中包含 .xmi 文件,那么产品将忽略这些 .xmi 文件。

然而,Java EE 5 或更高版本的模块可以在包含 Java EE 5 之前的文件并使用 .xmi 文件扩展名的应用程序中存在。

ibm-webservices-ext.xmiibm-webservices-bnd.xmiibm-webservicesclient-bnd.xmiibm-webservicesclient-ext.xmiibm-portlet-ext.xmi 文件继续使用 .xmi 文件扩展名。

sptcfg

如果迁移问题应用于您的 Web 应用程序,请遵循这些步骤:

过程

  1. IBM 内部 Servlet 用于启用特殊行为,例如文件服务及按类名服务 Servlet。如果已迁移的应用程序引用了内部 Servlet,那么通过位于每个 Web 模块 WEB-INF 目录中的 IBM WebSphere 扩展 XMI 文件 ibm-web-ext.xmi 或通过使用组装工具来启用或禁用该功能。
  2. 如果这些配置选项不可行,那么验证以下内部 Servlet 的包名是否与 V7 Web 部署描述符中使用的包名相匹配。
    功能部件 配置选项 Servlet 类
    目录浏览 directoryBrowsingEnabled="true" com.ibm.ws.webcontainer.servlet.DirectoryBrowsingServlet
    自动映射 Servlet 路径 serveServletsByClassnameEnabled="true: com.ibm.ws.webcontainer.servlet.SimpleFileServlet
    文件服务 fileServingEnabled="true" com.ibm.ws.webcontainer.servlet.FilterProxyServlet
  3. [z/OS]迁移 Servlet,这些 Servlet 扩展 PageListServlet 并依赖关联 XML Servlet 配置文件中的配置信息。 在 V4.0.1 中,XML Servlet 配置文件提供页列表的配置数据,并扩充 Servlet 配置信息。此文件命名为 servlet_class_name.servlet servlet_name.servlet,并且与 Servlet 类文件存储在同一个目录中。
  4. 添加 Web 容器定制属性 com.ibm.ws.webcontainer.contenttypecompatibility,值为 V4、V5、V6 和 V7 等。此值由应用程序所依赖于的版本确定。 请参阅“修改缺省 Web 容器配置”主题,以了解有关如何修改此定制属性的详细信息。因为此属性是全局设置,所以必须考虑对其他应用程序的影响。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_migrate2
文件名:tweb_migrate2.html