Hazelcast C++ Client
Hazelcast C++ Client Library
hazelcast::client::config::client_network_config Class Reference

Contains configuration parameters for client network related behaviour. More...

#include <client_network_config.h>

Public Member Functions

 client_network_config ()
 Constructor with default values. More...
 
ssl_configget_ssl_config ()
 Returns the current \ssl_config . More...
 
client_network_configset_ssl_config (const config::ssl_config &config)
 Sets the ssl_config. More...
 
client_network_configset_connection_timeout (const std::chrono::milliseconds &timeout)
 
std::chrono::milliseconds get_connection_timeout () const
 Connection timeout value for connecting to a member server. More...
 
client_network_configset_aws_config (const client_aws_config &client_aws_config)
 Sets configuration to connect nodes in aws environment. More...
 
client_aws_configget_aws_config ()
 Returns the current client_aws_config. More...
 
cloud_configget_cloud_config ()
 Returns the current cloud_config. More...
 
bool is_smart_routing () const
 See client_network_config::setSmartRouting(boolean) for details. More...
 
client_network_configset_smart_routing (bool smart_routing)
 If. More...
 
std::vector< addressget_addresses () const
 Returns the list of candidate addresses that client will use to establish initial connection. More...
 
client_network_configadd_addresses (const std::vector< address > &addresses)
 Adds given addresses to candidate address list that client will use to establish initial connection. More...
 
client_network_configset_addresses (const std::vector< address > &addresses)
 Adds given addresses to candidate address list that client will use to establish initial connection. More...
 
client_network_configadd_address (const address &address)
 Adds given address to candidate address list that client will use to establish initial connection. More...
 
socket_optionsget_socket_options ()
 
bool use_public_address () const
 
client_network_configuse_public_address (bool should_use_public_address)
 

Detailed Description

Contains configuration parameters for client network related behaviour.

Definition at line 35 of file client_network_config.h.

Constructor & Destructor Documentation

◆ client_network_config()

hazelcast::client::config::client_network_config::client_network_config ( )

Constructor with default values.

connectionTimeout(5000)

Definition at line 240 of file config.cpp.

241  : connection_timeout_(5000), smart_routing_(true) {}

Member Function Documentation

◆ add_address()

client_network_config & hazelcast::client::config::client_network_config::add_address ( const address address)

Adds given address to candidate address list that client will use to establish initial connection.

Parameters
addressto be added to initial address list
Returns
configured \client_network_config for chaining

Definition at line 292 of file config.cpp.

292  {
293  address_list_.push_back(address);
294  return *this;
295  }

◆ add_addresses()

client_network_config & hazelcast::client::config::client_network_config::add_addresses ( const std::vector< address > &  addresses)

Adds given addresses to candidate address list that client will use to establish initial connection.

Parameters
addressesto be added to initial address list
Returns
configured \client_network_config for chaining

Definition at line 282 of file config.cpp.

282  {
283  address_list_.insert(address_list_.end(), addresses.begin(), addresses.end());
284  return *this;
285  }

◆ get_addresses()

std::vector< address > hazelcast::client::config::client_network_config::get_addresses ( ) const

Returns the list of candidate addresses that client will use to establish initial connection.

Returns
list of addresses

Definition at line 278 of file config.cpp.

278  {
279  return address_list_;
280  }

◆ get_aws_config()

client_aws_config & hazelcast::client::config::client_network_config::get_aws_config ( )

Returns the current client_aws_config.

Returns
client_aws_config

Definition at line 261 of file config.cpp.

261  {
262  return client_aws_config_;
263  }

◆ get_cloud_config()

cloud_config & hazelcast::client::config::client_network_config::get_cloud_config ( )

Returns the current cloud_config.

Returns
cloud_config

Definition at line 265 of file config.cpp.

265  {
266  return cloud_config_;
267  }

◆ get_connection_timeout()

std::chrono::milliseconds hazelcast::client::config::client_network_config::get_connection_timeout ( ) const

Connection timeout value for connecting to a member server.

Returns
connection timeout set for a single connection attempt.

Definition at line 252 of file config.cpp.

252  {
253  return connection_timeout_;
254  }

◆ get_ssl_config()

ssl_config & hazelcast::client::config::client_network_config::get_ssl_config ( )

Returns the current \ssl_config .

Returns
the ssl_config .
See also
# set_ssl_config (ssl_config )

Definition at line 243 of file config.cpp.

243  {
244  return ssl_config_;
245  }

◆ is_smart_routing()

bool hazelcast::client::config::client_network_config::is_smart_routing ( ) const

See client_network_config::setSmartRouting(boolean) for details.

Returns
true if client is smart

Definition at line 269 of file config.cpp.

269  {
270  return smart_routing_;
271  }

◆ set_addresses()

client_network_config & hazelcast::client::config::client_network_config::set_addresses ( const std::vector< address > &  addresses)

Adds given addresses to candidate address list that client will use to establish initial connection.

Parameters
addressesto be added to initial address list
Returns
configured \client_network_config for chaining

Definition at line 287 of file config.cpp.

287  {
288  address_list_ = addresses;
289  return *this;
290  }

◆ set_aws_config()

client_network_config & hazelcast::client::config::client_network_config::set_aws_config ( const client_aws_config client_aws_config)

Sets configuration to connect nodes in aws environment.

Parameters
clientAwsConfigthe client_aws_config
See also
get_aws_config()

Definition at line 256 of file config.cpp.

256  {
257  this->client_aws_config_ = client_aws_config;
258  return *this;
259  }

◆ set_connection_timeout()

client_network_config & hazelcast::client::config::client_network_config::set_connection_timeout ( const std::chrono::milliseconds &  timeout)
Parameters
connectionTimeoutTimeout value for nodes to accept client connection requests. A zero value means wait until connection established or an error occurs. The resolution of time is up to milliseconds.
Returns
itself client_network_config

Definition at line 301 of file config.cpp.

301  {
302  connection_timeout_ = timeout;
303  return *this;
304  }

◆ set_smart_routing()

client_network_config & hazelcast::client::config::client_network_config::set_smart_routing ( bool  smart_routing)

If.

true

, client will route the key based operations to owner of the key on best-effort basis. Note that it uses a cached version of PartitionService::getPartitions() and doesn't guarantee that the operation will always be executed on the owner. The cached table is updated every 10 seconds.

If

smartRouting == false

, all operations will be routed to single member. Operations will need two hops if the chosen member is not owner of the key. Client will have only single open connection. Useful, if there are many clients and we want to avoid each of them connecting to each member.

Default value is

true

.

Parameters
smartRoutingtrue if smart routing should be enabled.
Returns
configured client_network_config for chaining

Definition at line 273 of file config.cpp.

273  {
274  client_network_config::smart_routing_ = smart_routing;
275  return *this;
276  }

◆ set_ssl_config()

client_network_config & hazelcast::client::config::client_network_config::set_ssl_config ( const config::ssl_config config)

Sets the ssl_config.

Parameters
configthe ssl_config .
Returns
the updated client_network_config.
See also
# get_ssl_config ()

Definition at line 247 of file config.cpp.

247  {
248  ssl_config_ = config;
249  return *this;
250  }

◆ use_public_address() [1/2]

bool hazelcast::client::config::client_network_config::use_public_address ( ) const
Returns
true if the public address of the server needs to be used when connecting to the cluster.

Definition at line 306 of file config.cpp.

306  {
307  return use_public_address_;
308  }

◆ use_public_address() [2/2]

client_network_config & hazelcast::client::config::client_network_config::use_public_address ( bool  should_use_public_address)
Parameters
should_use_public_addresstrue mean force usage of the public address of the server when connecting to the server. Otherwise, set to false to use the private address. Default is false.
Returns
configured \client_network_config for chaining

Definition at line 310 of file config.cpp.

310  {
311  use_public_address_ = should_use_public_address;
312  return *this;
313  }

The documentation for this class was generated from the following files: