Example: Developing and deploying a JAX-RPC Web service from an existing application

You can develop a JAX-RPC Web service from an Enterprise JavaBeans (EJB) or JavaBeans implementation. The development process is based on the Web Services for Java Platform, Enterprise Edition (Java EE) specification.

  1. Select the enterprise bean or JavaBeans implementation that you want to enable as a JAX-RPC Web service.
    The implementation must meet the following Web Services for Java EE specification requirements:
    • It must have methods that can be mapped to a service endpoint interface. See step 2 for more information.
    • It must be a stateless session EJB implementation or a JavaBeans implementation without client-specific state, because the implementation bean might be selected to process a request from any client. If a client-specific state is required, a client identifier must be passed as a parameter of the Web services operation.

      The selected methods of an enterprise bean must not have a transaction attribute of mandatory, because no standard currently exists, for these Web services transactions.

      A JavaBeans implementation in a Web container requires the following contents:
      • A public default constructor
      • Exposed public methods
      • It must not save a client-specific state between method calls
      • It must be a public, non-final, and non-abstract class
      • It must not define a finalize method
  2. Develop a service endpoint interface.

    Developing a Web service requires a service endpoint interface.

    If you are using an EJB implementation, develop a service endpoint interface from an EJB remote interface.

    If you are using a JavaBeans implementation, develop a service endpoint interface for a JavaBeans implementation.

  3. Develop a Web Services Description Language (WSDL) file.
  4. Develop deployment descriptor templates.

    If you are using an EJB implementation, develop Web services deployment descriptor templates from an EJB implementation.

    If you are using a JavaBeans implementation, develop Web services deployment descriptor templates for a JavaBeans implementation.

  5. Configure the deployment descriptors.

    By setting the ejb-link or servlet-link values of the service-impl-bean elements you can link to the enterprise bean or JavaBeans implementation that implement the service.

    Configure the webservices.xml deployment descriptor.

    Configure the ibm-webservices-bnd.xmi deployment descriptor.

  6. Assemble an enterprise archive (EAR) file from a JAR file or assemble an EAR file from a WAR file.
  7. Enable the Web service-enabled EAR file.

    This step only applies if you are using an EJB implementation.

  8. Deploy the Web service application.
  9. Publish the WSDL file.

For a complete list of the supported standards and specifications, see the Web services specifications and API documentation.

Web services development process based on Web Services for J2EE




Related tasks
Implementing Web services applications with JAX-RPC
Related reference
Web services specifications and APIs
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=rwbs_devxmp
File name: rwbs_devxmp.html