Develop Web services applications from enterprise beans

You can develop a Web service from an enterprise bean.

Overview

This task is one of four ways that you can develop a Web service. You can also develop a Web service from a Java bean, develop a Web service with an existing Web Services Description Language (WSDL) file using a Java bean, or develop a Web service with an existing WSDL file using an enterprise bean. In this task, you need develop a new WSDL file.

Enabling the enterprise bean for Web services includes developing the service endpoint interface, locating or developing a WSDL file that is the engine of the Web service, generating and configuring the deployment descriptors, completing the enterprise beans implementation, assembling all the artifacts required for the Web service, enabling the modules and deploying the application into the WebSphere Application Server environment.

To use an enterprise bean as the basis for a Web service implementation, follow these requirements:

• The enterprise bean must be a stateless session bean.

• Web service method parameters must be one of the supported Java API for XML-based remote procedure call (JAX-RPC) types.

These requirements are documented in the JAX-RPC specification available through Web services: Resources for learning.

Create the artifacts that enable the enterprise bean to be a Web service and assemble the artifacts into the enterprise application.

Procedure

1. Set up a development environment for Web services. You do not have to set up a development environment if you are using Rational Application Developer.

2. Access an existing Java archive (JAR) file to use as a Web service. Verify the enterprise bean meets the requirements.

3. Develop an Enterprise JavaBeans service endpoint interface. The service endpoint interface defines which enterprise bean methods should be made available as a Web service.

4. Develop a Web Services Description Language (WSDL) file. The WSDL file is the engine of a J2EE Web service; without it there is no Web service.

5. Develop Web services deployment descriptor templates from an Enterprise JavaBeans implementation. You need to complete this step to create the deployment descriptor templates that are configured to map the service implementation to the enterprise beans implementation.

6. Complete the enterprise beans implementation.

7. Configure the webservices.xml deployment descriptor. Configure the webservices.xml deployment descriptor so that WebSphere Application Server can process the incoming Web services requests.

8. Configure the ibm-webservices-bnd.xmi deployment descriptor. Configure the ibm-webservices-bnd.xml deployment descriptor so that WebSphere Application Server can process the incoming Web services requests.

9. Assemble a JAR file that is enabled for Web services from an enterprise bean. You can assemble the artifacts that are required to enable the enterprise beans module for Web services into a JAR file.

10. Assemble a Web services-enabled enterprise bean JAR file into an enterprise archive (EAR) file. You can assemble the artifacts that are required to enable the Web services-enabled JAR file into an EAR file.

11. Enable the EAR file. When the EAR file contains enterprise bean modules, it must have the Web services endpoint WAR file added with the endptEnabler tool before it is deployed.

12. Deploy the EAR file into WebSphere Application Server.

    This topic presents the steps necessary to deploy the EAR file that has been configured, assembled and enabled for Web services.

Results

What to do next

Related tasks

Related Reference