Developing JAX-RPC web services deployment descriptor templates for an enterprise bean implementation

You can develop deployment descriptor templates for an Enterprise JavaBeans (EJB) implementation that is enabled for Java API for XML-based RPC (JAX-RPC) web services.

Before you begin

You need to create a service endpoint interface and develop a Web Services Description Language (WSDL) file before you can develop the deployment descriptor templates because the service endpoint interface and the WSDL file are artifacts that are used to create the templates.

About this task

Completing this task creates deployment descriptor templates that describe how to map the service implementation to a Enterprise JavaBeans (EJB). This task is a required step in developing a web service from an enterprise bean.

To develop the deployment descriptor templates from a WSDL file, you must obtain the Uniform Resource Locator (URL) of the WSDL file to use.

[IBM i] If the WSDL file is a local file, the URL looks like this example: file:/path/file_name.wsdl.

You can also specify local files using the absolute or relative file system path.

When the web service implementation contains an enterprise bean in an EJB module, the webservices.xml, ibm-webservices-bnd.xmi and ibm-webservices-ext.xmi deployment descriptors, and the Java API for XML-based remote procedure call (JAX-RPC) mapping file are generated in the META-INF subdirectory.

Procedure

Run the WSDL2Java -verbose -role develop-server -container ejb -genJava no wsdlURL command to generate the server deployment descriptor templates and mapping file into the META-INF subdirectory. If the -verbose option is specified, a list of all generated files displays when the command runs.

Results

You have deployment descriptor templates that are required to implement a web service.

Example

The following example uses the AddressBookJ2WE.wsdl WSDL file:
  1. Generate the template files with the following command syntax:
    WSDL2Java -verbose -role develop-server -container ejb -genJava no AddressBookJ2WE.wsdl 
    The deployment descriptor templates are generated into the META-INF subdirectory as follows:
    Parsing XML file: AddressBookJ2WE.wsdl
    Generating: META-INF\webservices.xml
    Generating: META-INF\ibm-webservices-bnd.xmi
    Generating: META-INF\ibm-webservices-ext.xmi
    Generating: META-INF\AddressBookJ2WE_mapping.xml

What to do next

Continue to complete the steps that are necessary to develop a JAX-RPC web service from an enterprise bean. The next step is to complete the EJB implementation. When you complete the EJB implementation, you assemble an enterprise bean Java archive (JAR) file that contains the enterprise bean and supporting classes created from a WSDL file. To learn more, see the completing the EJB implementation for JAX-RPC applications information.
Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 10:32 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=twbs_ejbdeploydescriptor
File name: twbs_ejbdeploydescriptor.html