将 Web Service 应用程序部署到应用程序服务器上

将对 Web Service 启用 Web 模块所需的工件组装到企业归档 (EAR) 文件后,可以将 EAR 文件部署到应用程序服务器。

准备工作

要部署基于 Java 的 Web Service,您需要经过配置的及对 Web Service 启用的企业应用程序(又称为 EAR 文件)。

Java™ API for XML-Based Web Services (JAX-WS) 应用程序不需要额外的绑定和部署描述符,而 Java API for XML-based RPC (JAX-RPC) Web Service 应用程序需要您为应用程序部署添加额外的绑定和部署描述符。 JAX-WS 具有更强的动态性,且不需要部署步骤(部署 JAX-RPC 应用程序时需执行的步骤)所产生的任何静态数据。

对于 JAX-WS Web Service,可以选择是否使用 webservices.xml 部署描述符,这是因为您可以使用注释来指定该部署描述符文件所包含的所有信息。 可以使用部署描述符文件来扩充或覆盖现有 JAX-WS 注释。 您在 webservices.xml 部署描述符中定义的任何信息都将覆盖注释指定的任何相应信息。

混合版本环境: 在混合节点单元中,只能使用 WebSphere® Application Server V 7.0 和更高版本将启用 JAX-WS 的企业 Bean 模块作为目标指向服务器。 但是,您可以使用 WebSphere Application Server V 7.0 和更高版本或 WebSphere Application Server V 6.1 Feature Pack for Web Services 将支持 JAX-WS 的 Web 应用程序归档 (WAR) 模块作为服务器的目标

可以将 wsdeploy 命令与 JAX-RPC 应用程序配合使用,以将特定于 WebSphere 产品的部署类添加到与 Web Service 兼容的企业应用程序企业归档 (EAR) 文件或应用程序客户机 Java 归档 (JAR) 文件。

要安装或部署 JAX-WS 应用程序,只需要安装 JAX-WS 启用的 EAR 文件。 如果 Web Service 应用程序仅包含 JAX-WS 端点,那么您不需要运行 wsdeploy 命令,这是因为此命令仅用来处理 JAX-RPC 端点。

确保已将使用 endptEnabler 命令生成的 HTTP 或 Java 消息服务 (JMS) 路由器模块安装到与 Web Service 企业 Bean JAR 文件相同的目标中。 这些 HTTP 或 JMS 路由器模块包含在 Web service 应用程序中,它们需要使用应用程序服务器的运行时库。

有关此任务

本任务是开发和实现 Web Service 的一个步骤。

可以使用管理控制台或 wsadmin 脚本编制工具部署 EAR 文件。 如果要通过使用 wsadmin 命令安装包含 Web Service 的应用程序,请对 JAX-RPC 应用程序指定 -deployws 选项。 如果要使用管理控制台安装包含 Web Service 的应用程序,请选择“安装新的应用程序”向导中的部署 Web Service。 有关使用管理控制台安装应用程序的更多信息,请参阅“使用控制台安装企业应用程序文件”的信息。

如果 JAX-RPC Web Service 应用程序先前使用 wsdeploy 命令进行部署,那么在安装期间不需要指定 Web Service 部署。

下列操作使用 wsadmin 命令部署 EAR 文件:

过程

  1. 从命令提示符启动 install_root/bin/wsadmin

    [Linux][AIX][HP-UX][Solaris]在 AIX 或 Linux®之类的操作系统上,启动 install_root/bin/wsadmin.sh

  2. 部署 EAR 文件。
    • 对于 JAX-WS Web Service 应用程序,请在 wsadmin 提示符处输入 $AdminApp install EARfile "-usedefaultbindings" 命令。
    • 对于 JAX-RPC Web Service 应用程序,在 wsadmin 提示符处输入 $AdminApp install EARfile "-usedefaultbindings -deployws" 命令。

结果

在应用程序服务器上安装了 Web Service。

避免麻烦: 将包含大量企业 Bean 的 Web Service 应用程序安装到应用程序服务器上时,可能会收到内存不足错误。 如果收到内存不足错误,请增加 Java 虚拟机 (JVM) 的堆大小。 请阅读“为 Java 调整 IBM 虚拟机”文档以了解有关调整应用程序服务器环境的更多信息。

下一步做什么?

可以通过在浏览器中输入 Web Service 端点 URL,然后查看提供信息的页面来确认 Web Service 应用程序已部署。 提供信息的页面包含下列信息:
{http://webservice.pli.tc.wssvt.ibm.com}RetireWebServices 
Hello! This is an Axis2 web service!
此信息的第一行可变,这取决于 Web Service。 括号中的 URI 是名称空间,其后的字符串(在本示例中为 RetireWebServices)是用于访问 Web Service 的端口的名称。

您可能要考虑的下一步是将安全性应用于 Web Service。