Apache Geode Native C++

Pool Configuration Example and Settings

Connection pools require a standard client/server distributed system and cache configuration settings. You must also configure settings for the locator, server, and pool elements.

• Locator. Host and port where a server locator is listening.
• Server. Host and port where a server is listening.
• Pool. Client/server connection pool.

This page shows examples of creating a pool configuration programmatically using C++ code, and declaratively using XML.

Programmatic Pool Configuration

This example shows a programmatic pool configuration. For a list of the attributes you can configure, see PoolFactory in the API docs.

cache.getPoolManager()
      .createFactory()
      .addLocator("localhost", 34756)
      .setFreeConnectionTimeout(std::chrono::milliseconds(12345))
      .setIdleTimeout(std::chrono::milliseconds(5555))
      .setLoadConditioningInterval(std::chrono::milliseconds(23456))
      .setMaxConnections(7)
      .setMinConnections(3)
      .setPingInterval(std::chrono::milliseconds(12345))
      .setReadTimeout(std::chrono::milliseconds(23456))
      .setRetryAttempts(3)
      .setServerGroup("ServerGroup1")
      .setSocketBufferSize(32768)
      .setStatisticInterval(std::chrono::milliseconds(10123))
      .setSubscriptionAckInterval(std::chrono::milliseconds(567))
      .setSubscriptionEnabled(true)
      .setSubscriptionMessageTrackingTimeout(std::chrono::milliseconds(900123))
      .setSubscriptionRedundancy(0)
      .setThreadLocalConnections(true)
      .create("test_pool_1");

Declarative (File-based) Pool Configuration

This example shows a file-based pool configuration using an XML configuration file. Following the example is a table that describes the XML pool attributes you can configure.

Note: You create an instance of PoolFactory through PoolManager.

<pool free-connection-timeout="12345" idle-timeout="5555"
      load-conditioning-interval="23456"
      max-connections="7" min-connections="3"
      name="test_pool_1" ping-interval="12345"
      read-timeout="23456" retry-attempts="3" server-group="ServerGroup1"
      socket-buffer-size="32768" statistic-interval="10123"
      subscription-ack-interval="567" subscription-enabled="true"
      subscription-message-tracking-timeout="900123"
      subscription-redundancy="0" thread-local-connections="true">
   <locator host="localhost" port="34756"/>
</pool>

Pool Attributes