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(a)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 {
Show replies by date