不推荐使用的 WebSphere Application Server(传统) 功能部件
如果您要从 WebSphere® Application Server 的较早发行版迁移配置,那么应该知道在本发行版和较早发行版中已经不推荐使用的各种功能部件。
V.R.M.F
其中:- V = 版本
- R = 发行版
- M = 修订版
- F = 修订包
如果某个功能部件在本文中被列为不推荐使用的功能部件,那么 IBM® 会在该产品的后续发行版中移除此功能。未来投资将关注推荐的迁移操作下列出的策略化功能。通常,除非提供了等效的替代功能部件,否则不会不推荐使用某个功能部件。在不推荐使用某个功能部件的发行版之后,至少要在发行了两个主要发行版或者经过整整三年之后(以这两个选项中时间更长者优先)才会移除该功能部件。以包括 6.0、6.1 和 7.0 在内的发行版序列为例,在发行版 6.0 中不推荐使用的功能部件将在 7.0 中首次变为可移除。只有在很少的情况下,才可能需要尽快移除某些功能部件;在对这些已移除的功能部件的描述中清楚明确地指出了这样的情况。
下列各表按版本和发行版总结了不推荐使用的功能部件。这些表都指出了不推荐使用的功能部件,例如:应用程序编程接口 (API)、脚本编制接口、工具、向导、公开显示的配置数据、命名标识和常量。这些表还尽可能指出了建议执行的迁移操作。
本文包含下列不推荐使用的功能部件表:
V9.0 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器 | 以下可选 Java™ Platform Enterprise Edition (Java EE) 7 技术:
以下可选 Java EE 7 技术仍不推荐使用:
|
|
以下异步编程模型:
|
使用 Java EE 并行实用程序 (JSR 236)。Java EE 并行实用程序提供标准化方法在应用程序服务器中执行并行操作。有关如何从异步 bean 和 CommonJ 进行迁移的信息,请参阅从异步 Bean 和 CommonJ 迁移到 EE 并行的示例。 | |
平衡工作负载 | 备份集群 | 您应考虑使用 REST 接口来包装 EJB 功能,而不是利用核心组网桥跨多个单元使用基于 IIOP 的备份集群。然后,使用前端负载均衡(例如随需应变路由器)来平衡负载。 |
数据库 | WebSphere Application Server V4.0 数据源 | 对 WebSphere Application Server V5.0 及更高版本使用数据源。这些数据源基于标准 JCA 体系结构。数据源集合中描述了这些数据源的设置。 不推荐使用的 V4.0 数据源基于单连接管理器 (CM) 体系结构。数据源 (WebSphere Application Server V4) 集合(不推荐使用)中描述了这些数据源的设置。 有关这些数据源之间的差别的更多信息,请参阅数据源。 |
WebSphere Application Server V4.0 数据源 MBean | 使用 DataSource Mbean。有关更多信息,请参阅 DataSource MBean | |
Intelligent Management | 辅助并完成生命周期管理服务器 | 请将 WebSphere Liberty 服务器迁移至 Liberty 管理服务器集合体配置。对于其他服务器类型,没有任何建议的迁移操作。 |
中间服务 | DMZ Secure Proxy Server | 如果使用代理服务器作为 WebSphere Application Server 的前端,请使用 IBM HTTP Server 和 WebSphere Web 服务器插件、随需应变路由器或 IBM DataPower® 设备。
如果使用与 WebSphere Application Server 分离的代理服务器,请使用 IBM HTTP Server 和带有 Intelligent Management 的 WebSphere Web 服务器插件、随需应变路由器或 IBM DataPower。 有关中间服务的更多信息,请参阅为您的 WebSphere Application Server 拓扑选择前端。 |
系统管理 | Jython 2.1 | 迁移到 Jython 2.7 |
系统管理 | wsadmin 脚本编制(带有 Jacl) | 使用 Jython 语言创建 wsadmin 脚本。有关更多信息,请参阅和 Jython 一起使用 wsadmin 脚本编制。 |
![]() |
![]() |
![]() |
系统管理 | IBM Support Assistant (ISA) Data Collector 工具,它从 WebSphere Application Server 环境收集信息,以供 IBM 软件支持使用。 | 使用收集器工具(collector.bat 或 collector.sh)。
|
Web 服务器插件配置 | 以拓扑为中心的插件配置或全局插件配置。 | 使用以应用程序为中心的插件配置。以应用程序为中心的 plugin-cfg.xml 配置文件具有同时映射至 Web 服务器定义和应用程序服务器定义的应用程序。有关更多信息,请参阅实现 Web 服务器插件。 |
服务集成总线 | 通过 IBM MQ 服务器进行互操作。有关更多详细信息,请参阅使用 IBM MQ 服务器进行互操作。 | 使用 IBM MQ 资源适配器或 IBM MQ 链路来连接到 IBM MQ 网络,以进行互操作。有关更多信息,请参阅使用 WebSphere MQ 消息传递提供程序进行互操作和使用 WebSphere MQ 链路将总线连接到 WebSphere MQ 网络。 |
V8.5.5 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序组装和部署 | IBM Assembly and Deploy Tools for WebSphere Administration | 对于使用 Java EE 5 及更高版本的编程模型,请使用 IBM WebSphere Developer Tools。 要修改 Java EE 5 之前的 Java EE 编程模型的绑定和扩展部署描述符,请在安装应用程序前使用 WebSphere 管理控制台。有关更多信息,请参阅使用控制台安装企业应用程序文件。 要生成 Enterprise JavaBean (EJB) 2.x 的部署代码,请使用 ejbdeploy 命令,或者选择在安装应用程序时部署企业 Bean。 对于 ibm-webservices-bnd.xml 和编程模型扩展部署描述符的编辑器,没有替代编辑器。 |
Edge Components | WebSphere Edge
Components Load Balancer for IPv4 注: 从 V6.1 开始,已不推荐使用 Load Balancer for IPv4 和 IPv6 中不可用的功能部件,并且这些功能部件随后已稳定。有关更多信息,请参阅“稳定的功能部件”。
|
迁移到 WebSphere Edge Components Load Balancer for IPv4 和 IPv6 and IPv6。 |
![]() |
![]() 注: 此功能部件在 V9.0 中已除去。
|
![]() 如果使用独立于 WebSphere Application Server
的代理服务器,那么 z/OS 捆绑的 HTTP 服务器附带的基本 HTTP 代理功能可用:
|
IBM HTTP Server | 证书撤销列表 (CRL) 协议支持 | 将在线证书状态协议 (OCSP) 与 TLS 证书配合使用。 在 IBM HTTP Server 中,CRL 支持是使用 SSLCRLHostname 和 SSLCRLUserid 伪指令启用的。CRL 支持还受 TLS 证书中的 CRLDistributionPoint 扩展控制。 TLS 规范现在遵循 OCSP,OCSP 是使用 SSLOCSPEnable 和 SSLOCSPResponderURL 伪指令启用的。在 TLS 证书中,OCSP 支持受 AuthorityInformationAccess 扩展控制。 有关更多信息,请参阅 SSL 证书撤销列表和在线证书状态协议。 |
Web 2.0 and Mobile Toolkit | Dojo Toolkit,包含 Dojo Diagrammer | Dojo 桌面和移动应用程序将继续生效,但 IBM 不再提供支持。您可使用开放式源代码 Dojo Toolkit 继续开发 Dojo 应用程序。 |
Web 消息传递服务 | 迁移使用 Web 消息传递服务的应用程序以使用 Servlet 3.0 异步 servlet 或 WebSocket 协议。有关更多信息,请参阅使用 WebSphere Application Server 扩展来开发 Servlet。 | |
Ajax Proxy | 迁移 Ajax Proxy 应用程序以使用跨源资源共享 (CORS) 来处理跨域请求。 | |
支持以下服务器端服务:
|
重新构造应用程序以使用 Java API for RESTful Web Services (JAX-RS)。 迁移图形服务时,可使用开放式源代码 Apache Batik 项目以转换图像。 |
|
支持以下应用程序服务:
|
没有建议的迁移操作。 |
V8.5 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序服务 | com.ibm.websphere.management.application.client.EnvEntry_processAnnotations 属性 | 使用 com.ibm.websphere.management.application.client.EnvEntry_processBindings 属性 |
与已启用通信的应用程序 (CEA) 功能部件关联的 DOJO 窗口小部件 | 使用 CEA DOJO 1.5 窗口小部件源和描述,它们可从可供公众访问的 developerWorks® 中开发支持 WebSphere Application Server 通信的应用程序 (CEA) 窗口小部件一文中获取。 | |
与公共事件基础结构 (CEI) 模块相关的所有应用程序编程接口 (API) CEI 模块使用以下建议的文件:
|
对于需要基于事件的模型的新应用程序,请使用服务集成总线 (SIBus)。使用 SIBus 提供的 API 设计新应用程序来发送和接收事件。 | |
com.ibm.portal.* 软件包:
|
没有建议的迁移操作。 | |
来自 WSSecurityHelper 类的 revokeSSOCookies(HttpServletRequest, HttpServletResponse)
方法 注: Liberty 概要文件中不支持此方法。
|
使用 Java Servlet-3.0 logout() 方法提供的功能。 | |
来自 WSSecurityHelper 类的 getLTPACookieFromSSOToken() 方法 注: Liberty 概要文件中不支持此方法。
|
使用来自 WebSecurityHelper 类的 getSSOCookieFromSSOToken() 方法提供的功能。 | |
应用程序组装和部署 | 启用通信的应用程序 | 没有 CEA 的替代项。 如果要在 Liberty 上部署应用程序,请考虑使用 Rtcomm 功能,它提供了一组实时通信工具。有关更多信息,请参阅使用 Rtcomm 进行 WebRTC 应用程序开发。 |
Edge Components | WebSphere Edge Components Load Balancer for IPv4 提供的广域网分派器 (WAND) 功能部件 | 对 IPv4 使用网络地址转换 (NAT) 转发方法或对 IPv6 上使用介质访问控制 (MAC) 封装转发方法。 |
WebSphere Edge Components Load Balancer
for IPv4 的以下两个组件,这两个组件与这些供应商的交换机配合工作,以提供有关服务器可用性的简单网络管理协议
(SNMP) 统计信息:
|
使用 IBM Load Balancer。 | |
WebSphere Edge Components Load Balancer for IPv4 支持令牌环接口 | 使用 Ethernet 接口。 | |
系统管理 | Intelligent Management 支持以下辅助生命周期中间件服务器类型:
注: 在 V8.5.5 中已实现此支持并保持稳定。
|
使用 wsadmin 脚本编制可管理这些中间件服务器资源。 |
创建动态集群时使用的 defaultXD 和 defaultXDZOS 服务器模板。 | 使用 default 或 defaultZOS 服务器模板。 | |
![]() ![]() |
![]() ![]() |
V8.0.0.1 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
系统管理 | 支持以下软件,这些软件位于文件末尾:
|
移至以下内容:
|
V8.0 中不推荐使用的功能部件
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) 注: 此功能部件已在 V9.0 中移除。
|
使用 JSF 2.0 MyFaces 实现,它是
WebSphere Application Server V8.0 的缺省实现。 有关如何迁移至 JSF 2.0 MyFaces 实现的信息,请参阅JavaServer Faces 迁移和 IBM developerWorks 上的将 JavaServer Faces 1.x 应用程序迁移至 JavaServer Faces 2.0 主题。 |
应用程序服务 | 以下为 historyInfo 实用程序命令行参数:
|
使用
historyInfo 实用程序时注意以下事项:
|
以下为 versionInfo 实用程序命令行参数:
|
使用
versionInfo 实用程序时注意以下事项:
|
|
com.ibm.websphere.product.WASDirectory 类中的以下方法:
|
不要使用这些方法。
|
|
应用程序服务 | com.ibm.websphere.product.*
软件包下的以下类:
|
使用以下准则:
|
com.ibm.websphere.product.WASDirectory 类下的以下常量:
|
WASDirectory 接口独立于产品标识,并将其视为一个字符串。任何特定于产品的调用者应该亲自指定产品标识。 | |
对 Java API for XML Registries (JAXR) 的支持 | 使用 UDDI V3。 | |
安全性 | com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli® Access Manager (TAM) 信任关联拦截器 (TAI) 接口 | 从 Tivoli Access Manager Trust Association Interceptor Plus Web 站点获取最新版本的 Tivoli 代码。 |
系统管理 | AdminTask 项目的 ServerManagement 命令组中的 createServerType 命令 | 不要创建新的服务器类型。 |
AdminTask 对象的 ManagedNodeGroup 命令组中的以下命令:
|
使用 AdminTask 对象的 TargetGroup 命令组中的以下命令:
|
|
服务日志,通常命名为 activity.log | 使用以下某种方法来访问日志内容:
|
|
使用 Java EE Application Deployment API 规范 JSR-88 在应用程序服务器上部署 Java Platform, Enterprise Edition (Java EE) 模块或应用程序的支持 | 使用许多其他选项中的任何一个选项将应用程序部署到服务器(包括 wsadmin 脚本编制和 JMX MBean)。与使用 Java EE Deployment API 的最为接近的方法为使用 WebSphere JMX MBean。请参阅安装企业应用程序或模块的方法,以了解更多信息。 | |
DataPower 设备管理器 | 您可以继续使用 DataPower 设备管理器以管理现有受支持的 DataPower 设备,直到将其从产品中移除或直到设备不可用。 在 WebSphere Application
Server V8.0 中,支持以下设备:
通过单独 DataPower 设备管理产品管理不在先前列表上的新设备,此产品还可管理现有设备。 |
|
Tivoli Performance Viewer | Tivoli Performance Viewer 使用可伸缩向量图形 (SVG) 格式绘制图形 | 不需要任何操作。Tivoli Performance Viewer 现在使用 Dojo 格式来绘制图形。 注: 要返回到支持 SVG 和图像格式的先前的图形样式,请将 com.ibm.websphere.tpv.DojoGraph JVM 系统属性设置为 false。
|
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) 注: 此功能部件已在 V9.0 中移除。
|
使用 JSF 2.0 MyFaces 实现,它是
WebSphere Application Server V8.0 的缺省实现。 有关如何迁移至 JSF 2.0 MyFaces 实现的信息,请参阅JavaServer Faces 迁移和 IBM developerWorks 上的将 JavaServer Faces 1.x 应用程序迁移至 JavaServer Faces 2.0 主题。 |
应用程序服务 | 以下为 historyInfo 实用程序命令行参数:
|
使用
historyInfo 实用程序时注意以下事项:
|
以下为 versionInfo 实用程序命令行参数:
|
使用
versionInfo 实用程序时注意以下事项:
|
|
com.ibm.websphere.product.WASDirectory 类中的以下方法:
|
不要使用这些方法。
|
|
应用程序服务 | com.ibm.websphere.product.*
软件包下的以下类:
|
使用以下准则:
|
com.ibm.websphere.product.WASDirectory 类下的以下常量:
|
WASDirectory 接口独立于产品标识,并将其视为一个字符串。任何特定于产品的调用者应该亲自指定产品标识。 | |
对 Java API for XML Registries (JAXR) 的支持 | 使用 UDDI V3。 | |
安全性 | com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli Access Manager (TAM) 信任关联拦截器 (TAI) 接口 | 从 Tivoli Access Manager Trust Association Interceptor Plus Web 站点获取最新版本的 Tivoli 代码。 |
系统管理 | AdminTask 项目的 ServerManagement 命令组中的 createServerType 命令 | 不要创建新的服务器类型。 |
AdminTask 对象的 ManagedNodeGroup 命令组中的以下命令:
|
使用 AdminTask 对象的 TargetGroup 命令组中的以下命令:
|
|
以下命令用于启动 Profile Management Tool:
|
使用以下命令启动 WebSphere 定制工具箱:
|
|
服务日志,通常命名为 activity.log | 使用以下某种方法来访问日志内容:
|
|
使用 Java EE Application Deployment API 规范 JSR-88 在应用程序服务器上部署 Java Platform, Enterprise Edition (Java EE) 模块或应用程序的支持 | 使用许多其他选项中的任何一个选项将应用程序部署到服务器(包括 wsadmin 脚本编制和 JMX MBean)。与使用 Java EE Deployment API 的最为接近的方法为使用 WebSphere JMX MBean。请参阅安装企业应用程序或模块的方法,以了解更多信息。 | |
DataPower 设备管理器 | 您可以继续使用 DataPower 设备管理器以管理现有受支持的 DataPower 设备,直到将其从产品中移除或直到设备不可用。 在 WebSphere Application
Server V8.0 中,支持以下设备:
通过单独 DataPower 设备管理产品管理不在先前列表上的新设备,此产品还可管理现有设备。 |
|
Tivoli Performance Viewer | Tivoli Performance Viewer 使用可伸缩向量图形 (SVG) 格式绘制图形 | 不需要任何操作。Tivoli Performance Viewer 现在使用 Dojo 格式来绘制图形。 注: 要返回到支持 SVG 和图像格式的先前的图形样式,请将 com.ibm.websphere.tpv.DojoGraph JVM 系统属性设置为 false。
|
![[IBM i]](../images/iseries.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) 注: 此功能部件已在 V9.0 中移除。
|
使用 JSF 2.0 MyFaces 实现,它是
WebSphere Application Server V8.0 的缺省实现。 有关如何迁移至 JSF 2.0 MyFaces 实现的信息,请参阅JavaServer Faces 迁移和 IBM developerWorks 上的将 JavaServer Faces 1.x 应用程序迁移至 JavaServer Faces 2.0 主题。 |
应用程序服务 | 以下为 historyInfo 实用程序命令行参数:
|
使用
historyInfo 实用程序时注意以下事项:
|
以下为 versionInfo 实用程序命令行参数:
|
使用
versionInfo 实用程序时注意以下事项:
|
|
com.ibm.websphere.product.WASDirectory 类中的以下方法:
|
不要使用这些方法。
|
|
应用程序服务 | com.ibm.websphere.product.*
软件包下的以下类:
|
使用以下准则:
|
com.ibm.websphere.product.WASDirectory 类下的以下常量:
|
WASDirectory 接口独立于产品标识,并将其视为一个字符串。任何特定于产品的调用者应该亲自指定产品标识。 | |
对 Java API for XML Registries (JAXR) 的支持 | 使用 UDDI V3。 | |
安全性 | com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli Access Manager (TAM) 信任关联拦截器 (TAI) 接口 | 从 Tivoli Access Manager Trust Association Interceptor Plus Web 站点获取最新版本的 Tivoli 代码。 |
系统管理 | enableJvm 命令 | 使用 managesdk 命令。 |
AdminTask 项目的 ServerManagement 命令组中的 createServerType 命令 | 不要创建新的服务器类型。 | |
AdminTask 对象的 ManagedNodeGroup 命令组中的以下命令:
|
使用 AdminTask 对象的 TargetGroup 命令组中的以下命令:
|
|
服务日志,通常命名为 activity.log | 使用以下某种方法来访问日志内容:
|
|
使用 Java EE Application Deployment API 规范 JSR-88 在应用程序服务器上部署 Java Platform, Enterprise Edition (Java EE) 模块或应用程序的支持 | 使用许多其他选项中的任何一个选项将应用程序部署到服务器(包括 wsadmin 脚本编制和 JMX MBean)。与使用 Java EE Deployment API 的最为接近的方法为使用 WebSphere JMX MBean。请参阅安装企业应用程序或模块的方法,以了解更多信息。 | |
DataPower 设备管理器 | 您可以继续使用 DataPower 设备管理器以管理现有受支持的 DataPower 设备,直到将其从产品中移除或直到设备不可用。 在 WebSphere Application
Server V8.0 中,支持以下设备:
通过单独 DataPower 设备管理产品管理不在先前列表上的新设备,此产品还可管理现有设备。 |
|
Tivoli Performance Viewer | Tivoli Performance Viewer 使用可伸缩向量图形 (SVG) 格式绘制图形 | 不需要任何操作。Tivoli Performance Viewer 现在使用 Dojo 格式来绘制图形。 注: 要返回到支持 SVG 和图像格式的先前的图形样式,请将 com.ibm.websphere.tpv.DojoGraph JVM 系统属性设置为 false。
|
V7.0 中不推荐使用的功能部件
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.jtaextensions.ExtendedJTATransaction 接口中的 registerSynchronizationCallbackForCurrentTran 方法 | 请改为使用 TransactionSynchronizationRegistry 接口的 registerInterposedSynchronization 方法。 有关更多信息,请参阅 JTA support。 |
com.ibm.ws.extensionhelper.TransactionControl 接口 | 改用 com.ibm.wsspi.uow.UOWManager 接口。 有关更多信息,请参阅 JTA support。 |
|
com.ibm.websphere.Servlet.request 程序包中的 HttpServletRequestProxy 类 | 使用 HttpServletRequestWrapper 类来代替 HttpServletRequestProxy 类。可以使用该类的子类来重载或增强服务器所提供的 HttpServletRequest 的功能性。 | |
com.ibm.websphere.Servlet.response 程序包中的 HttpServletResponseProxy 类 | 使用 HttpServletResponseWrapper 类来代替 HttpServletResponseProxy 类。可以使用该类的子类来重载或增强服务器所提供的 HttpServletResponse 的功能性。 | |
WebSphere 相关资源适配器的下列类、接口、方法和字段:
|
如果您要使用 OracleDataStoreHelper,请切换到 Oracle 11g JDBC 驱动程序,并改为使用 Oracle10gDataStoreHelper。 不使用 getNativeConnection,而使用 Java 数据库连通性 (JDBC) 4.0 包装程序模式。 不使用 WSConnection 客户机信息,而使用 JDBC 4.0 客户机信息 API。 不使用 com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn),而使用 com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn, boolean logEvent) 方法。此新方法将提供一个布尔参数,该参数允许您控制连接错误事件是否会记录到 system out 消息中。 不使用 WSCallHelper.call,而使用标准的 Java 反射 API。 如果您正在使用 ORACLE_HELPER,请切换到 Oracle 11g JDBC 驱动程序并改为使用 ORACLE_11G_HELPER。 |
|
应用程序编程模型 | 下面的会话管理功能:
|
为进行会话共享,请重新设计应用程序,以便在 Java Servlet 规范 V2.2 和更高版本中所指定的 Web 模块内恰当地设置会话范围。如果必须跨 Web 模块边界共享数据,那么使用 Websphere Extension,共享会话上下文为 true,或使用 IBMApplicationSession API。 并不是将会话管理器属性指定为系统或 Web 容器定制属性,而是使用会话管理器定制属性。 |
按 SQL 查询的连接验证 | 使用 JDBC 4.0 所引入的基于超时的验证。 | |
类:
接口:SERV1\ws\code\admin.thinclient\src\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr.java 方法:在 RemoteCommandMgr 接口和 MBean XML 中的所有方法, SERV1\ws\code\admin.jmx\src\com\ibm\ws\management\ descriptor\xml\RemoteCommandMgr.xml 构造方法:RemoteCommandMgrImpl() |
不需要执行迁移操作。 | |
以下专有类用于表示和操作 Java API for XML Web Services (JAX-WS) 2.0 中的 WS-Addressing 端点引用:
|
改用以下类:
|
|
以下为 WebSphere 公共配置模型 (WCCM) 类型:
|
如果您的 Jython 脚本或 Jacl wsadmin 脚本之一使用了这些类型,请修改该脚本以使用正确的 AdminTask 命令来完成等价功能。例如:
|
|
环境 | IBM HTTP Server (IHS) mod_file_cache 模块 | 将您的 IHS 配置伪指令从 mod_file_cache 迁移至已提供的适当的高速缓存机制(mod_mem_cache 或 mod_cache)中。 |
IHS mod_ibm_ldap 模块 | 将您的 mod_ibm_ldap 配置伪指令迁移至等价的 mod_ldap 伪指令中。 | |
IHS mod_mime_magic 模块 | 移除任何与该模块相关的 IHS 配置伪指令。 | |
IHS mod_proxy_ftp 模块 | 移除任何与该模块相关的 IHS 配置伪指令。 | |
IHS mod_afpa_cache 模块 针对静态和动态生成的内容高速缓存,AIX® 和 Windows 操作系统均不推荐使用 Adaptive Fast Path Architecture (AFPA)。 |
移除任何与该模块相关的 IHS 配置伪指令。 | |
J2EE 资源 | 以下功能:
|
使用符合 J2EE 连接器体系结构 1.5 规范的 JMS 提供程序。 |
数据访问 | disablePK54589 系统属性 | 将数据源定制属性配置为 isConnectionSharingBasedOnCurrentState。
如果您正在使用 disablePK54589=true,那么您可以用 isConnectionSharingBasedOnCurrentState=false 来替换它。 |
编程 | JavaServer Faces 窗口小部件库 (JWL) 随 WebSphere Application Server 提供 | 使用 Rational® Application Developer 中的 JAR 来手动创建 JWL 的共享库。 |
概要文件管理 | Deployment Manager 概要文件模板 | 将管理概要文件模板用于 Deployment Manager 服务器。 |
安全性 | 支持使用简单且受保护的 GSS-API 协商机制信任关联拦截器 (SPNEGO TAI) 来安全地协商和认证对受保护资源发出的 HTTP 请求。 | 使用嵌入式 SPNEGO Web 认证,以提供动态重新装入 SPNEGO 过滤器的功能以及对应用程序登录方法启用回退。 |
服务器 | WebSphere Application Server for z/OS 支持 31 位寻址方式 | 启动“迁移至 64 位支持”。 V7.0 中缺省将创建新的服务器来运行 64 位寻址方式;但是,仍然可以配置从较早发行版迁移至 V7.0 的服务器来运行 31 位寻址方式。 |
Apache Struts 1.1、1.2.4 和 1.2.7 作为可选库随 WebSphere Application Server 提供 | 如果您想继续使用 Apache Struts 的这些版本,那么可从 Apache Struts Web 站点上获取。 | |
有关核心组传输,可以使用以下配置选项:
|
移动至通道框架传输。 有关更多信息,请参阅 核心组传输。 |
|
系统管理 | 用于安装 IBM Application Client for WebSphere Application Server 的 Pluggable Application Client 功能部件的选项 | 请改用新的“EJB 瘦应用程序客户机”功能部件。 |
以下服务集成总线 (SIBus) 安全性功能部件:
|
执行以下操作:
|
|
收集器工具(collector.bat 或 collector.sh)收集有关 WebSphere Application Server 安装的信息,并将其打包在 Java 归档
(JAR) 文件中,您可以将此文件发送给 IBM 软件支持 注: 此功能部件仍受推荐。
|
使用 IBM Support Assistant (ISA) Lite。 | |
基于协议的代理服务器模板 | 使用 ServerManagement 命令组中的管理控制台或 wsadmin 命令来选择代理服务器的一个或多个协议。 有关更多信息,请参阅 AdminTask 对象的 ServerManagement 命令组 |
|
WebSphere Touchpoint(WAS.admin.wstp 组件 - 所有类和方法) | 请使用 WebSphere Application Server 中的其他标准管理接口。 | |
AdminTask 对象的 SecureConversation 命令组中的命令 | 使用 WSSCacheManagement 命令组中的命令来管理 Web Service 安全性 (WS-Security) 分布式高速缓存配置。 | |
以下为虚拟成员管理器 (VMM) 联合存储库中的轻量级目录访问协议 (LDAP) 配置名称:
|
使用下列配置名称:
|
|
Web Service | 支持“2006/02”WS-Addressing Web 服务描述语言 (WSDL) 绑定名称空间 | 用“2006/05”名称空间的用法来替换 WSDL 文件中的“2006/02”名称空间的用法 |
Web Service 分布式管理 (WSDM) 接口 | 请使用 WebSphere Application Server 中的其他标准管理接口。 | |
用于 Java API for XML Web Services (JAX-WS) 或 Java API for XML-based RPC (JAX-RPC) 应用程序的 IBM 专有 SOAP over Java Message Service (JMS) 协议 | 使用标准的 SOAP over JMS 协议。 有关更多信息,请参阅SOAP over JMS 协议和SOAP over Java Message Service 。 限制: 如果客户机应用程序调用受比 V7.0 更早的 WebSphere Application Server 发行版支持的基于企业 Bean 的 Web Service,那么您必须继续使用 IBM 专有 SOAP over JMS 协议来访问这些 Web Service。
|
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.jtaextensions.ExtendedJTATransaction 接口中的 registerSynchronizationCallbackForCurrentTran 方法 | 请改为使用 TransactionSynchronizationRegistry 接口的 registerInterposedSynchronization 方法。 有关更多信息,请参阅 JTA support。 |
com.ibm.ws.extensionhelper.TransactionControl 接口 | 改用 com.ibm.wsspi.uow.UOWManager 接口。 有关更多信息,请参阅 JTA support。 |
|
com.ibm.websphere.Servlet.request 程序包中的 HttpServletRequestProxy 类 | 使用 HttpServletRequestWrapper 类来代替 HttpServletRequestProxy 类。可以使用该类的子类来重载或增强服务器所提供的 HttpServletRequest 的功能性。 | |
com.ibm.websphere.Servlet.response 程序包中的 HttpServletResponseProxy 类 | 使用 HttpServletResponseWrapper 类来代替 HttpServletResponseProxy 类。可以使用该类的子类来重载或增强服务器所提供的 HttpServletResponse 的功能性。 | |
WebSphere 相关资源适配器的下列类、接口、方法和字段:
|
如果您要使用 OracleDataStoreHelper,请切换到 Oracle 11g JDBC 驱动程序,并改为使用 Oracle10gDataStoreHelper。 不使用 getNativeConnection,而使用 Java 数据库连通性 (JDBC) 4.0 包装程序模式。 不使用 WSConnection 客户机信息,而使用 JDBC 4.0 客户机信息 API。 不使用 com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn),而使用 com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn, boolean logEvent) 方法。此新方法将提供一个布尔参数,该参数允许您控制连接错误事件是否会记录到 system out 消息中。 不使用 WSCallHelper.call,而使用标准的 Java 反射 API。 如果您正在使用 ORACLE_HELPER,请切换到 Oracle 11g JDBC 驱动程序并改为使用 ORACLE_11G_HELPER。 |
|
应用程序编程模型 | 下面的会话管理功能:
|
为进行会话共享,请重新设计应用程序,以便在 Java Servlet 规范 V2.2 和更高版本中所指定的 Web 模块内恰当地设置会话范围。如果必须跨 Web 模块边界共享数据,那么使用 Websphere Extension,共享会话上下文为 true,或使用 IBMApplicationSession API。 并不是将会话管理器属性指定为系统或 Web 容器定制属性,而是使用会话管理器定制属性。 |
按 SQL 查询的连接验证 | 使用 JDBC 4.0 所引入的基于超时的验证。 | |
类:
接口:SERV1\ws\code\admin.thinclient\src\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr.java 方法:在 RemoteCommandMgr 接口和 MBean XML 中的所有方法, SERV1\ws\code\admin.jmx\src\com\ibm\ws\management\ descriptor\xml\RemoteCommandMgr.xml 构造方法:RemoteCommandMgrImpl() |
不需要执行迁移操作。 | |
以下专有类用于表示和操作 Java API for XML Web Services (JAX-WS) 2.0 中的 WS-Addressing 端点引用:
|
改用以下类:
|
|
以下为 WebSphere 公共配置模型 (WCCM) 类型:
|
如果您的 Jython 脚本或 Jacl wsadmin 脚本之一使用了这些类型,请修改该脚本以使用正确的 AdminTask 命令来完成等价功能。例如:
|
|
环境 | IBM HTTP Server (IHS) mod_file_cache 模块 | 将您的 IHS 配置伪指令从 mod_file_cache 迁移至已提供的适当的高速缓存机制(mod_mem_cache 或 mod_cache)中。 |
IHS mod_ibm_ldap 模块 | 将您的 mod_ibm_ldap 配置伪指令迁移至等价的 mod_ldap 伪指令中。 | |
IHS mod_mime_magic 模块 | 移除任何与该模块相关的 IHS 配置伪指令。 | |
IHS mod_proxy_ftp 模块 | 移除任何与该模块相关的 IHS 配置伪指令。 | |
IHS mod_afpa_cache 模块 针对静态和动态生成的内容高速缓存,AIX 和 Windows 操作系统均不推荐使用 Adaptive Fast Path Architecture (AFPA)。 |
移除任何与该模块相关的 IHS 配置伪指令。 | |
安装和维护工具 | 支持使用 IBM Update Installer for WebSphere Software V6.x 以在 WebSphere Application Server V6.0.2.21+ 和 V6.1.0.x 上应用维护 | 使用 IBM Update
Installer for WebSphere Software
V7.0。 Update Installer V7.0 支持在 WebSphere Application Server V6.0.2.21+、V6.1.0.x 和 V7.0 上应用维护。 |
支持使用 IBM WebSphere Installation Factory V6.1 来为 WebSphere Application Server V6.1 创建安装包 | 使用 IBM WebSphere Installation Factory
V7.0。 WebSphere Installation Factory V7.0 支持为 WebSphere Application Server V6.1 和 V7.0 创建安装包。 |
|
J2EE 资源 | 以下功能:
|
使用符合 J2EE 连接器体系结构 1.5 规范的 JMS 提供程序。 |
数据访问 | disablePK54589 系统属性 | 将数据源定制属性配置为 isConnectionSharingBasedOnCurrentState。
如果您正在使用 disablePK54589=true,那么您可以用 isConnectionSharingBasedOnCurrentState=false 来替换它。 |
编程 | JavaServer Faces 窗口小部件库 (JWL) 随 WebSphere Application Server 提供 | 使用 Rational Application Developer 中的 JAR 来手动创建 JWL 的共享库。 |
概要文件管理 | Deployment Manager 概要文件模板 | 将管理概要文件模板用于 Deployment Manager 服务器。 |
安全性 | 支持使用简单且受保护的 GSS-API 协商机制信任关联拦截器 (SPNEGO TAI) 来安全地协商和认证对受保护资源发出的 HTTP 请求。 | 使用嵌入式 SPNEGO Web 认证,以提供动态重新装入 SPNEGO 过滤器的功能以及对应用程序登录方法启用回退。 |
服务器 | Apache Struts 1.1、1.2.4 和 1.2.7 作为可选库随 WebSphere Application Server 提供 | 如果您想继续使用 Apache Struts 的这些版本,那么可从 Apache Struts Web 站点上获取。 |
有关核心组传输,可以使用以下配置选项:
|
移动至通道框架传输。 有关更多信息,请参阅 核心组传输。 |
|
系统管理 | 用于安装 IBM Application Client for WebSphere Application Server 的 Pluggable Application Client 功能部件的选项 | 请改用新的“EJB 瘦应用程序客户机”功能部件。 |
以下服务集成总线 (SIBus) 安全性功能部件:
|
执行以下操作:
|
|
收集器工具(collector.bat 或 collector.sh)收集有关 WebSphere Application Server 安装的信息,并将其打包在 Java 归档
(JAR) 文件中,您可以将此文件发送给 IBM 软件支持 注: 此功能部件仍受推荐。
|
使用 IBM Support Assistant (ISA) Lite。 | |
基于协议的代理服务器模板 | 使用 ServerManagement 命令组中的管理控制台或 wsadmin 命令来选择代理服务器的一个或多个协议。 有关更多信息,请参阅 AdminTask 对象的 ServerManagement 命令组 |
|
WebSphere Touchpoint(WAS.admin.wstp 组件 - 所有类和方法) | 请使用 WebSphere Application Server 中的其他标准管理接口。 | |
AdminTask 对象的 SecureConversation 命令组中的命令 | 使用 WSSCacheManagement 命令组中的命令来管理 Web Service 安全性 (WS-Security) 分布式高速缓存配置。 | |
以下为虚拟成员管理器 (VMM) 联合存储库中的轻量级目录访问协议 (LDAP) 配置名称:
|
使用下列配置名称:
|
|
Web Service | 支持“2006/02”WS-Addressing Web 服务描述语言 (WSDL) 绑定名称空间 | 用“2006/05”名称空间的用法来替换 WSDL 文件中的“2006/02”名称空间的用法 |
Web Service 分布式管理 (WSDM) 接口 | 请使用 WebSphere Application Server 中的其他标准管理接口。 | |
用于 Java API for XML Web Services (JAX-WS) 或 Java API for XML-based RPC (JAX-RPC) 应用程序的 IBM 专有 SOAP over Java Message Service (JMS) 协议 | 使用标准的 SOAP over JMS 协议。 有关更多信息,请参阅SOAP over JMS 协议和SOAP over Java Message Service 。 限制: 如果客户机应用程序调用受比 V7.0 更早的 WebSphere Application Server 发行版支持的基于企业 Bean 的 Web Service,那么您必须继续使用 IBM 专有 SOAP over JMS 协议来访问这些 Web Service。
|
V6.1 中不推荐使用的功能部件
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.rsadapter.DataStoreHelperMetaData 类中的 setDatabaseDefaultIsolationLevel(int) 方法 | 开始改为使用以下方法:
|
“调解框架”运行时中的以下类和接口:
|
将使用的所有 com.ibm.websphere.sib.mediation.handler.SIMessageContextException 类替换为 com.ibm.websphere.sib.mediation.handler.MessageContextException 类。 将使用的所有 com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext 接口替换为一个等价接口。WebSphere Application Server 不提供此接口的实现。 |
|
对 HTTP 传输配置的支持 | 开始倾向于使用基于通道的传输。 | |
以下为 Web 容器消息 Bean 函数:
|
开始倾向于使用通道框架。 通道框架提供了 TransportChannelService 消息 Bean,该消息 Bean 更灵活,并且除当前 Web 容器传输相关的方法之外,此消息 Bean 还具有更多其他的方法。 |
|
对将容器管理的实体 Bean 部署至一般 SQL 数据库的支持 | 如果应用程序因必须与不同的关系数据库配合运行而使用了 SQL92 或 SQL99,请使用 IBM 工具来为该应用程序可能用到的每个数据库供应商或版本生成已部署的代码。在安装时,请指定将与 WebSphere Application Server 配合使用的数据库供应商或版本。 | |
下列类提供的 IBM
WebSphere Studio 工具运行时支持(用来利用 Visual Age for Java 工具):
|
重新设计应用程序以使用标准的 J2EE 编码约定。 | |
com.ibm.websphere.rsadapter.DataStoreHelper 类 API 中的 CUSTOM_HELPER 常量字段 | 如果创建了自己的 DataStoreHelper implementation 类,那么不要调用 setHelperType(DataStoreHelper.CUSTOM_HELPER)。改为由它继承的实现 类来设置 HelperType 值。 | |
J2EE 资源 | WebSphere Application Server V5 中支持从应用程序服务器或 J2EE 应用程序客户机连接到嵌入式消息传递功能部件的 JMS 服务器组件 不推荐使用的功能包括以下方面:
|
执行以下操作:
|
系统管理 | 定制对话,它是一组交互式系统生产率设施 (ISPF) 面板,用来为配置和迁移 WebSphere Application Server for z/OS 环境创建作业和指示信息 | 使用 Profile Management Tool(仅限 z/OS )或 zpmt 命令来生成用于创建概要文件的作业和指示信息。
使用 z/OS 迁移管理工具来生成迁移定义。有关使用 z/OS 迁移管理工具的信息,请参阅文档中的“使用 z/OS 迁移管理工具来创建和管理迁移定义”一文。 |
clientUpgrade 命令 | 不需要执行迁移操作。 | |
Cloudscape 数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) 和 Cloudscape 网络服务器数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) 以及它们在 DataStoreHelper 的类型 | 对于现有配置,不需要执行迁移操作。迁移实用程序会将不推荐使用的 Cloudscape 帮助程序更改为 Derby 帮助程序。 对于新配置,请使用 Derby 数据存储帮助程序,而不使用 Cloudscape 数据存储帮助程序。 有关更多信息,请参阅 按供应商排序的数据源最小必需设置。 |
|
DB2® 旧的基于 CLI 的 2 类 JDBC 驱动程序提供程序 | 使用 DB2 通用 JDBC 驱动程序提供程序来启动。 | |
逻辑池分配支持 (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) | 不需要执行迁移操作。 但是,在移除此功能之后,将忽略为它指定的所有定制对象请求代理 (ORB) 属性。有意义的定制 ORB 属性是 com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*。 有关更多信息,请参阅 对象请求代理定制属性。 |
|
server.xml 文件中作为 Server 对象的一部分的 ORB 线程池配置 | 使用 serverindex.xml 文件中作为 ServerIndex 对象的一部分的线程池配置。 | |
指定事务类映射文件名的 protocol_http_transport_class_mapping_file 配置变量 | 使用 wlm_classification_file 配置变量来指定将 HTTP 请求映射至 WLM 事务类的 XML 文件的名称。 不推荐使用的映射文件支持每行指定多个事务类。这就会产生人为的循环工作分派结果。尽管 wlm_classification_file 所指向的 XML 文件不支持每一行指定多个事务类,但是,通过使用 zWLM 的循环选项可以更好地获得此相同结果。可通过指定 wlm_stateful_session_placement_on=1 来选择此选项。 |
|
下列配置变量:
![]() |
使用 TCP 传输通道 listenBacklog 定制属性。 有关使用此属性的信息,请参阅 TCP 传输通道定制属性 |
|
protocol_https_cert_mapping_file 环境变量指定的 SSL 证书映射文件 还不推荐使用下列相关配置变量:
|
此时不需要执行迁移操作。 在 WebSphere Application Server for z/OS 的后续版本中,将提供一种新的配置机制,该机制将允许您根据用于套接字连接的服务器 IP 地址来选择另一个 SSL 服务器证书以用于 SSL 握手。此新的管理机制将替换由 protocol_http_cert_mapping_file 变量指向的文件的当前文件格式。 |
|
JVM 系统属性 com.ibm.websphere.sendredirect.compatibility | 开始修改应用程序以重定向非相对 URL(以正斜杠“/”开头的那些 URL),这些 URL 相对于 servlet 容器根 (web_server_root),而不是相对于 Web 应用程序上下文根。 有关 sendRedirect 应表现为何种行为的信息,请参阅 Java Servlet 2.4 规范,可从 http://jcp.org/aboutJava/communityprocess/final/jsr154/ 下载此规范。 |
|
Web 容器 PageList Servlet 定制扩展,包括下列类:
|
重新设计应用程序以使用 javax.Servlet.filter 类而不使用 com.ibm.Servlet 类。 从 Java Servlet 2.3 规范开始,javax.Servlet.filter 类向您提供拦截请求和检验响应的功能。它们还允许提供链接功能以及修饰或截断响应的功能。 |
|
以下数据源的定制属性:
|
目前,产品将这些属性作为预先配置的选项提供,这些选项是以下列表中的替换属性。要避免运行时错误消息,可以通过从定制属性列表中删除原始定制属性来将它们永久地禁用。
注: 如果新属性和旧属性同时存在,那么将优先使用新属性。
|
|
系统管理 | 对等重新启动和恢复 (PRR) | 对于事务恢复,从使用 PRR 功能迁移至使用高可用性管理器功能。 有关配置高可用性管理器以执行事务恢复的信息,请参阅 事务高可用性。 |
安全性 | 简单 WebSphere 认证机制 (SWAM) | 使用轻量级第三方认证 (LTPA) 机制。 有关更多信息,请参阅 轻量级第三方认证。 |
LoginHelper CORBA 认证助手功能 (com.ibm.ws.security.util.LoginHelper) | 迁移至 Java 认证和授权服务 (JAAS) 编程模型。有关此迁移信息,请参阅 将公共对象请求代理体系结构程序化登录迁移到 Java 认证和授权服务(CORBA 和 JAAS)。 | |
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor 信任关联拦截器 (TAI) 接口 提供了实现 WebSphere Application Server TAI 接口的 Tivoli TAI 拦截器以支持 WebSEAL V4.1。 |
如果打算使用 WebSEAL 5.1 或更高版本,那么您应该迁移以使用 com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus 拦截器。 | |
对除了守护程序之外的所有服务器类型的 z/OS 系统 SSL 支持 | 开始将现有的使用 z/OS 系统 SSL 安全性设置的 wsadmin 脚本转换为使用 JSSE 安全性设置的脚本。 | |
性能 | 不推荐使用对 Java 虚拟机概要分析程序接口 (JVMPI) 以及下面相关的 Java 虚拟机运行时计数器的支持:
|
开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
对 Java 虚拟机调试器接口 (JVMDI) 的支持 | 开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
|
问题确定 | WebSphere Application Server V6.0.x 和更低版本中使用的消息标识格式 日志文件的消息前缀先前未向主消息注册表注册。WebSphere Application Server V6.1.x 和更高版本在输出日志中使用兼容的消息前缀。 |
使用 convertlog 命令和 MessageConverter 类来帮助您迁移依赖于较旧的消息格式的工具。 有关更多信息,请参阅 将日志文件转换为使用 IBM 独有的消息标识。 |
com.ibm.etools.logging.util 插件,即 logutil.jar 文件
|
开始将使用 com.ibm.etools.logging.util 插件中的配置文件、类、方法或变量的插件和应用程序代码迁移至下列替代项:
|
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.rsadapter.DataStoreHelperMetaData 类中的 setDatabaseDefaultIsolationLevel(int) 方法 | 开始改为使用以下方法:
|
“调解框架”运行时中的以下类和接口:
|
将使用的所有 com.ibm.websphere.sib.mediation.handler.SIMessageContextException 类替换为 com.ibm.websphere.sib.mediation.handler.MessageContextException 类。 将使用的所有 com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext 接口替换为一个等价接口。WebSphere Application Server 不提供此接口的实现。 |
|
以下为 Web 容器消息 Bean 函数:
|
开始倾向于使用通道框架。 通道框架提供了 TransportChannelService 消息 Bean,该消息 Bean 更灵活,并且除当前 Web 容器传输相关的方法之外,此消息 Bean 还具有更多其他的方法。 |
|
对将容器管理的实体 Bean 部署至一般 SQL 数据库的支持 | 如果应用程序因必须与不同的关系数据库配合运行而使用了 SQL92 或 SQL99,请使用 IBM 工具来为该应用程序可能用到的每个数据库供应商或版本生成已部署的代码。在安装时,请指定将与 WebSphere Application Server 配合使用的数据库供应商或版本。 | |
下列类提供的 IBM
WebSphere Studio 工具运行时支持(用来利用 Visual Age for Java 工具):
|
重新设计应用程序以使用标准的 J2EE 编码约定。 | |
com.ibm.websphere.rsadapter.DataStoreHelper 类 API 中的 CUSTOM_HELPER 常量字段 | 如果创建了自己的 DataStoreHelper implementation 类,那么不要调用 setHelperType(DataStoreHelper.CUSTOM_HELPER)。改为由它继承的实现 类来设置 HelperType 值。 | |
J2EE 资源 | WebSphere Application Server V5 中支持从应用程序服务器或 J2EE 应用程序客户机连接到嵌入式消息传递功能部件的 JMS 服务器组件 不推荐使用的功能包括以下方面:
|
执行以下操作:
|
系统管理 | setup 命令 | 使用 install 命令。 |
clientUpgrade 命令 | 不需要执行迁移操作。 | |
wasprofile 命令 | 使用 manageprofiles 命令。 有关更多信息,请参阅 manageprofiles 命令。 |
|
下列 WASPostUpgrade 命令参数:
|
不需要执行迁移操作。 | |
Cloudscape 数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) 和 Cloudscape 网络服务器数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) 以及它们在 DataStoreHelper 的类型 | 对于现有配置,不需要执行迁移操作。迁移实用程序会将不推荐使用的 Cloudscape 帮助程序更改为 Derby 帮助程序。 对于新配置,请使用 Derby 数据存储帮助程序,而不使用 Cloudscape 数据存储帮助程序。 有关更多信息,请参阅 按供应商排序的数据源最小必需设置。 |
|
DB2 旧的基于 CLI 的 2 类 JDBC 驱动程序提供程序 | 使用 DB2 通用 JDBC 驱动程序提供程序来启动。 | |
逻辑池分配支持 (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) | 不需要执行迁移操作。 但是,在移除此功能之后,将忽略为它指定的所有定制对象请求代理 (ORB) 属性。有意义的定制 ORB 属性是 com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*。 有关更多信息,请参阅 逻辑池分布 和 对象请求代理定制属性。 |
|
server.xml 文件中作为 Server 对象的一部分的 ORB 线程池配置 | 使用 serverindex.xml 文件中作为 ServerIndex 对象的一部分的线程池配置。 | |
JVM 系统属性 com.ibm.websphere.sendredirect.compatibility | 开始修改应用程序以重定向非相对 URL(以正斜杠“/”开头的那些 URL),这些 URL 相对于 servlet 容器根 (web_server_root),而不是相对于 Web 应用程序上下文根。 有关 sendRedirect 应表现为何种行为的信息,请参阅 Java Servlet 2.4 规范,可从 http://jcp.org/aboutJava/communityprocess/final/jsr154/ 下载此规范。 |
|
Web 容器 PageList Servlet 定制扩展,包括下列类:
|
重新设计应用程序以使用 javax.Servlet.filter 类而不使用 com.ibm.Servlet 类。 从 Java Servlet 2.3 规范开始,javax.Servlet.filter 类向您提供拦截请求和检验响应的功能。它们还允许提供链接功能以及修饰或截断响应的功能。 |
|
以下数据源的定制属性:
|
目前,产品将这些属性作为预先配置的选项提供,这些选项是以下列表中的替换属性。要避免运行时错误消息,可以通过从定制属性列表中删除原始定制属性来将它们永久地禁用。
注: 如果新属性和旧属性同时存在,那么将优先使用新属性。
|
|
DISABLE_FILE_LOCKING 事务服务定制属性 | 清除管理控制台的事务服务面板上的启用文件锁定复选框。 有关更多信息,请参阅 禁用文件锁定。 |
|
简单 WebSphere 认证机制 (SWAM) | 使用轻量级第三方认证 (LTPA) 机制。 有关更多信息,请参阅 轻量级第三方认证。 |
|
安全性 | LoginHelper CORBA 认证助手功能 (com.ibm.ws.security.util.LoginHelper) | 迁移至 Java 认证和授权服务 (JAAS) 编程模型。有关此迁移信息,请参阅 将公共对象请求代理体系结构程序化登录迁移到 Java 认证和授权服务(CORBA 和 JAAS)。 |
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor 信任关联拦截器 (TAI) 接口 提供了实现 WebSphere Application Server TAI 接口的 Tivoli TAI 拦截器以支持 WebSEAL V4.1。 |
如果打算使用 WebSEAL 5.1 或更高版本,那么您应该迁移以使用 com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus 拦截器。 | |
不推荐使用对 Java 虚拟机概要分析程序接口 (JVMPI) 以及下面相关的 Java 虚拟机运行时计数器的支持:
|
开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
|
性能 | 对 Java 虚拟机调试器接口 (JVMDI) 的支持 | 开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
WebSphere Application Server V6.0.x 和更低版本中使用的消息标识格式 日志文件的消息前缀先前未向主消息注册表注册。WebSphere Application Server V6.1.x 和更高版本在输出日志中使用兼容的消息前缀。 |
使用 convertlog 命令和 MessageConverter 类来帮助您迁移依赖于较旧的消息格式的工具。 有关更多信息,请参阅 将日志文件转换为使用 IBM 独有的消息标识。 |
|
问题确定 | com.ibm.etools.logging.util 插件,即 logutil.jar 文件
|
开始将使用 com.ibm.etools.logging.util 插件中的配置文件、类、方法或变量的插件和应用程序代码迁移至下列替代项:
|
![[IBM i]](../images/iseries.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.rsadapter.DataStoreHelperMetaData 类中的 setDatabaseDefaultIsolationLevel(int) 方法 | 开始改为使用以下方法:
|
“调解框架”运行时中的以下类和接口:
|
将使用的所有 com.ibm.websphere.sib.mediation.handler.SIMessageContextException 类替换为 com.ibm.websphere.sib.mediation.handler.MessageContextException 类。 将使用的所有 com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext 接口替换为一个等价接口。WebSphere Application Server 不提供此接口的实现。 |
|
以下为 Web 容器消息 Bean 函数:
|
开始倾向于使用通道框架。 通道框架提供了 TransportChannelService 消息 Bean,该消息 Bean 更灵活,并且除当前 Web 容器传输相关的方法之外,此消息 Bean 还具有更多其他的方法。 |
|
对将容器管理的实体 Bean 部署至一般 SQL 数据库的支持 | 如果应用程序因必须与不同的关系数据库配合运行而使用了 SQL92 或 SQL99,请使用 IBM 工具来为该应用程序可能用到的每个数据库供应商或版本生成已部署的代码。在安装时,请指定将与 WebSphere Application Server 配合使用的数据库供应商或版本。 | |
下列类提供的 IBM
WebSphere Studio 工具运行时支持(用来利用 Visual Age for Java 工具):
|
重新设计应用程序以使用标准的 J2EE 编码约定。 | |
com.ibm.websphere.rsadapter.DataStoreHelper 类 API 中的 CUSTOM_HELPER 常量字段 | 如果创建了自己的 DataStoreHelper implementation 类,那么不要调用 setHelperType(DataStoreHelper.CUSTOM_HELPER)。改为由它继承的实现 类来设置 HelperType 值。 | |
J2EE 资源 | WebSphere Application Server V5 中支持从应用程序服务器或 J2EE 应用程序客户机连接到嵌入式消息传递功能部件的 JMS 服务器组件 此不推荐使用包括下列方面:
|
执行以下操作:
|
系统管理 | clientUpgrade 命令 | 不需要执行迁移操作。 |
wasprofile 命令 | 使用 manageprofiles 命令。 有关更多信息,请参阅 manageprofiles 命令。 |
|
下列 WASPostUpgrade 命令参数:
|
不需要执行迁移操作。 | |
Cloudscape 数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) 和 Cloudscape 网络服务器数据存储帮助程序 (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) 以及它们在 DataStoreHelper 的类型 | 对于现有配置,不需要执行迁移操作。迁移实用程序会将不推荐使用的 Cloudscape 帮助程序更改为 Derby 帮助程序。 对于新配置,请使用 Derby 数据存储帮助程序,而不使用 Cloudscape 数据存储帮助程序。 有关更多信息,请参阅 按供应商排序的数据源最小必需设置。 |
|
DB2 旧的基于 CLI 的 2 类 JDBC 驱动程序提供程序 | 使用 DB2 通用 JDBC 驱动程序提供程序来启动。 | |
逻辑池分配支持 (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) | 不需要执行迁移操作。 但是,在移除此功能之后,将忽略为它指定的所有定制对象请求代理 (ORB) 属性。有意义的定制 ORB 属性是 com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*。 有关更多信息,请参阅 逻辑池分布 和 对象请求代理定制属性。 |
|
server.xml 文件中作为 Server 对象的一部分的 ORB 线程池配置 | 使用 serverindex.xml 文件中作为 ServerIndex 对象的一部分的线程池配置。 | |
JVM 系统属性 com.ibm.websphere.sendredirect.compatibility | 开始修改应用程序以重定向非相对 URL(以正斜杠“/”开头的那些 URL),这些 URL 相对于 servlet 容器根 (web_server_root),而不是相对于 Web 应用程序上下文根。 有关 sendRedirect 应表现为何种行为的信息,请参阅 Java Servlet 2.4 规范,可从 http://jcp.org/aboutJava/communityprocess/final/jsr154/ 下载此规范。 |
|
Web 容器 PageList Servlet 定制扩展,包括下列类:
|
重新设计应用程序以使用 javax.Servlet.filter 类而不使用 com.ibm.Servlet 类。 从 Java Servlet 2.3 规范开始,javax.Servlet.filter 类向您提供拦截请求和检验响应的功能。它们还允许提供链接功能以及修饰或截断响应的功能。 |
|
以下数据源的定制属性:
|
目前,产品将这些属性作为预先配置的选项提供,这些选项是以下列表中的替换属性。要避免运行时错误消息,可以通过从定制属性列表中删除原始定制属性来将它们永久地禁用。
注: 如果新属性和旧属性同时存在,那么将优先使用新属性。
|
|
DISABLE_FILE_LOCKING 事务服务定制属性 | 清除管理控制台的事务服务面板上的启用文件锁定复选框。 有关更多信息,请参阅 禁用文件锁定。 |
|
简单 WebSphere 认证机制 (SWAM) | 使用轻量级第三方认证 (LTPA) 机制。 有关更多信息,请参阅 轻量级第三方认证。 |
|
安全性 | LoginHelper CORBA 认证助手功能 (com.ibm.ws.security.util.LoginHelper) | 迁移至 Java 认证和授权服务 (JAAS) 编程模型。有关此迁移信息,请参阅 将公共对象请求代理体系结构程序化登录迁移到 Java 认证和授权服务(CORBA 和 JAAS)。 |
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor 信任关联拦截器 (TAI) 接口 提供了实现 WebSphere Application Server TAI 接口的 Tivoli TAI 拦截器以支持 WebSEAL V4.1。 |
如果打算使用 WebSEAL 5.1 或更高版本,那么您应该迁移以使用 com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus 拦截器。 | |
不推荐使用对 Java 虚拟机概要分析程序接口 (JVMPI) 以及下面相关的 Java 虚拟机运行时计数器的支持:
|
开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
|
性能 | 对 Java 虚拟机调试器接口 (JVMDI) 的支持 | 开始倾向于使用 Java 虚拟机工具接口 (JVMTI)。 有关更多信息,请参阅 JVM 工具接口 (JVMTI)。 |
WebSphere Application Server V6.0.x 和更低版本中使用的消息标识格式 日志文件的消息前缀先前未向主消息注册表注册。WebSphere Application Server V6.1.x 和更高版本在输出日志中使用兼容的消息前缀。 |
使用 convertlog 命令和 MessageConverter 类来帮助您迁移依赖于较旧的消息格式的工具。 有关更多信息,请参阅 将日志文件转换为使用 IBM 独有的消息标识。 |
|
问题确定 | com.ibm.etools.logging.util 插件,即 logutil.jar 文件
|
开始将使用 com.ibm.etools.logging.util 插件中的配置文件、类、方法或变量的插件和应用程序代码迁移至下列替代项:
|
V6.0.2 中不推荐使用的功能部件
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.runtime.ServerName 类中的下列方法:
|
这些方法仅用于 WebSphere Application Server 运行时。 应用程序不应调用这些方法。 |
对 HTTP 传输配置的支持 | 开始倾向于使用基于通道的传输。 | |
性能 | com.ibm.websphere.cache.DistributedLockingMap 接口 | 请不要使用 com.ibm.websphere.cache.DistributedLockingMap 接口,因为此接口不受 WebSphere Application Server 运行时支持。 |
在 com.ibm.websphere.cache.DistributedObjectCache 类中定义的 TYPE_DISTRIBUTED_LOCKING_MAP 常量 | 请不要使用在 com.ibm.websphere.cache.DistributedObjectCache 类中定义的 TYPE_DISTRIBUTED_LOCKING_MAP 常量,因为此常量不受 WebSphere Application Server 运行时支持。 | |
系统管理 | 以下数据源的定制属性:
|
用以下内容替换属性:
注: 如果新属性和旧属性同时存在,那么将优先使用新属性。
|
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型 | com.ibm.websphere.runtime.ServerName 类中的下列方法:
|
这些方法仅用于 WebSphere Application Server 运行时。 应用程序不应调用这些方法。 |
性能 | com.ibm.websphere.cache.DistributedLockingMap 接口 | 请不要使用 com.ibm.websphere.cache.DistributedLockingMap 接口,因为此接口不受 WebSphere Application Server 运行时支持。 |
在 com.ibm.websphere.cache.DistributedObjectCache 类中定义的 TYPE_DISTRIBUTED_LOCKING_MAP 常量 | 请不要使用在 com.ibm.websphere.cache.DistributedObjectCache 类中定义的 TYPE_DISTRIBUTED_LOCKING_MAP 常量,因为此常量不受 WebSphere Application Server 运行时支持。 | |
系统管理 | 以下数据源的定制属性:
|
用以下内容替换属性:
注: 如果新属性和旧属性同时存在,那么将优先使用新属性。
|
![[z/OS]](../images/ngzos.gif)
V6.0.1 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
安全性 | z/OS 安全认证服务 (z/SAS) IIOP 安全协议 | 使用公共安全互操作性 V2 (CSIv2) 协议。 |
V6.0 中不推荐使用的功能部件
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器支持 | JavaServer Pages (JSP) 引擎中对下列 tsx 标记的支持:
|
在不使用 tsx 标记的情况下,应该使用来自 JavaServer Pages 标准标记库 (JSTL) 的等价标记。JSTL 在 WebSphere Application Server V6.0 中受支持,并且标记库随产品一起提供。使用此表作为将 tsx 标记转换为 JSTL 标记的指南:
|
下列后端标识:
|
使用其他后端标识。 | |
应用程序服务 | JRas 扩展 API 不打算进一步增强对 JRas 的支持。 |
使用 java.util.logging 软件包 (JSR47) 中的等价功能。 |
统一描述、发现和集成协议 (UDDI) V2 EJB 到 UDDI 注册中心的接口 | 没有接口可以用来替代 EJB 接口。为了与 V5.x 保持兼容,WebSphere Application Server V6.0 中也包含此接口。用户不需要执行任何特定操作,就可以继续使用 V2 EJB API;但是应该知道该 API 并不包含 UDDI V3 新增的任何 UDDI 功能,并且在后续的 WebSphere Application Server 发行版中可能会移除该接口。 | |
UDDI4J V2 类库,即 uddi4jv2.jar 文件 | 开始使用 V3 UDDI API。提供了客户机库来简化从 Java 构造和发送 UDDI V3 请求。 这是 uddiv3client.jar 中提供的用于 Java 的 IBM UDDI V3 客户机。 虽然仍然可以使用 UDDI4J API,但是请注意它们不提供对新增的任何 UDDI V3 功能的访问,并且在后续的 WebSphere Application Server 发行版中可能会移除它们。 | |
所有低级 UDDI 实用程序工具 (UUT) API,例如 BusinessStub 和 ServiceStub 等等, 这些 API 全部被替换为 com.ibm.uddi.promoter 程序包中的高级 PromoterAPI 接口。 |
开始使用 com.ibm.uddi.promoter 程序包中的 PromoterAPI 接口来代替这些低级 API,这些 API 在后续的 WebSphere Application Server 发行版中会被移除。PromoterAPI 在更高的抽象级别上提供相同的功能。 | |
J2EE 连接器体系结构运行时中的下列方法:
|
这些方法被替换为如下所示:
对于容器管理的认证别名,在应用程序的资源绑定信息中指定容器管理的凭证。 |
|
管理控制台的“工作管理器”面板上的 ApplicationProfile 属性 | 请参阅 应用程序概要分析 部分中的文章,以了解有关 V5.x 和 V6.0.x 中应用程序概要分析之间的差别。 |
|
以下项来自管理控制台的“数据源”面板:
|
定义资源引用中的 DefaultPrincipleMapping 属性。 | |
com.ibm.websphere.Servlet.filter 程序包中的所有类包含以下内容:
|
重新设计应用程序以使用 javax.Servlet.filter 类而不使用 com.ibm.websphere.Servlet.filter 类。从 Servlet 2.3 规范开始,javax.Servlet.filter 类向您提供拦截请求和检验响应的功能。它们还允许您实现链接功能,以及修饰和截断响应。 | |
应用程序服务 | 多用途因特网邮件扩展 (MIME) 过滤 最初在 WebSphere Application Server V3.5 中引入 MIME 过滤器以根据输出内容的 MIME 类型,作为 servlet 修饰、截断和修改其他 servlet 生成的响应的方法。 |
Servlet 2.3 规范中引入的 javax.servlet.filters 允许用户插入过滤器,这些过滤器可以拦截到 servlet 的请求以及从 servlet 发出的响应。它们还可以修改任一方向的内容流。 javax.servlet.filters 维护 MIME 过滤器的所有功能。javax.servlet.filters 是标准 API,并且受所有兼容的应用程序服务器支持。 请参阅 Servlet 2.3 规范或Servlet 过滤,以了解更多信息。 |
使用方法级别访问意向配置的容器管理的持久性 (CMP) 实体 Bean 可能会遇到数据访问问题(例如,死锁)。因此,不推荐使用方法级别的访问意向。 | 将 CMP 实体 Bean 重新配置为使用 Bean 级别的访问意向,或者使用 WebSphere Application Server Toolkit 来重新配置应用程序概要文件。 | |
com.ibm.websphere.product.product 和 com.ibm.websphere.product.buildInfo 类中的所有方法和字段。 因此,不推荐使用 com.ibm.websphere.product.WASProduct 类(它涉及 com.ibm.websphere.product.product 和 com.ibm.websphere.product.buildInfo 对象)中的下列方法:
|
使用 com.ibm.websphere.product.WASDirectory 的下列受支持的方法:
另外,您现在应该使用 WASDirectory 类的下列方法来获取产品信息(名称、版本、构建级别、构建日期),而不是从旧的 WASProduct API (com.ibm.websphere.product.WASProduct) 中获取它们。
|
|
WebSphere Application Server 在 databeans.jar 文件中包含的数据访问 bean | 您应该使用服务数据对象 (SDO) 而不是数据访问 bean。 | |
IBM 部署描述符扩展(包括 WAR 文件扩展 (WEB-INF/ibm-web-ext.xmi) 和应用程序扩展 (META-INF/ibm-application-ext.xmi))的 reloadInterval 和 reloadingEnabled 属性。 | 您应该使用在进行应用程序部署期间提供的重新装入启用和时间间隔选项,而不使用部署描述符扩展。 请参阅 企业应用程序设置 以了解更多详细信息。 |
|
com.ibm.websphere.Servlet.session.UserTransactionWrapper API | 没有 API 可以用来替代此 API。无须使用包装器就可以直接将 UserTransaction 对象放入 HTTP 会话中。 | |
安全性 | 基于 Apache SOAP 实现的 SOAP 安全性(XML 数字签名) | 您应该将应用程序迁移至 Web Service 的 JSR-109 实现,而不是使用 SOAP 安全性。另外,迁移(重新配置应用程序)以使用 WSS(Web Service 安全性)1.0 实现。 |
Web Service 安全性 (WSS) 草稿 13 规范级别的支持 | 应用程序应该迁移至受支持的 WSS 1.0 标准。当消息级别在草稿和 WSS 1.0 实现之间更改时,该草稿级别的支持不提供与某些第三方供应商的互操作性。 仅 J2EE 1.4 应用程序中支持 WSS 1.0。因此,首先需要将应用程序迁移至 J2EE 1.4。下一步将是使用 Application Server Toolkit 或 Rational Application Developer 工具来为迁移的应用程序重新配置 WSS。在此 Application Server Toolkit 发行版或 Rational Application Developer 工具 V6.0 中不提供 WSS 的自动迁移;必须手动执行迁移。 还不推荐使用以下 SPI:
com.ibm.wsspi.wssecurity.config.KeyLocator 需要将实现迁移至 V6.0 中 WSS 1.0 支持的新 SPI:com.ibm.wsspi.wssecurity.keyinfo.KeyLocator 最后,Java 认证和授权服务 (JAAS) LoginModule 实现需要迁移至 V6.0 中的 JAAS LoginModule 的新编程模型。 |
|
系统管理 | 在单元范围下配置资源 | 而是应该在集群范围下配置资源。在前发行版中,您将单元范围资源配置为允许集群成员共享资源配置定义。在 V6 中,不推荐使用单元范围资源配置,这是因为单元范围资源对于单元中的每个节点是可视的,即使并不是单元中的每个节点都能够支持资源也是如此。 |
AdminApp 脚本编制对象中的安装命令的 depl.extension.reg 和 installdir 选项 | 没有可以用来替代 depl.extension.reg 选项的选项。在 V5.x 中,此选项是空操作。对于 installdir 选项,改为使用 installed.ear.destination 选项。 | |
性能 | V4.0 中引入的用来以编程方式从 WebSphere Application Server 中收集性能数据的 PMI 客户机 API | 建议使用 Java 管理扩展 (JMX) 接口(它是 J2EE 规范的一部分)来收集 WebSphere Application Server 性能数据。可以从 J2EE 管理的对象消息 Bean 或从 WebSphere PMI Perf 消息 Bean 收集 PMI 数据。当 J2EE 消息 Bean 提供有关特定组件的性能数据时,Perf 消息 Bean 充当到 WebSphere Application Server PMI 服务的网关,并且提供对所有组件的性能数据的访问权限。 |
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器支持 | JavaServer Pages (JSP) 引擎中对下列 tsx 标记的支持:
|
在不使用 tsx 标记的情况下,应该使用来自 JavaServer Pages 标准标记库 (JSTL) 的等价标记。JSTL 在 WebSphere Application Server V6.0 中受支持,并且标记库随产品一起提供。使用此表作为将 tsx 标记转换为 JSTL 标记的指南:
|
下列后端标识:
|
使用其他后端标识。 | |
应用程序服务 | JRas 扩展 API 不打算进一步增强对 JRas 的支持。 |
使用 java.util.logging 软件包 (JSR47) 中的等价功能。 |
统一描述、发现和集成协议 (UDDI) V2 EJB 到 UDDI 注册中心的接口 | 没有接口可以用来替代 EJB 接口。为了与 V5.x 保持兼容,WebSphere Application Server V6.0 中也包含此接口。用户不需要执行任何特定操作,就可以继续使用 V2 EJB API;但是应该知道该 API 并不包含 UDDI V3 新增的任何 UDDI 功能,并且在后续的 WebSphere Application Server 发行版中可能会移除该接口。 | |
UDDI4J V2 类库,即 uddi4jv2.jar 文件 | 开始使用 V3 UDDI API。提供了客户机库来简化从 Java 构造和发送 UDDI V3 请求。 这是 uddiv3client.jar 中提供的用于 Java 的 IBM UDDI V3 客户机。 虽然仍然可以使用 UDDI4J API,但是请注意它们不提供对新增的任何 UDDI V3 功能的访问,并且在后续的 WebSphere Application Server 发行版中可能会移除它们。 | |
所有低级 UDDI 实用程序工具 (UUT) API,例如 BusinessStub 和 ServiceStub 等等, 这些 API 全部被替换为 com.ibm.uddi.promoter 程序包中的高级 PromoterAPI 接口。 |
开始使用 com.ibm.uddi.promoter 程序包中的 PromoterAPI 接口来代替这些低级 API,这些 API 在后续的 WebSphere Application Server 发行版中会被移除。PromoterAPI 在更高的抽象级别上提供相同的功能。 | |
J2EE 连接器体系结构运行时中的下列方法:
|
这些方法被替换为如下所示:
对于容器管理的认证别名,在应用程序的资源绑定信息中指定容器管理的凭证。 |
|
管理控制台的“工作管理器”面板上的 ApplicationProfile 属性 | 请参阅 应用程序概要分析 部分中的文章,以了解有关 V5.x 和 V6.0.x 中应用程序概要分析之间的差别。 |
|
以下项来自管理控制台的“数据源”面板:
|
定义资源引用中的 DefaultPrincipleMapping 属性。 | |
com.ibm.websphere.Servlet.filter 程序包中的所有类包含以下内容:
|
重新设计应用程序以使用 javax.Servlet.filter 类而不使用 com.ibm.websphere.Servlet.filter 类。从 Servlet 2.3 规范开始,javax.Servlet.filter 类向您提供拦截请求和检验响应的功能。它们还允许您实现链接功能,以及修饰和截断响应。 | |
应用程序服务 | 多用途因特网邮件扩展 (MIME) 过滤 最初在 WebSphere Application Server V3.5 中支持 MIME 过滤器以根据输出内容的 MIME 类型,作为 servlet 修饰、截断和修改其他 servlet 生成的响应的方法。 |
Servlet 2.3 规范中引入的 javax.servlet.filters 允许用户插入过滤器,这些过滤器可以拦截到 servlet 的请求以及从 servlet 发出的响应。它们还可以修改任一方向的内容流。 javax.servlet.filters 维护 MIME 过滤器的所有功能。javax.servlet.filters 是标准 API,并且受所有兼容的应用程序服务器支持。 请参阅 Servlet 2.3 规范或Servlet 过滤,以了解更多信息。 |
使用方法级别访问意向配置的容器管理的持久性 (CMP) 实体 Bean 可能会遇到数据访问问题(例如,死锁)。因此,不推荐使用方法级别的访问意向。 | 将 CMP 实体 Bean 重新配置为使用 Bean 级别的访问意向,或者使用 WebSphere Application Server Toolkit 来重新配置应用程序概要文件。 | |
com.ibm.websphere.product.product 和 com.ibm.websphere.product.buildInfo 类中的所有方法和字段 因此,不推荐使用 com.ibm.websphere.product.WASProduct 类(它涉及 com.ibm.websphere.product.product 和 com.ibm.websphere.product.buildInfo 对象)中的下列方法:
|
使用 com.ibm.websphere.product.WASDirectory 的下列受支持的方法:
另外,您现在应该使用 WASDirectory 类的下列方法来获取产品信息(名称、版本、构建级别、构建日期),而不是从旧的 WASProduct API (com.ibm.websphere.product.WASProduct) 中获取它们。
|
|
WebSphere Application Server 在 databeans.jar 文件中包含的数据访问 bean | 您应该使用服务数据对象 (SDO) 而不使用数据访问 Bean。 请参阅 Service Data Objects 以了解更多详细信息。 |
|
IBM 部署描述符扩展(包括 WAR 文件扩展 (WEB-INF/ibm-web-ext.xmi) 和应用程序扩展 (META-INF/ibm-application-ext.xmi))的 reloadInterval 和 reloadingEnabled 属性。 | 您应该使用在进行应用程序部署期间提供的重新装入启用和时间间隔选项,而不使用部署描述符扩展。 请参阅 企业应用程序设置 以了解更多详细信息。 |
|
com.ibm.websphere.Servlet.session.UserTransactionWrapper API | 没有 API 可以用来替代此 API。无须使用包装器就可以直接将 UserTransaction 对象放入 HTTP 会话中。 | |
安全性 | 基于 Apache SOAP 实现的 SOAP 安全性(XML 数字签名) | 您应该将应用程序迁移至 Web Service 的 JSR-109 实现,而不是使用 SOAP 安全性。另外,迁移(重新配置应用程序)以使用 WSS(Web Service 安全性)1.0 实现。 |
Web Service 安全性 (WSS) 草稿 13 规范级别的支持 | 应用程序应该迁移至受支持的 WSS 1.0 标准。当消息级别在草稿和 WSS 1.0 实现之间更改时,该草稿级别的支持不提供与某些第三方供应商的互操作性。 仅 J2EE 1.4 应用程序中支持 WSS 1.0。因此,首先需要将应用程序迁移至 J2EE 1.4。下一步将是使用 Application Server Toolkit 或 Rational Application Developer 工具来为迁移的应用程序重新配置 WSS。在此 Application Server Toolkit 发行版或 Rational Application Developer 工具 V6.0 中不提供 WSS 的自动迁移;必须手动执行迁移。 还不推荐使用以下 SPI:
com.ibm.wsspi.wssecurity.config.KeyLocator 需要将实现迁移至 V6.0 中 WSS 1.0 支持的新 SPI:com.ibm.wsspi.wssecurity.keyinfo.KeyLocator 最后,Java 认证和授权服务 (JAAS) LoginModule 实现需要迁移至 V6.0 中的 JAAS LoginModule 的新编程模型。 |
|
安全认证服务 (SAS) IIOP 安全协议 | 使用公共安全互操作性 V2 (CSIv2) 协议。 | |
安全认证服务 (SAS) CORBA 安全性编程 API | 从 SAS 编程 API 迁移至 Java 认证和授权服务 (JAAS)。有关此迁移信息,请参阅 将公共对象请求代理体系结构程序化登录迁移到 Java 认证和授权服务(CORBA 和 JAAS)。 | |
系统管理 | 在单元范围下配置资源 | 而是应该在集群范围下配置资源。在前发行版中,您将单元范围资源配置为允许集群成员共享资源配置定义。在 V6 中,不推荐使用单元范围资源配置,这是因为单元范围资源对于单元中的每个节点是可视的,即使并不是单元中的每个节点都能够支持资源也是如此。 |
AdminApp 脚本编制对象中的安装命令的 depl.extension.reg 和 installdir 选项 | 没有可以用来替代 depl.extension.reg 选项的选项。在 V5.x 中,此选项是空操作。对于 installdir 选项,改为使用 installed.ear.destination 选项。 | |
性能 | V4.0 中引入的用来以编程方式从 WebSphere Application Server 中收集性能数据的 PMI 客户机 API | 建议使用 Java 管理扩展 (JMX) 接口(它是 J2EE 规范的一部分)来收集 WebSphere Application Server 性能数据。可以从 J2EE 管理的对象消息 Bean 或从 WebSphere PMI Perf 消息 Bean 收集 PMI 数据。当 J2EE 消息 Bean 提供有关特定组件的性能数据时,Perf 消息 Bean 充当到 WebSphere Application Server PMI 服务的网关,并且提供对所有组件的性能数据的访问权限。 |
V5.1.1 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器支持 | Web Service 网关定制 API | 规划在以后将现有过滤器替换为 JAX-RPC 处理程序和服务集成总线调解的组合。 |
应用程序服务 | 下列 Java 数据库连接 (JDBC) 驱动程序:
|
如果要使用这些 JDBC 驱动程序中的任何一个并且仍想使用 Microsoft SQL Server 作为数据库,那么可以切换至 Connect JDBC 驱动程序。您可以从 DataDirect Technologies 购买 Connect JDBC 驱动程序。 |
V5.1 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
安装和迁移工具 | 用于开发 J2EE 应用程序的 Application Assembly Tool 被 Application Server Toolkit 的 Assembly Tool 组件替代。 | 用户将安装和运行 Application Server Toolkit 的 Assembly Toolkit 组件,而不运行 Application Assembly Tool。Application Server Toolkit 是基于 Eclipse 框架。 启动 Application Server Toolkit 时,通过打开 J2EE 透视图来找到 J2EE 功能。 |
使用 WebSphere Studio Application Developer Integration Edition V5.0 或较早版本构建的业务流程 | 需要将使用 WebSphere Studio Application Developer Integration Edition V5.0 或较早版本构建的业务流程迁移至基于 BPEL 的流程。使用 WebSphere Studio Application Developer Integration Edition V5.1 提供的“迁移”选项。 | |
用于 WebSphere Studio Application Developer Integration Edition V5.0 或较早版本创建的业务流程的一些流程编排器 API 接口和方法。可以在随流程编排器一起提供的 API 文档中找到一个列表。 | 在相应 API 的 API 文档中提供了有关建议对不推荐使用的 API 执行的迁移操作的信息。 | |
JDOM(这是提供用于有效阅读、操控和编写文档的 API 的 XML 文档的 Java 表示) 不会将 WebSphere Application Server 中当前打包的 JDOM 版本打包到后续的发行版中。 |
请转至 JDOM Web
站点,以获取 JDOM 的最新副本并且将它捆绑到应用程序中。 注: 运行 WebSphere Studio
Application Developer Integration Edition V4.1 应用程序的客户将它们迁移至 WebSphere Studio Application Developer Integration
Edition V5.0。
|
|
C++ 对象请求代理 (ORB)、IDL 值类型的 C++ 库和 WebSphere Application Server C++ 安全客户机 将不再提供对公共对象请求代理体系结构 (CORBA) C++ 开发者工具箱的支持。CORBA 技术是迁移至 Java 2 Platform Enterprise Edition (J2EE) 和 WebSphere Application Server 环境的桥梁。 除了上面提到的信息之外,在后续的发行版中还将从 Application Client 安装映像中移除 CORBA C++ 客户机功能部件。 |
建议客户使用 WebSphere Application Server 随附的 Java 技术迁移至对象请求代理 (ORB) 服务。但是,没有为 C++ 安全客户机或 C++ 值类型库提供等价的 J2EE 功能。需要此种功能的客户必须提供或开发他们自已的功能。 有关 Java 技术的 ORB 服务的信息,请参阅 管理对象请求代理。 不推荐 CORBA C++ 开发者工具箱不会影响对 CORBA 与 CORBA 服务的供应商软件的互操作性的支持。查看下列链接,以获得有关互操作性的其他信息:
|
|
IBM Cloudscape V5.1.x | 使用 Cloudscape Network Server JDBC 驱动程序。 | |
服务器 | IBM HTTP Server (IHS) V1.3.x | 如果要将 IHS V1.3.x:
|
应用程序编程模型和容器支持 | Bean 脚本框架 (BSF) JavaServer Pages (JSP) 执行和调试功能 | 如果要使用 JavaScript、Tcl 和 Python 语言,那么需要重新设计该功能。
如果要在您自已的定制应用程序中使用 BSF 脚本编制,那么它们不受影响。为 WebSphere Application Server 管理控制台编写的定制脚本也不会受影响。 此功能在 WebSphere Application Server V5.1 和后续发行版中将继续存在,直到 V6.0 为止。如果调试 JSP 文件,那么在 JavaScript 调试会话期间,可能必须重新启动应用程序服务器。 |
下列“业务规则 bean”类、方法和属性:
|
用户无需执行任何操作。 | |
com.ibm.websphere.rsadapter 中的数据访问编程接口。 相关资源适配器接口:(com.ibm.websphere.rsadapter)。 在下列类型中不推荐使用方法:
|
这些不满足相关资源适配器条件的方法不影响应用程序。 注: 如果有 OracleDataStoreHelper 类的子类,那么不需要在它们的子类中实现这些不推荐使用的方法。WebSphere Application Server 运行时不会调用这些不推荐使用的方法。
|
|
调度程序 (com.ibm.websphere.scheduler) 编程接口 - 以下方法的 V5.x 公用类型:
|
使用下列方法代替不推荐使用的方法:
要使用受支持的 createTaskInfo 方法来创建 BeanTaskInfo 对象:
|
|
Web 容器 API Web 修改: 注: 不存在已声明的不推荐使用的对象。仅有的更改是由于 Java API
在 1.3 和 1.4 之间的更改所致。
更改的类是 com.ibm.websphere.Servlet.error.ServletErrorReport。更改了 getStackTrace( ) 的返回特征符,这是由于 java.lang.Throwable 现在用不同的返回特征符定义相同的方法。
|
如果要使用 com.ibm.websphere.Servlet.error.ServletErrorReport.getStackTrace( ) 并且要求返回类型为 String,那么需要更改应用程序以使用替换方法。 | |
应用程序服务 | 数据访问二进制文件 - 公共连接器框架,包括以下 JAR 文件:
|
应该使用 J2EE 连接器体系结构解决方案而不使用公共连接器框架。 有关使用 J2EE 连接器体系结构(工具和运行时)的更多信息,请参阅 使用 Java EE 连接器体系结构连接器来访问数据。 |
使用 TRANLOG_ROOT 变量来设置 XA 伙伴日志目录 | 需要将当前存储在 TRANLOG_ROOT 变量中的设置(如果有的话)添加至所有需要使用 XA 伙伴日志的服务器的“事务服务”面板。如果要使用缺省位置,那么不需要执行操作。在管理控制台中,可以通过选择“应用程序服务器”、选择要修改的应用程序服务器,然后在显示的面板上选择“事务服务”来找到“事务服务”面板。应该将 TRANLOG_ROOT 中的当前目录输入面板上的“记录目录”框。 | |
安全性 | 将 API 用于 com.ibm.websphere.security.auth.WSPrincipal.getCredential()。 | 您现在应该使用下列某个方法来获取包含 WSCredential 的主体集,而不是从主体中获取 WSCredential:
|
安全性编程接口中的以下元素:
|
将 Java 认证和授权服务 (JAAS) 用于所有与认证相关的功能。 | |
集成加密服务工具 (ICSF) 认证机制 | 使用轻量级第三方认证 (LTPA) 机制。 有关更多信息,请参阅 轻量级第三方认证。 |
|
系统管理 | 下列类: com.ibm.websphere.rsadapter.DB2390DataStoreHelper |
如果当前在访问数据时将 DB2390DataStoreHelper 类用于 DB2 旧的基于 CLI 的提供程序,那么现在应该使用 DB2DataStoreHelper 类。 如果当前在访问数据时将 DB2390DataStoreHelper 类用于 DB2 通用 JDBC 提供程序,那么现在应该使用 DB2UniversalDataStoreHelper 类。 |
V5.0.2 中不推荐使用的功能部件
![[z/OS]](../images/ngzos.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器支持 | Web Service 网关中的 Apache SOAP 通道。 | 应将网关服务部署到 SOAP HTTP 通道,而不是 Apache SOAP 通道。服务的端点 (URL) 将与此通道的端点不同,因此,与网关通信的客户机程序将需要使用新服务端点。 |
Apache SOAP、WEBSJAVA.SOAP:
|
有关更多信息,请参阅将 Apache SOAP Web Service 迁移到基于 Java EE 标准的 JAX-RPC Web Service。 |
|
调度程序 (com.ibm.websphere.scheduler) 编程接口 - 以下方法的 V5.x 公用类型:
|
使用下列方法代替不推荐使用的方法:
|
|
应用程序服务 | com.ibm.websphere.rsadapter 中的数据访问编程接口。 相关资源适配器接口 (com.ibm.websphere.rsadapter) 不推荐使用下列类型的方法:
|
这些不满足相关资源适配器条件的方法不影响应用程序。 注: 如果有 GenericDataStoreHelper 的子类,那么不需要在它们的子类中实现这些不推荐使用的方法。WebSphere Application Server 运行时不会调用这些不推荐使用的方法。
对于 com.ibm.websphere.rsadapter.WSCallHelper,请使用 getDataStoreHelper(datasource) 方法以获取 DataStoreHelper 对象。 |
系统管理 | DB2390DataStoreHelper 和 DB2390LocalDataStoreHelper 类 | DB2DataStoreHelper 类现在提供当前使用 DB2390DataStoreHelper 和 DB2390LocalDataStoreHelper 类的提供程序所需的所有必需帮助程序信息。 |
DB2 390 本地 JDBC 提供程序 (RRS) | 使用 DB2 zOS 本地 JDBC 提供程序 (RRS) 替换此提供程序。 | |
AdminControl 脚本编制对象中的 testConnection 命令($AdminControl TestConnection
configId 弹出) 在 WebSphere Application Server V5.0.2
或更高版本中运行此命令会返回以下消息:
|
对于 WebSphere Application Server V5.0.2 或更高版本,测试数据源连接的首选方式是使用将数据源配置标识作为唯一参数传递的 testConnection 命令。 | |
AdminControl 脚本编制对象中的 getPropertiesForDataSource 命令 ($AdminControl getPropertiesForDataSource
configId) 当您在已连接方式下运行此命令时,它不正确地假设配置服务的可用性。在 WebSphere Application Server V5.0.2
或更高版本中运行此命令会返回以下消息:
|
没有此命令的替换项。 |
![[IBM i]](../images/iseries.gif)
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序编程模型和容器支持 | Web Service 网关中的 Apache SOAP 通道。 | 应将网关服务部署到 SOAP HTTP 通道,而不是 Apache SOAP 通道。服务的端点 (URL) 将与此通道的端点不同,因此,与网关通信的客户机程序将需要使用新服务端点。 |
Apache SOAP、WEBSJAVA.SOAP:
|
有关更多信息,请参阅将 Apache SOAP Web Service 迁移到基于 Java EE 标准的 JAX-RPC Web Service。 |
|
调度程序 (com.ibm.websphere.scheduler) 编程接口 - 以下方法的 V5.x 公用类型:
|
使用下列方法代替不推荐使用的方法:
|
|
应用程序服务 | com.ibm.websphere.rsadapter 中的数据访问编程接口。 相关资源适配器接口 (com.ibm.websphere.rsadapter) 不推荐使用下列类型的方法:
|
这些不满足相关资源适配器条件的方法不影响应用程序。 注: 如果有 GenericDataStoreHelper 的子类,那么不需要在它们的子类中实现这些不推荐使用的方法。WebSphere Application Server 运行时不会调用这些不推荐使用的方法。
对于 com.ibm.websphere.rsadapter.WSCallHelper,请使用 getDataStoreHelper(datasource) 方法以获取 DataStoreHelper 对象。 |
系统管理 | DB2390DataStoreHelper 和 DB2390LocalDataStoreHelper 类 | DB2DataStoreHelper 类现在提供当前使用 DB2390DataStoreHelper 和 DB2390LocalDataStoreHelper 类的提供程序所需的所有必需帮助程序信息。 |
AdminControl 脚本编制对象中的 testConnection 命令($AdminControl TestConnection
configId 弹出) 在 WebSphere Application Server V5.0.2
或更高版本中运行此命令会返回以下消息:
|
对于 WebSphere Application Server V5.0.2 或更高版本,测试数据源连接的首选方式是使用将数据源配置标识作为唯一参数传递的 testConnection 命令。 | |
AdminControl 脚本编制对象中的 getPropertiesForDataSource 命令 ($AdminControl getPropertiesForDataSource
configId) 当您在已连接方式下运行此命令时,它不正确地假设配置服务的可用性。在 WebSphere Application Server V5.0.2
或更高版本中运行此命令会返回以下消息:
|
没有此命令的替换项。 |
V5.0.1 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序服务 | com.ibm.websphere.rsadapter 中的数据访问编程接口。 相关资源适配器接口 (com.ibm.websphere.rsadapter)。 不推荐使用下列类型的方法:
|
这些不满足相关资源适配器条件的方法不影响应用程序。 注: 如果有 com.ibm.websphere.rsadapter.GenericDataStoreHelper 的子类,那么不需要在它们的子类中实现这些不推荐使用的方法。WebSphere Application Server 运行时不会调用这些不推荐使用的方法。
|
V5.0 中不推荐使用的功能部件
类别 | 不推荐 | 建议执行的迁移操作 |
---|---|---|
应用程序服务 | 来自 com.ibm.websphere.appprofile.accessintent.AccessIntent 的以下三种方法:
这是一个基本 API。 |
开发者应使用来自相同接口的以下方法,而不是使用 AccessIntent 接口上的三种不推荐的方法:
在 AccessIntent 接口上定义可能的返回值:
|
Web 应用程序编程接口 - com.ibm.websphere.ServletErrorReport 中的各种 V5.x 方法 | ||
安全性 | com.ibm.websphere.security.CustomRegistry 接口 | 使用 com.ibm.websphere.security.UserRegistry 接口。 |
性能 | 性能监控基础结构 - 各种 V5.x 公共方法:
|
这些方法被替换为如下所示:
|