Configure the ibm-webservices-bnd.xmi deployment descriptor

This topic explains how to configure the ibm-webservices-bnd.xml deployment descriptor.

 

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. Before one can configure the ibm-webservices-bnd.xml deployment descriptor, develop the deployment descriptor templates and complete the implementation.

 

Overview

This task is one of the steps in developing a Web service. You need to configure the deployment descriptors so that WebSphere Application Server can process the incoming Web services requests.

Depending on if you are developing a Web service from a Java bean or an enterprise bean:

Then, complete the EJB implementation or complete the JavaBeans implementation. When the EJB implementation is complete, the enterprise bean JAR file is assembled. When the JavaBeans implementation is complete, the Web module WAR file is assembled. These archive files contain the webservices.xml deployment descriptor. The archive files must be assembled before one can configure the webservices.xml deployment descriptor.

Configure the webservices.xml deployment descriptor by following the steps provided in this task section.

 

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. Click File > Import to import the enterprise bean JAR file or WAR file into the assembly tool.

  3. Open the J2EE perspective by clicking Windows >Open Perspective > Other > J2EE.

  4. Switch to the Project Navigator pane by clicking the Project Navigator tab.

  5. Locate the project containing the ibm-webservices-bnd.xml file in the Project Navigator pane.

  6. Expand the directories under the project until the META-INF or the WEB-INF directory and its contents are displayed.

  7. Right-click the ibm-webservices-bnd.xml file.

  8. Select Open. The Web Services editor is open.

  9. Click the Bindings tab located at the bottom of the editor pane. The Web Services Bindings editor is open.

  10. Verify the wsdescNameLink element settings.

    1. Expand the Web services description bindings section. Verify that the value of the <webservice-description-name> element in the ibm-webservices-bnd.xml deployment descriptor is listed in the section. If the value is not listed:

    2. (Optional) Click Add, choose the correct Web services name and click OK. You do not need to complete this step if you have verified that the correct Web services name is listed in the Web Services Description Bindings tab.

  11. Verify the pcnameLink attribute settings.

    1. Expand the Web Service Description Bindings section. Verify that the correct service is selected. If the correct service is not listed:

    2. (Optional) Expand Port Component Binding. Verify that the correct Web services name is selected in the Web Service Description Bindings section.

      This selection is a prerequisite to creating a pcnameLink attribute.

    3. In the Port Component Binding section, click Add. Make a selection in the Web Service Description Bindings section before you create the port component binding in the Port Component Binding section. The Port Component Bindings Dialog is opened.

    4. Select a port from the list in the PC Name Link field.

    5. Click OK.

    6. Click the Binding Configurations tab to view the bindings for your port.

    7. Save the bindings file.

  12. Click File > Export to export the JAR file, or to continue with the configuration and assembly tasks.

  13. Click ctrl-s to save your changes.

 

Result

The ibm-webservices-bnd.xmi deployment descriptor is configured for the Web service implementation module.

 

What to do next

If you are developing a Web service from from a Java bean, assemble a WAR file that is enabled for Web services from Java code.

If you are developing a Web service from an enterprise bean, assemble a JAR file that is enabled for Web services from an enterprise bean. In this task you assemble the artifacts that are required to enable the EJB module for Web services into the JAR file.

 

See also


ibm-webservices-bnd.xmi assembly properties

 

Related Tasks


Starting an assembly tool
Configuring the webservices.xml deployment descriptor
Assembling a JAR file that is enabled for Web services from an enterprise bean
Assembling a Web services-enabled enterprise bean JAR file from a WSDL file
Assembling a WAR file that is enabled for Web services from Java code
Assembling a Web services-enabled WAR file from a WSDL file
Developing Web services deployment descriptor templates for a JavaBeans implementation
Developing Web services deployment descriptor templates for an EJB implementation