+

Search Tips   |   Advanced Search

Develop JAX-RPC Web services deployment descriptor templates for a Java Beans 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 Web Services for Java EE technology. Develop a Web Services Description Language (WSDL) file.

we need a WSDL file to use Web services. We 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 we are creating the own.

Completing this task creates the deployment descriptors used to describe how to map the service implementation to a Java Beanscomponent for 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 we are running on the Windows platform, the Web address looks like this example: file:drive:\path\file_name.wsdl. If 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 Java Beans 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.

  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

we have deployment descriptor templates that are 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


 

Next steps

Now, we need to configure the webservices.xml deployment descriptor and configure the ibm-webservices-bnd.xmi deployment descriptor so that appserver 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 concepts


Assembly tools

 

Related tasks


Implement Web services applications with JAX-RPC
Implement Web services applications from existing WSDL files with JAX-RPC
Develop a service endpoint interface from Java Beans for JAX-RPC applications
Develop a WSDL file for JAX-RPC applications
Assemble Web services applications

 

Related


Completing the Java Beans implementation for JAX-RPC applications