Develop Web services deployment descriptor templates for an EJB implementation

 

Overview

Develop a WSDL file.

 

Overview

Completing this task creates the deployment descriptors used to describe how to map the service implementation to an enterprise Java bean (EJB).

To develop the deployment descriptor templates from a Web Services Description Language (WSDL) file, obtain the Uniform Resource Locator (URL) of the WSDL file to use.

If it is a local file and you are running the Windows platform, the URL looks like this: file:drive:\path\file_name.wsdl. If you are using the UNIX platform, the URL looks like this: file:/path/file_name.wsdl. You can also specify local files using the absolute or relative file system path.

When the Web service implementation is an EJB 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.

To develop deployment descriptor templates:

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

Deployment descriptor templates that are required to implement a Web service.

 

Example

The following example uses a WSDL file named AddressBookJ2WE.wsdl:

  1. Generate the template files:

    • 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

Related tasks
Configuring Web services deployment descriptors
Configuring the webservices.xml deployment descriptor
Configuring the ibm-webservices-bnd.xmi deployment descriptor
Developing a new Web service from an existing WSDL file using a stateless session enterprise bean
Developing a Web service from an enterprise bean
Related reference
WSDL2Java command