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 that are developed using the Web services for J2EE. Develop a Web Services Description Language (WSDL) file.

We 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 URL. This documentation assumes you are creating your own.

 

Overview

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

 

Procedure

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.

 

Results

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

Now, we need to configure the webservices.xml deployment descriptor and configure the ibm-webservices-bnd.xmi deployment descriptor so that WAS can process the incoming Web services. After you configure the deployment descriptors, assemble the Web services application for deployment.

---

WSDL2Java command for JAX-RPC applications

 

Related tasks

Configure the webservices.xml deployment descriptor
Configure the ibm-webservices-bnd.xmi deployment descriptor
Developing Web services applications from existing WSDL files with JavaBeans
Developing Web services applications from JavaBeans