+

Search Tips   |   Advanced Search

Develop 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 JAX-RPC web services developed using Web Services for Java EE technology.

Develop a WSDL file.

You need a WSDL file to use web services. We can develop our own WSDL file or get one from a web services provider through email, downloading, or through a URL. This documentation assumes we are creating our 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 JAX-RPC applications.

To develop the deployment descriptor templates from a WSDL file, we must obtain the web address of the WSDL file.

If the WSDL file is a local file and we are running on the Windows platform, the web address looks like this example: file:drive:\path\file_name.wsdl. If we are using the Linux or Unix platform, the Web address looks like this example: file:/path/file_name.wsdl. We 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.


Tasks

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 the generated files is displayed when the command runs.

The WSDL2Java command-line tool is not supported on the z/OS platform. This functionality is provided by the assembly tools provided with the z/OS version of the product. Read about the WSDL2Java command-line tool for Java API for XML-based Remote Procedure Call (JAX-RPC) applications to learn more about this tool.

We have deployment descriptor templates required to implement or use JAX-RPC web services.


Example

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

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: 
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

(iSeries) Now, we need to configure the deployment descriptors so that WebSphere Application Server can process the incoming web services. After configuring the deployment descriptors, assemble the web services application for deployment.

Now, we 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 configuring the deployment descriptors, 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.


Subtopics


Related:

  • Development and assembly tools
  • Implement web services applications with JAX-RPC
  • Implement web services applications from existing WSDL files with JAX-RPC
  • Developing a service endpoint interface from JavaBeans for JAX-RPC applications
  • Developing a WSDL file for JAX-RPC applications
  • Assembling web services applications
  • Configure the webservices.xml deployment descriptor for JAX-RPC web services
  • Configure the ibm-webservices-bnd.xmi deployment descriptor for JAX-RPC web services
  • Completing the JavaBeans implementation for JAX-RPC applications