Deployment descriptors are standard text files, formatted using XML and packaged in a Web services application. Deployment descriptors are required to deploy JAX-RPC Web services that are developed using the Web services for Java 2 Platform, Enterprise Edition (J2EE).
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 e-mail, downloading, or through a Uniform Resource Locator (URL). This documentation assumes you are creating your own.
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.
Develop deployment descriptor templates by running the designated command:
The following example uses a WSDL file named AddressBookJ2WB.wsdl:
WSDL2Java -verbose -role develop-server -container web -genJava no AddressBookJ2WB.wsdlThe 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 webservices.xml deployment descriptor and configure the ibm-webservices-bnd.xmi deployment descriptor 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.