JAX 应用程序的 ibm-webservicesclient-bnd.xmi 组装属性
ibm-webservicesclient-bnd.xmi 部署描述符文件包含特定于 WebSphere® 产品的 Web Service 运行时的信息。此部署描述符文件与 Java™ API for XML-based Web Service 配合使用。
您可以使用 WebSphere Application Server 提供的组装工具配置部署描述符。请阅读“在 ibm-webservicesclient-bnd.xmi 部署描述符中配置 JAX-RPC Web Service 客户机绑定”,以了解有关配置此部署描述符的更多信息。
组合件属性
下表是受支持的属性以及可以为应用程序定义的属性的集合。
- componentNameLink
- componentScopedRefs 元素的属性。Web Service 由 Enterprise JavaBeans (EJB) 实现来实现时,每个 <componentScopedRefs> 元素包含个别企业 Bean 的组装属性。<componentScopedRefs> 元素的 componentNameLink 属性识别组装属性通过指定 <ejb-name> 应用的企业 Bean。此属性仅在 Web Service 客户机是企业 Bean 时使用。
- serviceRefLink
- serviceRefs 元素的属性。指定到客户机部署描述符中 <service-ref> 元素中的 <service-ref-name> 的链接。客户机部署描述符是 ejb-jar.xml、web.xml 或 application-client.xml。
- deployedWSDLFile
- serviceRefs 元素的属性是可选的。允许使用备用 Web Service 描述语言 (WSDL) 文件,而不是客户机部署描述符中 <service-ref> 元素的 <wsdl-file> 元素中指定的文件。如果指定属性,那么备用 WSDL 文件必须与开发 WSDL 文件打包在相同的模块中并且必须兼容。deployedWSDLFile 属性提供新 WSDL 文件,该文件包含与原始 WSDL 文件不同的端点 Web 地址。
- defaultMappings
- 客户机未选择要用于给定 portType 的端口时,此元素将确定一个端口。此元素具有以下属性:portTypeNamespace、portTypeLocalName、portNamespace 和 portLocalName。这些属性标识将哪个 wsdl:port 用于 wsdl:portType。
- syncTimeout
- portQnameBindings 元素的属性。它指定等待同步调用的响应需要多长时间(以秒计)。缺省值为 300 秒。
- basicAuth
- portQnameBindings 元素的元素。独立于包括 HTTP、HTTPS 和 Java 消息服务 (JMS) 的底层传输,认证到服务端点的服务客户机。需要时设置用户标识和密码属性。
- sslConfig
- portQnameBindings 元素的元素。指定 HTTPS 出站请求的安全套接字层 (SSL) 配置。名称属性是 SSL 配置条目的名称或在 SSL 配置指令表中定义的别名。此属性仅当客户机运行在 WebSphere Application Server 上时使用。
对于 WebSphere Application Server for z/OS®,需要某个数字证书和密钥环管理。要了解更多信息,请参阅“创建安全套接字层数字证书和系统授权工具密钥环供应用程序用于启动 HTTPS 请求”信息。
- overriddenEndpointURI
- 此属性指定请求将发送到的最终 URL。运行客户机调用 Web Service 时,请求将发送到此属性的 URL,该 URL 优先于 WSDL 文件和客户机代码中指定的地址。 此属性是 ibm-webservicesclient-bnd.xmi 文件中唯一适用于 JAX-WS 服务的属性。
绑定文件示例
以下示例说明各种属性的拼写和位置。您无法剪切和粘贴这些示例,因为它们不包含必需的标识属性。如果您添加元素到由 WSDL2Java 命令生成的绑定文件模板,您必须确认每个元素有值是唯一的字符串的标识属性。复审 WSDL2Java 命令生成的模板 xmi 文件以获取标识字符串的实例。请阅读 Java API for XML-based Remote Procedure Call (JAX-RPC) 应用程序的 WSDL2Java 命令行工具的内容,以了解有关此工具的更多信息。
<com.ibm.etools.webservice.wscbnd:ClientBinding xmi:version="2.0"
xmlns:xmi="http://www.omg.org/XMI" xmlns:com.ibm.etools.webservice.wscbnd=
"http://www.ibm.com/websphere/appserver/schemas/5.0.2/wscbnd.xmi">
<componentScopedRefs componentNameLink="myComponent ref"/>
<serviceRefs serviceRefLink="myService ref" deployedWSDLFile="META-INF/wsdl/alternate.wsdl">
<defaultMappings portTypeLocalName="AddressBook" portTypeNamespace="http://www.com.ibm"
portLocalName="AddressBookPort" portNamespace="http://www.com.ibm"/>
<portQnameBindings portQnameNamespaceLink="http://www.com.ibm"
portQnameLocalNameLink="AddressBookPort" syncTimeout="99">
<basicAuth userid="myId" password="myPassword"/>
<sslConfig name="mynode/DefaultSSLSettings"/>
</portQnameBindings>
</serviceRefs>
</com.ibm.etools.webservice.wscbnd:ClientBinding>