Apache Geode Native C++ Reference 1.15.0
apache::geode::client::SystemProperties Class Reference

The SystemProperties class. More...

#include <SystemProperties.hpp>

Public Member Functions

const std::chrono::milliseconds & bucketWaitTimeout () const
 Returns the connect wait timeout(in milliseconds) used for to connect to server This is only applicable for linux. More...
 
const std::string & conflateEvents () const
 Returns client Queueconflation option. More...
 
const std::chrono::milliseconds & connectTimeout () const
 Returns the connect timeout used for server and locator handshakes. More...
 
const std::chrono::milliseconds & connectWaitTimeout () const
 Returns the connect wait timeout(in milliseconds) used for to connect to server This is only applicable for linux. More...
 
const std::string & durableClientId () const
 Returns the durable client ID. More...
 
const std::chrono::seconds & durableTimeout () const
 Returns the durable timeout. More...
 
bool enableChunkHandlerThread () const
 Returns true if chunk handler thread is enabled, false if not. More...
 
bool getEnableTimeStatistics () const
 Whether time stats are enabled for the statistics. More...
 
int32_t heapLRUDelta () const
 Returns the HeapLRUDelta value (a percent value). More...
 
size_t heapLRULimit () const
 Returns the HeapLRULimit value (in bytes), the maximum memory that values in a cache can use to store data before overflowing to disk or destroying entries to ensure that the server process never runs out of memory due to cache memory usage. More...
 
bool heapLRULimitEnabled () const
 Returns a boolean that specifies if heapLRULimit has been enabled for the process. More...
 
uint32_t logDiskSpaceLimit () const
 Returns the log-disk-space-limit. More...
 
const std::string & logFilename () const
 Returns the name of the filename into which logging would be done. More...
 
uint32_t logFileSizeLimit () const
 Returns the log-file-size-limit. More...
 
LogLevel logLevel () const
 Returns the log level at which logging would be done. More...
 
void logSettings ()
 print all settings to the process log. More...
 
int32_t maxSocketBufferSize () const
 Returns the maximum socket buffer size to use. More...
 
const std::chrono::milliseconds & notifyAckInterval () const
 Returns the periodic notify ack interval. More...
 
const std::chrono::milliseconds & notifyDupCheckLife () const
 Returns the expiry time of an idle event id map entry for duplicate notification checking. More...
 
bool onClientDisconnectClearPdxTypeIds () const
 Returns true if app wants to clear pdx type ids when client disconnect. More...
 
const std::chrono::seconds & pingInterval () const
 Returns the time between two consecutive pings to servers. More...
 
void processProperty (const std::string &property, const std::string &value)
 Processes the given property/value pair, saving the results internally: More...
 
const std::chrono::seconds & redundancyMonitorInterval () const
 Returns the time between two consecutive checks for redundancy for HA. More...
 
void setEnableChunkHandlerThread (bool set)
 Enables or disables the chunk handler thread. More...
 
void setLogLevel (LogLevel newLogLevel)
 Changes the current log level to newLogLevel. More...
 
void setOnClientDisconnectClearPdxTypeIds (bool set)
 Set to true if app wants to clear pdx type ids when client disconnect. More...
 
bool sslEnabled () const
 Whether SSL is enabled for socket connections. More...
 
const std::string & sslKeyStore () const
 Returns the path of the private key file for SSL use. More...
 
const std::string & sslKeystorePassword () const
 Returns the client keystore password. More...
 
const std::string & sslTrustStore () const
 Returns the path of the public key file for SSL use. More...
 
const std::string & statisticsArchiveFile () const
 Returns the name of the filename into which statistics would be archived. More...
 
bool statisticsEnabled () const
 Tells whether statistics needs to be archived or not. More...
 
const std::chrono::milliseconds statisticsSampleInterval () const
 Returns the sampling interval of the sampling thread. More...
 
uint32_t statsDiskSpaceLimit () const
 Returns the stat-disk-size-limit. More...
 
uint32_t statsFileSizeLimit () const
 Returns the stat-file-space-limit. More...
 
 SystemProperties (const std::shared_ptr< Properties > &propertiesPtr, const std::string &configFile="")
 Constructor. More...
 
 ~SystemProperties ()
 Destructor. More...
 

Data Fields

_GEODE_DEPRECATED_("Diffie-Hellman based credentials encryption is not supported.") const std bool m_statisticsEnabled
 Return the keystore (.pem file ) path. More...
 

Detailed Description

The SystemProperties class.

A class for internal use that encapsulates the properties that can be set from DistributedSystem::connect.

Constructor & Destructor Documentation

◆ SystemProperties()

apache::geode::client::SystemProperties::SystemProperties ( const std::shared_ptr< Properties > &  propertiesPtr,
const std::string &  configFile = "" 
)
explicit

Constructor.

Will set the default values first, and then overwrite with the values found in the given Properties object (if any), and then from the values in the given file (if it exists).

If useMemType is true, use the given member type; if false, always set member type to SERVER.

◆ ~SystemProperties()

apache::geode::client::SystemProperties::~SystemProperties ( )

Destructor.

Member Function Documentation

◆ bucketWaitTimeout()

const std::chrono::milliseconds & apache::geode::client::SystemProperties::bucketWaitTimeout ( ) const
inline

Returns the connect wait timeout(in milliseconds) used for to connect to server This is only applicable for linux.

◆ conflateEvents()

const std::string & apache::geode::client::SystemProperties::conflateEvents ( ) const
inline

Returns client Queueconflation option.

◆ connectTimeout()

const std::chrono::milliseconds & apache::geode::client::SystemProperties::connectTimeout ( ) const
inline

Returns the connect timeout used for server and locator handshakes.

◆ connectWaitTimeout()

const std::chrono::milliseconds & apache::geode::client::SystemProperties::connectWaitTimeout ( ) const
inline

Returns the connect wait timeout(in milliseconds) used for to connect to server This is only applicable for linux.

◆ durableClientId()

const std::string & apache::geode::client::SystemProperties::durableClientId ( ) const
inline

Returns the durable client ID.

◆ durableTimeout()

const std::chrono::seconds & apache::geode::client::SystemProperties::durableTimeout ( ) const
inline

Returns the durable timeout.

◆ enableChunkHandlerThread()

bool apache::geode::client::SystemProperties::enableChunkHandlerThread ( ) const
inline

Returns true if chunk handler thread is enabled, false if not.

◆ getEnableTimeStatistics()

bool apache::geode::client::SystemProperties::getEnableTimeStatistics ( ) const
inline

Whether time stats are enabled for the statistics.

◆ heapLRUDelta()

int32_t apache::geode::client::SystemProperties::heapLRUDelta ( ) const
inline

Returns the HeapLRUDelta value (a percent value).

This specifies the percentage of entries the system will evict each time it detects that it has exceeded the HeapLRULimit. Defaults to 10%

◆ heapLRULimit()

size_t apache::geode::client::SystemProperties::heapLRULimit ( ) const
inline

Returns the HeapLRULimit value (in bytes), the maximum memory that values in a cache can use to store data before overflowing to disk or destroying entries to ensure that the server process never runs out of memory due to cache memory usage.

◆ heapLRULimitEnabled()

bool apache::geode::client::SystemProperties::heapLRULimitEnabled ( ) const
inline

Returns a boolean that specifies if heapLRULimit has been enabled for the process.

If enabled, the HeapLRULimit specifies the maximum amount of memory that values in a cache can use to store data before overflowing to disk or destroying entries to ensure that the server process never runs out of memory

◆ logDiskSpaceLimit()

uint32_t apache::geode::client::SystemProperties::logDiskSpaceLimit ( ) const
inline

Returns the log-disk-space-limit.

◆ logFilename()

const std::string & apache::geode::client::SystemProperties::logFilename ( ) const
inline

Returns the name of the filename into which logging would be done.

◆ logFileSizeLimit()

uint32_t apache::geode::client::SystemProperties::logFileSizeLimit ( ) const
inline

Returns the log-file-size-limit.

◆ logLevel()

LogLevel apache::geode::client::SystemProperties::logLevel ( ) const
inline

Returns the log level at which logging would be done.

◆ logSettings()

void apache::geode::client::SystemProperties::logSettings ( )

print all settings to the process log.

◆ maxSocketBufferSize()

int32_t apache::geode::client::SystemProperties::maxSocketBufferSize ( ) const
inline

Returns the maximum socket buffer size to use.

◆ notifyAckInterval()

const std::chrono::milliseconds & apache::geode::client::SystemProperties::notifyAckInterval ( ) const
inline

Returns the periodic notify ack interval.

◆ notifyDupCheckLife()

const std::chrono::milliseconds & apache::geode::client::SystemProperties::notifyDupCheckLife ( ) const
inline

Returns the expiry time of an idle event id map entry for duplicate notification checking.

◆ onClientDisconnectClearPdxTypeIds()

bool apache::geode::client::SystemProperties::onClientDisconnectClearPdxTypeIds ( ) const
inline

Returns true if app wants to clear pdx type ids when client disconnect.

default is false.

◆ pingInterval()

const std::chrono::seconds & apache::geode::client::SystemProperties::pingInterval ( ) const
inline

Returns the time between two consecutive pings to servers.

◆ processProperty()

void apache::geode::client::SystemProperties::processProperty ( const std::string &  property,
const std::string &  value 
)

Processes the given property/value pair, saving the results internally:

◆ redundancyMonitorInterval()

const std::chrono::seconds & apache::geode::client::SystemProperties::redundancyMonitorInterval ( ) const
inline

Returns the time between two consecutive checks for redundancy for HA.

◆ setEnableChunkHandlerThread()

void apache::geode::client::SystemProperties::setEnableChunkHandlerThread ( bool  set)
inline

Enables or disables the chunk handler thread.

◆ setLogLevel()

void apache::geode::client::SystemProperties::setLogLevel ( LogLevel  newLogLevel)
inline

Changes the current log level to newLogLevel.

◆ setOnClientDisconnectClearPdxTypeIds()

void apache::geode::client::SystemProperties::setOnClientDisconnectClearPdxTypeIds ( bool  set)
inline

Set to true if app wants to clear pdx type ids when client disconnect.

Default is false.

◆ sslEnabled()

bool apache::geode::client::SystemProperties::sslEnabled ( ) const
inline

Whether SSL is enabled for socket connections.

◆ sslKeyStore()

const std::string & apache::geode::client::SystemProperties::sslKeyStore ( ) const
inline

Returns the path of the private key file for SSL use.

◆ sslKeystorePassword()

const std::string & apache::geode::client::SystemProperties::sslKeystorePassword ( ) const
inline

Returns the client keystore password.

◆ sslTrustStore()

const std::string & apache::geode::client::SystemProperties::sslTrustStore ( ) const
inline

Returns the path of the public key file for SSL use.

◆ statisticsArchiveFile()

const std::string & apache::geode::client::SystemProperties::statisticsArchiveFile ( ) const
inline

Returns the name of the filename into which statistics would be archived.

◆ statisticsEnabled()

bool apache::geode::client::SystemProperties::statisticsEnabled ( ) const
inline

Tells whether statistics needs to be archived or not.

◆ statisticsSampleInterval()

const std::chrono::milliseconds apache::geode::client::SystemProperties::statisticsSampleInterval ( ) const
inline

Returns the sampling interval of the sampling thread.

This would be how often the statistics thread writes to disk.

◆ statsDiskSpaceLimit()

uint32_t apache::geode::client::SystemProperties::statsDiskSpaceLimit ( ) const
inline

Returns the stat-disk-size-limit.

◆ statsFileSizeLimit()

uint32_t apache::geode::client::SystemProperties::statsFileSizeLimit ( ) const
inline

Returns the stat-file-space-limit.

Field Documentation

◆ m_statisticsEnabled

_GEODE_DEPRECATED_ ( "Diffie-Hellman based credentials encryption is not supported.") const std bool apache::geode::client::SystemProperties::m_statisticsEnabled

Return the keystore (.pem file ) path.

Returns
Empty string
Deprecated:
Diffie-Hellman based credentials encryption is not supported.

Returns securityPropertiesPtr.

Returns
std::shared_ptr<Properties> value. Checks whether list of endpoint is shuffled or not.
bool value.
Deprecated:
Diffie-Hellman based credentials encryption is not supported.
Returns
false. Whether a non durable client starts to receive and process subscription events automatically. If set to false then a non-durable client should call the Cache::readyForEvents() method after all regions are created and listeners attached for the client to start receiving events whether the client is initialized programmatically or declaratively.
the value of the property. Returns the timeout after which suspended transactions are rolled back. Returns the tombstone timeout

Apache Geode C++ Cache API Documentation