You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@marmotta.apache.org by bu...@apache.org on 2013/02/26 11:39:17 UTC

svn commit: r852039 [2/6] - in /websites/staging/marmotta/trunk/content: ./ kiwi/ ldcache/ ldclient/ ldpath/

Modified: websites/staging/marmotta/trunk/content/integration.html
==============================================================================
--- websites/staging/marmotta/trunk/content/integration.html (original)
+++ websites/staging/marmotta/trunk/content/integration.html Tue Feb 26 10:39:16 2013
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at Feb 25, 2013
+ | Generated by Apache Maven Doxia at Feb 26, 2013
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20130225" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Marmotta - Continuous Integration</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -81,7 +81,83 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project <b class="caret"></b></a>
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
                       <li class="dropdown-submenu">
@@ -128,29 +204,6 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
-</li>
-                  
-                      <li>      <a href="kiwi-triplestore.html"  title="KiWi Triple Store">KiWi Triple Store</a>
-</li>
-                  
-                      <li>      <a href="ldcache.html"  title="LDCache">LDCache</a>
-</li>
-                  
-                      <li>      <a href="ldclient.html"  title="LDClient">LDClient</a>
-</li>
-                  
-                      <li>      <a href="ldpath.html"  title="LDPath">LDPath</a>
-</li>
-                  
-                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
         <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
@@ -172,12 +225,6 @@
       </li>
                   </ul>
           
-                      <form id="search-form" action="http://www.google.com/search" method="get"  class="navbar-search pull-right" >
-    
-  <input value="marmotta.incubator.apache.org" name="sitesearch" type="hidden"/>
-  <input class="search-query" name="q" id="query" type="text" />
-</form>
-<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script>
           
                                                               
                    
@@ -205,7 +252,7 @@
         <ul class="breadcrumb">
                 
             
-                  <li id="publishDate">Last Published: 2013-02-25</li>
+                  <li id="publishDate">Last Published: 2013-02-26</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
                       
                 

Modified: websites/staging/marmotta/trunk/content/issue-tracking.html
==============================================================================
--- websites/staging/marmotta/trunk/content/issue-tracking.html (original)
+++ websites/staging/marmotta/trunk/content/issue-tracking.html Tue Feb 26 10:39:16 2013
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at Feb 25, 2013
+ | Generated by Apache Maven Doxia at Feb 26, 2013
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20130225" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Marmotta - Issue Tracking</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -81,7 +81,83 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project <b class="caret"></b></a>
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
                       <li class="dropdown-submenu">
@@ -128,29 +204,6 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
-</li>
-                  
-                      <li>      <a href="kiwi-triplestore.html"  title="KiWi Triple Store">KiWi Triple Store</a>
-</li>
-                  
-                      <li>      <a href="ldcache.html"  title="LDCache">LDCache</a>
-</li>
-                  
-                      <li>      <a href="ldclient.html"  title="LDClient">LDClient</a>
-</li>
-                  
-                      <li>      <a href="ldpath.html"  title="LDPath">LDPath</a>
-</li>
-                  
-                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
         <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
@@ -172,12 +225,6 @@
       </li>
                   </ul>
           
-                      <form id="search-form" action="http://www.google.com/search" method="get"  class="navbar-search pull-right" >
-    
-  <input value="marmotta.incubator.apache.org" name="sitesearch" type="hidden"/>
-  <input class="search-query" name="q" id="query" type="text" />
-</form>
-<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script>
           
                                                               
                    
@@ -205,7 +252,7 @@
         <ul class="breadcrumb">
                 
             
-                  <li id="publishDate">Last Published: 2013-02-25</li>
+                  <li id="publishDate">Last Published: 2013-02-26</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
                       
                 

Modified: websites/staging/marmotta/trunk/content/kiwi-triplestore.html
==============================================================================
--- websites/staging/marmotta/trunk/content/kiwi-triplestore.html (original)
+++ websites/staging/marmotta/trunk/content/kiwi-triplestore.html Tue Feb 26 10:39:16 2013
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at Feb 25, 2013
+ | Generated by Apache Maven Doxia at Feb 26, 2013
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20130225" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Marmotta - </title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -81,7 +81,83 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project <b class="caret"></b></a>
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
                       <li class="dropdown-submenu">
@@ -128,29 +204,6 @@
                           </ul>
       </li>
                 <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="client-library.html"  title="Client Library">Client Library</a>
-</li>
-                  
-                      <li>      <a href="kiwi-triplestore.html"  title="KiWi Triple Store">KiWi Triple Store</a>
-</li>
-                  
-                      <li>      <a href="ldcache.html"  title="LDCache">LDCache</a>
-</li>
-                  
-                      <li>      <a href="ldclient.html"  title="LDClient">LDClient</a>
-</li>
-                  
-                      <li>      <a href="ldpath.html"  title="LDPath">LDPath</a>
-</li>
-                  
-                      <li>      <a href="sesame.html"  title="Sesame Tools">Sesame Tools</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
         <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
         <ul class="dropdown-menu">
         
@@ -172,12 +225,6 @@
       </li>
                   </ul>
           
-                      <form id="search-form" action="http://www.google.com/search" method="get"  class="navbar-search pull-right" >
-    
-  <input value="marmotta.incubator.apache.org" name="sitesearch" type="hidden"/>
-  <input class="search-query" name="q" id="query" type="text" />
-</form>
-<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script>
           
                                                               
                    
@@ -205,7 +252,7 @@
         <ul class="breadcrumb">
                 
             
-                  <li id="publishDate">Last Published: 2013-02-25</li>
+                  <li id="publishDate">Last Published: 2013-02-26</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
                       
                 
@@ -267,6 +314,7 @@ try {
 </ul><p>We plan to add support for additional databases over time.</p>
 </div><div class="section"><h3> Performance Considerations <a name="Performance_Considerations"></a></h3><p>Additionally, there are some things to keep in mind when using a KiWi triple store (all of them are good coding practice, but in KiWi they also have performance implications):</p>
 <ul>
+  <li>if you are interested in good performance (production environments), use a proper database (e.g. <i>PostgreSQL</i>)!</li>
   <li>a RepositoryConnection has a direct correspondence to a database connection, so it always needs to be closed properly;  if you forget closing connections, you will have resource leakage pretty quickly</li>
   <li>all operations carried out on a repository connection are directly carried out in the database (e.g. inserting  triples); the database connection is transactional, i.e. changes will only be available to other transactions when  the commit() method is called explicitly; it is therefore good practice to always commit or rollback a connection  before closing it</li>
   <li>a RepositoryResult has a direct correspondence to a database ResultSet and therefore to a database cursor, so like  with connections, it needs to be closed properly or otherwise you will have resource leakage</li>

Added: websites/staging/marmotta/trunk/content/kiwi/introduction.html
==============================================================================
--- websites/staging/marmotta/trunk/content/kiwi/introduction.html (added)
+++ websites/staging/marmotta/trunk/content/kiwi/introduction.html Tue Feb 26 10:39:16 2013
@@ -0,0 +1,311 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Feb 26, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Marmotta - </title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link title="doap" rel="meta" type="application/rdf+xml" href="doap.rdf"/>
+                      
+        
+<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
+                      
+        
+<script src="./js/marmotta.js" type="text/javascript"></script>
+          
+              <!-- Google Analytics -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-38225305-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Marmotta <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../index.html"  title="Home">Home</a>
+</li>
+                  
+                      <li>      <a href="../download.html"  title="Download">Download</a>
+</li>
+                  
+                      <li>      <a href="../installation.html"  title="Installation">Installation</a>
+</li>
+                  
+                      <li>      <a href="../configuration.html"  title="Configuration">Configuration</a>
+</li>
+                  
+                      <li>      <a href="../development.html"  title="Development">Development</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/marmotta"  title="Wiki">Wiki</a>
+</li>
+                  
+                      <li>      <a href="../privacy.html"  title="Privacy">Privacy</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="../sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li class="dropdown-submenu">
+                                      <a href="../project-info.html"  title="Project Information">Project Information</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../index.html"  title="About">About</a>
+</li>
+                                  <li>      <a href="../plugin-management.html"  title="Plugin Management">Plugin Management</a>
+</li>
+                                  <li>      <a href="../distribution-management.html"  title="Distribution Management">Distribution Management</a>
+</li>
+                                  <li>      <a href="../dependency-info.html"  title="Dependency Information">Dependency Information</a>
+</li>
+                                  <li>      <a href="../source-repository.html"  title="Source Repository">Source Repository</a>
+</li>
+                                  <li>      <a href="../mail-lists.html"  title="Mailing Lists">Mailing Lists</a>
+</li>
+                                  <li>      <a href="../issue-tracking.html"  title="Issue Tracking">Issue Tracking</a>
+</li>
+                                  <li>      <a href="../integration.html"  title="Continuous Integration">Continuous Integration</a>
+</li>
+                                  <li>      <a href="../plugins.html"  title="Project Plugins">Project Plugins</a>
+</li>
+                                  <li>      <a href="../license.html"  title="Project License">Project License</a>
+</li>
+                                  <li>      <a href="../dependency-management.html"  title="Dependency Management">Dependency Management</a>
+</li>
+                                  <li>      <a href="../team-list.html"  title="Project Team">Project Team</a>
+</li>
+                                  <li>      <a href="../project-summary.html"  title="Project Summary">Project Summary</a>
+</li>
+                                  <li>      <a href="../dependencies.html"  title="Dependencies">Dependencies</a>
+</li>
+                              </ul>
+            </li>
+                  
+                      <li class="dropdown-submenu">
+                                      <a href="../project-reports.html"  title="Project Reports">Project Reports</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../rat-report.html"  title="RAT Report">RAT Report</a>
+</li>
+                              </ul>
+            </li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org"  title="The Apache Software Foundation">The Apache Software Foundation</a>
+</li>
+                  
+                      <li>      <a href="http://incubator.apache.org"  title="Apache Incubator">Apache Incubator</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Thanks">Thanks</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Become a Sponsor">Become a Sponsor</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/security/"  title="Security">Security</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                              
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Apache Marmotta Site</h2>
+                </div>
+                      </div>
+        <div class="pull-right">              <div id="bannerRight">
+                                                                                                <img src="../images/marmotta.png"  alt="Apache Marmotta (incubating)"/>
+                </div>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-02-26</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
+                      
+                
+            
+      
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <h1>KiWi Triple Store</h1><p>The KiWi triple store is a high performance transactional triple store backend for OpenRDF Sesame building on top of a relational database (currently H2, PostgreSQL, or MySQL). It has optional support for rule-based reasoning (sKWRL) and versioning of updates. The KiWi triple store is also the default backend for Apache Marmotta. It originated in the EU-funded research project KiWi - Knowledge in a Wiki (hence the name).</p><p>The KiWi triple store is composed of a number of Sesame Sail modules that can be combined and stacked as needed. Currently (Apache Marmotta v3.0), the KiWi triple store offers the following modules:</p>
+<ul>
+  <li>kiwi-triplestore: implements triple persistence in a relational database</li>
+  <li>kiwi-transactions: adds extended transaction support to a notifying sail (notifies on transaction commit)</li>
+  <li>kiwi-tripletable: support for in-memory indexed Java Collections for OpenRDF statements</li>
+  <li>kiwi-contextaware: support for context-aware OpenRDF Sails (allow overriding contexts in statements)</li>
+  <li>kiwi-reasoner: adds a rule-based forward chaining reasoner with truth maintenance for the KiWi triple store</li>
+  <li>kiwi-versioning: adds versioning of updates to a KiWi triple store</li>
+</ul><p>Versioning and Reasoner only work with a KiWi store as parent Sail, i.e. they cannot be used with other Sesame backends. Transactions, Context-Aware Sails, and the Triple Table support classes are in principle independent and can also be stacked with other storage backends.</p>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+      
+                <p id="poweredBy" class="pull-right">
+                          <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+              </p>
+        
+        <p>
+            Copyright &copy;                    2012-2013
+                        <a href="http://www.apache.org">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+              </p>
+
+                    <?xml version="1.0" encoding="UTF-8"?>
+<footer>
+  <p>The Apache Marmotta project was initiated by the Salzburg NewMediaLab,
+                a K-Project in the Austrian COMET programme. Some people who are working 
+                on the project are part-funded by SNML.</p>
+  <p>Licensed under the Apache License, Version 2.0.</p>
+  <p>Apache, Marmotta and the Apache feather and Marmotta logos are trademarks 
+                of The Apache Software Foundation.</p>
+</footer>
+        
+                </div>
+    </footer>
+  </body>
+</html>

Added: websites/staging/marmotta/trunk/content/kiwi/reasoner.html
==============================================================================
--- websites/staging/marmotta/trunk/content/kiwi/reasoner.html (added)
+++ websites/staging/marmotta/trunk/content/kiwi/reasoner.html Tue Feb 26 10:39:16 2013
@@ -0,0 +1,350 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Feb 26, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Marmotta - </title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link title="doap" rel="meta" type="application/rdf+xml" href="doap.rdf"/>
+                      
+        
+<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
+                      
+        
+<script src="./js/marmotta.js" type="text/javascript"></script>
+          
+              <!-- Google Analytics -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-38225305-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Marmotta <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../index.html"  title="Home">Home</a>
+</li>
+                  
+                      <li>      <a href="../download.html"  title="Download">Download</a>
+</li>
+                  
+                      <li>      <a href="../installation.html"  title="Installation">Installation</a>
+</li>
+                  
+                      <li>      <a href="../configuration.html"  title="Configuration">Configuration</a>
+</li>
+                  
+                      <li>      <a href="../development.html"  title="Development">Development</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/marmotta"  title="Wiki">Wiki</a>
+</li>
+                  
+                      <li>      <a href="../privacy.html"  title="Privacy">Privacy</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="../sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li class="dropdown-submenu">
+                                      <a href="../project-info.html"  title="Project Information">Project Information</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../index.html"  title="About">About</a>
+</li>
+                                  <li>      <a href="../plugin-management.html"  title="Plugin Management">Plugin Management</a>
+</li>
+                                  <li>      <a href="../distribution-management.html"  title="Distribution Management">Distribution Management</a>
+</li>
+                                  <li>      <a href="../dependency-info.html"  title="Dependency Information">Dependency Information</a>
+</li>
+                                  <li>      <a href="../source-repository.html"  title="Source Repository">Source Repository</a>
+</li>
+                                  <li>      <a href="../mail-lists.html"  title="Mailing Lists">Mailing Lists</a>
+</li>
+                                  <li>      <a href="../issue-tracking.html"  title="Issue Tracking">Issue Tracking</a>
+</li>
+                                  <li>      <a href="../integration.html"  title="Continuous Integration">Continuous Integration</a>
+</li>
+                                  <li>      <a href="../plugins.html"  title="Project Plugins">Project Plugins</a>
+</li>
+                                  <li>      <a href="../license.html"  title="Project License">Project License</a>
+</li>
+                                  <li>      <a href="../dependency-management.html"  title="Dependency Management">Dependency Management</a>
+</li>
+                                  <li>      <a href="../team-list.html"  title="Project Team">Project Team</a>
+</li>
+                                  <li>      <a href="../project-summary.html"  title="Project Summary">Project Summary</a>
+</li>
+                                  <li>      <a href="../dependencies.html"  title="Dependencies">Dependencies</a>
+</li>
+                              </ul>
+            </li>
+                  
+                      <li class="dropdown-submenu">
+                                      <a href="../project-reports.html"  title="Project Reports">Project Reports</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../rat-report.html"  title="RAT Report">RAT Report</a>
+</li>
+                              </ul>
+            </li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org"  title="The Apache Software Foundation">The Apache Software Foundation</a>
+</li>
+                  
+                      <li>      <a href="http://incubator.apache.org"  title="Apache Incubator">Apache Incubator</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Thanks">Thanks</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Become a Sponsor">Become a Sponsor</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/security/"  title="Security">Security</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                              
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Apache Marmotta Site</h2>
+                </div>
+                      </div>
+        <div class="pull-right">              <div id="bannerRight">
+                                                                                                <img src="../images/marmotta.png"  alt="Apache Marmotta (incubating)"/>
+                </div>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-02-26</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
+                      
+                
+            
+      
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <h1>KiWi Reasoner</h1><p>The KiWi reasoner is a powerful and flexible rule-based reasoner that can be used on top of a KiWi Triple Store. Its expressivity is more or less the same as Datalog, i.e. it will always terminate and can be evaluated in polynomial time (data complexity not taking into account the number of rules). In the context of triple stores, the KiWi reasoner can be used to easily implement the implicit semantics of different domain vocabularies. For example, the following rule program expresses SKOS semantics:</p>
+<div class="source"><pre class="prettyprint">@prefix skos: &lt;http://www.w3.org/2004/02/skos/core#&gt;
+
+($1 skos:broader $2) -&gt; ($1 skos:broaderTransitive $2)
+($1 skos:narrower $2) -&gt; ($1 skos:narrowerTransitive $2)
+
+($1 skos:broaderTransitive $2), ($2 skos:broaderTransitive $3) -&gt; ($1 skos:broaderTransitive $3)
+($1 skos:narrowerTransitive $2), ($2 skos:narrowerTransitive $3) -&gt; ($1 skos:narrowerTransitive $3)
+
+($1 skos:broader $2) -&gt; ($2 skos:narrower $1)
+($1 skos:narrower $2) -&gt; ($2 skos:broader $1)
+
+($1 skos:broader $2) -&gt; ($1 skos:related $2)
+($1 skos:narrower $2) -&gt; ($1 skos:related $2)
+($1 skos:related $2) -&gt; ($2 skos:related $1)
+</pre></div><p>Similarly, the reasoner can be used for expressing RDFS subclass and domain inference, as well as a subset of OWL semantics (the one that is most interesting :-P ). Beyond RDFS and OWL, it also allows implementing domain-specific rule semantics. Additional examples for programs can be found in the source code.</p><p>The reasoner is implemented as a incremental forward-chaining reasoner with truth maintenance. In practice, this means that:</p>
+<ul>
+  <li>incremental reasoning is triggered after a transaction commits successfully; the reasoner will then apply those  rules that match with at least one of the newly added triples</li>
+  <li>inferred triples are then materialized in the triple store in the inferred context (see the configuration of  the triple store above) and are thus available in the same way as base triples</li>
+  <li>truth maintenance keeps track of the reasons (i.e. rules and triples) why an inferred triple exists; this helps  making updates (especially removals of rules and triples) very efficient without requiring to completely  recompute all inferred triples</li>
+</ul><div class="section"><h2>Maven Artifact<a name="Maven_Artifact"></a></h2><p>The KiWi Reasoner can only be used in conjunction with the KiWi Triple Store, because it maintains most of its information in the relational database (e.g. the data structures for truth maintenance) and directly translates rule body query patterns into SQL. To include it in a project that uses the KiWi Triple Store, add the following dependency to your Maven project:</p>
+<div class="source"><pre class="prettyprint"> &lt;dependency&gt;
+     &lt;groupId&gt;org.apache.marmotta&lt;/groupId&gt;
+     &lt;artifactId&gt;kiwi-reasoner&lt;/artifactId&gt;
+     &lt;version&gt;3.0.0-incubating-SNAPSHOT&lt;/version&gt;
+ &lt;/dependency&gt;
+</pre></div></div><div class="section"><h2>Code Usage<a name="Code_Usage"></a></h2><p>The KiWi Reasoner can be stacked into any sail stack with a transactional sail (see kiwi-transactions) and a KiWi Store at its root. The relevant database tables are created automatically when the repository is initialised. A simple repository with reasoner is initialized as follows:</p>
+<div class="source"><pre class="prettyprint">KiWistore = new KiWiStore(&quot;test&quot;,jdbcUrl,jdbcUser,jdbcPass,dialect, &quot;http://localhost/context/default&quot;, &quot;http://localhost/context/inferred&quot;);
+KiWiTransactionalSail tsail = new KiWiTransactionalSail(store);
+KiWiReasoningSail rsail = new KiWiReasoningSail(tsail, new ReasoningConfiguration());
+repository = new SailRepository(rsail);
+repository.initialize();
+
+// add a reasoning program
+rsail.addProgram(&quot;simple&quot;, this.getClass().getResourceAsStream(&quot;simple.kwrl&quot;));
+
+// update an existing reasoning program
+rsail.updateProgram(&quot;simple&quot;, ...);
+
+// run full reasoning (delete all existing inferred triples and re-create them)
+rsail.reRunPrograms();
+</pre></div><p>The reasoner can have any number of reasoning programs. The concept of a program is merely introduced to group different tasks. Internally, all reasoning rules are considered as an unordered collection, regardless which program they belong to.</p></div><div class="section"><h2>Performance Considerations<a name="Performance_Considerations"></a></h2><p>Even though the reasoner is efficient compared with many other reasoners, there are a number of things to take into account, because reasoning is always a potentially expensive operation:</p>
+<ul>
+  <li>reasoning will always terminate, but the upper bound for inferred triples is in theory the set of all combinations  of nodes occurring in base triples in the database used as subject, predicate, or object, i.e. n^3</li>
+  <li>specific query patterns with many ground values are more efficient than patterns with many variables, as fixed  values can considerably reduce the candidate results in the SQL queries while variables are translated into SQL  joins</li>
+  <li>re-running a full reasoning can be extremely costly on large databases, so it is better configuring the reasoning  programs before importing large datasets (large being in the range of millions of triples)</li>
+  <li>updating a program is more efficient than first deleting the old version and then adding the new version,  because the reasoner compares old and new program and only updates the changed rules</li>
+</ul><p>In addition, the reasoner is currently executed in a single worker thread. The main reason is that otherwise there are potentially many transaction conflicts. We are working on an improved version that could benefit more from multi-core processors.</p></div>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+      
+                <p id="poweredBy" class="pull-right">
+                          <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+              </p>
+        
+        <p>
+            Copyright &copy;                    2012-2013
+                        <a href="http://www.apache.org">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+              </p>
+
+                    <?xml version="1.0" encoding="UTF-8"?>
+<footer>
+  <p>The Apache Marmotta project was initiated by the Salzburg NewMediaLab,
+                a K-Project in the Austrian COMET programme. Some people who are working 
+                on the project are part-funded by SNML.</p>
+  <p>Licensed under the Apache License, Version 2.0.</p>
+  <p>Apache, Marmotta and the Apache feather and Marmotta logos are trademarks 
+                of The Apache Software Foundation.</p>
+</footer>
+        
+                </div>
+    </footer>
+  </body>
+</html>

Added: websites/staging/marmotta/trunk/content/kiwi/transactions.html
==============================================================================
--- websites/staging/marmotta/trunk/content/kiwi/transactions.html (added)
+++ websites/staging/marmotta/trunk/content/kiwi/transactions.html Tue Feb 26 10:39:16 2013
@@ -0,0 +1,319 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Feb 26, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Marmotta - </title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link title="doap" rel="meta" type="application/rdf+xml" href="doap.rdf"/>
+                      
+        
+<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
+                      
+        
+<script src="./js/marmotta.js" type="text/javascript"></script>
+          
+              <!-- Google Analytics -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-38225305-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Marmotta <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../index.html"  title="Home">Home</a>
+</li>
+                  
+                      <li>      <a href="../download.html"  title="Download">Download</a>
+</li>
+                  
+                      <li>      <a href="../installation.html"  title="Installation">Installation</a>
+</li>
+                  
+                      <li>      <a href="../configuration.html"  title="Configuration">Configuration</a>
+</li>
+                  
+                      <li>      <a href="../development.html"  title="Development">Development</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/marmotta"  title="Wiki">Wiki</a>
+</li>
+                  
+                      <li>      <a href="../privacy.html"  title="Privacy">Privacy</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="../sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li class="dropdown-submenu">
+                                      <a href="../project-info.html"  title="Project Information">Project Information</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../index.html"  title="About">About</a>
+</li>
+                                  <li>      <a href="../plugin-management.html"  title="Plugin Management">Plugin Management</a>
+</li>
+                                  <li>      <a href="../distribution-management.html"  title="Distribution Management">Distribution Management</a>
+</li>
+                                  <li>      <a href="../dependency-info.html"  title="Dependency Information">Dependency Information</a>
+</li>
+                                  <li>      <a href="../source-repository.html"  title="Source Repository">Source Repository</a>
+</li>
+                                  <li>      <a href="../mail-lists.html"  title="Mailing Lists">Mailing Lists</a>
+</li>
+                                  <li>      <a href="../issue-tracking.html"  title="Issue Tracking">Issue Tracking</a>
+</li>
+                                  <li>      <a href="../integration.html"  title="Continuous Integration">Continuous Integration</a>
+</li>
+                                  <li>      <a href="../plugins.html"  title="Project Plugins">Project Plugins</a>
+</li>
+                                  <li>      <a href="../license.html"  title="Project License">Project License</a>
+</li>
+                                  <li>      <a href="../dependency-management.html"  title="Dependency Management">Dependency Management</a>
+</li>
+                                  <li>      <a href="../team-list.html"  title="Project Team">Project Team</a>
+</li>
+                                  <li>      <a href="../project-summary.html"  title="Project Summary">Project Summary</a>
+</li>
+                                  <li>      <a href="../dependencies.html"  title="Dependencies">Dependencies</a>
+</li>
+                              </ul>
+            </li>
+                  
+                      <li class="dropdown-submenu">
+                                      <a href="../project-reports.html"  title="Project Reports">Project Reports</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../rat-report.html"  title="RAT Report">RAT Report</a>
+</li>
+                              </ul>
+            </li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org"  title="The Apache Software Foundation">The Apache Software Foundation</a>
+</li>
+                  
+                      <li>      <a href="http://incubator.apache.org"  title="Apache Incubator">Apache Incubator</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Thanks">Thanks</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Become a Sponsor">Become a Sponsor</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/security/"  title="Security">Security</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                              
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Apache Marmotta Site</h2>
+                </div>
+                      </div>
+        <div class="pull-right">              <div id="bannerRight">
+                                                                                                <img src="../images/marmotta.png"  alt="Apache Marmotta (incubating)"/>
+                </div>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-02-26</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
+                      
+                
+            
+      
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <h1>KiWi Transaction Support</h1><p>OpenRDF Sesame already offers basic transaction handling and update notification support in any OpenRDF sail stack around a NotifyingSail. This module builds on this functionality to provide a mechanism for keeping track of all changes (added and removed triples) occurring between the time a transaction began and the time the transaction was committed or rolled back. The transaction data is then handed over to all registered transaction listeners at certain event points (in analogy to JPA we offer before commit, after commit, on rollback). Since the KiWi transaction support builds upon the NotifyingSail, it can be used in any OpenRDF sail stack, independently of the other KiWi modules.</p><p>Extended transaction support is e.g. used by the versioning component (each transaction is considered a unit of work or version) and by the reasoner (on transaction commit, the transaction data is handed to the incremental reasoner). It is 
 also used by some extended Apache Marmotta and Linked Media Framework functionalities like the LMF Semantic Search.</p><div class="section"><h2>Maven Artifact<a name="Maven_Artifact"></a></h2><p>To use the extended transaction support, include the following artifact in your Maven build file:</p>
+<div class="source"><pre class="prettyprint"> &lt;dependency&gt;
+     &lt;groupId&gt;org.apache.marmotta&lt;/groupId&gt;
+     &lt;artifactId&gt;kiwi-transactions&lt;/artifactId&gt;
+     &lt;version&gt;3.0.0-incubating-SNAPSHOT&lt;/version&gt;
+ &lt;/dependency&gt;
+</pre></div></div><div class="section"><h2>Code Usage<a name="Code_Usage"></a></h2><p>In your code, the KiWi extended transactions can easily be stacked into your sail stack around any NotifyingSail. Event listeners can be added/removed by calling the appropriate addTransactionListener and removeTransactionListener methods:</p>
+<div class="source"><pre class="prettyprint">KiWiTransactionalSail sail = new KiWiTransactionalSail(new MemoryStore());
+sail.addTransactionListener(...);
+Repository repository = new SailRepository(sail);
+...
+</pre></div><p>The TransactionListener interface defines three methods:</p>
+<ul>
+  <li><i>beforeCommit(TransactionData data)</i> is called just before the transaction actually carries out its commit  to the database;</li>
+  <li><i>afterCommit(TransactionData data)</i> is called immediately after the transaction has been committed to the database  (i.e. you can rely on the data being persistent)</li>
+  <li><i>rollback(TransactionData data)</i> is called when the transaction is rolled back (e.g. in case of an error)</li>
+</ul></div>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+      
+                <p id="poweredBy" class="pull-right">
+                          <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+              </p>
+        
+        <p>
+            Copyright &copy;                    2012-2013
+                        <a href="http://www.apache.org">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+              </p>
+
+                    <?xml version="1.0" encoding="UTF-8"?>
+<footer>
+  <p>The Apache Marmotta project was initiated by the Salzburg NewMediaLab,
+                a K-Project in the Austrian COMET programme. Some people who are working 
+                on the project are part-funded by SNML.</p>
+  <p>Licensed under the Apache License, Version 2.0.</p>
+  <p>Apache, Marmotta and the Apache feather and Marmotta logos are trademarks 
+                of The Apache Software Foundation.</p>
+</footer>
+        
+                </div>
+    </footer>
+  </body>
+</html>

Added: websites/staging/marmotta/trunk/content/kiwi/triplestore.html
==============================================================================
--- websites/staging/marmotta/trunk/content/kiwi/triplestore.html (added)
+++ websites/staging/marmotta/trunk/content/kiwi/triplestore.html Tue Feb 26 10:39:16 2013
@@ -0,0 +1,348 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Feb 26, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130226" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Marmotta - </title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link title="doap" rel="meta" type="application/rdf+xml" href="doap.rdf"/>
+                      
+        
+<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
+                      
+        
+<script src="./js/marmotta.js" type="text/javascript"></script>
+          
+              <!-- Google Analytics -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-38225305-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Marmotta <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../index.html"  title="Home">Home</a>
+</li>
+                  
+                      <li>      <a href="../download.html"  title="Download">Download</a>
+</li>
+                  
+                      <li>      <a href="../installation.html"  title="Installation">Installation</a>
+</li>
+                  
+                      <li>      <a href="../configuration.html"  title="Configuration">Configuration</a>
+</li>
+                  
+                      <li>      <a href="../development.html"  title="Development">Development</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/marmotta"  title="Wiki">Wiki</a>
+</li>
+                  
+                      <li>      <a href="../privacy.html"  title="Privacy">Privacy</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">KiWi Triple Store <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../kiwi/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/triplestore.html"  title="Store">Store</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/transactions.html"  title="Transactions">Transactions</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/tripletable.html"  title="Triple Table">Triple Table</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/reasoner.html"  title="Reasoner">Reasoner</a>
+</li>
+                  
+                      <li>      <a href="../kiwi/versioning.html"  title="Versioning">Versioning</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDClient <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldclient/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/usage.html"  title="Modules">Modules</a>
+</li>
+                  
+                      <li>      <a href="../ldclient/dataproviders.html"  title="Data Providers">Data Providers</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDCache <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldcache/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">LDPath <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../ldpath/introduction.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/language.html"  title="Language">Language</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/usage.html"  title="Usage">Usage</a>
+</li>
+                  
+                      <li>      <a href="../ldpath/backends.html"  title="Backends">Backends</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Libraries <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../client-library.html"  title="Client Library">Client Library</a>
+</li>
+                  
+                      <li>      <a href="../sesame.html"  title="Sesame Tools">Sesame Tools</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Reports <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li class="dropdown-submenu">
+                                      <a href="../project-info.html"  title="Project Information">Project Information</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../index.html"  title="About">About</a>
+</li>
+                                  <li>      <a href="../plugin-management.html"  title="Plugin Management">Plugin Management</a>
+</li>
+                                  <li>      <a href="../distribution-management.html"  title="Distribution Management">Distribution Management</a>
+</li>
+                                  <li>      <a href="../dependency-info.html"  title="Dependency Information">Dependency Information</a>
+</li>
+                                  <li>      <a href="../source-repository.html"  title="Source Repository">Source Repository</a>
+</li>
+                                  <li>      <a href="../mail-lists.html"  title="Mailing Lists">Mailing Lists</a>
+</li>
+                                  <li>      <a href="../issue-tracking.html"  title="Issue Tracking">Issue Tracking</a>
+</li>
+                                  <li>      <a href="../integration.html"  title="Continuous Integration">Continuous Integration</a>
+</li>
+                                  <li>      <a href="../plugins.html"  title="Project Plugins">Project Plugins</a>
+</li>
+                                  <li>      <a href="../license.html"  title="Project License">Project License</a>
+</li>
+                                  <li>      <a href="../dependency-management.html"  title="Dependency Management">Dependency Management</a>
+</li>
+                                  <li>      <a href="../team-list.html"  title="Project Team">Project Team</a>
+</li>
+                                  <li>      <a href="../project-summary.html"  title="Project Summary">Project Summary</a>
+</li>
+                                  <li>      <a href="../dependencies.html"  title="Dependencies">Dependencies</a>
+</li>
+                              </ul>
+            </li>
+                  
+                      <li class="dropdown-submenu">
+                                      <a href="../project-reports.html"  title="Project Reports">Project Reports</a>
+              <ul class="dropdown-menu">
+                                  <li>      <a href="../rat-report.html"  title="RAT Report">RAT Report</a>
+</li>
+                              </ul>
+            </li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">The ASF <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org"  title="The Apache Software Foundation">The Apache Software Foundation</a>
+</li>
+                  
+                      <li>      <a href="http://incubator.apache.org"  title="Apache Incubator">Apache Incubator</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Thanks">Thanks</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Become a Sponsor">Become a Sponsor</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/security/"  title="Security">Security</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                              
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Apache Marmotta Site</h2>
+                </div>
+                      </div>
+        <div class="pull-right">              <div id="bannerRight">
+                                                                                                <img src="../images/marmotta.png"  alt="Apache Marmotta (incubating)"/>
+                </div>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-02-26</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 3.0.0-incubating-SNAPSHOT</li>
+                      
+                
+            
+      
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <h1>KiWi Store</h1><p>The heart of the KiWi triple store is the KiWiStore storage backend. It implements a OpenRDF Notifying Sail on top of a custom relational database schema. It can be used in a similar way to the already existing (but now deprecated) OpenRDF RDBMS backends. The KiWi triple store operates almost directly on top of the relational database, there is only minimal overhead on the Java side (some caching and result transformations). Each OpenRDF repository connection is a database connection, and each repository result is a database cursor (so it supports lazy fetching when iterating over the result).</p><div class="section"><h2>Maven Artifact<a name="Maven_Artifact"></a></h2><p>To use the KiWiStore, include the following artifact in your Maven build file:</p>
+<div class="source"><pre class="prettyprint">&lt;dependency&gt;
+    &lt;groupId&gt;org.apache.marmotta&lt;/groupId&gt;
+    &lt;artifactId&gt;kiwi-triplestore&lt;/artifactId&gt;
+    &lt;version&gt;3.0.0-incubating-SNAPSHOT&lt;/version&gt;
+&lt;/dependency&gt;
+</pre></div></div><div class="section"><h2>Code Usage<a name="Code_Usage"></a></h2><p>In your code, creating a KiWi triple store works mostly like other OpenRDF backends. The only additional data that is required are the JDBC connection details for accessing the database (i.e. database type, database URI, database user and database password) and how to store inferred triples or triples without explicit context. You can create a new instance of a KiWi store as follows:</p>
+<div class="source"><pre class="prettyprint">String defaultContext  = &quot;http://localhost/context/default&quot;;
+String inferredContext = &quot;http://localhost/context/inferred&quot;;
+KiWiDialect dialect    = new H2Dialect();
+KiWiStore store = new KiWiStore(&quot;test&quot;,jdbcUrl,jdbcUser,jdbcPass,dialect, defaultContext, inferredContext );
+Repository repository = new SailRepository(store);
+try {
+    repository.initialize();
+
+    // get a connection and perform operations as usual
+    RepositoryConnection con = repository.getConnection();
+    try {
+        con.begin();
+
+        // do stuff
+
+        con.commit();
+    } finally {
+        con.close();
+    }
+} catch(RepositoryException ex) {
+    // handle exception
+} finally {
+    repository.shutdown();
+}
+</pre></div><p>Note that there are some uncommon parameters, most notably the defaultContext and inferredContext:</p>
+<ul>
+  <li><b>defaultContext</b> is the URI of the context to use in case no explicit context is specified; this changes the default  behaviour of OpenRDF a bit, but it is the cleaner approach (and more efficient in the relational database because it  avoids NULL values)</li>
+  <li><b>inferredContext</b> is the URI to use for storing all triples that are inferred by some reasoner (either the KiWi reasoner  or the OpenRDF RDFS reasoner); this is also a different behaviour to OpenRDF; we use it because the semantics is  otherwise not completely clear in case an inference was made based on the information stemming from two different  contexts</li>
+  <li><b>dialect</b> specifies the dialect to use for connecting to the database; currently supported dialects are H2Dialect,  PostgreSQLDialect and MySQLDialect; note that the MySQL JDBC library is licensed under LGPL and can therefore not  be shipped with Apache Marmotta</li>
+</ul><p>We plan to add support for additional databases over time.</p></div><div class="section"><h2>Performance Considerations<a name="Performance_Considerations"></a></h2><p>Additionally, there are some things to keep in mind when using a KiWi triple store (all of them are good coding practice, but in KiWi they also have performance implications):</p>
+<ul>
+  <li>if you are interested in good performance (production environments), use a proper database (e.g. <i>PostgreSQL</i>)!</li>
+  <li>a RepositoryConnection has a direct correspondence to a database connection, so it always needs to be closed properly;  if you forget closing connections, you will have resource leakage pretty quickly</li>
+  <li>all operations carried out on a repository connection are directly carried out in the database (e.g. inserting  triples); the database connection is transactional, i.e. changes will only be available to other transactions when  the commit() method is called explicitly; it is therefore good practice to always commit or rollback a connection  before closing it</li>
+  <li>a RepositoryResult has a direct correspondence to a database ResultSet and therefore to a database cursor, so like  with connections, it needs to be closed properly or otherwise you will have resource leakage</li>
+  <li>the value factory of the KiWi Store maintains its own, separate database connection for creating and retrieving  RDF values; any newly created values are committed immediately to the database to make sure they are available to  other transactions</li>
+  <li>the database tables will only be created when repository.initialize() is called; if the tables already exist,  initialization will check whether a schema upgrade is required and automatically do the upgrade if needed</li>
+  <li>the repository must be explicitly shutdown when it is no longer needed, or otherwise it will keep open  the database connection of the value factory as well as the internal connection pool</li>
+</ul></div>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+      
+                <p id="poweredBy" class="pull-right">
+                          <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+              </p>
+        
+        <p>
+            Copyright &copy;                    2012-2013
+                        <a href="http://www.apache.org">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+              </p>
+
+                    <?xml version="1.0" encoding="UTF-8"?>
+<footer>
+  <p>The Apache Marmotta project was initiated by the Salzburg NewMediaLab,
+                a K-Project in the Austrian COMET programme. Some people who are working 
+                on the project are part-funded by SNML.</p>
+  <p>Licensed under the Apache License, Version 2.0.</p>
+  <p>Apache, Marmotta and the Apache feather and Marmotta logos are trademarks 
+                of The Apache Software Foundation.</p>
+</footer>
+        
+                </div>
+    </footer>
+  </body>
+</html>