Configuring Web service client bindings

When a Web service application is deployed into WebSphere Application Server, an instance is created for each application or module. The instance contains deployment information for the Web module or enterprise JavaBeans (EJB) module, including client bindings.

Before you begin

New or updated for this feature pack Important: The WebSphere® Application Server Version 6.1 Feature Pack for Web Services extends the capabilities of this product to introduce support for the Java API for XML-Based Web Services (JAX-WS) 2.0 programming model. JAX-WS is the next generation Web services programming model complimenting the foundation provided by the Java API for XML-based RPC (JAX-RPC) programming model. Using the strategic JAX-WS programming model, development of Web services and clients is simplified through support of a standards-based annotations model. Although the JAX-RPC programming model and applications are still supported, take advantage of the easy-to-implement JAX-WS programming model to develop new Web services applications and clients.
Supported configurations New or updated for this feature pack Supported configurations: The Feature Pack for Web Services does not support Java Message Service (JMS) transports or enterprise beans. This product only supports an HTTP transport and hosting JavaBeans endpoints within the Web container for JAX-WS Web services applications. To develop enterprise beans hosted as Web services, you must use the JAX-RPC programming model. This product does allow JAX-WS clients to issue requests from any of the Java Platform, Enterprise Edition (Java EE) containers along with the client Java 2 Standard Edition (J2SE) environment.sptcfg

Deploy a JAX-RPC Web service into your WebSphere Application Server instance. Read about deploying Web services applications onto application servers.

About this task

The client bindings define the Web Services Description Language (WSDL) file name and preferred ports. The relative path of a Web service in a module is specified within a compatible WSDL file that contains the actual URL to be used for requests. The address is only needed if the original WSDL file did not contain a URL, or when a different address is needed. For a service endpoint with multiple ports, you need to define an alternative WSDL file name.

The following steps describe how to edit bindings for a Web service after these bindings are deployed on a server. When one Web service communicates with another Web service, you must configure the client bindings to access the downstream Web service.

[AIX HP-UX Linux Solaris Windows] [z/OS] You can also configure client bindings with wsadmin.

To configure client bindings through the administrative console:

Procedure

  1. Open the administrative console.
  2. Click Applications > Enterprise Applications > application_instance > Manage Modules > module_instance > Web services client bindings.
  3. Find the Web service you want to update.

    The Web services are listed in the Web Service field.

  4. Select the WSDL file name from the drop down box in the WSDL file name field.
  5. Click Edit in the Preferred port mappings field to configure the default port to use.
    1. Specify the port type and the preferred ports in the Port type and Preferred ports fields.

      Configuring the preferred port enables you to select an optimal port implementation use non-SOAP protocols. See RMI-IIOP Web services using JAX-RPC for more information about using non-SOAP protocols.

    2. Click Apply and OK.
  6. Click Edit in the Port information field to configure the request timeout, the overridden endpoint, and the overridden binding namespace for a port.

    Configuring the request timeout accommodates complex topologies that can have multiple cascaded Web services that involve multiple hops or long-running services.

    Timeout values can be configured based on observed behavior of the overall system as integration proceeds. For example, a Web service client might time out because of changing network conditions or the performance of an external Web service. When you have applications containing Web services clients that timeout, you can change the request time out values for the clients.

    1. Click Apply and OK.

Results

Your Web service client bindings are configured.

What to do next

Now you can finish any other configurations, start or restart the application, and verify the expected behavior of the Web service.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=twbs_clientbindings
File name: twbs_clientbindings.html