Develop client bindings from a WSDL file

This topic explains how to develop client bindings from a Web Services Description (WSDL) file.

 

Before you begin

To develop the client bindings from a WSDL file, obtain the Uniform Resource Locator (URL) of the WSDL file to use. You need bindings and deployment descriptors in order for a client to use a Web service.

If it is a local file and you are running the Windows platform, the URL looks like the following example: file:drive:\path\file_name.wsdl. If you are using the Linux or UNIX platform, the URL looks like the following example: file:/path/file_name.wsdl. We can also specify local files using the absolute or relative file system path.

Client bindings are generated using the -role develop-client option in combination with the -container option of the WSDL2Java command. The -container option takes the following parameters:

  • -container client

    Generates bindings and deployment descriptors for a client residing in the application client container.

  • -container ejb

    Generates bindings and deployment descriptors for a client that is an enterprise bean in the EJB module.

  • -container web

    Generates bindings and deployment descriptors for a client residing in the Web container.

 

Overview

Develop client bindings from a WSDL file by running the appropriate command:

 

Step for this task

Run the WSDL2Java -verbose -role develop-client -container type wsdlURL command,

where type is ejb for an enterprise EJB client, web for a JavaBeans client, or client for an application client.

You can use the following combinations in the command-line:

  • -container web

  • -container ejb

  • -container client

Because the verbose option is specified, a list of all generated files is displayed when the command runs.

 

Result

You have the bindings and deployment descriptors needed by a client to use a Web service.

 

Example

The following example uses the AddressBook enterprise bean the AddressBook.wsdl WSDL

file. After generating the bindings from the WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl command, the following files are generated: 

Parsing XML file:  file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Parsing XML file:  AddressBook.wsdl
WSWS3282I: Info: Generating addr\Address.java.
WSWS3282I: Info: Generating addr\Phone.java.
WSWS3282I: Info: Generating addr\StateType.java.
WSWS3282I: Info: Generating addr\AddressBook.java.
WSWS3282I: Info: Generating addr\AddressBookService.java.

 

What to do next

Complete the client implementation. Assemble a Web services-enabled client JAR and EAR file.

 

Related Tasks


Developing Web services clients