Deployment descriptors are standard text files, formatted using XML and packaged in a Web services application. Deployment descriptors are required to deploy Web services that are developed using the Web services for Java 2 Platform, Enterprise Edition (J2EE).
Before you begin
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 e-mail, downloading, or through a Uniform Resource Locator (URL). This documentation assumes you are creating your own.
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 JavaBeans component.
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 Java API for XML-based remote procedure call (JAX-RPC) mapping file are generated in the WEB-INF subdirectory.
Develop deployment descriptor templates by running the designated command:
Step for this task
Result
You have deployment descriptor templates that are required to implement or use Web services.Example
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
What to do next
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.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 JavaBeans
technology
Developing a Web service from a Java bean
Related reference
WSDL2Java command