Configure the JAX-RPC web services client bindings in the ibm-webservicesclient-bnd.xmi deployment descriptor

We can configure the ibm-webservicesclient-bnd.xmi deployment descriptor file with assembly tools.

We can configure deployment descriptors with assembly tools provided with the application server.

Configure the assembly tool before we can use it. Read about configuring the assembly tool in the Rational Application Developer documentation.

Now that we have assembled the client module, complete this step to configure the ibm-webservicesclient-bnd.xmi deployment descriptor. Deployment descriptors are required so that so that WebSphere Application Server can process the incoming web services requests.

Configure the ibm-webservicesclient-bnd.xmi deployment descriptor file with the following steps provided:

Tasks

1. Start an assembly tool. Read about starting the assembly tool in the Rational Application Developer documentation.
2. Switch to the Java EE Perspective.

   1. Click Window > Open Perspective > Other > Java EE.

3. Open the Project Explorer.

   1. Click Window > Show View > Other > Project Explorer.

4. Locate the deployment descriptor file for the module. Hint: Deployment Descriptor: <module>
5. Double-click the deployment descriptor file to open the Deployment Descriptor editor.

   1. Select the WS Binding tab in the editor window to open the Web Services Client Bindings editor.

6. Verify the serviceRefLink element settings.

   1. Open the Web Services Client Bindings editor.

   2. Click the Services References tab.

   3. Click Add.

   4. Select the service references defined in the client deployment descriptor file from the list.

7. Verify the deployedWSDLFile element settings.

   1. Open the Web Services Client Bindings editor.

   2. Select the service reference.

   3. Expand the Service Reference Details section.

   4. Click Browse located to the side of the Deployed WSDL file field.

   5. Select the new Web Services Description Language (WSDL) file.

   6. Click OK.

   We can also change the deployedWSDLFile element of a deployed web service using the administrative console. Click Enterprise Applications > application > Web module or EJB module > module > Web services client bindings.

8. Verify the defaultMappings element settings.

   1. Open the Web services client bindings editor.

   2. Click Default mappings.

   3. Click Add.

   4. Edit the entries in the newly added row to establish a mapping between a portType and a port in the WSDL file. Only one entry is supported for each portType.

   5. Click OK.

   We can also change the defaultMappings element of a deployed web service using the administrative console. Click Enterprise Applications > application > Web module or EJB module > module > Web services client bindings.

9. Access the web services client Port bindings editor through the Port qualified name binding details section.

10. Verify the syncTimeout element settings.

    1. Create a Port qualified name bindings for the port.

    2. Open the Web services client bindings editor.
    3. Confirm that a service reference is selected in either the Component-scoped references or the Service references section.

    4. Expand the Port qualified name binding section.

    5. Click Add. The Add port qualified name binding dialog opens.

    6. Type the namespace of the WSDL file port we want to configure, in the Port namespace link field.

    7. Type the local_name of the WSDL file port we want to configure in the Port local name link field. The name displayed in the Port qualified name binding list is the local name of the WSDL file port.

    8. Click OK.

    1. Configure the syncTimeout property by locating the Synchronization timeout field and enter the desired value. The default is 300 seconds.

11. Verify the basicAuth element settings.
    1. Locate the HTTP basic authentication field in the Port qualified name binding details section.

    2. Type the desired value in the User ID and Password fields.

    3. Click OK.

12. Verify the sslConfig element settings.
    1. Locate the SSL configuration field in the Port qualified name binding details section.

    2. Type the desired value in the Name field.

    3. Click OK.

13. After editing the properties, type ctrl-s on your keyboard to save the changes.

We have configured the ibm-webservicesclient-bnd.xmi deployment descriptor. If we have configured all of the client deployment descriptors, test the web services client. If we have not configured all of the client deployment descriptors, complete the configurations and then test the web services client.

Subtopics

• 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.

Related:

Development and assembly tools