![]() |
Hazelcast C++ Client
Hazelcast C++ Client Library
|
Client Properties is an internal class. More...
#include <client_properties.h>
Static Public Attributes | |
static const std::string | PROP_HEARTBEAT_TIMEOUT |
Client will be sending heartbeat messages to members and this is the timeout. | |
static const std::string | PROP_HEARTBEAT_TIMEOUT_DEFAULT = "60000" |
static const std::string | PROP_HEARTBEAT_INTERVAL |
Time interval in milliseconds between the heartbeats sent by the client to the nodes. | |
static const std::string | PROP_HEARTBEAT_INTERVAL_DEFAULT = "5000" |
static const std::string | PROP_REQUEST_RETRY_COUNT |
Client will retry requests which either inherently retryable(idempotent
client) or client_network_config#redoOperation is set to true_ This property is to configure retry count before client give up retrying. | |
static const std::string | PROP_REQUEST_RETRY_COUNT_DEFAULT = "20" |
static const std::string | PROP_REQUEST_RETRY_WAIT_TIME |
Client will retry requests which either inherently retryable(idempotent
client) or client_network_config#redoOperation is set to true. | |
static const std::string | PROP_REQUEST_RETRY_WAIT_TIME_DEFAULT = "1" |
static const std::string | PROP_AWS_MEMBER_PORT = "hz-port" |
The discovery mechanism will discover only IP addresses. | |
static const std::string | PROP_AWS_MEMBER_PORT_DEFAULT = "5701" |
static const std::string | INVOCATION_RETRY_PAUSE_MILLIS |
Pause time between each retry cycle of an invocation in milliseconds. | |
static const std::string | INVOCATION_RETRY_PAUSE_MILLIS_DEFAULT |
static const std::string | INVOCATION_TIMEOUT_SECONDS |
When an invocation gets an exception because : | |
static const std::string | INVOCATION_TIMEOUT_SECONDS_DEFAULT = "120" |
static const std::string | EVENT_THREAD_COUNT |
Number of the threads to handle the incoming event packets. | |
static const std::string | EVENT_THREAD_COUNT_DEFAULT = "5" |
static const std::string | INTERNAL_EXECUTOR_POOL_SIZE |
static const std::string | INTERNAL_EXECUTOR_POOL_SIZE_DEFAULT = "3" |
static const std::string | SHUFFLE_MEMBER_LIST |
Client shuffles the given member list to prevent all clients to connect to the same node when this property is set to true. | |
static const std::string | SHUFFLE_MEMBER_LIST_DEFAULT = "true" |
static const std::string | MAX_CONCURRENT_INVOCATIONS |
The maximum number of concurrent invocations allowed. | |
static const std::string | MAX_CONCURRENT_INVOCATIONS_DEFAULT |
static const std::string | BACKPRESSURE_BACKOFF_TIMEOUT_MILLIS |
Control the maximum timeout in millis to wait for an invocation space to be available. | |
static const std::string | BACKPRESSURE_BACKOFF_TIMEOUT_MILLIS_DEFAULT = "-1" |
static const std::string | STATISTICS_ENABLED |
Use to enable the client statistics collection. | |
static const std::string | STATISTICS_ENABLED_DEFAULT = "false" |
static const std::string | STATISTICS_PERIOD_SECONDS |
The period in seconds the statistics sent to the cluster. | |
static const std::string | STATISTICS_PERIOD_SECONDS_DEFAULT = "3" |
static constexpr const char * | OPERATION_BACKUP_TIMEOUT_MILLIS |
If an operation has backups, this property specifies how long the invocation will wait for acks from the backup replicas. | |
static constexpr const char * | OPERATION_BACKUP_TIMEOUT_MILLIS_DEFAULT |
static constexpr const char * | FAIL_ON_INDETERMINATE_OPERATION_STATE |
When this configuration is enabled, if an operation has sync backups and acks are not received from backup replicas in time, or the member which owns primary replica of the target partition leaves the cluster, then the invocation fails with \indeterminate_operation_state. | |
static constexpr const char * | FAIL_ON_INDETERMINATE_OPERATION_STATE_DEFAULT |
static constexpr const char * | CLOUD_URL_BASE = "hazelcast.client.cloud.url" |
Internal client property to change base url of cloud discovery endpoint. | |
static constexpr const char * | CLOUD_URL_BASE_DEFAULT |
static constexpr const char * | PARTITION_ARGUMENT_CACHE_SIZE |
Parametrized SQL queries touching only a single partition benefit from using the partition owner as the query coordinator, if the partition owner can be determined from one of the query parameters. | |
static constexpr const char * | PARTITION_ARGUMENT_CACHE_SIZE_DEFAULT = "1024" |
Client Properties is an internal class.
Only use properties documentations as references to be used in client_config::set_property
Definition at line 66 of file client_properties.h.
hazelcast::client::client_properties::client_properties | ( | const std::unordered_map< std::string, std::string > & | properties | ) |
Definition at line 1041 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::backup_timeout_millis | ( | ) | const |
Definition at line 1184 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::cloud_base_url | ( | ) | const |
Definition at line 1196 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::fail_on_indeterminate_state | ( | ) | const |
Definition at line 1190 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_aws_member_port | ( | ) | const |
Definition at line 1089 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_backpressure_backoff_timeout_millis | ( | ) | const |
Definition at line 1131 of file client_impl.cpp.
bool hazelcast::client::client_properties::get_boolean | ( | const client_property & | property | ) | const |
Returns the configured boolean value of a ClientProperty
.
property | the ClientProperty to get the value from |
Definition at line 1166 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_event_thread_count | ( | ) | const |
Definition at line 1107 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_heartbeat_interval | ( | ) | const |
Definition at line 1083 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_heartbeat_timeout | ( | ) | const |
Definition at line 1077 of file client_impl.cpp.
int32_t hazelcast::client::client_properties::get_integer | ( | const client_property & | property | ) | const |
Returns the configured int32_t value of a ClientProperty
.
property | the ClientProperty to get the value from |
Definition at line 1172 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_internal_executor_pool_size | ( | ) | const |
Definition at line 1113 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_invocation_retry_pause_millis | ( | ) | const |
Definition at line 1095 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_invocation_timeout_seconds | ( | ) | const |
Definition at line 1101 of file client_impl.cpp.
int64_t hazelcast::client::client_properties::get_long | ( | const client_property & | property | ) | const |
Returns the configured int64_t value of a ClientProperty
.
property | the ClientProperty to get the value from |
Definition at line 1178 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_max_concurrent_invocations | ( | ) | const |
Definition at line 1125 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_shuffle_member_list | ( | ) | const |
Definition at line 1119 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_statistics_enabled | ( | ) | const |
Definition at line 1137 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::get_statistics_period_seconds | ( | ) | const |
Definition at line 1143 of file client_impl.cpp.
std::string hazelcast::client::client_properties::get_string | ( | const client_property & | property | ) | const |
Returns the configured value of a ClientProperty
as std::string.
property | the ClientProperty to get the value from |
Definition at line 1149 of file client_impl.cpp.
const client_property & hazelcast::client::client_properties::partition_arg_cache_size | ( | ) | const |
Definition at line 1202 of file client_impl.cpp.
|
static |
Control the maximum timeout in millis to wait for an invocation space to be available.
If an invocation can't be made because there are too many pending invocations, then an exponential backoff is done to give the system time to deal with the backlog of invocations. This property controls how long an invocation is allowed to wait before getting a com.hazelcast.core.hazelcast_overload
.
When set to -1 then hazelcast_overload_exception
is thrown immediately without any waiting.
Definition at line 220 of file client_properties.h.
|
static |
Definition at line 221 of file client_properties.h.
|
staticconstexpr |
Internal client property to change base url of cloud discovery endpoint.
Used for testing cloud discovery.
Definition at line 265 of file client_properties.h.
|
staticconstexpr |
Definition at line 266 of file client_properties.h.
|
static |
Number of the threads to handle the incoming event packets.
Definition at line 183 of file client_properties.h.
|
static |
Definition at line 184 of file client_properties.h.
|
staticconstexpr |
When this configuration is enabled, if an operation has sync backups and acks are not received from backup replicas in time, or the member which owns primary replica of the target partition leaves the cluster, then the invocation fails with \indeterminate_operation_state.
However, even if the invocation fails, there will not be any rollback on other successful replicas.
Definition at line 256 of file client_properties.h.
|
staticconstexpr |
Definition at line 258 of file client_properties.h.
|
static |
Definition at line 186 of file client_properties.h.
|
static |
Definition at line 187 of file client_properties.h.
|
static |
Pause time between each retry cycle of an invocation in milliseconds.
Definition at line 163 of file client_properties.h.
|
static |
Definition at line 164 of file client_properties.h.
|
static |
When an invocation gets an exception because :
Definition at line 177 of file client_properties.h.
|
static |
Definition at line 178 of file client_properties.h.
|
static |
The maximum number of concurrent invocations allowed.
To prevent the system from overloading, user can apply a constraint on the number of concurrent invocations. If the maximum number of concurrent invocations has been exceeded and a new invocation comes in, then hazelcast will throw hazelcast_overload_exception
By default it is configured as INT32_MAX.
Definition at line 206 of file client_properties.h.
|
static |
Definition at line 207 of file client_properties.h.
|
staticconstexpr |
If an operation has backups, this property specifies how long the invocation will wait for acks from the backup replicas.
If acks are not received from some backups, there will not be any rollback on other successful replicas.
Definition at line 243 of file client_properties.h.
|
staticconstexpr |
Definition at line 245 of file client_properties.h.
|
staticconstexpr |
Parametrized SQL queries touching only a single partition benefit from using the partition owner as the query coordinator, if the partition owner can be determined from one of the query parameters.
When such a query is executed, the cluster sends the index of such argument to the client. This parameter configures the size of the cache the client uses for storing this information.
Definition at line 277 of file client_properties.h.
|
staticconstexpr |
Definition at line 279 of file client_properties.h.
|
static |
The discovery mechanism will discover only IP addresses.
You can define the port on which Hazelcast is expected to be running here. This port number is not used by the discovery mechanism itself, it is only returned by the discovery mechanism. The default port is PROP_AWS_MEMBER_PORT_DEFAULT
Definition at line 157 of file client_properties.h.
|
static |
Definition at line 158 of file client_properties.h.
|
static |
Time interval in milliseconds between the heartbeats sent by the client to the nodes.
attribute "hazelcast_client_heartbeat_interval" default value "5000"
Definition at line 123 of file client_properties.h.
|
static |
Definition at line 124 of file client_properties.h.
|
static |
Client will be sending heartbeat messages to members and this is the timeout.
If there is no any message passing between client and member within the given time via this property in milliseconds the connection will be closed.
attribute "hazelcast_client_heartbeat_timeout" default value "60000"
Definition at line 113 of file client_properties.h.
|
static |
Definition at line 114 of file client_properties.h.
|
static |
Client will retry requests which either inherently retryable(idempotent
client) or client_network_config#redoOperation
is set to true_ This property is to configure retry count before client give up retrying.
attribute "hazelcast_client_request_retry_count" default value "20"
Definition at line 135 of file client_properties.h.
|
static |
Definition at line 136 of file client_properties.h.
|
static |
Client will retry requests which either inherently retryable(idempotent
client) or client_network_config#redoOperation
is set to true.
Time delay in seconds between retries.
attribute "hazelcast_client_request_retry_wait_time" default value "1"
Definition at line 147 of file client_properties.h.
|
static |
Definition at line 148 of file client_properties.h.
|
static |
Client shuffles the given member list to prevent all clients to connect to the same node when this property is set to true.
When it is set to false, the client tries to connect to the nodes in the given order.
Definition at line 194 of file client_properties.h.
|
static |
Definition at line 195 of file client_properties.h.
|
static |
Use to enable the client statistics collection.
The default is false.
Definition at line 228 of file client_properties.h.
|
static |
Definition at line 229 of file client_properties.h.
|
static |
The period in seconds the statistics sent to the cluster.
Definition at line 234 of file client_properties.h.
|
static |
Definition at line 235 of file client_properties.h.