Configuring the ibm-webservices-bnd.xmi deployment descriptor

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

Before you begin

You must configure the assembly tool before you can use it.

Before you can configure the ibm-webservices-bnd.xml deployment descriptor, you must develop the deployment descriptor templates and complete the implementation.

About this task

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.

Then, complete the EJB implementation or complete the JavaBeans implementation. When the EJB implementation is complete, the enterprise bean Java archive (JAR) file is assembled. When the JavaBeans implementation is complete, the Web module Web archive (WAR) file is assembled. These archive files contain the webservices.xml deployment descriptor. The archive files must be assembled before you 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 and other assembly tools, provide a graphical interface for developing code artifacts, assembling the code artifacts into various archives (modules) and configuring related Java 2 Platform, Enterprise Edition (J2EE) Version 1.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 Java 2 Platform, Enterprise Edition (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.

Results

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




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 10:03:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-zos&topic=twbs_atkdd2
File name: twbs_atkdd2.html