为 JAX-WS 应用程序开发 webservices.xml 部署描述符

部署描述符是标准文本文件,使用 XML 格式化,并打包在 Web Service 应用程序中。可选择使用 webservices.xml 部署描述符来扩充或覆盖在 Java™ API for XML-Based Web Services (JAX-WS) Web Service 的注释中指定的应用程序元数据。

关于此任务

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

JAX-WS Web Service 要求您使用 javax.jws.WebService 注释或提供程序端点的 javax.jws.WebServiceProvider 注释对 Java 类进行注释。可以使用服务器端的部署描述符来覆盖注释的相应属性或改进注释中的信息。在部署描述符元素和 @WebService 以及 @WebServiceProvider 注释之间存在已定义的关系。请参阅 Web Services for Java Platform, Enterprise Edition (Java EE) 规范 V1.2 中的第 5.3 节以获取有关部署描述符元素以及到 @WebService 和 @WebServiceProvider 注释属性的映射的详细信息。在映射到其他注释的 webservice.xml 部署描述符中也有元素。例如,部署描述符元素 <protocol-binding> 映射到 @BindingType 注释,而部署描述符元素 <enable-mtom> 映射到 @MTOM 注释。 有关 Web Service 部署描述符元素的更多信息,请参阅 Web Services for Java Platform, Enterprise Edition (Java EE) 规范中的第 7.1 节。

过程

使用组装工具来生成 webservice.xml 部署描述符。

结果

您具有部署描述符模板,可用来覆盖 JAX-WS 注释属性或指定注释未定义的属性。

示例

在以下示例中,JAX-WS Web Service 的服务实现类包括 @WebService 注释:
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
相关联的 webservices.xml 部署描述符为 WSDL 文档指定其他文件名,如下所示:
<webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
</webservice-description>
</webservices>
在部署描述符 META-INF/wsdl/ExampleService.wsdl 中指定的值将覆盖注释值。

下一步做什么

配置 webservice.xml 部署描述符。配置部署描述符后,必须组装 Web Service 应用程序以进行部署。


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



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