ibm-webservicesclient-bnd.xmi assembly properties for JAX applications

WAS v8.5 > Reference > Configuration file descriptions
ibm-webservicesclient-bnd.xmi assembly properties for JAX applications

The ibm-webservicesclient-bnd.xmi deployment descriptor file contains information for the web services run time that is WebSphere product-specific. This deployment descriptor file is used with Java API for XML-based web services.
We can configure deployment descriptors with assembly tools provided with WAS. Read about configuring the JAX-RPC web services client bindings in the ibm-webservicesclient-bnd.xmi deployment descriptor to learn more about configuring this deployment descriptor.

Assembly properties
The following list is a collection of supported properties and attributes that we can define for the applications.
The overriddenEndpointURI property is the only property that is applicable for JAX-WS Web services.

componentNameLink

An attribute of the componentScopedRefs element. When a web service is implemented by an EJB implementation, each <componentScopedRefs> element contains assembly properties for an individual enterprise bean. The componentNameLink attribute of the <componentScopedRefs> element identifies the enterprise bean the assembly properties apply to by specifying the <ejb-name>. This property is used only when the web service client is an enterprise bean.

serviceRefLink

An attribute of the serviceRefs element. Link to the <service-ref-name> in the <service-ref> element in the client deployment descriptor. The client deployment descriptor is either ejb-jar.xml, web.xml or application-client.xml.

deployedWSDLFile

An attribute of the serviceRefs element is optional. Permits analternate Web Services Description Language (WSDL) file to use other than that specified in the <wsdl-file> element of the <service-ref> element in the client deployment descriptor. If an attribute is specified, the alternate WSDL file must be packaged in the same module and must be compatible with the development WSDL file. The deployedWSDLFile property supplies a new WSDL file containing a different endpoint web address than the original WSDL file.

defaultMappings

An element that identifies which port to use for a given portType when one is not selected by the client. This element has the following attributes: portTypeNamespace, portTypeLocalName, portNamespace, portLocalName. These attributes identify which wsdl:port is used for a wsdl:portType.

syncTimeout

An attribute of the portQnameBindings element. How long, in seconds, to wait for a response from a synchronous call. The default is 300 seconds.

basicAuth

An element of the portQnameBindings element. Authenticates a service client to the service endpoint, independent of the underlying transport that includes, HTTP, HTTPS, and JMS. Set the user ID and password attributes as needed.

sslConfig

An element of the portQnameBindings element. Specifies the Secure Sockets Layer (SSL) configuration of an HTTPS outbound request. The name attribute is the name of an SSL configuration entry or alias defined in the SSL configuration repertoire. This attribute is used only when the client is running in the WAS.

overriddenEndpointURI

A property that specifies the final URL to which requests will be sent. When the client is run to invoke the web service, the request is sent to this property's URL, which takes precedence over the address given in the WSDL file and the client code. This property is the only property in the ibm-webservicesclient-bnd.xmi file which is applicable to JAX-WS services.

A bindings file example

The following example demonstrates the spelling and position of the various attributes. We cannot cut and paste these examples because they do not contain the required ID attributes. If you add elements to a binding file template generated by the WSDL2Java command, you must confirm that each element has an ID attribute whose value is a unique string. Review the template xmi files generated by the WSDL2Java command for examples of ID strings. Read about the WSDL2Java command-line tool for Java API for XML-based Remote Procedure Call (JAX-RPC) applications to learn more about this tool.
<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>
Related concepts:

Development and assembly tools

Related

View web services deployment descriptors in the dmgr console
Configure the JAX-RPC web services client bindings in the ibm-webservicesclient-bnd.xmi deployment descriptor
Assemble web services applications

Reference:

WSDL2Java command for JAX-RPC applications

+
Search Tips | Advanced Search