HttpClientConfiguration (javadoc 2.0.3 API)

java.lang.Object
- io.micronaut.http.client.HttpClientConfiguration

Direct Known Subclasses:

BraveTracerConfiguration.HttpClientSenderConfiguration, DefaultHttpClientConfiguration, ServiceHttpClientConfiguration
```
public abstract class HttpClientConfiguration
extends java.lang.Object
```
Configuration for the HttpClient.

Since:

1.0

Author:

Graeme Rocher

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class HttpClientConfiguration.ConnectionPoolConfiguration
Configuration for the HTTP client connnection pool.

Nested Classes
Modifier and Type	Class and Description
`static class`	`HttpClientConfiguration.ConnectionPoolConfiguration` Configuration for the HTTP client connnection pool.

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`DEFAULT_EXCEPTION_ON_ERROR_STATUS` The default value.
`static boolean`	`DEFAULT_FOLLOW_REDIRECTS` The default follow redirects value.
`static int`	`DEFAULT_MAX_CONTENT_LENGTH` The default max content length in bytes.
`static long`	`DEFAULT_READ_IDLE_TIMEOUT_MINUTES` The default read idle timeout in minutes.
`static long`	`DEFAULT_READ_TIMEOUT_SECONDS` The default read timeout in seconds.
`static long`	`DEFAULT_SHUTDOWN_TIMEOUT_MILLISECONDS` The default shutdown timeout in millis.

Constructor Summary

Constructors
Constructor and Description
`HttpClientConfiguration()` Default constructor.
`HttpClientConfiguration(ApplicationConfiguration applicationConfiguration)`
`HttpClientConfiguration(HttpClientConfiguration copy)` Copy constructor.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`java.util.Map<java.lang.String,java.lang.Object>`	`getChannelOptions()`
`abstract HttpClientConfiguration.ConnectionPoolConfiguration`	`getConnectionPoolConfiguration()` Obtains the connection pool configuration.
`java.util.Optional<java.time.Duration>`	`getConnectTimeout()`
`java.util.Optional<java.time.Duration>`	`getConnectTtl()`
`java.nio.charset.Charset`	`getDefaultCharset()`
`java.lang.String`	`getEventLoopGroup()`
`HttpVersion`	`getHttpVersion()` The HTTP version to use.
`java.util.Optional<java.lang.String>`	`getLoggerName()`
`java.util.Optional<LogLevel>`	`getLogLevel()`
`int`	`getMaxContentLength()`
`java.util.OptionalInt`	`getNumOfThreads()`
`java.util.Optional<java.net.SocketAddress>`	`getProxyAddress()` The proxy to use.
`java.util.Optional<java.lang.String>`	`getProxyPassword()`
`java.util.Optional<java.net.ProxySelector>`	`getProxySelector()`
`java.net.Proxy.Type`	`getProxyType()` The proxy to use.
`java.util.Optional<java.lang.String>`	`getProxyUsername()`
`java.util.Optional<java.time.Duration>`	`getReadIdleTimeout()` For streaming requests and WebSockets, the `getReadTimeout()` method does not apply instead a configurable idle timeout is applied.
`java.util.Optional<java.time.Duration>`	`getReadTimeout()`
`java.util.Optional<java.time.Duration>`	`getShutdownTimeout()` The amount of time to wait for shutdown.
`SslConfiguration`	`getSslConfiguration()`
`java.util.Optional<java.lang.Class<? extends java.util.concurrent.ThreadFactory>>`	`getThreadFactory()`
`boolean`	`isExceptionOnErrorStatus()`
`boolean`	`isFollowRedirects()`
`java.net.Proxy`	`resolveProxy(boolean isSsl, java.lang.String host, int port)` Resolves a proxy to use for connection.
`void`	`setChannelOptions(java.util.Map<java.lang.String,java.lang.Object> channelOptions)`
`void`	`setConnectTimeout(java.time.Duration connectTimeout)` Sets the connect timeout.
`void`	`setConnectTtl(java.time.Duration connectTtl)` Sets the connect timeout.
`void`	`setDefaultCharset(java.nio.charset.Charset defaultCharset)` Sets the default charset to use.
`void`	`setEventLoopGroup(java.lang.String eventLoopGroup)`
`void`	`setExceptionOnErrorStatus(boolean exceptionOnErrorStatus)` Sets whether throwing an exception upon HTTP error status (>= 400) is preferred.
`void`	`setFollowRedirects(boolean followRedirects)` Sets whether redirects should be followed.
`void`	`setHttpVersion(HttpVersion httpVersion)` Sets the HTTP version to use.
`void`	`setLoggerName(java.lang.String loggerName)` Sets the client-specific logger name.
`void`	`setLogLevel(LogLevel logLevel)` Sets the level to enable trace logging at.
`void`	`setMaxContentLength(int maxContentLength)` Sets the maximum content length the client can consume.
`void`	`setNumOfThreads(java.lang.Integer numOfThreads)` Sets the number of threads the client should use for requests.
`void`	`setProxyAddress(java.net.SocketAddress proxyAddress)` Sets a proxy address.
`void`	`setProxyPassword(java.lang.String proxyPassword)` Sets the proxy password.
`void`	`setProxySelector(java.net.ProxySelector proxySelector)` Sets the proxy selector.
`void`	`setProxyType(java.net.Proxy.Type proxyType)`
`void`	`setProxyUsername(java.lang.String proxyUsername)` Sets the proxy user name to use.
`void`	`setReadIdleTimeout(java.time.Duration readIdleTimeout)` Sets the max read idle time for streaming requests.
`void`	`setReadTimeout(java.time.Duration readTimeout)` Sets the read timeout.
`void`	`setShutdownTimeout(java.time.Duration shutdownTimeout)` Sets the amount of time to wait for shutdown of client thread pools.
`void`	`setSslConfiguration(SslConfiguration sslConfiguration)` Sets the SSL configuration for the client.
`void`	`setThreadFactory(java.lang.Class<? extends java.util.concurrent.ThreadFactory> threadFactory)` Sets a thread factory.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_READ_TIMEOUT_SECONDS
```
public static final long DEFAULT_READ_TIMEOUT_SECONDS
```
    The default read timeout in seconds.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_READ_IDLE_TIMEOUT_MINUTES
```
public static final long DEFAULT_READ_IDLE_TIMEOUT_MINUTES
```
    The default read idle timeout in minutes.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_SHUTDOWN_TIMEOUT_MILLISECONDS
```
public static final long DEFAULT_SHUTDOWN_TIMEOUT_MILLISECONDS
```
    The default shutdown timeout in millis.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_MAX_CONTENT_LENGTH
```
public static final int DEFAULT_MAX_CONTENT_LENGTH
```
    The default max content length in bytes.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_FOLLOW_REDIRECTS
```
public static final boolean DEFAULT_FOLLOW_REDIRECTS
```
    The default follow redirects value.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_EXCEPTION_ON_ERROR_STATUS
```
public static final boolean DEFAULT_EXCEPTION_ON_ERROR_STATUS
```
    The default value.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - HttpClientConfiguration
```
public HttpClientConfiguration()
```
    Default constructor.
  - HttpClientConfiguration
```
public HttpClientConfiguration(ApplicationConfiguration applicationConfiguration)
```
    Parameters:
    
    applicationConfiguration - The application configuration
  - HttpClientConfiguration
```
public HttpClientConfiguration(HttpClientConfiguration copy)
```
    Copy constructor.
    
    Parameters:
    
    copy - The client configuration to copy settings from
- Method Detail
  - getHttpVersion
```
public HttpVersion getHttpVersion()
```
    The HTTP version to use. Defaults to HttpVersion.HTTP_1_1.
    
    Returns:
    
    The http version
  - setHttpVersion
```
public void setHttpVersion(HttpVersion httpVersion)
```
    Sets the HTTP version to use. Defaults to HttpVersion.HTTP_1_1.
    
    Parameters:
    
    httpVersion - The http version
  - getLogLevel
```
public java.util.Optional<LogLevel> getLogLevel()
```
    Returns:
    
    The trace logging level
  - setLogLevel
```
public void setLogLevel(@Nullable
                        LogLevel logLevel)
```
    Sets the level to enable trace logging at. Depending on the implementation this may activate additional handlers. For example in Netty this will activate LoggingHandler at the given level.
    
    Parameters:
    
    logLevel - The trace logging level
  - getEventLoopGroup
```
public java.lang.String getEventLoopGroup()
```
    Returns:
    
    The event loop group to use.
  - setEventLoopGroup
```
public void setEventLoopGroup(@NonNull
                              java.lang.String eventLoopGroup)
```
    Parameters:
    
    eventLoopGroup - Sets the event loop group to use for the client.
  - getConnectionPoolConfiguration
```
public abstract HttpClientConfiguration.ConnectionPoolConfiguration getConnectionPoolConfiguration()
```
    Obtains the connection pool configuration.
    
    Returns:
    
    The connection pool configuration.
  - getSslConfiguration
```
public SslConfiguration getSslConfiguration()
```
    Returns:
    
    The SslConfiguration for the client
  - setSslConfiguration
```
public void setSslConfiguration(SslConfiguration sslConfiguration)
```
    Sets the SSL configuration for the client.
    
    Parameters:
    
    sslConfiguration - The SSL configuration
  - isFollowRedirects
```
public boolean isFollowRedirects()
```
    Returns:
    
    Whether redirects should be followed
  - isExceptionOnErrorStatus
```
public boolean isExceptionOnErrorStatus()
```
    Returns:
    
    Whether throwing an exception upon HTTP error status (>= 400) is preferred.
  - setExceptionOnErrorStatus
```
public void setExceptionOnErrorStatus(boolean exceptionOnErrorStatus)
```
    Sets whether throwing an exception upon HTTP error status (>= 400) is preferred. Default value (DEFAULT_EXCEPTION_ON_ERROR_STATUS)
    
    Parameters:
    
    exceptionOnErrorStatus - Whether
  - getLoggerName
```
public java.util.Optional<java.lang.String> getLoggerName()
```
    Returns:
    
    The client-specific logger name if configured
  - setLoggerName
```
public void setLoggerName(@Nullable
                          java.lang.String loggerName)
```
    Sets the client-specific logger name.
    
    Parameters:
    
    loggerName - The name of the logger.
  - setFollowRedirects
```
public void setFollowRedirects(boolean followRedirects)
```
    Sets whether redirects should be followed. Default value (DEFAULT_FOLLOW_REDIRECTS).
    
    Parameters:
    
    followRedirects - Whether redirects should be followed
  - getDefaultCharset
```
public java.nio.charset.Charset getDefaultCharset()
```
    Returns:
    
    The default charset to use
  - setDefaultCharset
```
public void setDefaultCharset(java.nio.charset.Charset defaultCharset)
```
    Sets the default charset to use. Default value (UTF-8);
    
    Parameters:
    
    defaultCharset - The charset to use
  - getChannelOptions
```
public java.util.Map<java.lang.String,java.lang.Object> getChannelOptions()
```
    Returns:
    
    The Client channel options.
  - setChannelOptions
```
public void setChannelOptions(java.util.Map<java.lang.String,java.lang.Object> channelOptions)
```
    Parameters:
    
    channelOptions - The Client channel options
  - getReadTimeout
```
public java.util.Optional<java.time.Duration> getReadTimeout()
```
    Returns:
    
    The default read timeout. Defaults to 10 seconds.
  - getReadIdleTimeout
```
public java.util.Optional<java.time.Duration> getReadIdleTimeout()
```
    For streaming requests and WebSockets, the getReadTimeout() method does not apply instead a configurable idle timeout is applied.
    
    Returns:
    
    The default amount of time to allow read operation connections to remain idle
  - getConnectTimeout
```
public java.util.Optional<java.time.Duration> getConnectTimeout()
```
    Returns:
    
    The default connect timeout. Defaults to Netty default.
  - getConnectTtl
```
public java.util.Optional<java.time.Duration> getConnectTtl()
```
    Returns:
    
    The connectTtl.
  - getShutdownTimeout
```
public java.util.Optional<java.time.Duration> getShutdownTimeout()
```
    The amount of time to wait for shutdown.
    
    Returns:
    
    The shutdown timeout
  - setShutdownTimeout
```
public void setShutdownTimeout(@Nullable
                               java.time.Duration shutdownTimeout)
```
    Sets the amount of time to wait for shutdown of client thread pools. Default value (100L milliseconds).
    
    Parameters:
    
    shutdownTimeout - The shutdown time
  - setReadTimeout
```
public void setReadTimeout(@Nullable
                           java.time.Duration readTimeout)
```
    Sets the read timeout. Default value (10L seconds).
    
    Parameters:
    
    readTimeout - The read timeout
  - setReadIdleTimeout
```
public void setReadIdleTimeout(@Nullable
                               java.time.Duration readIdleTimeout)
```
    Sets the max read idle time for streaming requests. Default value (5L seconds).
    
    Parameters:
    
    readIdleTimeout - The read idle time
  - setConnectTimeout
```
public void setConnectTimeout(@Nullable
                              java.time.Duration connectTimeout)
```
    Sets the connect timeout.
    
    Parameters:
    
    connectTimeout - The connect timeout
  - setConnectTtl
```
public void setConnectTtl(@Nullable
                          java.time.Duration connectTtl)
```
    Sets the connect timeout.
    
    Parameters:
    
    connectTtl - The connect timeout
  - getNumOfThreads
```
public java.util.OptionalInt getNumOfThreads()
```
    Returns:
    
    The number of threads the client should use for requests
  - setNumOfThreads
```
public void setNumOfThreads(@Nullable
                            java.lang.Integer numOfThreads)
```
    Sets the number of threads the client should use for requests.
    
    Parameters:
    
    numOfThreads - The number of threads the client should use for requests
  - getThreadFactory
```
public java.util.Optional<java.lang.Class<? extends java.util.concurrent.ThreadFactory>> getThreadFactory()
```
    Returns:
    
    An Optional ThreadFactory
  - setThreadFactory
```
public void setThreadFactory(java.lang.Class<? extends java.util.concurrent.ThreadFactory> threadFactory)
```
    Sets a thread factory.
    
    Parameters:
    
    threadFactory - The thread factory
  - getMaxContentLength
```
public int getMaxContentLength()
```
    Returns:
    
    The maximum content length the client can consume
  - setMaxContentLength
```
public void setMaxContentLength(@ReadableBytes
                                int maxContentLength)
```
    Sets the maximum content length the client can consume. Default value (10485760 => 10MB).
    
    Parameters:
    
    maxContentLength - The maximum content length the client can consume
  - getProxyType
```
public java.net.Proxy.Type getProxyType()
```
    The proxy to use. For authentication specify http.proxyUser and http.proxyPassword system properties.
    Alternatively configure a java.net.ProxySelector
    
    Returns:
    
    The proxy type
  - setProxyType
```
public void setProxyType(java.net.Proxy.Type proxyType)
```
    Parameters:
    
    proxyType - The proxy type
  - getProxyAddress
```
public java.util.Optional<java.net.SocketAddress> getProxyAddress()
```
    The proxy to use. For authentication specify http.proxyUser and http.proxyPassword system properties.
    Alternatively configure a java.net.ProxySelector
    
    Returns:
    
    The optional proxy address
  - setProxyAddress
```
public void setProxyAddress(java.net.SocketAddress proxyAddress)
```
    Sets a proxy address.
    
    Parameters:
    
    proxyAddress - The proxy address
  - getProxyUsername
```
public java.util.Optional<java.lang.String> getProxyUsername()
```
    Returns:
    
    The proxy user name to use
  - setProxyUsername
```
public void setProxyUsername(java.lang.String proxyUsername)
```
    Sets the proxy user name to use.
    
    Parameters:
    
    proxyUsername - The proxy user name to use
  - getProxyPassword
```
public java.util.Optional<java.lang.String> getProxyPassword()
```
    Returns:
    
    The proxy password to use.
  - setProxyPassword
```
public void setProxyPassword(java.lang.String proxyPassword)
```
    Sets the proxy password.
    
    Parameters:
    
    proxyPassword - The proxy password
  - setProxySelector
```
public void setProxySelector(java.net.ProxySelector proxySelector)
```
    Sets the proxy selector. ProxySelector decides what proxy to use and take precedence over setProxyAddress(SocketAddress) and setProxyType(Proxy.Type).
    
    Parameters:
    
    proxySelector - The proxy selector to use
  - getProxySelector
```
public java.util.Optional<java.net.ProxySelector> getProxySelector()
```
    Returns:
    
    The proxy selector provided
  - resolveProxy
```
public java.net.Proxy resolveProxy(boolean isSsl,
                                   java.lang.String host,
                                   int port)
```
    Resolves a proxy to use for connection.
    If ProxySelector is set by setProxySelector(ProxySelector) then it constructs URI and pass it to ProxySelector.select(URI). First proxy returned by proxy selector will be used. If no proxy is returned by select, then Proxy.NO_PROXY will be used.
    If ProxySelector is not set then parameters are ignored and a proxy as defined by setProxyAddress(SocketAddress) and setProxyType(Proxy.Type) will be returned. If no proxy is defined then parameters are ignored and Proxy.NO_PROXY is returned.
    
    Parameters:
    
    isSsl - is it http or https connection
    
    host - connection host
    
    port - connection port
    
    Returns:
    
    A non null proxy instance

Class HttpClientConfiguration

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_READ_TIMEOUT_SECONDS

DEFAULT_READ_IDLE_TIMEOUT_MINUTES

DEFAULT_SHUTDOWN_TIMEOUT_MILLISECONDS

DEFAULT_MAX_CONTENT_LENGTH

DEFAULT_FOLLOW_REDIRECTS

DEFAULT_EXCEPTION_ON_ERROR_STATUS

Constructor Detail

HttpClientConfiguration

HttpClientConfiguration

HttpClientConfiguration

Method Detail

getHttpVersion

setHttpVersion

getLogLevel

setLogLevel

getEventLoopGroup

setEventLoopGroup

getConnectionPoolConfiguration

getSslConfiguration

setSslConfiguration

isFollowRedirects

isExceptionOnErrorStatus

setExceptionOnErrorStatus

getLoggerName

setLoggerName

setFollowRedirects

getDefaultCharset

setDefaultCharset

getChannelOptions

setChannelOptions

getReadTimeout

getReadIdleTimeout

getConnectTimeout

getConnectTtl

getShutdownTimeout

setShutdownTimeout

setReadTimeout

setReadIdleTimeout

setConnectTimeout

setConnectTtl

getNumOfThreads

setNumOfThreads

getThreadFactory

setThreadFactory

getMaxContentLength

setMaxContentLength

getProxyType

setProxyType

getProxyAddress

setProxyAddress

getProxyUsername

setProxyUsername

getProxyPassword

setProxyPassword

setProxySelector

getProxySelector

resolveProxy