Configure the Web services client bindings in the ibm-webservicesclient-bnd.xmi deployment descriptor

This topic explains how to configure the ibm-webservicesclient-bnd.xmi deployment descriptor file with assembly tools.

 

Before you begin

One can configure deployment descriptors with assembly tools provided with WebSphere Application Server.

You must configure the assembly tool before use it.

 

Overview

Now that you 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:

 

Procedure

1. Start an assembly tool. The Eclipse assembly tools, Application Server Toolkit (AST) and Rational Web Developer, provide a graphical interface for developing code artifacts, assembling the code artifacts into various archives (modules) and configuring related J2EE V1.2, 1.3 or 1.4 compliant deployment descriptors.

2. Switch to the J2EE Perspective.

   1. Click Window > Open Perspective > Other > J2EE.

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 at the bottom of 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 that is located to the right 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 at the bottom of the editor pane.

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 you want to configure, in the Port namespace link field.

    7. Type the local_name of the WSDL file port you 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.

 

Result

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

 

See also

ibm-webservicesclient-bnd.xmi assembly properties

 

Related Tasks

Developing Web services clients
Developing client bindings from a WSDL file
Configuring the client deployment descriptor
Starting an assembly tool

 

---