Developing JAX-RPC web services deployment descriptor templates for a JavaBeans implementation
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.
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 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.
About this task
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.
Procedure
Results
Example
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
What to do next
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.
Now, you need to configure the webservices.xml deployment descriptor and configure the ibm-webservices-bnd.xmi deployment descriptor so that application server can process the incoming web services. After you configure the deployment descriptors, you must assemble the web services application for deployment. See the information on configuring the webservices.xml deployment descriptor for JAX-RPC web services and configuring the ibm-webservices-bnd.xmi deployment descriptor for JAX-RPC web services.