ClientConfiguration (GridGain 8.9.15)

java.lang.Object
- org.apache.ignite.configuration.ClientConfiguration

All Implemented Interfaces:

Serializable
```
public final class ClientConfiguration
extends Object
implements Serializable
```
TcpIgniteClient configuration.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

ClientConfiguration()

Constructors
Constructor and Description
`ClientConfiguration()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String[]`	`getAddresses()`
`ClientAddressFinder`	`getAddressesFinder()`
`Executor`	`getAsyncContinuationExecutor()` Gets the async continuation executor.
`BinaryConfiguration`	`getBinaryConfiguration()`
`EventListener[]`	`getEventListeners()`
`long`	`getHeartbeatInterval()` Gets the heartbeat message interval, in milliseconds.
`IgniteLogger`	`getLogger()` Gets the logger.
`int`	`getReceiveBufferSize()`
`long`	`getReconnectThrottlingPeriod()` Gets reconnect throttling period.
`int`	`getReconnectThrottlingRetries()` Gets reconnect throttling retries.
`int`	`getRetryLimit()` Get retry limit.
`ClientRetryPolicy`	`getRetryPolicy()` Gets the retry policy.
`int`	`getSendBufferSize()`
`String`	`getSslClientCertificateKeyStorePassword()`
`String`	`getSslClientCertificateKeyStorePath()`
`String`	`getSslClientCertificateKeyStoreType()`
`javax.cache.configuration.Factory<SSLContext>`	`getSslContextFactory()`
`String`	`getSslKeyAlgorithm()`
`SslMode`	`getSslMode()`
`SslProtocol`	`getSslProtocol()`
`String`	`getSslTrustCertificateKeyStorePassword()`
`String`	`getSslTrustCertificateKeyStorePath()`
`String`	`getSslTrustCertificateKeyStoreType()`
`int`	`getTimeout()`
`ClientTransactionConfiguration`	`getTransactionConfiguration()` Gets transactions configuration.
`Map<String,String>`	`getUserAttributes()` Returns user attributes which can be used on server node.
`String`	`getUserName()`
`String`	`getUserPassword()`
`boolean`	`isAffinityAwarenessEnabled()` Gets a value indicating whether partition awareness should be enabled.
`boolean`	`isAutoBinaryConfigurationEnabled()` Gets a value indicating whether automatic binary configuration retrieval should be enabled.
`boolean`	`isClusterDiscoveryEnabled()` Gets a value indicating whether cluster discovery should be enabled.
`boolean`	`isHeartbeatEnabled()` Gets a value indicating whether heartbeats are enabled.
`boolean`	`isSslTrustAll()`
`boolean`	`isTcpNoDelay()`
`ClientConfiguration`	`setAddresses(String... addrs)` Set addresses of Ignite server nodes within a cluster.
`ClientConfiguration`	`setAddressesFinder(ClientAddressFinder finder)`
`ClientConfiguration`	`setAffinityAwarenessEnabled(boolean affinityAwarenessEnabled)` Sets a value indicating whether partition awareness should be enabled.
`ClientConfiguration`	`setAsyncContinuationExecutor(Executor asyncContinuationExecutor)` Sets the async continuation executor.
`ClientConfiguration`	`setAutoBinaryConfigurationEnabled(boolean autoBinaryConfigurationEnabled)` Sets a value indicating whether automatic binary configuration retrieval should be enabled.
`ClientConfiguration`	`setBinaryConfiguration(BinaryConfiguration binaryCfg)`
`ClientConfiguration`	`setClusterDiscoveryEnabled(boolean clusterDiscoveryEnabled)` Sets a value indicating whether cluster discovery should be enabled.
`ClientConfiguration`	`setEventListeners(EventListener... listeners)`
`ClientConfiguration`	`setHeartbeatEnabled(boolean heartbeatEnabled)` Sets a value indicating whether heartbeats are enabled.
`ClientConfiguration`	`setHeartbeatInterval(long heartbeatInterval)` Sets the heartbeat message interval, in milliseconds.
`ClientConfiguration`	`setLogger(IgniteLogger logger)` Sets the logger.
`ClientConfiguration`	`setReceiveBufferSize(int rcvBufSize)`
`ClientConfiguration`	`setReconnectThrottlingPeriod(long reconnectThrottlingPeriod)` Sets reconnect throttling period.
`ClientConfiguration`	`setReconnectThrottlingRetries(int reconnectThrottlingRetries)` Sets reconnect throttling retries.
`ClientConfiguration`	`setRetryLimit(int retryLimit)` Sets the retry limit.
`ClientConfiguration`	`setRetryPolicy(ClientRetryPolicy retryPolicy)` Sets the retry policy.
`ClientConfiguration`	`setSendBufferSize(int sndBufSize)`
`ClientConfiguration`	`setSslClientCertificateKeyStorePassword(String newVal)`
`ClientConfiguration`	`setSslClientCertificateKeyStorePath(String newVal)`
`ClientConfiguration`	`setSslClientCertificateKeyStoreType(String newVal)`
`ClientConfiguration`	`setSslContextFactory(javax.cache.configuration.Factory<SSLContext> newVal)`
`ClientConfiguration`	`setSslKeyAlgorithm(String newVal)`
`ClientConfiguration`	`setSslMode(SslMode sslMode)`
`ClientConfiguration`	`setSslProtocol(SslProtocol newVal)`
`ClientConfiguration`	`setSslTrustAll(boolean newVal)`
`ClientConfiguration`	`setSslTrustCertificateKeyStorePassword(String newVal)`
`ClientConfiguration`	`setSslTrustCertificateKeyStorePath(String newVal)`
`ClientConfiguration`	`setSslTrustCertificateKeyStoreType(String newVal)`
`ClientConfiguration`	`setTcpNoDelay(boolean tcpNoDelay)`
`ClientConfiguration`	`setTimeout(int timeout)`
`ClientConfiguration`	`setTransactionConfiguration(ClientTransactionConfiguration txCfg)` Sets transactions configuration.
`ClientConfiguration`	`setUserAttributes(Map<String,String> userAttrs)` Sets user attributes which can be used to send additional info to the server nodes.
`ClientConfiguration`	`setUserName(String newVal)`
`ClientConfiguration`	`setUserPassword(String newVal)`
`String`	`toString()`

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

- Constructor Detail
  - ClientConfiguration
```
public ClientConfiguration()
```
- Method Detail
  - getAddresses
```
public String[] getAddresses()
```
    Returns:
    
    Host addresses.
  - setAddresses
```
public ClientConfiguration setAddresses(String... addrs)
```
    Set addresses of Ignite server nodes within a cluster. An address can be IPv4 address or hostname, with or without port. If port is not set then Ignite will generate multiple addresses for default port range. See ClientConnectorConfiguration.DFLT_PORT, ClientConnectorConfiguration.DFLT_PORT_RANGE.
    
    Parameters:
    
    addrs - Host addresses.
  - getAddressesFinder
```
public ClientAddressFinder getAddressesFinder()
```
    Returns:
    
    Finder that finds server node addresses.
  - setAddressesFinder
```
public ClientConfiguration setAddressesFinder(ClientAddressFinder finder)
```
    Parameters:
    
    finder - Finds server node addresses.
  - isTcpNoDelay
```
public boolean isTcpNoDelay()
```
    Returns:
    
    Whether Nagle's algorithm is enabled.
  - setTcpNoDelay
```
public ClientConfiguration setTcpNoDelay(boolean tcpNoDelay)
```
    Parameters:
    
    tcpNoDelay - whether Nagle's algorithm is enabled.
  - getTimeout
```
public int getTimeout()
```
    Returns:
    
    Send/receive timeout in milliseconds.
  - setTimeout
```
public ClientConfiguration setTimeout(int timeout)
```
    Parameters:
    
    timeout - Send/receive timeout in milliseconds.
  - getSendBufferSize
```
public int getSendBufferSize()
```
    Returns:
    
    Send buffer size.
  - setSendBufferSize
```
public ClientConfiguration setSendBufferSize(int sndBufSize)
```
    Parameters:
    
    sndBufSize - Send buffer size.
  - getReceiveBufferSize
```
public int getReceiveBufferSize()
```
    Returns:
    
    Send buffer size.
  - setReceiveBufferSize
```
public ClientConfiguration setReceiveBufferSize(int rcvBufSize)
```
    Parameters:
    
    rcvBufSize - Send buffer size.
  - getBinaryConfiguration
```
public BinaryConfiguration getBinaryConfiguration()
```
    Returns:
    
    Configuration for Ignite Binary objects.
  - setBinaryConfiguration
```
public ClientConfiguration setBinaryConfiguration(BinaryConfiguration binaryCfg)
```
    Parameters:
    
    binaryCfg - Configuration for Ignite Binary objects.
  - getSslMode
```
public SslMode getSslMode()
```
    Returns:
    
    SSL mode.
  - setSslMode
```
public ClientConfiguration setSslMode(SslMode sslMode)
```
    Parameters:
    
    sslMode - SSL mode.
  - getSslClientCertificateKeyStorePath
```
public String getSslClientCertificateKeyStorePath()
```
    Returns:
    
    Ssl client certificate key store path.
  - setSslClientCertificateKeyStorePath
```
public ClientConfiguration setSslClientCertificateKeyStorePath(String newVal)
```
    Parameters:
    
    newVal - Ssl client certificate key store path.
  - getSslClientCertificateKeyStorePassword
```
public String getSslClientCertificateKeyStorePassword()
```
    Returns:
    
    Ssl client certificate key store password.
  - setSslClientCertificateKeyStorePassword
```
public ClientConfiguration setSslClientCertificateKeyStorePassword(String newVal)
```
    Parameters:
    
    newVal - Ssl client certificate key store password.
  - getSslClientCertificateKeyStoreType
```
public String getSslClientCertificateKeyStoreType()
```
    Returns:
    
    Ssl client certificate key store type.
  - setSslClientCertificateKeyStoreType
```
public ClientConfiguration setSslClientCertificateKeyStoreType(String newVal)
```
    Parameters:
    
    newVal - Ssl client certificate key store type.
  - getSslTrustCertificateKeyStorePath
```
public String getSslTrustCertificateKeyStorePath()
```
    Returns:
    
    Ssl trust certificate key store path.
  - setSslTrustCertificateKeyStorePath
```
public ClientConfiguration setSslTrustCertificateKeyStorePath(String newVal)
```
    Parameters:
    
    newVal - Ssl trust certificate key store path.
  - getSslTrustCertificateKeyStorePassword
```
public String getSslTrustCertificateKeyStorePassword()
```
    Returns:
    
    Ssl trust certificate key store password.
  - setSslTrustCertificateKeyStorePassword
```
public ClientConfiguration setSslTrustCertificateKeyStorePassword(String newVal)
```
    Parameters:
    
    newVal - Ssl trust certificate key store password.
  - getSslTrustCertificateKeyStoreType
```
public String getSslTrustCertificateKeyStoreType()
```
    Returns:
    
    Ssl trust certificate key store type.
  - setSslTrustCertificateKeyStoreType
```
public ClientConfiguration setSslTrustCertificateKeyStoreType(String newVal)
```
    Parameters:
    
    newVal - Ssl trust certificate key store type.
  - getSslKeyAlgorithm
```
public String getSslKeyAlgorithm()
```
    Returns:
    
    Ssl key algorithm.
  - setSslKeyAlgorithm
```
public ClientConfiguration setSslKeyAlgorithm(String newVal)
```
    Parameters:
    
    newVal - Ssl key algorithm.
  - isSslTrustAll
```
public boolean isSslTrustAll()
```
    Returns:
    
    Flag indicating if certificate validation errors should be ignored.
  - setSslTrustAll
```
public ClientConfiguration setSslTrustAll(boolean newVal)
```
    Parameters:
    
    newVal - Flag indicating if certificate validation errors should be ignored.
  - getSslProtocol
```
public SslProtocol getSslProtocol()
```
    Returns:
    
    Ssl protocol.
  - setSslProtocol
```
public ClientConfiguration setSslProtocol(SslProtocol newVal)
```
    Parameters:
    
    newVal - Ssl protocol.
  - getUserName
```
public String getUserName()
```
    Returns:
    
    User name.
  - setUserName
```
public ClientConfiguration setUserName(String newVal)
```
    Parameters:
    
    newVal - User name.
  - getUserPassword
```
public String getUserPassword()
```
    Returns:
    
    User password.
  - setUserPassword
```
public ClientConfiguration setUserPassword(String newVal)
```
    Parameters:
    
    newVal - User password.
  - getSslContextFactory
```
public javax.cache.configuration.Factory<SSLContext> getSslContextFactory()
```
    Returns:
    
    SSL Context Factory.
  - setSslContextFactory
```
public ClientConfiguration setSslContextFactory(javax.cache.configuration.Factory<SSLContext> newVal)
```
    Parameters:
    
    newVal - SSL Context Factory.
  - getTransactionConfiguration
```
public ClientTransactionConfiguration getTransactionConfiguration()
```
    Gets transactions configuration.
    
    Returns:
    
    Transactions configuration.
  - setTransactionConfiguration
```
public ClientConfiguration setTransactionConfiguration(ClientTransactionConfiguration txCfg)
```
    Sets transactions configuration.
    
    Returns:
    
    this for chaining.
  - isAffinityAwarenessEnabled
```
public boolean isAffinityAwarenessEnabled()
```
    Gets a value indicating whether partition awareness should be enabled.
    Default is true: client sends requests directly to the primary node for the given cache key. To do so, connection is established to every known server node.
    When false, only one connection is established at a given moment to a random server node.
  - setAffinityAwarenessEnabled
```
public ClientConfiguration setAffinityAwarenessEnabled(boolean affinityAwarenessEnabled)
```
    Sets a value indicating whether partition awareness should be enabled.
    Default is true: client sends requests directly to the primary node for the given cache key. To do so, connection is established to every known server node.
    When false, only one connection is established at a given moment to a random server node.
    
    Returns:
    
    this for chaining.
  - isClusterDiscoveryEnabled
```
public boolean isClusterDiscoveryEnabled()
```
    Gets a value indicating whether cluster discovery should be enabled.
    Default is true: client get addresses of server nodes from the cluster and connects to all of them.
    When false, client only connects to the addresses provided in setAddresses(String...) and setAddressesFinder(ClientAddressFinder).
  - setClusterDiscoveryEnabled
```
public ClientConfiguration setClusterDiscoveryEnabled(boolean clusterDiscoveryEnabled)
```
    Sets a value indicating whether cluster discovery should be enabled.
    Default is true: client get addresses of server nodes from the cluster and connects to all of them.
    When false, client only connects to the addresses provided in setAddresses(String...) and setAddressesFinder(ClientAddressFinder).
  - getReconnectThrottlingPeriod
```
public long getReconnectThrottlingPeriod()
```
    Gets reconnect throttling period.
  - setReconnectThrottlingPeriod
```
public ClientConfiguration setReconnectThrottlingPeriod(long reconnectThrottlingPeriod)
```
    Sets reconnect throttling period.
    
    Returns:
    
    this for chaining.
  - getReconnectThrottlingRetries
```
public int getReconnectThrottlingRetries()
```
    Gets reconnect throttling retries.
  - setReconnectThrottlingRetries
```
public ClientConfiguration setReconnectThrottlingRetries(int reconnectThrottlingRetries)
```
    Sets reconnect throttling retries.
    
    Returns:
    
    this for chaining.
  - getRetryLimit
```
public int getRetryLimit()
```
    Get retry limit.
  - setRetryLimit
```
public ClientConfiguration setRetryLimit(int retryLimit)
```
    Sets the retry limit. When a request fails due to a connection error, and multiple server connections are available, Ignite will retry the request on every connection. When this property is greater than zero, Ignite will limit the number of retries.
    
    Returns:
    
    this for chaining.
  - getRetryPolicy
```
public ClientRetryPolicy getRetryPolicy()
```
    Gets the retry policy.
    
    Returns:
    
    Retry policy.
  - setRetryPolicy
```
public ClientConfiguration setRetryPolicy(ClientRetryPolicy retryPolicy)
```
    Sets the retry policy. When a request fails due to a connection error, and multiple server connections are available, Ignite will retry the request if the specified policy allows it.
    When retryLimit is set, retry count will be limited even if the specified policy returns true.
    Default is ClientRetryAllPolicy.
    
    Parameters:
    
    retryPolicy - Retry policy.
    
    Returns:
    
    this for chaining.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getUserAttributes
```
public Map<String,String> getUserAttributes()
```
    Returns user attributes which can be used on server node.
    
    Returns:
    
    User attributes.
  - setUserAttributes
```
public ClientConfiguration setUserAttributes(Map<String,String> userAttrs)
```
    Sets user attributes which can be used to send additional info to the server nodes. Sent attributes can be accessed on server nodes from GridRestRequest or ClientListenerAbstractConnectionContext (depends on client type).
    
    Parameters:
    
    userAttrs - User attributes.
    
    Returns:
    
    this for chaining.
  - getAsyncContinuationExecutor
```
public Executor getAsyncContinuationExecutor()
```
    Gets the async continuation executor.
    When null (default), ForkJoinPool.commonPool() is used.
    When async client operation completes, corresponding IgniteFuture listeners will be invoked using this executor. Thin client operation results are handled by a dedicated thread. This thread should be free from any extra work, and should not be not be used to execute future listeners directly.
    
    Returns:
    
    Executor for async continuations.
  - setAsyncContinuationExecutor
```
public ClientConfiguration setAsyncContinuationExecutor(Executor asyncContinuationExecutor)
```
    Sets the async continuation executor.
    When null (default), ForkJoinPool.commonPool() is used.
    When async client operation completes, corresponding IgniteFuture listeners will be invoked using this executor. Thin client operation results are handled by a dedicated thread. This thread should be free from any extra work, and should not be not be used to execute future listeners directly.
    
    Parameters:
    
    asyncContinuationExecutor - Executor for async continuations.
    
    Returns:
    
    this for chaining.
  - isHeartbeatEnabled
```
public boolean isHeartbeatEnabled()
```
    Gets a value indicating whether heartbeats are enabled.
    When thin client connection is idle (no operations are performed), heartbeat messages are sent periodically to keep the connection alive and detect potential half-open state.
    See also heartbeatInterval.
    
    Returns:
    
    Whether heartbeats are enabled.
  - setHeartbeatEnabled
```
public ClientConfiguration setHeartbeatEnabled(boolean heartbeatEnabled)
```
    Sets a value indicating whether heartbeats are enabled.
    When thin client connection is idle (no operations are performed), heartbeat messages are sent periodically to keep the connection alive and detect potential half-open state.
    See also heartbeatInterval.
    
    Parameters:
    
    heartbeatEnabled - Whether to enable heartbeats.
    
    Returns:
    
    this for chaining.
  - getHeartbeatInterval
```
public long getHeartbeatInterval()
```
    Gets the heartbeat message interval, in milliseconds. Default is 30_000.
    When server-side ClientConnectorConfiguration.getIdleTimeout() is not zero, effective heartbeat interval is set to min(heartbeatInterval, idleTimeout / 3).
    When thin client connection is idle (no operations are performed), heartbeat messages are sent periodically to keep the connection alive and detect potential half-open state. *
    
    Returns:
    
    Heartbeat interval.
  - setHeartbeatInterval
```
public ClientConfiguration setHeartbeatInterval(long heartbeatInterval)
```
    Sets the heartbeat message interval, in milliseconds. Default is 30_000.
    When server-side ClientConnectorConfiguration.getIdleTimeout() is not zero, effective heartbeat interval is set to min(heartbeatInterval, idleTimeout / 3).
    When thin client connection is idle (no operations are performed), heartbeat messages are sent periodically to keep the connection alive and detect potential half-open state. *
    
    Parameters:
    
    heartbeatInterval - Heartbeat interval, in milliseconds.
    
    Returns:
    
    this for chaining.
  - isAutoBinaryConfigurationEnabled
```
public boolean isAutoBinaryConfigurationEnabled()
```
    Gets a value indicating whether automatic binary configuration retrieval should be enabled.
    When enabled, compact footer (BinaryConfiguration.isCompactFooter()) and name mapper (BinaryConfiguration.getNameMapper()) settings will be retrieved from the server to match the cluster configuration.
    Default is true.
    
    Returns:
    
    Whether automatic binary configuration is enabled.
  - setAutoBinaryConfigurationEnabled
```
public ClientConfiguration setAutoBinaryConfigurationEnabled(boolean autoBinaryConfigurationEnabled)
```
    Sets a value indicating whether automatic binary configuration retrieval should be enabled.
    When enabled, compact footer (BinaryConfiguration.isCompactFooter()) and name mapper (BinaryConfiguration.getNameMapper()) settings will be retrieved from the server to match the cluster configuration.
    Default is true.
    
    Parameters:
    
    autoBinaryConfigurationEnabled - Whether automatic binary configuration is enabled.
    
    Returns:
    
    this for chaining.
  - setLogger
```
public ClientConfiguration setLogger(IgniteLogger logger)
```
    Sets the logger.
    
    Parameters:
    
    logger - Logger.
    
    Returns:
    
    this for chaining.
  - getLogger
```
public IgniteLogger getLogger()
```
    Gets the logger.
    
    Returns:
    
    Logger.
  - setEventListeners
```
public ClientConfiguration setEventListeners(EventListener... listeners)
```
    Parameters:
    
    listeners - Clent event listeners.
    
    Returns:
    
    this for chaining.
  - getEventListeners
```
public EventListener[] getEventListeners()
```
    Returns:
    
    Client event listeners.

Class ClientConfiguration

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ClientConfiguration

Method Detail

getAddresses

setAddresses

getAddressesFinder

setAddressesFinder

isTcpNoDelay

setTcpNoDelay

getTimeout

setTimeout

getSendBufferSize

setSendBufferSize

getReceiveBufferSize

setReceiveBufferSize

getBinaryConfiguration

setBinaryConfiguration

getSslMode

setSslMode

getSslClientCertificateKeyStorePath

setSslClientCertificateKeyStorePath

getSslClientCertificateKeyStorePassword

setSslClientCertificateKeyStorePassword

getSslClientCertificateKeyStoreType

setSslClientCertificateKeyStoreType

getSslTrustCertificateKeyStorePath

setSslTrustCertificateKeyStorePath

getSslTrustCertificateKeyStorePassword

setSslTrustCertificateKeyStorePassword

getSslTrustCertificateKeyStoreType

setSslTrustCertificateKeyStoreType

getSslKeyAlgorithm

setSslKeyAlgorithm

isSslTrustAll

setSslTrustAll

getSslProtocol

setSslProtocol

getUserName

setUserName

getUserPassword

setUserPassword

getSslContextFactory

setSslContextFactory

getTransactionConfiguration

setTransactionConfiguration

isAffinityAwarenessEnabled

setAffinityAwarenessEnabled

isClusterDiscoveryEnabled

setClusterDiscoveryEnabled

getReconnectThrottlingPeriod

setReconnectThrottlingPeriod

getReconnectThrottlingRetries

setReconnectThrottlingRetries

getRetryLimit

setRetryLimit

getRetryPolicy

setRetryPolicy

toString

getUserAttributes

setUserAttributes

getAsyncContinuationExecutor

setAsyncContinuationExecutor

isHeartbeatEnabled

setHeartbeatEnabled

getHeartbeatInterval

setHeartbeatInterval

isAutoBinaryConfigurationEnabled

setAutoBinaryConfigurationEnabled

setLogger

getLogger

setEventListeners

getEventListeners