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

Developing Web services clients

This topic explains how to develop a Web services client based on the Web Services for Java 2 Platform, Enterprise Edition (J2EE) specification.

Before you begin

You need a Web Services Description Language (WSDL) file to use Web services. Before you begin this task, locate the WSDL file that defines the Web service that you want to access. You can locate the WSDL from the services provider through e-mail, through a Uniform Resource Locator (URL) or by looking it up in a Universal Description, Discovery and Integration (UDDI) registry.

Why and when to perform this task

For a Java application to act as a Web service client, a mapping between the Web Services Description Language (WSDL) file and the Java application must exist. The mapping is defined by the Java API for XML-based RPC (JAX-RPC) specification. You can use a Java component to implement a Web service by specifying the component interface and binding information in the WSDL file and designing the application server infrastructure to accept the service request. This entire process is based on the Web Services for J2EE specification. The JAX-RPC specification defines the mapping between a WSDL file, Java code and XML Schema types.

Create the client code and artifacts that enable the application client to access a Web service by following the steps provided:

Steps for this task

  1. Develop client bindings from a WSDL file. The client-side bindings and deployment descriptors are generated.
  2. Complete the client implementation.
  3. (Optional) Assemble a Web services-enabled client Java archive (JAR) file. Complete this step if you are developing a managed client that runs in the J2EE client container.
  4. (Optional) Assemble a Web services-enabled client Web archive (WAR) file. Complete this step if you are developing a managed client that runs in the J2EE client container.
  5. (Optional) Configure the client deployment descriptor. Complete this step if you are developing a managed client that runs in the J2EE client container.
  6. (Optional) Configure the ibm-webservicesclient-bnd.xmi deployment descriptor. Complete this step if you are deploying a managed client that runs in the J2EE client container and you want to override the default client settings. See ibm-webservicesclient-bnd.xmi assembly properties for more information about the ibm-webservicesclient-bnd.xmi deployment descriptor.
  7. Test the Web services-enabled client application. This task explains how to test an unmanaged client JAR file and an unmanaged client application.

Result

You have created and tested a Web services client application. For step-by-step information see Example: Developing Web services clients.

What to do next

After you develop a Web services application client, and the client is statically bound, the service endpoint used by the implementation is the one that is identified in the WSDL file that you used during the development process. During or after installation of the Web services application, you might want to change the service endpoint. You can change the endpoint with the administrative console or the wsadmin scripting tool.



Sub-topics
Example: Developing Web services clients
Developing client bindings from a WSDL file
Assembling a Web services-enabled client JAR file into an EAR file
Assembling a Web services-enabled client WAR file into an EAR file
Testing Web services-enabled clients

Related concepts
Web services

Related tasks
Implementing Web services applications
Developing Web services applications
Configuring the Web services client bindings in the ibm-webservicesclient-bnd.xmi deployment descriptor
Configuring the client deployment descriptor
Configuring the client deployment descriptor for handler classes with an assembly tool

Related reference
Artifacts used to develop Web services
ibm-webservices-bnd.xmi assembly properties

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_devwbsclient.html

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