Configure additional HTTP transport properties for JAX-RPC web services with an assembly tool
We can configure additional HTTP transport properties for JAX-RPC web services with an assembly tool. The assembly tool is used to configure the ibm-webservicesclient-bnd.xmi deployment descriptor binding file.
We can configure additional HTTP transport properties with assembly tools provided with WebSphere Application Server.
This task is one of three ways that we can configure additional HTTP transport properties for a web service acting as a client to another web service. We can also configure the additional HTTP transport properties in the following ways:
- Configuring additional HTTP transport properties using the JVM custom property panel in the administrative console
- Configure the properties using the wsadmin command-line tool.
To programmatically configure the properties using the Java API XML-based Remote Procedure Call (JAX-RPC) programming model or the JAX-WS programming model, review the JAX-RPC or JAX-WS specifications.
For more information about the following HTTP properties that we can configure, read about HTTP custom properties for web services applications:
- com.ibm.websphere.webservices.http.requestContentEncoding
- com.ibm.websphere.webservices.http.responseContentEncoding
Avoid trouble: This property is for JAX-RPC only, and it will not be used if it is enabled for services based on JAX-WS.gotcha
- com.ibm.websphere.webservices.http.connectionKeepAlive
- com.ibm.websphere.webservices.http.requestResendEnabled
- com.ibm.websphere.webservices.http.SocketTimeout
- com.ibm.ws.webservices.enableHTTPPrefix
- http.proxyHost
- http.proxyPort
- https.proxyHost
- https.proxyPort
- http.nonProxyHosts - We can only configure this property as a JVM custom property. This property applies for both HTTP and HTTPS connections.
These additional properties are configured for web services applications that use the HTTP protocol. The properties affect the content encoding of the message in the HTTP request, the HTTP response, the HTTP connection persistence and the behavior of an HTTP request that is resent after a java.net.ConnectException error occurs when there is a read time-out.
Configure the additional HTTP properties with an assembly tool with the following steps provided in this task section:
- Start an assembly tool. Read about starting the assembly tool in the Rational Application Developer documentation.
- If we have not done so already, configure the assembly tool so that it works on Java EE modules. You need to verify the Java EE and Web categories are enabled. Read about configuring the assembly tool in the Rational Application Developer documentation.
- Migrate the WAR files created with the Assembly Toolkit, Application Assembly Tool (AAT) or a different tool to the Rational Application Developer assembly tool. To migrate files, import the WAR files to the assembly tool. Read about migrating code artifacts to an assembly tool in the Rational Application Developer documentation.
- Configure the additional HTTP transport properties. Create and specify the name/value pair in the Web Services Client Port Binding page for a web service client. The Web Services Client Port Binding page is available after double-clicking the client deployment descriptor file. Read about configuring HTTP transport properties in the Rational Application Developer documentation.
Results
You have configured additional HTTP transport properties for a web services application.
Related concepts
Development and assembly tools
Related tasks
Secure web services applications at the transport level Configure additional HTTP transport properties using the JVM custom property panel in the administrative console Configure additional HTTP transport properties using wsadmin-line tool Configure a web services client to access resources using a web proxy
HTTP transport custom properties for web services applications Java virtual machine custom properties Web services specifications and APIs