gora-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lewi...@apache.org
Subject svn commit: r1757437 - /gora/site/trunk/content/current/gora-couchdb.md
Date Tue, 23 Aug 2016 21:46:30 GMT
Author: lewismc
Date: Tue Aug 23 21:46:30 2016
New Revision: 1757437

URL: http://svn.apache.org/viewvc?rev=1757437&view=rev
GORA-489 Adding CouchDB Datastore Documentation


Added: gora/site/trunk/content/current/gora-couchdb.md
URL: http://svn.apache.org/viewvc/gora/site/trunk/content/current/gora-couchdb.md?rev=1757437&view=auto
--- gora/site/trunk/content/current/gora-couchdb.md (added)
+++ gora/site/trunk/content/current/gora-couchdb.md Tue Aug 23 21:46:30 2016
@@ -0,0 +1,36 @@
+Title: Gora CouchDB Module
+This is the main documentation for the gora-couchdb module. gora-couchdb module enables [Apache
CouchDB](http://couchdb.apache.org/) backend support for Gora.
+* <code>gora.datastore.default=org.apache.gora.couchdb.store.CouchDBStore</code>
- Implementation of the storage class 
+* <code>gora.datastore.couchdb.server=localhost</code> - Property pointing to
the host where the server is running
+* <code>gora.datastore.couchdb.port=5984</code> - Property pointing to the port
where the server is running
+* <code>gora.datastore.mapping.file=gora-couchdb-mapping.xml</code> -  The XML
mapping file to be used. If no value is used this defaults to.
+##Gora CouchDB mappings
+You should then create a gora-couchdb-mapping.xml which will describe how you want to store
each of your Gora persistent objects:
+    <gora-otd>
+        <class name="org.apache.gora.examples.generated.Employee" keyClass="java.lang.String"
+       		<field name="name"/>
+    		<field name="dateOfBirth"/>
+    		<field name="ssn"/>
+    		<field name="salary"/>
+    		<field name="boss"/>
+    		<field name="webpage"/>
+  		</class>		
+    </gora-otd>		
+Here you can see that we require the definition of two child elements within the <code>gora-otd</code>
mapping configuration, namely;
+The class element where we specify of persistent fields which values should map to. This
+1. a parameter containing the Persistent class name e.g. : <b>org.apache.gora.examples.generated.Employee
+2. a parameter containing the keyClass e.g. <b>java.lang.String</b> which specifies
the keys which map to the field values,
+3. finally nested child element(s) mapping fields which are to be persisted into CouchDB.
These fields need to be configured such that they receive; a parameter containing the name
e.g. (name, dateOfBirth, ssn and salary respectively),

View raw message