[Version 5.0.2 and later]Developing Web services deployment descriptor templates for a Java bean implementation

Before you begin

Develop a WSDL file.

Why and when to perform this task

Completing this task creates the deployment descriptors used to describe how to map the service implementation to a JavaBean.

To develop the deployment descriptor templates from a Web Services Description Language (WSDL) file, you must 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 a Java bean in a Web 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 WEB-INF subdirectory.

To develop deployment descriptor templates:

Steps for this task

  1. Run the WSDL2Java -verbose -role develop-server -container web -genJava no wsdlURL command to generate the server deployment descriptor templates and mapping file into the WEB-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 or use a Web service.

Example

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

  1. Generate the template files:
    • WSDL2Java -verbose -role develop-server -container web -genJava no AddressBookJ2WB.wsdl
    The deployment descriptor templates and mapping file are generated into the WEB-INF subdirectory as follows:
    Parsing XML file: AddressBookJ2WB.wsdl
    Generating: WEB-INF\webservices.xml
    Generating: WEB-INF\ibm-webservices-bnd.xmi
    Generating: WEB-INF\ibm-webservices-ext.xmi
    Generating: WEB-INF\AddressBookJ2WB_mapping.xml
    
    

What to do next

Configure Web services deployment descriptors.

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 with an existing WSDL file using a Java bean
Developing a Web service from a Java bean
Related reference
WSDL2Java command



Searchable topic ID:   twbs_beandeploydescriptor
Last updated: Jun 21, 2007 4:55:42 PM CDT    WebSphere Application Server Network Deployment, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/twbs_beandeploydescriptor.html

Library | Support | Terms of Use | Feedback