WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Developing 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, you must 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. You 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 Enterprise JavaBeans (EJB) module.

  • -container web

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

Why and when to perform this task

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.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-bnd.xmi.
WSWS3282I: Info: Generating META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-ext.xmi.

What to do next

Complete the client implementation.

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



Related tasks
Developing Web services clients

Task topic    

Terms of Use | Feedback

Last updated: Mar 17, 2005 4:28:29 AM CST
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/twbs_devclientbindings.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)