Enabling HTTP conduit client properties and user custom properties
You can define the HTTP client properties and user custom properties by using the ibm-ws-bnd.xml file for JAX-WS applications on Liberty.
Before you begin
The ibm-ws-bnd.xml file must be in the /WEB-INF directory of a web-based web services application (WAR file), or in the /META-INF directory of a EJB-based web service application (JAR file). If the client is running in clientContainer, the ibm-ws-bnd.xml file must be in the /META-INF directory of the JAR file in the client EAR.
About this task
HTTP client properties and user custom properties can
be defined by using the service-ref and port elements in the ibm-ws-bnd.xml file for the
specific service client or port that is injected by the @WebServiceRef annotation. Properties in the port element override
the same properties in the service-ref element.
- HTTP client properties
- The following HTTP client properties are supported in Liberty; these properties must have the prefix
http.conduit.client.. For example:
http.conduit.client.ConnectionTimeout. These HTTP client properties are valid
only when sending or receiving SOAP messages, and they are not applicable when connecting to a WSDL URL.
- ConnectionTimeout
- ReceiveTimeout
- AsyncExecuteTimeout
- AsyncExecuteTimeoutRejection
- AutoRedirect
- MaxRetransmits
- AllowChunking
- ChunkingThreshold
- Connection
- DecoupledEndpoint
- ProxyServer
- ProxyServerPort
- ProxyServerType
- NonProxyHosts
- For more information about these properties, see HTTP configuration schema in Apache CXF and Client HTTP Transport (including SSL support) .
- User Custom Properties
- Besides the supported HTTP client properties in Liberty, you can define the user custom properties that might be used in your application, and retrieve these properties from the client request context. All attributes defined in the properties element will be put into the service client request context.
For all available elements that you can configure within the ibm-ws-bnd.xml file, see Liberty: The ibm-ws-bnd.xml file.