Develop Web services deployment descriptor templates for an EJB implementation

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 enterprise Java bean (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.

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

 

Usage Scenario

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
    
    

 

See Also

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 using a stateless session enterprise bean
WSDL2Java command