org.mule.service.http.api.client

Class HttpClientConfiguration.Builder

java.lang.Object

org.mule.service.http.api.client.HttpClientConfiguration.Builder

Enclosing class:

HttpClientConfiguration

public static class HttpClientConfiguration.Builder
extends Object

Builder of HttpClientConfigurations. At the very least, a thread name prefix and an owner name must be provided.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
HttpClientConfiguration	build()
HttpClientConfiguration.Builder	setClientSocketProperties(TcpClientSocketProperties clientSocketProperties) Optionally defines TCP specific properties like the socket connection timeout, for example, via a TcpClientSocketProperties.
HttpClientConfiguration.Builder	setConnectionIdleTimeout(int connectionIdleTimeout) Defines the number of milliseconds that a connection can remain idle before being closed.
HttpClientConfiguration.Builder	setMaxConnections(int maxConnections) Defines the maximum number of outbound connections that will be kept open at the same time.
HttpClientConfiguration.Builder	setOwnerName(String ownerName) Defines the name of the HttpClient's owner.
HttpClientConfiguration.Builder	setProxyConfig(ProxyConfig proxyConfig) Required when connecting through a proxy, this defines the relevant data to do so using a ProxyConfig.
HttpClientConfiguration.Builder	setThreadNamePrefix(String threadNamePrefix) Defines the prefix to use to name the HttpClient's threads.
HttpClientConfiguration.Builder	setTlsContextFactory(org.mule.runtime.api.tls.TlsContextFactory tlsContextFactory) Required exclusively for HTTPS, this defines through a TlsContextFactory all the TLS related data to establish such connections.
HttpClientConfiguration.Builder	setUsePersistentConnections(boolean usePersistentConnections) Defines if connections should be kept after a request is completed or closed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

setTlsContextFactory

public HttpClientConfiguration.Builder setTlsContextFactory(org.mule.runtime.api.tls.TlsContextFactory tlsContextFactory)

Required exclusively for HTTPS, this defines through a TlsContextFactory all the TLS related data to establish such connections. Set to null by default.

Parameters:

tlsContextFactory - a TlsContextFactory with the required data.

Returns:

this builder

setProxyConfig

public HttpClientConfiguration.Builder setProxyConfig(ProxyConfig proxyConfig)

Required when connecting through a proxy, this defines the relevant data to do so using a ProxyConfig. Set to null by default.

Parameters:

proxyConfig - a ProxyConfig specifying the proxy data

Returns:

this builder

setClientSocketProperties

public HttpClientConfiguration.Builder setClientSocketProperties(TcpClientSocketProperties clientSocketProperties)

Optionally defines TCP specific properties like the socket connection timeout, for example, via a TcpClientSocketProperties. Set to null by default, transport default values will be used in that case.

Parameters:

clientSocketProperties - a TcpClientSocketProperties specifying each property

Returns:

this builder

setMaxConnections

public HttpClientConfiguration.Builder setMaxConnections(int maxConnections)

Defines the maximum number of outbound connections that will be kept open at the same time. Unlimited by default.

Parameters:

maxConnections - number of connections to allow

Returns:

this builder

setUsePersistentConnections

public HttpClientConfiguration.Builder setUsePersistentConnections(boolean usePersistentConnections)

Defines if connections should be kept after a request is completed or closed. Default value is true.

Parameters:

usePersistentConnections - boolean specifying the decision

Returns:

this builder

setConnectionIdleTimeout

public HttpClientConfiguration.Builder setConnectionIdleTimeout(int connectionIdleTimeout)

Defines the number of milliseconds that a connection can remain idle before being closed. Only relevant if persistent connections are used, the default value is 30 seconds.

Parameters:

connectionIdleTimeout - timeout value (in milliseconds)

Returns:

this builder

setThreadNamePrefix

public HttpClientConfiguration.Builder setThreadNamePrefix(String threadNamePrefix)

Defines the prefix to use to name the HttpClient's threads. Must be specified.

Parameters:

threadNamePrefix - a String representing the prefix

Returns:

this builder

setOwnerName

public HttpClientConfiguration.Builder setOwnerName(String ownerName)

Defines the name of the HttpClient's owner. Must be specified.

Parameters:

ownerName - a String with the name

Returns:

this builder

build

public HttpClientConfiguration build()

Returns:

an HttpClientConfiguration as specified.