modules/common/cassandra-ccm/cassandra-ccm-core/src/main/java/org/rhq/cassandra/DeploymentOptionsFactory.java | 11 ++++++++++ modules/common/cassandra-util/src/main/java/org/rhq/cassandra/util/ClusterBuilder.java | 4 +++ 2 files changed, 15 insertions(+)
New commits: commit c95589acf496f891f07417c5b9610dc64e7de0f5 Author: John Sanda jsanda@redhat.com Date: Fri Apr 26 21:41:39 2013 -0400
adding javadocs
diff --git a/modules/common/cassandra-ccm/cassandra-ccm-core/src/main/java/org/rhq/cassandra/DeploymentOptionsFactory.java b/modules/common/cassandra-ccm/cassandra-ccm-core/src/main/java/org/rhq/cassandra/DeploymentOptionsFactory.java index 7e585ac..5c111d6 100644 --- a/modules/common/cassandra-ccm/cassandra-ccm-core/src/main/java/org/rhq/cassandra/DeploymentOptionsFactory.java +++ b/modules/common/cassandra-ccm/cassandra-ccm-core/src/main/java/org/rhq/cassandra/DeploymentOptionsFactory.java @@ -26,10 +26,21 @@ package org.rhq.cassandra;
/** + * Creates {@link DeploymentOptions} objects. + * * @author John Sanda */ public class DeploymentOptionsFactory {
+ /** + * @return A new {@link DeploymentOptions}. This method checks the platform arch + * (32 bit vs 64 bit) and the JRE being used to determine if any particular defaults + * need to be set. For example, on 32 bit arches running on OpenJDK 6, Cassandra + * cannot use its default thread stack stack of 180k. It causes the JVM to segfault on + * start up. When this runtime environment is detected, the factory will set the + * appropriate system property so that a default thread stack of 240k is used. That + * can be overridden by calling {@link DeploymentOptions#setStackSize(String)}. + */ public DeploymentOptions newDeploymentOptions() { String arch = System.getProperty("os.arch"); String javaVMName = System.getProperty("java.vm.name"); diff --git a/modules/common/cassandra-util/src/main/java/org/rhq/cassandra/util/ClusterBuilder.java b/modules/common/cassandra-util/src/main/java/org/rhq/cassandra/util/ClusterBuilder.java index 6502df9..f6f81cf 100644 --- a/modules/common/cassandra-util/src/main/java/org/rhq/cassandra/util/ClusterBuilder.java +++ b/modules/common/cassandra-util/src/main/java/org/rhq/cassandra/util/ClusterBuilder.java @@ -30,6 +30,10 @@ import com.datastax.driver.core.Cluster; import com.datastax.driver.core.ProtocolOptions;
/** + * This class should generally be used for creating a {@link Cluster} instead of + * {@link Cluster.Builder}. It ensures that the cluster and session objects are configured + * in a consistent fashion everywhere they are used. + * * @author John Sanda */ public class ClusterBuilder {