You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@gora.apache.org by bu...@apache.org on 2013/06/18 01:55:24 UTC

svn commit: r865996 - in /websites/staging/gora/trunk/content: ./ current/tutorial.html

Author: buildbot
Date: Mon Jun 17 23:55:24 2013
New Revision: 865996

Log:
Staging update by buildbot for gora

Modified:
    websites/staging/gora/trunk/content/   (props changed)
    websites/staging/gora/trunk/content/current/tutorial.html

Propchange: websites/staging/gora/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Jun 17 23:55:24 2013
@@ -1 +1 @@
-1493895
+1493978

Modified: websites/staging/gora/trunk/content/current/tutorial.html
==============================================================================
--- websites/staging/gora/trunk/content/current/tutorial.html (original)
+++ websites/staging/gora/trunk/content/current/tutorial.html Mon Jun 17 23:55:24 2013
@@ -383,53 +383,52 @@ are serialized and persisted to the data
 <h3 id="hbase-mappings">HBase mappings</h3>
 <p>HBase mappings are stored at file named gora-hbase-mappings.xml. 
 For this tutorial we will be using the file gora-tutorial/conf/gora-hbase-mappings.xml.</p>
-<div class="codehilite"><pre>  <span class="o">&lt;</span>!<span class="o">--</span>  <span class="n">This</span> <span class="n">is</span> <span class="n">gora</span><span class="o">-</span><span class="n">sql</span><span class="o">-</span><span class="n">mapping</span><span class="p">.</span><span class="n">xml</span>
-</pre></div>
+<div class="codehilite"><pre>  <span class="c">&lt;!--  This is gora-sql-mapping.xml</span>
 
+<span class="c">&lt;gora-orm&gt;</span>
+<span class="c">  &lt;class name=&quot;org.apache.gora.tutorial.log.generated.Pageview&quot; keyClass=&quot;java.lang.Long&quot; table=&quot;AccessLog&quot;&gt;</span>
+<span class="c">   &lt;primarykey column=&quot;line&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;url&quot; column=&quot;url&quot; length=&quot;512&quot; primarykey=&quot;true&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;timestamp&quot; column=&quot;timestamp&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;ip&quot; column=&quot;ip&quot; length=&quot;16&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;httpMethod&quot; column=&quot;httpMethod&quot; length=&quot;6&quot;/&gt;</span>
+<span class="c">  &lt;;field name=&quot;httpStatusCode&quot; column=&quot;httpStatusCode&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;responseSize&quot; column=&quot;responseSize&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;referrer&quot; column=&quot;referrer&quot; length=&quot;512&quot;/&gt;</span>
+<span class="c">  &lt;field name=&quot;userAgent&quot; column=&quot;userAgent&quot; length=&quot;512&quot;/&gt;</span>
+<span class="c">  &lt;/class&amp;gt;</span>
+
+<span class="c"> ...</span>
+
+<span class="c">&lt;/gora-orm&gt;</span>
+
+<span class="c">  --&gt;</span>
+
+<span class="nt">&lt;gora-orm</span><span class="err">&amp;gt;</span>
+  <span class="err">&lt;table</span> <span class="na">name=</span><span class="s">&quot;Pageview&quot;</span><span class="nt">&gt;</span> <span class="c">&lt;!-- optional descriptors for tables --&gt;</span>
+    <span class="nt">&lt;family</span> <span class="na">name=</span><span class="s">&quot;common&quot;</span><span class="nt">&gt;</span> <span class="c">&lt;!-- This can also have params like compression, bloom filters --&gt;</span>
+    <span class="nt">&lt;family</span> <span class="na">name=</span><span class="s">&quot;http&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;family</span> <span class="na">name=</span><span class="s">&quot;misc&quot;</span><span class="nt">/&gt;</span>
+  <span class="nt">&lt;/table&gt;</span>
+
+  <span class="nt">&lt;class</span> <span class="na">name=</span><span class="s">&quot;org.apache.gora.tutorial.log.generated.Pageview&quot;</span> <span class="na">keyClass=</span><span class="s">&quot;java.lang.Long&quot;</span> <span class="na">table=</span><span class="s">&quot;AccessLog&quot;</span><span class="nt">&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;url&quot;</span> <span class="na">family=</span><span class="s">&quot;common&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;url&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;timestamp&quot;</span> <span class="na">family=</span><span class="s">&quot;common&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;timestamp&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;ip&quot;</span> <span class="na">family=</span><span class="s">&quot;common&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;ip&quot;</span> <span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;httpMethod&quot;</span> <span class="na">family=</span><span class="s">&quot;http&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;httpMethod&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;httpStatusCode&quot;</span> <span class="na">family=</span><span class="s">&quot;http&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;httpStatusCode&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;responseSize&quot;</span> <span class="na">family=</span><span class="s">&quot;http&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;responseSize&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;referrer&quot;</span> <span class="na">family=</span><span class="s">&quot;misc&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;referrer&quot;</span><span class="nt">/&gt;</span>
+   <span class="nt">&lt;field</span> <span class="na">name=</span><span class="s">&quot;userAgent&quot;</span> <span class="na">family=</span><span class="s">&quot;misc&quot;</span> <span class="na">qualifier=</span><span class="s">&quot;userAgent&quot;</span><span class="nt">/&gt;</span>
+  <span class="nt">&lt;/class&gt;</span>
 
-<p><source>
- &lt;gora-orm&gt;
-  &lt;class name="org.apache.gora.tutorial.log.generated.Pageview" keyClass="java.lang.Long" table="AccessLog"&gt;
-    &lt;primarykey column="line"/&gt;
-    &lt;field name="url" column="url" length="512" primarykey="true"/&gt;
-    &lt;field name="timestamp" column="timestamp"/&gt;
-    &lt;field name="ip" column="ip" length="16"/&gt;
-    &lt;field name="httpMethod" column="httpMethod" length="6"/&gt;
-    &lt;field name="httpStatusCode" column="httpStatusCode"/&gt;
-    &lt;field name="responseSize" column="responseSize"/&gt;
-    &lt;field name="referrer" column="referrer" length="512"/&gt;
-    &lt;field name="userAgent" column="userAgent" length="512"/&gt;
-  &lt;/class&gt;</p>
-<p>...</p>
-<p>&lt;/gora-orm&gt;</p>
-<div class="codehilite"><pre>  <span class="o">&lt;/</span><span class="n">source</span><span class="o">&gt;</span>
-  <span class="o">--&gt;</span>
-
-<span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">gora</span><span class="o">-</span><span class="n">orm</span><span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span>
-  <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">table</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">Pageview</span>&quot;<span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span> <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span>!<span class="o">--</span> <span class="n">optional</span> <span class="n">descriptors</span> <span class="k">for</span> <span class="n">tables</span> <span class="o">--&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">family</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">common</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span> <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span>!<span class="o">--</span> <span class="n">This</span> <span class="n">can</span> <span class="n">also</span> <span class="n">have</span> <span class="n">params</span> <span class="n">like</span> <span class="n">compression</span><span class="p">,</span> <span class="n">bloom</span> <span class="n">filters</span> <span class="o">--&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">family</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">http</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">family</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">misc</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-  <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="o">/</span><span class="n">table</span><span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span>
-
-  <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">class</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">gora</span><span class="p">.</span><span class="n">tutorial</span><span class="p">.</span><span class="nb">log</span><span class="p">.</span><span class="n">generated</span><span class="p">.</span><span class="n">Pageview</span>&quot; <span class="n">keyClass</span><span class="p">=</span>&quot;<span class="n">java</span><span class="p">.</span><span class="n">lang</span><span class="p">.</span><span class="n">Long</span>&quot; <span class="n">table</span><span class="p">=</span>&quot;<span class="n">AccessLog</span>&quot;<span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">url</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">common</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">url</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">timestamp</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">common</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">timestamp</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">ip</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">common</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">ip</span>&quot; <span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">httpMethod</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">http</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">httpMethod</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">httpStatusCode</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">http</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">httpStatusCode</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">responseSize</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">http</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">responseSize</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">referrer</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">misc</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">referrer</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-    <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="n">field</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">userAgent</span>&quot; <span class="n">family</span><span class="p">=</span>&quot;<span class="n">misc</span>&quot; <span class="n">qualifier</span><span class="p">=</span>&quot;<span class="n">userAgent</span>&quot;<span class="o">/&amp;</span><span class="n">gt</span><span class="p">;</span>
-  <span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="o">/</span><span class="n">class</span><span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span>
+  ...
 
-  <span class="p">...</span>
-
-<span class="o">&amp;</span><span class="n">lt</span><span class="p">;</span><span class="o">/</span><span class="n">gora</span><span class="o">-</span><span class="n">orm</span><span class="o">&amp;</span><span class="n">gt</span><span class="p">;</span>
+<span class="nt">&lt;/gora-orm&gt;</span>
 </pre></div>
 
 
-<p>Every mapping file starts with the top level element &lt;gora-orm&gt;. 
+<p>Every mapping file starts with the top level element <gora-orm>. 
 Gora HBase mapping files can have two type of child elements, table and 
 class declarations. All of the table and class definitions should be 
 listed at this level.</p>
@@ -437,7 +436,7 @@ listed at this level.</p>
 declaration from the class sub elements. However, some of the HBase 
 specific table configuration such as compression, blockCache, etc can be given here, 
 if Gora is used to auto-create the tables. The exact syntax for the file can be found 
-<a href="/gora-hbase.html">here</a>.</p>
+<a href="/current/gora-hbase.html">here</a>.</p>
 <p>In Gora, data store access is always 
 done in a key-value data model, since most of the target backends support this model.
 DataStore API expects to know the class names of the key and persistent classes, so that 
@@ -452,8 +451,8 @@ of the HBase data model. If the qualifie
 as the column qualifier. Note that map and array type fields are stored in unique column 
 families, so the configuration should be list unique column families for each map and 
 array type, and no qualifier should be given. The exact data model is discussed further 
-at the <a href="/gora-hbase.html">gora-hbase</a> documentation. </p>
-<h2 id="basic-api-wzxhzdk83">Basic API </title></h2>
+at the <a href="/current/gora-hbase.html">gora-hbase</a> documentation. </p>
+<h2 id="basic-api-wzxhzdk54">Basic API </title></h2>
 <h3 id="parsing-the-logs">Parsing the logs</h3>
 <p>Now that we have the basic setup, we can see Gora API in action. As you can notice below the API 
 is pretty simple to use. We will be using the class LogManager (which is located at