Editing JAX-RPC web services

If you have created a web service or client that uses the WebSphere® JAX-RPC runtime environment, you can edit the deployment information for the service or client using the Web Services Editor.

About this task

If a web service or web service client has been created with the IBM® WebSphere runtime environments, deployment information is generated into the project. In case of a web service, webservices.xml is generated. In the case of a web service client, what is generated depends on the J2EE level of the project.
  • If the project has a J2EE level of 1.3, webservicesclient.xml will be generated.
  • If the project has a J2EE level of 1.4, modifications will be made to the existing deployment descriptor for that project. For example, in the case of a Web project, web service client deployment information will be added to web.xml. webservices.xml and webservicesclient.xml can be edited with the Web Services Editor, and the Web Services Client Editor respectively. You can also edit the settings contained in the binding (ibm-webservices-bnd.xmi and ibm-webservicesclient-bnd.xmi) and extensions (ibm-webservices-ext.xmi and ibm-webservicesclient-ext.xmi) files using the editor, by selecting the following pages within the editor as appropriate:
    • ibm-webservices-bnd.xmi: Bindings, Binding Configurations pages
    • ibm-webservicesclient-bnd.xmi: Web Services Client Binding, Port Binding pages
    • ibm-webservices-ext.xmi: Security Extensions page
    • ibm-webservicesclient-ext.xmi: Security Extensions page
    In the case of a web service client in a J2EE 1.4 project, the References and WS Handler pages of the editor for the project's existing deployment descriptor can be used. The extension and binding settings can be edited using the WS Extension and WS Binding pages respectively.

To edit the webservices.xml or webservicesclient.xml file:

Procedure

  1. In the Services view, right-click your service or client and select Show > Deployment Descriptor.
  2. Select the appropriate tab to edit:
    • For the service, choose from the following tabs:
      • web services page
      • Port Components page
      • Handlers page
      • Security: Extensions page
      • Bindings: Bindings page, Binding Configurations page
    • The web service client deployment descriptor will open the web.xml file, from which you can access the:
      • WebSphere Bindings descriptor (ibm-web-bnd.xml)
      • WebSphere Extensions descriptor (ibm-web-ext.xml)
      • WebSphere Programming Model Extensions descriptor (ibm-web-ext-pme.xml)

    Changes to the bindings and extensions tabs will be reflected in the bindings and extensions XMI files.

Results

Note: The Web Services Editor does not validate the changes you make.

Feedback