Author: lewismc
Date: Wed Feb 12 13:16:26 2014
New Revision: 1567613
URL: http://svn.apache.org/r1567613
Log:
CMS commit to gora by lewismc
Modified:
gora/site/trunk/content/current/gora-cassandra.md
Modified: gora/site/trunk/content/current/gora-cassandra.md
URL:
http://svn.apache.org/viewvc/gora/site/trunk/content/current/gora-cassandra.md?rev=1567613&r1=1567612&r2=1567613&view=diff
==============================================================================
--- gora/site/trunk/content/current/gora-cassandra.md (original)
+++ gora/site/trunk/content/current/gora-cassandra.md Wed Feb 12 13:16:26 2014
@@ -29,17 +29,20 @@ Say we wished to map some Employee data
</class>
</gora-orm>
-Here you can see that within the keyspace section we specify the Cassandra
-keyspace schema name Employee, the host localhost and the cluster name
-Gora Cassandra Test Cluster. Additionally we are required to specify the type
of
-column families we wish to create within Cassandra. In this case we create
three columns;
-p, f and sc the last of which is further defined as a super column.
-Further to this, within the Cassandra mappings we are required to specify
persistent fields
-which values should map to. In the above example we see that within the class
element
-the generated class name org.apache.gora.examples.generated.Employee specifies
the Avro generated
-persistent class, the keyClass java.lang.String which specifies the keys which
map to the field
-values and finally the keyspace Employee which matches to the above keyspace
definition.
-Finally fields which are to be persisted into Cassandra need to be configuired
such that they
-receive a name (name, dateOfBirth, ssn and salary respectively), the column
family
-to which they belong (all p in this case) and additionally a qualifier, which
enables
+Here you can see that we require the definition of two child elements within
the
+<code>gora-orm</code> mapping configuration, namely;
+ 1. The keyspace element; where we specify:
+ the Cassandra keyspace schema name e.g. <b>Employee<>,
+ the host e.g. <b>localhost<.b>,
+ the Cassandra cluster name e.g. <b>Gora Cassandra Test Cluster</b>,
+ the type of column families we wish to create within Cassandra. In this
case we create three columns;
+<b>p</b>, <b>f</b> and <b>sc</b> the last of which is further defined as a
super column.
+ 2. Specification of persistent fields which values should map to;
+ the Persistent class name e.g.
<b>org.apache.gora.examples.generated.Employee</b>,
+ the keyClass e.g. <b>java.lang.String</b> which specifies the keys which
map to the field
+values,
+ the keyspace e.g. <b>Employee</b> which matches to the above keyspace
definition,
+ finally fields which are to be persisted into Cassandra need to be
configured such that they
+receive a <b>name</b> e.g. (name, dateOfBirth, ssn and salary respectively),
the column <b>family</b>
+to which they belong e.g. (all p in this case) and an additional
<b>qualifier</b>, which enables
more granular control over the data to be persisted into Cassandra.
