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

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

Before you begin

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

You must configure the assembly tool before you can use it. Read about configuring the assembly tool in the Rational® Application Developer documentation.

About this task

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.
    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 that is located to the side of the Deployed WSDL file field.
    5. Select the new Web Services Description Language (WSDL) file.
    6. Click OK.
    You 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.
    You 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 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.

Results

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.