Web Service 迁移最佳实践

在迁移 Web Service 应用程序时,请使用这些 Web Service 迁移最佳实践。

如果已使用 Apache SOAP 支持在 WebSphere® Application Server V4、V5 或 V5.1 中开发 Web Service 客户机应用程序,那么可能需要迁移应用程序或应用程序的安全文件。下表汇总了 WebSphere 产品支持的 Web Service 规范。

表 1. WebSphere Application Server 支持的 Web Service 规范汇总. 产品支持此表中的 Web Service 规范。
WebSphere Application Server 版本 支持的 Web Service 规范
4.0 Apache SOAP 2.2
5.0 和 5.0.1 Apache SOAP 2.3
5.0.2 或更高版本 Java™ 2 Platform, Enterprise Edition (J2EE),也称为 (JSR 109)
6.0.x 和 6.1 J2EE (JSR 109)
7.0 或更高版本 Web Services for Java Platform, Enterprise Edition (Java EE) 5 也称为 JSR 109
支持的配置 支持的配置: 不再支持 WebSphere Application Server V4.0.x、V5.0 和 V5.0.1 中提供的基于 Apache SOAP 2.2 和 Apache SOAP 2.3 的实现。建议使用这些 SOAP 实现的应用程序迁移到当前 WebSphere Application Server 版本中提供的 Web Services for Java EE (JSR 109) 支持。sptcfg

有关迁移 Web Service 的更多信息,请阅读将 Apache SOAP Web Service 迁移至基于 Java EE 标准的 JAX-RPC Web Service 的相关内容。

建议使用 Web Services for Java EE 规范来开发新的 Web Service。要了解更多信息,请阅读实现 Web Service 应用程序的相关内容。

不能将安全性从 SOAP 2.3 直接迁移到 Java EE 标准。在将 Web Service 迁移到 Java EE 标准之后,请考虑保护 Web Service 应用程序的安全。要了解更多信息,请阅读使用消息级安全性来保护 Web Service 应用程序的安全的相关内容。

请遵循下列最佳实践以获取最佳的迁移体验:

应用程序服务器支持 Java API for XML-Based Web Services (JAX-WS) 编程模型和 Java API for XML-based RPC (JAX-RPC) 编程模型。JAX-WS 是下一代 Web Service 编程模型,用于扩展 JAX-RPC 编程模型所提供的基础。

现有需要使用 JAX-WS 功能部件的 JAX-RPC 应用程序必须使用 JAX-WS 编程模型进行重写。

在迁移到应用程序服务器的新发行版之后,重新部署现有 JAX-RPC Web Service

迁移到应用程序服务器的新发行版时,建议您重新部署 Web Service 应用程序。应该在新的应用程序服务器环境中重新部署 Web Service 应用程序,因为在每个发行版中可能更改了 Web Service 规范和 Web Service 部署描述符的受支持级别。要重新部署 Web Service,请在“安装新的应用程序”向导中选择部署 Web Service,或使用 wsdeploy 命令。要了解此过程的更多信息,请参阅“将 Web Service 应用程序部署到应用程序服务器”文档。

迁移 Java API for XML-based remote procedure call (JAX-RPC) V5 客户机(该客户机使用“SOAP over Java 消息服务 (JMS)”来调用 Web Service)

在 WebSphere Application Server V5 上运行的 JAX-RPC 客户机可使用 SOAP over JMS 来调用在 V5 应用程序服务器上运行的 Web Service。

在目标 WebSphere MQ 队列上,用户标识和密码不是必需的。将应用程序服务器迁移到 V6.x 并使用 V6.x 缺省消息传递功能部件之后,客户机请求可能失败,因为已启用基本认证。在发生此迁移问题时,会显示以下错误消息:
SibMessage W [:] CWSIT0009W: A client request failed in the application server with 
endpoint <endpoint name> in bus <bus_name> with reason: CWSIT0016E: The user
ID null failed authentication in bus <bus_name>.

将应用程序服务器迁移到 V6.x、使用缺省消息传递提供程序(服务集成技术)并且为服务器或单元启用了管理和应用程序安全性时,在缺省情况下,服务集成总线队列目标会继承该服务器或单元的安全特征。如果服务器或单元启用了基本认证,那么客户机请求失败。

下列选项可用来解决此问题。按使用的安全性级别列出了以下解决方案:
  • 请在管理控制台中的主安全性面板上禁用管理和应用程序安全性。要禁用管理和应用程序安全性,请单击安全性 > 全局安全性。请取消选择启用管理安全性启用应用程序安全性选项。
  • 请修改用来管理队列目标的服务集成总线的设置,以便禁用总线安全性且总线不会继承服务器或单元中的安全特征。此选项等价于可以在 V5 中配置的安全性级别。
  • 请在使用该服务的每台客户机上配置基本认证。要了解更多信息,请参阅使用管理控制台来配置 JAX-RPC Web Service 的 HTTP 基本认证的相关信息。

迁移 Apache SOAP Web Service

可以将使用 Apache SOAP 开发的 Web Service 迁移到基于 Web Services for Java 2 Platform, Enterprise Edition (J2EE) 规范开发的 Web Service。请参阅将 Apache SOAP Web Service 迁移到基于 Java EE 标准的 JAX-RPC Web Service 的相关信息。

迁移使用较低版本的 Application Server Toolkit 或 Assembly Toolkit 组装的 Web Service

如果要将 Web Service 或 Web Service 组件从较低版本的 Application Server Toolkit 或 Assembly Toolkit 进行迁移,请参阅下列提示与技巧以成功完成此项任务:
  • 将 Web Service 从 J2EE 1.3 迁移到 J2EE 1.4 时,“J2EE 迁移向导”不会迁移安全 Web Service。
  • 迁移安全 Web Service 时需要手动执行某些步骤。
  • 在 J2EE 迁移之后,必须手动将安全绑定和扩展文件迁移到 J2EE 1.4,如下所示:
    1. 双击 webservices.xml 文件以打开 Web Service 编辑器。
    2. 选择绑定配置选项卡以编辑绑定文件。
    3. 将所有必需的绑定配置添加到新的部分请求使用者绑定配置详细信息响应生成器绑定配置详细信息下面。
    4. 选择扩展选项卡以编辑扩展文件。
    5. 将所有必需的扩展配置添加到新的部分请求使用者服务配置详细信息响应生成器服务配置详细信息下面。
    6. 保存并退出编辑器。

将 V8.5 之前的 WebSphere Application Server 节点迁移至 8.5 或更高版本

当客户将 V8.5 之前的 WebSphere Application Server 节点迁移至 8.5 或更高版本时,可能会在 Deployment Manager 的 JVM 日志文件中显示以下错误:
[7/31/12 14:48:34:323 CDT] 0000043f EditionHelper E   Unexpected Error: ibmasyncrsp -- The Application's Directory in the Repository is EMPTY.
[7/31/12 14:48:34:339 CDT] 0000043f FfdcProvider  W com.ibm.ws.ffdc.impl.FfdcProvider logIncident FFDC1003I: FFDC Incident emitted on c:\opt\WAS85\profiles\dmgr.xd61\logs\ffdc\dmgr_483a68e7_12.07.31_14.48.34.3396174315962980574983.txt com.ibm.ws.xd.appeditionmgr.EditModuleTargetsTaskHandler 104
[7/31/12 14:48:34:339 CDT] 0000043f EditModuleTar E   ERROR_IN_EDIT_MODULE_TARGETS_TASK_HANDLER

只有在将 WebSphere Application Server 以外的应用程序服务器联合到单元时,才会显示此错误。将记录有关 ibmasyncrsp.ear 文件的消息,该文件是应用程序服务器的内部 JAX-WS 引擎所使用的内部系统应用程序。由于 JAX-WS 引擎与 WebSphere Application Server 以外的应用程序服务器无关,因此不会造成任何功能损坏。可忽略该消息。


指示主题类型的图标 参考主题



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