Deploying a gateway service for proxy operation

Use this task to set the gateway to act purely as a proxy for your service, and use JAX-RPC handlers to set the endpoints for incoming request messages for the service.

 

Overview

 

Overview

For an overview of proxy operation, see JAX-RPC handlers and proxy operation. To deploy a gateway service for proxy operation, complete the following steps:

1. Create a JAX-RPC handler that sets the transport.url context property to set the target endpoint for the service.It is up to you to decide how you want to establish the target endpoint, and to create and configure the transport.url JAX-RPC handler. For information about creating JAX-RPC handlers, see the IBM developerWorks article A developer introduction to JAX-RPC, Part 2: Mine the JAX-RPC specification to improve Web service interoperability.

2. Deploy the new handler to the gateway.

3. Deploy the SOAP over HTTP channel (if not already deployed).Proxy operation is only supported by this channel.

4. Deploy your Web service. Ensure that you set the following parameters:

   1. Enable Selective SOAP parsing.

   2. Enable Operate in Proxy Mode.

   3. (Optional)   If you want to override the default proxy service template WSDL, then type the location of your replacement template WSDL file in the Proxy Service Template WSDL Override field.

   4. Select the SOAP over HTTP channel from the list of available channels.

   Note: Do not set any Target Service Properties.

5. List the Web services that are deployed to the Web services gateway, then complete the following steps to add the handler that sets the target endpoint for this service:

   1. Click the name of your service in the list. A form is displayed that you can use to view and modify the current deployment details.

   2. Scroll down to Channels, then click Edit JAX-RPC handler configuration.

   3. Select the handler that sets the target endpoint for this service, and add it to the handler chain.

 

What to do next

Ensure that all service requesters append an operationMode HTTP query string parameter to the Web address for the gateway service. The value of this parameter is either oneway or requestResponse. For example, if the Web address of the deployed proxy service is http://.../wsgwsoap/urn:wsgw::ProxyService, then requesting clients indicate that they are sending a one-way request by using the following URL:

http://.../wsgwsoap/urn:wsgw::ProxyService?operationMode=oneway

---

JAX-RPC handlers and proxy operation

Deploying Web services to the Web services gateway
Working with JAX-RPC handlers
    

 

---