请勿使用 JBoss Web Service 部署描述符
此规则标记任何现有 webservices.xml 以检测对于 JBoss 是否存在 J2EE Web service 部署描述符文件。 在源扫描程序中，此快速修订生成具有特定 IBM Ant 任务的 Ant 脚本。 这些任务会生成基于 JBoss Java Platform, Enterprise Edition (Java EE) Web Service 部署描述符的 JAX-RPC Web Service。 快速修订会对这些 Web Service 部署描述符进行扫描并生成 Ant 脚本。

用于触发该规则的条件：
此规则根据以下条件检测 JAX-RPC Web Service 是否存在：
a. J2EE Web Service 部署描述符文件 webservices.xml 是否存在
b. 在源扫描程序中，它检测到项目的根文件夹中尚不存在 IBM Ant 生成的文件。

规则属性：
此规则中的属性仅影响快速修订。 必须为规则属性提供正确的值。 要更改此规则的属性值，请在“软件分析器配置”窗口中选择该规则。 然后，使用“属性”选项卡中的字段。 此规则的属性如下：
  • 所生成 Ant 脚本的名称：
    这是将生成的新 Ant 脚本的名称。该文件名必须是有效文件名。该值不能包含任何正斜杠或反斜杠。所生成文件将位于项目的根文件夹中。
    缺省值：build-ibm-ws.xml

  • 生成文件夹名称：
    这是放置所生成工件的文件夹的名称。 该值不能包含任何正斜杠或反斜杠。生成文件夹位于项目的根文件夹中。
    缺省值：ibm-ws-gen

Ant 类路径：
ant 类路径是从 Eclipse 项目计算的。验证对于编译必需的所有元素是否都在 Eclipse 类路径上很重要。

webservices.xml 文件中定义的 JAX-RPC 服务
根据 webservices.xml 文件中定义的信息以及服务类型，会生成 Ant 脚本以重新生成 JAXRPC 服务。

  • 所生成 Ant 目标：
    所生成 Ant 脚本包含用于生成 WSDL 文件和 JAX-RPC 服务的目标。
    仅当快速修订无法找到 WSDL 文件（如元素 <wsdl-file> 中所定义）时，才会生成 WSDL 生成目标。
    WSDL 生成目标（如果已创建）具有名称 genWSDL_ssss，其中 ssss 是服务的名称（如元素 <webservice-description-name> 中所定义）。
    服务生成目标具有名称 genService_pppp，其中 pppp 是端口的名称（如元素 <port-component-name> 所定义）。

IBM WebSphere Application Server Ant 任务
IBM WebSphere® Application Server 包含 Ant 任务，例如 java2wsdl 和 wsdl2java，用于为 JAX-RPC 服务 生成必需的工件。  生成的 Ant 脚本使用这些任务来 构建服务。 有关这些任务的其他信息可从 WebSphere Application Server 文档获取。

运行 Ant 脚本
在快速修订生成 Ant 脚本之后，请查看该脚本，并在必要时添加其他定制。 请参阅 WebSphere Application Server 文档，以了解有关 IBM Ant 任务的其他定制。 必须使用 IBM WebSphere Application Server 随附的 IBM 提供的 Ant 工具来运行脚本。 可以从以下位置运行 IBM Ant 脚本：
  • Windows® 操作系统上的 WAS_HOME\bin\ws_ant.bat
  • UNIX® 操作系统上的 WAS_HOME\bin\ws_ant.sh
例如：c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

当 Ant 目标运行时，生成的工件会位于生成文件夹中。可以检查所生成代码及部署描述符，然后将这些工件添加至其模块。