Configure additional HTTP transport properties using the JVM custom property panel in the administrative console
We can configure additional HTTP transport properties for JAX-WS and JAX-RPC Web services with the JVM custom properties panel in the administrative console.
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:
- Configure the properties with an assembly tool
- 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 a complete list of the supported standards and specifications, see the web services specifications and API documentation.
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
This property is for JAX-RPC only, and it will not be used if it is enabled for services based on JAX-WS.
- 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.
Tasks
- Open the administrative console.
- Click Servers > Application Servers > server > Java and Process Management > Process Definition > Java Virtual Machine > Custom Properties.
- Optional: If the property is not listed, create a new property name.
- Enter the name and value.
- Optional: Accept the redirection of the HTTP request to a different URI in HTTPS.
A redirection of the HTTP request to a different URI in HTTPS can occur if the transport guarantee of CONFIDENTIAL or INTEGRAL is configured in the application. To accept the redirection, we can do either of the following tasks:
- Set the com.ibm.ws.webservices.HttpRedirectEnabled Java system property to true.
- Programmatically set the com.ibm.wsspi.webservices.Constants.HTTP_REDIRECT_ENABLED property to a java.lang.Boolean object in the Stub or Call object before invoking the service. For example, use any of the following java.lang.Boolean values to set the property to true:
- Boolean.TRUE
- new Boolean(true)
- new Boolean("true")
We have configured HTTP transport properties for a web services application.
Secure web services applications at the transport level Configure additional HTTP transport properties for JAX-RPC web services with an assembly tool Configure additional HTTP transport properties using the wsadmin command-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