Deployment descriptors are standard text files, formatted using XML and packaged in a web services application. Deployment descriptors are required to deploy Java API for XML-based RPC (JAX-RPC) web services that are developed using Web Services for Java Platform, Enterprise Edition (Java EE) technology.
Develop a Web Services Description Language (WSDL) file.
You need a WSDL file to use web services. You can develop your own WSDL file or get one from a web services provider through email, downloading, or through a Uniform Resource Locator (URL). This documentation assumes you are creating your own. See the developing a WSDL file for JAX-RPC applications information.
Completing this task creates the deployment descriptors used to describe how to map the service implementation to a JavaBeans component for Java API for XML-based RPC (JAX-RPC) applications.
To develop the deployment descriptor templates from a WSDL file, you must obtain the web address of the WSDL file.
If the WSDL file is a local file and you are running on the Windows platform, the web address looks like this example: file:drive:\path\file_name.wsdl. If you are using the Linux or Unix platform, the Web address 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 is a JavaBeans implementation in a web module, the webservices.xml,ibm-webservices-bnd.xmi and ibm-webservices.ext.xmi deployment descriptors and the JAX-RPC mapping file are generated in the WEB-INF subdirectory.
The following example uses a WSDL file named AddressBookJ2WB.wsdl:
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: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
Now, you need to configure the deployment
descriptors so that WebSphere® Application Server
can process the incoming web services. After you configure the deployment
descriptors, you must assemble the web services application for deployment.