opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/DatastoreContext.java

   1 /*
   2  * Copyright (c) 2014 Brocade Communications Systems, Inc. and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8
   9 package org.opendaylight.controller.cluster.datastore;
  10
  11 import akka.util.Timeout;
  12 import com.google.common.annotations.VisibleForTesting;
  13 import com.google.common.base.Preconditions;
  14 import com.google.common.collect.Sets;
  15 import java.util.Set;
  16 import java.util.concurrent.TimeUnit;
  17 import org.apache.commons.lang3.text.WordUtils;
  18 import org.opendaylight.controller.cluster.common.actor.AkkaConfigurationReader;
  19 import org.opendaylight.controller.cluster.common.actor.FileAkkaConfigurationReader;
  20 import org.opendaylight.controller.cluster.raft.ConfigParams;
  21 import org.opendaylight.controller.cluster.raft.DefaultConfigParamsImpl;
  22 import org.opendaylight.controller.cluster.raft.PeerAddressResolver;
  23 import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType;
  24 import org.opendaylight.controller.md.sal.dom.store.impl.InMemoryDOMDataStoreConfigProperties;
  25 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
  26 import scala.concurrent.duration.Duration;
  27 import scala.concurrent.duration.FiniteDuration;
  28
  29 /**
  30  * Contains contextual data for a data store.
  31  *
  32  * @author Thomas Pantelis
  33  */
  34 public class DatastoreContext {
  35     public static final String METRICS_DOMAIN = "org.opendaylight.controller.cluster.datastore";
  36
  37     public static final Duration DEFAULT_SHARD_TRANSACTION_IDLE_TIMEOUT = Duration.create(10, TimeUnit.MINUTES);
  38     public static final int DEFAULT_OPERATION_TIMEOUT_IN_MS = 5000;
  39     public static final int DEFAULT_SHARD_TX_COMMIT_TIMEOUT_IN_SECONDS = 30;
  40     public static final int DEFAULT_JOURNAL_RECOVERY_BATCH_SIZE = 1;
  41     public static final int DEFAULT_SNAPSHOT_BATCH_COUNT = 20000;
  42     public static final int DEFAULT_HEARTBEAT_INTERVAL_IN_MILLIS = 500;
  43     public static final int DEFAULT_ISOLATED_LEADER_CHECK_INTERVAL_IN_MILLIS =
  44             DEFAULT_HEARTBEAT_INTERVAL_IN_MILLIS * 10;
  45     public static final int DEFAULT_SHARD_TX_COMMIT_QUEUE_CAPACITY = 50000;
  46     public static final Timeout DEFAULT_SHARD_INITIALIZATION_TIMEOUT = new Timeout(5, TimeUnit.MINUTES);
  47     public static final Timeout DEFAULT_SHARD_LEADER_ELECTION_TIMEOUT = new Timeout(30, TimeUnit.SECONDS);
  48     public static final boolean DEFAULT_PERSISTENT = true;
  49     public static final FileAkkaConfigurationReader DEFAULT_CONFIGURATION_READER = new FileAkkaConfigurationReader();
  50     public static final int DEFAULT_SHARD_SNAPSHOT_DATA_THRESHOLD_PERCENTAGE = 12;
  51     public static final int DEFAULT_SHARD_ELECTION_TIMEOUT_FACTOR = 2;
  52     public static final int DEFAULT_TX_CREATION_INITIAL_RATE_LIMIT = 100;
  53     public static final String UNKNOWN_DATA_STORE_TYPE = "unknown";
  54     public static final int DEFAULT_SHARD_BATCHED_MODIFICATION_COUNT = 1000;
  55     public static final long DEFAULT_SHARD_COMMIT_QUEUE_EXPIRY_TIMEOUT_IN_MS =
  56             TimeUnit.MILLISECONDS.convert(2, TimeUnit.MINUTES);
  57     public static final int DEFAULT_SHARD_SNAPSHOT_CHUNK_SIZE = 2048000;
  58
  59     private static final Set<String> GLOBAL_DATASTORE_NAMES = Sets.newConcurrentHashSet();
  60
  61     private InMemoryDOMDataStoreConfigProperties dataStoreProperties;
  62     private Duration shardTransactionIdleTimeout = DatastoreContext.DEFAULT_SHARD_TRANSACTION_IDLE_TIMEOUT;
  63     private long operationTimeoutInMillis = DEFAULT_OPERATION_TIMEOUT_IN_MS;
  64     private String dataStoreMXBeanType;
  65     private int shardTransactionCommitTimeoutInSeconds = DEFAULT_SHARD_TX_COMMIT_TIMEOUT_IN_SECONDS;
  66     private int shardTransactionCommitQueueCapacity = DEFAULT_SHARD_TX_COMMIT_QUEUE_CAPACITY;
  67     private Timeout shardInitializationTimeout = DEFAULT_SHARD_INITIALIZATION_TIMEOUT;
  68     private Timeout shardLeaderElectionTimeout = DEFAULT_SHARD_LEADER_ELECTION_TIMEOUT;
  69     private boolean persistent = DEFAULT_PERSISTENT;
  70     private AkkaConfigurationReader configurationReader = DEFAULT_CONFIGURATION_READER;
  71     private long transactionCreationInitialRateLimit = DEFAULT_TX_CREATION_INITIAL_RATE_LIMIT;
  72     private final DefaultConfigParamsImpl raftConfig = new DefaultConfigParamsImpl();
  73     private String dataStoreName = UNKNOWN_DATA_STORE_TYPE;
  74     private LogicalDatastoreType logicalStoreType = LogicalDatastoreType.OPERATIONAL;
  75     private YangInstanceIdentifier storeRoot = YangInstanceIdentifier.EMPTY;
  76     private int shardBatchedModificationCount = DEFAULT_SHARD_BATCHED_MODIFICATION_COUNT;
  77     private boolean writeOnlyTransactionOptimizationsEnabled = true;
  78     private long shardCommitQueueExpiryTimeoutInMillis = DEFAULT_SHARD_COMMIT_QUEUE_EXPIRY_TIMEOUT_IN_MS;
  79     private boolean useTellBasedProtocol = false;
  80     private boolean transactionDebugContextEnabled = false;
  81     private String shardManagerPersistenceId;
  82
  83     public static Set<String> getGlobalDatastoreNames() {
  84         return GLOBAL_DATASTORE_NAMES;
  85     }
  86
  87     private DatastoreContext() {
  88         setShardJournalRecoveryLogBatchSize(DEFAULT_JOURNAL_RECOVERY_BATCH_SIZE);
  89         setSnapshotBatchCount(DEFAULT_SNAPSHOT_BATCH_COUNT);
  90         setHeartbeatInterval(DEFAULT_HEARTBEAT_INTERVAL_IN_MILLIS);
  91         setIsolatedLeaderCheckInterval(DEFAULT_ISOLATED_LEADER_CHECK_INTERVAL_IN_MILLIS);
  92         setSnapshotDataThresholdPercentage(DEFAULT_SHARD_SNAPSHOT_DATA_THRESHOLD_PERCENTAGE);
  93         setElectionTimeoutFactor(DEFAULT_SHARD_ELECTION_TIMEOUT_FACTOR);
  94         setShardSnapshotChunkSize(DEFAULT_SHARD_SNAPSHOT_CHUNK_SIZE);
  95     }
  96
  97     private DatastoreContext(final DatastoreContext other) {
  98         this.dataStoreProperties = other.dataStoreProperties;
  99         this.shardTransactionIdleTimeout = other.shardTransactionIdleTimeout;
 100         this.operationTimeoutInMillis = other.operationTimeoutInMillis;
 101         this.dataStoreMXBeanType = other.dataStoreMXBeanType;
 102         this.shardTransactionCommitTimeoutInSeconds = other.shardTransactionCommitTimeoutInSeconds;
 103         this.shardTransactionCommitQueueCapacity = other.shardTransactionCommitQueueCapacity;
 104         this.shardInitializationTimeout = other.shardInitializationTimeout;
 105         this.shardLeaderElectionTimeout = other.shardLeaderElectionTimeout;
 106         this.persistent = other.persistent;
 107         this.configurationReader = other.configurationReader;
 108         this.transactionCreationInitialRateLimit = other.transactionCreationInitialRateLimit;
 109         this.dataStoreName = other.dataStoreName;
 110         this.logicalStoreType = other.logicalStoreType;
 111         this.storeRoot = other.storeRoot;
 112         this.shardBatchedModificationCount = other.shardBatchedModificationCount;
 113         this.writeOnlyTransactionOptimizationsEnabled = other.writeOnlyTransactionOptimizationsEnabled;
 114         this.shardCommitQueueExpiryTimeoutInMillis = other.shardCommitQueueExpiryTimeoutInMillis;
 115         this.transactionDebugContextEnabled = other.transactionDebugContextEnabled;
 116         this.shardManagerPersistenceId = other.shardManagerPersistenceId;
 117         this.useTellBasedProtocol = other.useTellBasedProtocol;
 118
 119         setShardJournalRecoveryLogBatchSize(other.raftConfig.getJournalRecoveryLogBatchSize());
 120         setSnapshotBatchCount(other.raftConfig.getSnapshotBatchCount());
 121         setHeartbeatInterval(other.raftConfig.getHeartBeatInterval().toMillis());
 122         setIsolatedLeaderCheckInterval(other.raftConfig.getIsolatedCheckIntervalInMillis());
 123         setSnapshotDataThresholdPercentage(other.raftConfig.getSnapshotDataThresholdPercentage());
 124         setElectionTimeoutFactor(other.raftConfig.getElectionTimeoutFactor());
 125         setCustomRaftPolicyImplementation(other.raftConfig.getCustomRaftPolicyImplementationClass());
 126         setShardSnapshotChunkSize(other.raftConfig.getSnapshotChunkSize());
 127         setPeerAddressResolver(other.raftConfig.getPeerAddressResolver());
 128         setTempFileDirectory(other.getTempFileDirectory());
 129         setFileBackedStreamingThreshold(other.getFileBackedStreamingThreshold());
 130     }
 131
 132     public static Builder newBuilder() {
 133         return new Builder(new DatastoreContext());
 134     }
 135
 136     public static Builder newBuilderFrom(DatastoreContext context) {
 137         return new Builder(new DatastoreContext(context));
 138     }
 139
 140     public InMemoryDOMDataStoreConfigProperties getDataStoreProperties() {
 141         return dataStoreProperties;
 142     }
 143
 144     public Duration getShardTransactionIdleTimeout() {
 145         return shardTransactionIdleTimeout;
 146     }
 147
 148     public String getDataStoreMXBeanType() {
 149         return dataStoreMXBeanType;
 150     }
 151
 152     public long getOperationTimeoutInMillis() {
 153         return operationTimeoutInMillis;
 154     }
 155
 156     public ConfigParams getShardRaftConfig() {
 157         return raftConfig;
 158     }
 159
 160     public int getShardTransactionCommitTimeoutInSeconds() {
 161         return shardTransactionCommitTimeoutInSeconds;
 162     }
 163
 164     public int getShardTransactionCommitQueueCapacity() {
 165         return shardTransactionCommitQueueCapacity;
 166     }
 167
 168     public Timeout getShardInitializationTimeout() {
 169         return shardInitializationTimeout;
 170     }
 171
 172     public Timeout getShardLeaderElectionTimeout() {
 173         return shardLeaderElectionTimeout;
 174     }
 175
 176     public boolean isPersistent() {
 177         return persistent;
 178     }
 179
 180     public AkkaConfigurationReader getConfigurationReader() {
 181         return configurationReader;
 182     }
 183
 184     public long getShardElectionTimeoutFactor() {
 185         return raftConfig.getElectionTimeoutFactor();
 186     }
 187
 188     public String getDataStoreName() {
 189         return dataStoreName;
 190     }
 191
 192     public LogicalDatastoreType getLogicalStoreType() {
 193         return logicalStoreType;
 194     }
 195
 196     public YangInstanceIdentifier getStoreRoot() {
 197         return storeRoot;
 198     }
 199
 200     public long getTransactionCreationInitialRateLimit() {
 201         return transactionCreationInitialRateLimit;
 202     }
 203
 204     public String getShardManagerPersistenceId() {
 205         return shardManagerPersistenceId;
 206     }
 207
 208     public String getTempFileDirectory() {
 209         return raftConfig.getTempFileDirectory();
 210     }
 211
 212     private void setTempFileDirectory(String tempFileDirectory) {
 213         raftConfig.setTempFileDirectory(tempFileDirectory);
 214     }
 215
 216     public int getFileBackedStreamingThreshold() {
 217         return raftConfig.getFileBackedStreamingThreshold();
 218     }
 219
 220     private void setFileBackedStreamingThreshold(int fileBackedStreamingThreshold) {
 221         raftConfig.setFileBackedStreamingThreshold(fileBackedStreamingThreshold);
 222     }
 223
 224     private void setPeerAddressResolver(PeerAddressResolver resolver) {
 225         raftConfig.setPeerAddressResolver(resolver);
 226     }
 227
 228     private void setHeartbeatInterval(long shardHeartbeatIntervalInMillis) {
 229         raftConfig.setHeartBeatInterval(new FiniteDuration(shardHeartbeatIntervalInMillis,
 230                 TimeUnit.MILLISECONDS));
 231     }
 232
 233     private void setShardJournalRecoveryLogBatchSize(int shardJournalRecoveryLogBatchSize) {
 234         raftConfig.setJournalRecoveryLogBatchSize(shardJournalRecoveryLogBatchSize);
 235     }
 236
 237
 238     private void setIsolatedLeaderCheckInterval(long shardIsolatedLeaderCheckIntervalInMillis) {
 239         raftConfig.setIsolatedLeaderCheckInterval(
 240                 new FiniteDuration(shardIsolatedLeaderCheckIntervalInMillis, TimeUnit.MILLISECONDS));
 241     }
 242
 243     private void setElectionTimeoutFactor(long shardElectionTimeoutFactor) {
 244         raftConfig.setElectionTimeoutFactor(shardElectionTimeoutFactor);
 245     }
 246
 247     private void setCustomRaftPolicyImplementation(String customRaftPolicyImplementation) {
 248         raftConfig.setCustomRaftPolicyImplementationClass(customRaftPolicyImplementation);
 249     }
 250
 251     private void setSnapshotDataThresholdPercentage(int shardSnapshotDataThresholdPercentage) {
 252         Preconditions.checkArgument(shardSnapshotDataThresholdPercentage >= 0
 253                 && shardSnapshotDataThresholdPercentage <= 100);
 254         raftConfig.setSnapshotDataThresholdPercentage(shardSnapshotDataThresholdPercentage);
 255     }
 256
 257     private void setSnapshotBatchCount(long shardSnapshotBatchCount) {
 258         raftConfig.setSnapshotBatchCount(shardSnapshotBatchCount);
 259     }
 260
 261     private void setShardSnapshotChunkSize(int shardSnapshotChunkSize) {
 262         raftConfig.setSnapshotChunkSize(shardSnapshotChunkSize);
 263     }
 264
 265     public int getShardBatchedModificationCount() {
 266         return shardBatchedModificationCount;
 267     }
 268
 269     public boolean isWriteOnlyTransactionOptimizationsEnabled() {
 270         return writeOnlyTransactionOptimizationsEnabled;
 271     }
 272
 273     public long getShardCommitQueueExpiryTimeoutInMillis() {
 274         return shardCommitQueueExpiryTimeoutInMillis;
 275     }
 276
 277     public boolean isTransactionDebugContextEnabled() {
 278         return transactionDebugContextEnabled;
 279     }
 280
 281     public boolean isUseTellBasedProtocol() {
 282         return useTellBasedProtocol;
 283     }
 284
 285     public int getShardSnapshotChunkSize() {
 286         return raftConfig.getSnapshotChunkSize();
 287     }
 288
 289     public static class Builder {
 290         private final DatastoreContext datastoreContext;
 291         private int maxShardDataChangeExecutorPoolSize =
 292                 InMemoryDOMDataStoreConfigProperties.DEFAULT_MAX_DATA_CHANGE_EXECUTOR_POOL_SIZE;
 293         private int maxShardDataChangeExecutorQueueSize =
 294                 InMemoryDOMDataStoreConfigProperties.DEFAULT_MAX_DATA_CHANGE_EXECUTOR_QUEUE_SIZE;
 295         private int maxShardDataChangeListenerQueueSize =
 296                 InMemoryDOMDataStoreConfigProperties.DEFAULT_MAX_DATA_CHANGE_LISTENER_QUEUE_SIZE;
 297         private int maxShardDataStoreExecutorQueueSize =
 298                 InMemoryDOMDataStoreConfigProperties.DEFAULT_MAX_DATA_STORE_EXECUTOR_QUEUE_SIZE;
 299
 300         private Builder(DatastoreContext datastoreContext) {
 301             this.datastoreContext = datastoreContext;
 302
 303             if (datastoreContext.getDataStoreProperties() != null) {
 304                 maxShardDataChangeExecutorPoolSize =
 305                         datastoreContext.getDataStoreProperties().getMaxDataChangeExecutorPoolSize();
 306                 maxShardDataChangeExecutorQueueSize =
 307                         datastoreContext.getDataStoreProperties().getMaxDataChangeExecutorQueueSize();
 308                 maxShardDataChangeListenerQueueSize =
 309                         datastoreContext.getDataStoreProperties().getMaxDataChangeListenerQueueSize();
 310                 maxShardDataStoreExecutorQueueSize =
 311                         datastoreContext.getDataStoreProperties().getMaxDataStoreExecutorQueueSize();
 312             }
 313         }
 314
 315         public Builder boundedMailboxCapacity(int boundedMailboxCapacity) {
 316             // TODO - this is defined in the yang DataStoreProperties but not currently used.
 317             return this;
 318         }
 319
 320         public Builder enableMetricCapture(boolean enableMetricCapture) {
 321             // TODO - this is defined in the yang DataStoreProperties but not currently used.
 322             return this;
 323         }
 324
 325
 326         public Builder shardTransactionIdleTimeout(long timeout, TimeUnit unit) {
 327             datastoreContext.shardTransactionIdleTimeout = Duration.create(timeout, unit);
 328             return this;
 329         }
 330
 331         public Builder shardTransactionIdleTimeoutInMinutes(long timeout) {
 332             return shardTransactionIdleTimeout(timeout, TimeUnit.MINUTES);
 333         }
 334
 335         public Builder operationTimeoutInSeconds(int operationTimeoutInSeconds) {
 336             datastoreContext.operationTimeoutInMillis = TimeUnit.SECONDS.toMillis(operationTimeoutInSeconds);
 337             return this;
 338         }
 339
 340         public Builder operationTimeoutInMillis(long operationTimeoutInMillis) {
 341             datastoreContext.operationTimeoutInMillis = operationTimeoutInMillis;
 342             return this;
 343         }
 344
 345         public Builder dataStoreMXBeanType(String dataStoreMXBeanType) {
 346             datastoreContext.dataStoreMXBeanType = dataStoreMXBeanType;
 347             return this;
 348         }
 349
 350         public Builder shardTransactionCommitTimeoutInSeconds(int shardTransactionCommitTimeoutInSeconds) {
 351             datastoreContext.shardTransactionCommitTimeoutInSeconds = shardTransactionCommitTimeoutInSeconds;
 352             return this;
 353         }
 354
 355         public Builder shardJournalRecoveryLogBatchSize(int shardJournalRecoveryLogBatchSize) {
 356             datastoreContext.setShardJournalRecoveryLogBatchSize(shardJournalRecoveryLogBatchSize);
 357             return this;
 358         }
 359
 360         public Builder shardSnapshotBatchCount(int shardSnapshotBatchCount) {
 361             datastoreContext.setSnapshotBatchCount(shardSnapshotBatchCount);
 362             return this;
 363         }
 364
 365         public Builder shardSnapshotDataThresholdPercentage(int shardSnapshotDataThresholdPercentage) {
 366             datastoreContext.setSnapshotDataThresholdPercentage(shardSnapshotDataThresholdPercentage);
 367             return this;
 368         }
 369
 370         public Builder shardHeartbeatIntervalInMillis(int shardHeartbeatIntervalInMillis) {
 371             datastoreContext.setHeartbeatInterval(shardHeartbeatIntervalInMillis);
 372             return this;
 373         }
 374
 375         public Builder shardTransactionCommitQueueCapacity(int shardTransactionCommitQueueCapacity) {
 376             datastoreContext.shardTransactionCommitQueueCapacity = shardTransactionCommitQueueCapacity;
 377             return this;
 378         }
 379
 380         public Builder shardInitializationTimeout(long timeout, TimeUnit unit) {
 381             datastoreContext.shardInitializationTimeout = new Timeout(timeout, unit);
 382             return this;
 383         }
 384
 385         public Builder shardInitializationTimeoutInSeconds(long timeout) {
 386             return shardInitializationTimeout(timeout, TimeUnit.SECONDS);
 387         }
 388
 389         public Builder shardLeaderElectionTimeout(long timeout, TimeUnit unit) {
 390             datastoreContext.shardLeaderElectionTimeout = new Timeout(timeout, unit);
 391             return this;
 392         }
 393
 394         public Builder shardLeaderElectionTimeoutInSeconds(long timeout) {
 395             return shardLeaderElectionTimeout(timeout, TimeUnit.SECONDS);
 396         }
 397
 398         public Builder configurationReader(AkkaConfigurationReader configurationReader) {
 399             datastoreContext.configurationReader = configurationReader;
 400             return this;
 401         }
 402
 403         public Builder persistent(boolean persistent) {
 404             datastoreContext.persistent = persistent;
 405             return this;
 406         }
 407
 408         public Builder shardIsolatedLeaderCheckIntervalInMillis(int shardIsolatedLeaderCheckIntervalInMillis) {
 409             datastoreContext.setIsolatedLeaderCheckInterval(shardIsolatedLeaderCheckIntervalInMillis);
 410             return this;
 411         }
 412
 413         public Builder shardElectionTimeoutFactor(long shardElectionTimeoutFactor) {
 414             datastoreContext.setElectionTimeoutFactor(shardElectionTimeoutFactor);
 415             return this;
 416         }
 417
 418         public Builder transactionCreationInitialRateLimit(long initialRateLimit) {
 419             datastoreContext.transactionCreationInitialRateLimit = initialRateLimit;
 420             return this;
 421         }
 422
 423         public Builder logicalStoreType(LogicalDatastoreType logicalStoreType) {
 424             datastoreContext.logicalStoreType = Preconditions.checkNotNull(logicalStoreType);
 425
 426             // Retain compatible naming
 427             switch (logicalStoreType) {
 428                 case CONFIGURATION:
 429                     dataStoreName("config");
 430                     break;
 431                 case OPERATIONAL:
 432                     dataStoreName("operational");
 433                     break;
 434                 default:
 435                     dataStoreName(logicalStoreType.name());
 436             }
 437
 438             return this;
 439         }
 440
 441         public Builder storeRoot(final YangInstanceIdentifier storeRoot) {
 442             datastoreContext.storeRoot = storeRoot;
 443             return this;
 444         }
 445
 446         public Builder dataStoreName(String dataStoreName) {
 447             datastoreContext.dataStoreName = Preconditions.checkNotNull(dataStoreName);
 448             datastoreContext.dataStoreMXBeanType = "Distributed" + WordUtils.capitalize(dataStoreName) + "Datastore";
 449             return this;
 450         }
 451
 452         public Builder shardBatchedModificationCount(final int shardBatchedModificationCount) {
 453             datastoreContext.shardBatchedModificationCount = shardBatchedModificationCount;
 454             return this;
 455         }
 456
 457         public Builder writeOnlyTransactionOptimizationsEnabled(boolean value) {
 458             datastoreContext.writeOnlyTransactionOptimizationsEnabled = value;
 459             return this;
 460         }
 461
 462         public Builder shardCommitQueueExpiryTimeoutInMillis(long value) {
 463             datastoreContext.shardCommitQueueExpiryTimeoutInMillis = value;
 464             return this;
 465         }
 466
 467         public Builder shardCommitQueueExpiryTimeoutInSeconds(long value) {
 468             datastoreContext.shardCommitQueueExpiryTimeoutInMillis = TimeUnit.MILLISECONDS.convert(
 469                     value, TimeUnit.SECONDS);
 470             return this;
 471         }
 472
 473         public Builder transactionDebugContextEnabled(boolean value) {
 474             datastoreContext.transactionDebugContextEnabled = value;
 475             return this;
 476         }
 477
 478         public Builder maxShardDataChangeExecutorPoolSize(int maxShardDataChangeExecutorPoolSize) {
 479             this.maxShardDataChangeExecutorPoolSize = maxShardDataChangeExecutorPoolSize;
 480             return this;
 481         }
 482
 483         public Builder maxShardDataChangeExecutorQueueSize(int maxShardDataChangeExecutorQueueSize) {
 484             this.maxShardDataChangeExecutorQueueSize = maxShardDataChangeExecutorQueueSize;
 485             return this;
 486         }
 487
 488         public Builder maxShardDataChangeListenerQueueSize(int maxShardDataChangeListenerQueueSize) {
 489             this.maxShardDataChangeListenerQueueSize = maxShardDataChangeListenerQueueSize;
 490             return this;
 491         }
 492
 493         public Builder maxShardDataStoreExecutorQueueSize(int maxShardDataStoreExecutorQueueSize) {
 494             this.maxShardDataStoreExecutorQueueSize = maxShardDataStoreExecutorQueueSize;
 495             return this;
 496         }
 497
 498         public Builder useTellBasedProtocol(boolean value) {
 499             datastoreContext.useTellBasedProtocol = value;
 500             return this;
 501         }
 502
 503         /**
 504          * For unit tests only.
 505          */
 506         @VisibleForTesting
 507         public Builder shardManagerPersistenceId(String id) {
 508             datastoreContext.shardManagerPersistenceId = id;
 509             return this;
 510         }
 511
 512         public DatastoreContext build() {
 513             datastoreContext.dataStoreProperties = InMemoryDOMDataStoreConfigProperties.create(
 514                     maxShardDataChangeExecutorPoolSize, maxShardDataChangeExecutorQueueSize,
 515                     maxShardDataChangeListenerQueueSize, maxShardDataStoreExecutorQueueSize);
 516
 517             if (datastoreContext.dataStoreName != null) {
 518                 GLOBAL_DATASTORE_NAMES.add(datastoreContext.dataStoreName);
 519             }
 520
 521             return datastoreContext;
 522         }
 523
 524         public Builder customRaftPolicyImplementation(String customRaftPolicyImplementation) {
 525             datastoreContext.setCustomRaftPolicyImplementation(customRaftPolicyImplementation);
 526             return this;
 527         }
 528
 529         public Builder shardSnapshotChunkSize(int shardSnapshotChunkSize) {
 530             datastoreContext.setShardSnapshotChunkSize(shardSnapshotChunkSize);
 531             return this;
 532         }
 533
 534         public Builder shardPeerAddressResolver(PeerAddressResolver resolver) {
 535             datastoreContext.setPeerAddressResolver(resolver);
 536             return this;
 537         }
 538
 539         public Builder tempFileDirectory(String tempFileDirectory) {
 540             datastoreContext.setTempFileDirectory(tempFileDirectory);
 541             return this;
 542         }
 543
 544         public Builder fileBackedStreamingThresholdInMegabytes(int  fileBackedStreamingThreshold) {
 545             datastoreContext.setFileBackedStreamingThreshold(fileBackedStreamingThreshold * ConfigParams.MEGABYTE);
 546             return this;
 547         }
 548     }
 549 }