jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mdue...@apache.org
Subject svn commit: r1594576 [2/8] - in /jackrabbit/site/live/oak/docs: ./ security/ security/accesscontrol/ security/authentication/ security/permission/ security/principal/ security/privilege/ security/user/
Date Wed, 14 May 2014 13:30:14 GMT
Modified: jackrabbit/site/live/oak/docs/microkernel.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/microkernel.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/microkernel.html (original)
+++ jackrabbit/site/live/oak/docs/microkernel.html Wed May 14 13:30:13 2014
@@ -1,15 +1,15 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
-    <title>Jackrabbit Oak - </title>
+    <title>Jackrabbit Oak - MicroKernel and NodeStore</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" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -226,7 +219,7 @@
                   
       <li class="active">
     
-            <a href="#"><i class="none"></i>NodesStore and MicroKernel</a>
+            <a href="#"><i class="none"></i>NodeStore and MicroKernel</a>
           </li>
                   
       <li>
@@ -267,9 +260,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -281,6 +274,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -295,9 +295,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 
@@ -375,18 +375,18 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License. --><p>TODO: Document Microkernel API and implementations</p>
+   limitations under the License. --><h1>MicroKernel and NodeStore</h1>
+<p>A <tt>MicroKernel</tt> or a <tt>NodeStore</tt> are ultimately implementations of the <a href="nodestate.html">node state model</a>. A <tt>MicroKernel</tt> exposes its functionality through a String only (JSON) API, which is easy to remote. In contrast a <tt>NodeStore</tt> exposes its functionality through a pure Java API, which is easier to work with and has lower performance and memory overhead.</p>
+<p>Oak comes with two flavours: <a href="segmentmk.html">Segment</a> and <a href="documentmk.html">Document</a>. The former is optimised for maximal performance in standalone deployments while the latter is optimised for maximal scalability in clustered deployments.</p>
+<div class="section">
+<h2>See also<a name="See_also"></a></h2>
 
 <ul>
   
-<li><a href="segmentmk.html">SegmentMK design overview</a></li>
-  
-<li><a href="documentmk.html">DocumentMK design overview</a></li>
-  
 <li><a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/oak-it/mk/README.md">MicroKernel integration tests</a></li>
   
 <li><a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/oak-mk-perf/README.md">MicroKernel performance tests</a></li>
-</ul>
+</ul></div>
                   </div>
             </div>
           </div>

Modified: jackrabbit/site/live/oak/docs/nodestate.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/nodestate.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/nodestate.html (original)
+++ jackrabbit/site/live/oak/docs/nodestate.html Wed May 14 13:30:13 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Understanding the node state model</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -224,9 +217,9 @@
                   
       <li>
     
-                          <a href="microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li>
@@ -267,9 +260,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -281,6 +274,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -295,9 +295,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 

Modified: jackrabbit/site/live/oak/docs/osgi_config.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/osgi_config.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/osgi_config.html (original)
+++ jackrabbit/site/live/oak/docs/osgi_config.html Wed May 14 13:30:13 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Repository OSGi Configuration</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -226,9 +219,9 @@
                   
       <li>
     
-                          <a href="microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li>
@@ -269,9 +262,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li class="active">
@@ -281,6 +274,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -295,9 +295,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 

Modified: jackrabbit/site/live/oak/docs/overview.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/overview.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/overview.html (original)
+++ jackrabbit/site/live/oak/docs/overview.html Wed May 14 13:30:13 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The big picture</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li class="active">
@@ -224,9 +217,9 @@
                   
       <li>
     
-                          <a href="microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li>
@@ -267,9 +260,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -281,6 +274,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -295,9 +295,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 

Modified: jackrabbit/site/live/oak/docs/participating.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/participating.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/participating.html (original)
+++ jackrabbit/site/live/oak/docs/participating.html Wed May 14 13:30:13 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Participating</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -226,9 +219,9 @@
                   
       <li>
     
-                          <a href="microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li>
@@ -269,9 +262,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -283,6 +276,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -297,9 +297,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 

Modified: jackrabbit/site/live/oak/docs/query.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query.html (original)
+++ jackrabbit/site/live/oak/docs/query.html Wed May 14 13:30:13 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The Query Engine</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -226,9 +219,9 @@
                   
       <li>
     
-                          <a href="microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li class="active">
@@ -267,9 +260,9 @@
                   
       <li>
     
-                          <a href="differences.html" title="Differences to Jackrabbit 2">
+                          <a href="construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -281,6 +274,13 @@
                   
       <li>
     
+                          <a href="differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -295,9 +295,9 @@
                   
       <li>
     
-                          <a href="when_things_go_wrong.html" title="When things go wrong">
+                          <a href="FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 
@@ -525,6 +525,49 @@ org.apache.jackrabbit.oak.query.QueryEng
 }
 </pre></div></div>
 <div class="section">
+<h3>The Ordered Index<a name="The_Ordered_Index"></a></h3>
+<p>Extension of the Property index will keep the order of the indexed property persisted in the repository.</p>
+<p>Used to speed-up queries with <tt>ORDER BY</tt> clause, <i>equality</i> and <i>range</i> ones.</p>
+
+<div class="source">
+<pre>SELECT * FROM [nt:base] ORDER BY jcr:lastModified
+
+SELECT * FROM [nt:base] WHERE jcr:lastModified &gt; $date
+
+SELECT * FROM [nt:base] WHERE jcr:lastModified &lt; $date
+
+SELECT * FROM [nt:base]
+WHERE jcr:lastModified &gt; $date1 AND jcr:lastModified &lt; $date2
+
+SELECT * FROM [nt:base] WHERE [jcr:uuid] = $id
+</pre></div>
+<p>To define a property index on a subtree you have to add an index definition node that:</p>
+
+<ul>
+  
+<li>must be of type <tt>oak:QueryIndexDefinition</tt></li>
+  
+<li>must have the <tt>type</tt> property set to <b><tt>ordered</tt></b></li>
+  
+<li>contains the <tt>propertyNames</tt> property that indicates what properties  will be stored in the index. <tt>propertyNames</tt> has to be a single  value list of type <tt>Name[]</tt></li>
+</ul>
+<p><i>Optionally</i> you can specify</p>
+
+<ul>
+  
+<li>the <tt>reindex</tt> flag which when set to <tt>true</tt>, triggers a full content  re-index.</li>
+  
+<li>The direction of the sorting by specifying a <tt>direction</tt> property of  type <tt>String</tt> of value <tt>ascending</tt> or <tt>descending</tt>. If not provided  <tt>ascending</tt> is the default.</li>
+  
+<li>The index can be defined as asynchronous by providing the property  <tt>async=async</tt></li>
+</ul>
+<p><i>Caveats</i></p>
+
+<ul>
+  
+<li>In case deploying on the index on a clustered mongodb you have to  define it as asynchronous by providing <tt>async=async</tt> in the index  definition. This is to avoid cluster merges.</li>
+</ul></div>
+<div class="section">
 <h3>The Lucene Full-Text Index<a name="The_Lucene_Full-Text_Index"></a></h3>
 <p>The full-text index handles the &#x2018;contains&#x2019; type of queries:</p>
 

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol.html?rev=1594576&r1=1594575&r2=1594576&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol.html Wed May 14 13:30:13 2014
@@ -1,15 +1,15 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-06
+ | Generated by Apache Maven Doxia at 2014-05-14
  | 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="20140506" />
+    <meta name="Date-Revision-yyyymmdd" content="20140514" />
     <meta http-equiv="Content-Language" content="en" />
-    <title>Jackrabbit Oak - The Oak Security Layer</title>
+    <title>Jackrabbit Oak - Access Control</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" />
@@ -58,9 +58,6 @@
                   
                       <li>      <a href="../downloads.html"  title="Downloads">Downloads</a>
 </li>
-                  
-                      <li>      <a href="../from_here.html"  title="From here">From here</a>
-</li>
                           </ul>
       </li>
                 <li class="dropdown">
@@ -73,7 +70,7 @@
                       <li>      <a href="../nodestate.html"  title="The node state model">The node state model</a>
 </li>
                   
-                      <li>      <a href="../microkernel.html"  title="NodesStore and MicroKernel">NodesStore and MicroKernel</a>
+                      <li>      <a href="../microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
 </li>
                   
                       <li>      <a href="../query.html"  title="Query">Query</a>
@@ -96,19 +93,22 @@
                       <li>      <a href="../use_getting_started.html"  title="Getting Started">Getting Started</a>
 </li>
                   
-                      <li>      <a href="../differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+                      <li>      <a href="../construct.html"  title="Repository construction">Repository construction</a>
 </li>
                   
                       <li>      <a href="../osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
 </li>
                   
+                      <li>      <a href="../differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
                       <li>      <a href="../known_issues.html"  title="Known Issues">Known Issues</a>
 </li>
                   
                       <li>      <a href="../dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
 </li>
                   
-                      <li>      <a href="../when_things_go_wrong.html"  title="When things go wrong">When things go wrong</a>
+                      <li>      <a href="../FAQ.html"  title="FAQ">FAQ</a>
 </li>
                           </ul>
       </li>
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-06</li>
+                  <li id="publishDate">Last Published: 2014-05-14</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -201,13 +201,6 @@
           <i class="none"></i>
         Downloads</a>
             </li>
-                  
-      <li>
-    
-                          <a href="../from_here.html" title="From here">
-          <i class="none"></i>
-        From here</a>
-            </li>
                               <li class="nav-header">Concepts and architecture</li>
                                 
       <li>
@@ -226,9 +219,9 @@
                   
       <li>
     
-                          <a href="../microkernel.html" title="NodesStore and MicroKernel">
+                          <a href="../microkernel.html" title="NodeStore and MicroKernel">
           <i class="none"></i>
-        NodesStore and MicroKernel</a>
+        NodeStore and MicroKernel</a>
             </li>
                   
       <li>
@@ -269,9 +262,9 @@
                   
       <li>
     
-                          <a href="../differences.html" title="Differences to Jackrabbit 2">
+                          <a href="../construct.html" title="Repository construction">
           <i class="none"></i>
-        Differences to Jackrabbit 2</a>
+        Repository construction</a>
             </li>
                   
       <li>
@@ -283,6 +276,13 @@
                   
       <li>
     
+                          <a href="../differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
                           <a href="../known_issues.html" title="Known Issues">
           <i class="none"></i>
         Known Issues</a>
@@ -297,9 +297,9 @@
                   
       <li>
     
-                          <a href="../when_things_go_wrong.html" title="When things go wrong">
+                          <a href="../FAQ.html" title="FAQ">
           <i class="none"></i>
-        When things go wrong</a>
+        FAQ</a>
             </li>
                               <li class="nav-header">Developing Oak</li>
                                 
@@ -377,13 +377,147 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License. --><h1>The Oak Security Layer</h1>
-<div class="section">
+   limitations under the License. --><div class="section">
 <h2>Access Control<a name="Access_Control"></a></h2>
-<p><i>TODO</i></p>
 <div class="section">
-<h3>Differences wrt Jackrabbit 2.x<a name="Differences_wrt_Jackrabbit_2.x"></a></h3>
-<p>see the corresponding <a href="../differences_accesscontrol.html">documentation</a>.</p></div></div>
+<h3>JCR API<a name="JCR_API"></a></h3>
+<p><i>todo</i></p></div>
+<div class="section">
+<h3>Jackrabbit API<a name="Jackrabbit_API"></a></h3>
+<p><i>todo</i></p></div>
+<div class="section">
+<h3>Oak API<a name="Oak_API"></a></h3>
+<p><i>todo</i></p></div>
+<div class="section">
+<h3>Characteristics of the Default Implementation<a name="Characteristics_of_the_Default_Implementation"></a></h3>
+<div class="section">
+<h4>General<a name="General"></a></h4>
+<p>In general the authorization related code in Oak clearly separates between access control management (such as defined by the JCR and Jackrabbit API) and the internal permission evaluation (see also <a href="differences_permissions.html">Permission Evaluation</a>).</p>
+<p>The default implementation of the access control management corresponds to the resource-based implementation present with Jackrabbit 2.x. The former principal-base access control management is no longer available but it&#x2019;s functionality has been incorporated both in the default ac management implementation and the permission evaluation.</p></div>
+<div class="section">
+<h4>Differences wrt Jackrabbit 2.x<a name="Differences_wrt_Jackrabbit_2.x"></a></h4>
+<p>see the corresponding <a href="accesscontrol/differences.html">documentation</a>.</p></div>
+<div class="section">
+<h4>Resource Based Access Control<a name="Resource_Based_Access_Control"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4>Principal Base Access Control<a name="Principal_Base_Access_Control"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4>Access Control Policies<a name="Access_Control_Policies"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4>Access Control Entries<a name="Access_Control_Entries"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4>Restrictions<a name="Restrictions"></a></h4>
+<p>see section <a href="accesscontrol/restriction.html">Restriction Management</a> for details.</p></div></div>
+<div class="section">
+<h3>Representation in the Repository<a name="Representation_in_the_Repository"></a></h3>
+<p>The node type definition used to represent access control content:</p>
+
+<div class="source">
+<pre>[rep:AccessControllable]
+  mixin
+  + rep:policy (rep:Policy) protected IGNORE
+
+[rep:RepoAccessControllable]
+  mixin
+  + rep:repoPolicy (rep:Policy) protected IGNORE
+
+[rep:Policy]
+  abstract
+
+[rep:ACL] &gt; rep:Policy
+  orderable
+  + * (rep:ACE) = rep:GrantACE protected IGNORE
+
+[rep:ACE]
+  - rep:principalName (STRING) protected mandatory
+  - rep:privileges (NAME) protected mandatory multiple
+  - rep:nodePath (PATH) protected /* deprecated in favor of restrictions */
+  - rep:glob (STRING) protected   /* deprecated in favor of restrictions */
+  - * (UNDEFINED) protected       /* deprecated in favor of restrictions */
+  + rep:restrictions (rep:Restrictions) = rep:Restrictions protected /* since oak 1.0 */
+
+[rep:GrantACE] &gt; rep:ACE
+
+[rep:DenyACE] &gt; rep:ACE
+
+/**
+ * @since oak 1.0
+ */
+[rep:Restrictions]
+  - * (UNDEFINED) protected
+  - * (UNDEFINED) protected multiple
+</pre></div></div>
+<div class="section">
+<h3>XML Import<a name="XML_Import"></a></h3>
+<p>As of OAK 1.0 access control content can be imported both with Session and Workspace import.</p>
+<p>In addition the JCR XML import behavior has been extended to respect the <tt>o.a.j.oak.spi.xml.ImportBehavior</tt> flags instead of just performing a best effort import.</p>
+<p>Currently the <tt>ImportBehavior</tt> is only used to switch between different ways of handling principals unknown to the repository. For consistency and in order to match the validation requirements as specified by <tt>AccessControlList#addAccessControlEntry</tt> the default behavior is ABORT (while in Jackrabbit 2.x the behavior always was BESTEFFORT).</p>
+<p>The different <tt>ImportBehavior</tt> flags are implemented as follows: - <tt>ABORT</tt>: throws an <tt>AccessControlException</tt> if the principal is unknown - <tt>IGNORE</tt>: ignore the entry defining the unknown principal - <tt>BESTEFFORT</tt>: import the access control entry with an unknown principal.</p>
+<p>In order to get the same best effort behavior as present with Jackrabbit 2.x the configuration parameters of the <tt>AuthorizationConfiguration</tt> must contain the following entry:</p>
+
+<div class="source">
+<pre>importBehavior = &quot;besteffort&quot;
+</pre></div>
+<p>See also (<a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-1350">OAK-1350</a>))</p></div>
+<div class="section">
+<h3>API Extensions<a name="API_Extensions"></a></h3>
+<p><i>todo</i></p>
+<p>org.apache.jackrabbit.oak.spi.security.authorization.accesscontrol <a class="externalLink" href="http://svn.apache.org/repos/asf/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/spi/security/authorization/restriction/">1</a></p>
+
+<ul>
+  
+<li><tt>AbstractAccessControlList</tt></li>
+  
+<li><tt>ImmutableACL</tt></li>
+  
+<li><tt>ACE</tt></li>
+</ul>
+<div class="section">
+<h4>Restriction Management<a name="Restriction_Management"></a></h4>
+
+<ul>
+  
+<li><tt>RestrictionProvider</tt>:</li>
+  
+<li><tt>RestrictionDefinition</tt></li>
+  
+<li><tt>RestrictionPattern</tt></li>
+  
+<li><tt>Restriction</tt></li>
+</ul>
+<p>See <a href="accesscontrol/restriction.html">Restriction Management</a> for details.</p></div></div>
+<div class="section">
+<h3>Configuration<a name="Configuration"></a></h3>
+<p>The following access control related configuration options are present with the <a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/AuthorizationConfiguration.html">AuthorizationConfiguration</a> as of Oak 1.0:</p>
+
+<ul>
+  
+<li><tt>getAccessControlManager</tt></li>
+  
+<li><tt>getRestrictionProvider</tt></li>
+</ul>
+<p>Differences to Jackrabbit 2.x:</p>
+
+<ul>
+  
+<li>The &#x201c;omit-default-permission&#x201d; configuration option present with the Jackrabbit&#x2019;s AccessControlProvider implementations is no longer supported with Oak.</li>
+  
+<li>As of OAK no extra access control content is installed by default which renders that flag superfluous.</li>
+</ul></div>
+<div class="section">
+<h3>Further Reading<a name="Further_Reading"></a></h3>
+
+<ul>
+  
+<li><a href="accesscontrol/differences.html">Differences wrt Jackrabbit 2.x</a></li>
+  
+<li><a href="accesscontrol/restriction.html">Restriction Management</a></li>
+</ul>
+<!-- hidden references --></div></div>
                   </div>
             </div>
           </div>

Added: jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html?rev=1594576&view=auto
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html (added)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html Wed May 14 13:30:13 2014
@@ -0,0 +1,487 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2014-05-14
+ | 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="20140514" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Jackrabbit Oak - AccessControl Management : Differences wrt Jackrabbit 2.x</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>
+
+    
+            </head>
+        <body class="topBarEnabled">
+          
+    
+    
+            
+    
+    
+    <a href="http://github.com/apache/jackrabbit-oak">
+      <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
+        src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
+        alt="Fork me on GitHub">
+    </a>
+  
+                
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                <div class="container-fluid">
+        <a data-target=".nav-collapse" data-toggle="collapse" class="btn btn-navbar">
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </a>
+                
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../../index.html"  title="Jackrabbit Oak">Jackrabbit Oak</a>
+</li>
+                  
+                      <li>      <a href="../../license.html"  title="License">License</a>
+</li>
+                  
+                      <li>      <a href="../../downloads.html"  title="Downloads">Downloads</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Concepts and architecture <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../../overview.html"  title="Overview">Overview</a>
+</li>
+                  
+                      <li>      <a href="../../nodestate.html"  title="The node state model">The node state model</a>
+</li>
+                  
+                      <li>      <a href="../../microkernel.html"  title="NodeStore and MicroKernel">NodeStore and MicroKernel</a>
+</li>
+                  
+                      <li>      <a href="../../query.html"  title="Query">Query</a>
+</li>
+                  
+                      <li>      <a href="../../blobstore.html"  title="BlobStore">BlobStore</a>
+</li>
+                  
+                      <li>      <a href="../../security/overview.html"  title="Security">Security</a>
+</li>
+                  
+                      <li>      <a href="../../clustering.html"  title="Clustering">Clustering</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Using Oak <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../../use_getting_started.html"  title="Getting Started">Getting Started</a>
+</li>
+                  
+                      <li>      <a href="../../construct.html"  title="Repository construction">Repository construction</a>
+</li>
+                  
+                      <li>      <a href="../../osgi_config.html"  title="Configuring Oak">Configuring Oak</a>
+</li>
+                  
+                      <li>      <a href="../../differences.html"  title="Differences to Jackrabbit 2">Differences to Jackrabbit 2</a>
+</li>
+                  
+                      <li>      <a href="../../known_issues.html"  title="Known Issues">Known Issues</a>
+</li>
+                  
+                      <li>      <a href="../../dos_and_donts.html"  title="Dos and don'ts">Dos and don'ts</a>
+</li>
+                  
+                      <li>      <a href="../../FAQ.html"  title="FAQ">FAQ</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Developing Oak <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../../dev_getting_started.html"  title="Getting Started">Getting Started</a>
+</li>
+                  
+                      <li>      <a href="../../participating.html"  title="Participating">Participating</a>
+</li>
+                  
+                      <li>      <a href="../../apidocs/index.html"  title="API docs">API docs</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://jackrabbit.apache.org/oak"  title="Apache Jackrabbit Oak">Apache Jackrabbit Oak</a>
+</li>
+                  
+                      <li>      <a href="http://jackrabbit.apache.org/"  title="Apache Jackrabbit">Apache Jackrabbit</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+          
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Oak Documentation</h2>
+                </div>
+                      </div>
+        <div class="pull-right">  </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                    
+                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
+                      
+                
+                    
+      
+                            </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+                    
+                <ul class="nav nav-list">
+                    <li class="nav-header">Overview</li>
+                                
+      <li>
+    
+                          <a href="../../index.html" title="Jackrabbit Oak">
+          <i class="none"></i>
+        Jackrabbit Oak</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../license.html" title="License">
+          <i class="none"></i>
+        License</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../downloads.html" title="Downloads">
+          <i class="none"></i>
+        Downloads</a>
+            </li>
+                              <li class="nav-header">Concepts and architecture</li>
+                                
+      <li>
+    
+                          <a href="../../overview.html" title="Overview">
+          <i class="none"></i>
+        Overview</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../nodestate.html" title="The node state model">
+          <i class="none"></i>
+        The node state model</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../microkernel.html" title="NodeStore and MicroKernel">
+          <i class="none"></i>
+        NodeStore and MicroKernel</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../query.html" title="Query">
+          <i class="none"></i>
+        Query</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../blobstore.html" title="BlobStore">
+          <i class="none"></i>
+        BlobStore</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../security/overview.html" title="Security">
+          <i class="none"></i>
+        Security</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../clustering.html" title="Clustering">
+          <i class="none"></i>
+        Clustering</a>
+            </li>
+                              <li class="nav-header">Using Oak</li>
+                                
+      <li>
+    
+                          <a href="../../use_getting_started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../construct.html" title="Repository construction">
+          <i class="none"></i>
+        Repository construction</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../osgi_config.html" title="Configuring Oak">
+          <i class="none"></i>
+        Configuring Oak</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../differences.html" title="Differences to Jackrabbit 2">
+          <i class="none"></i>
+        Differences to Jackrabbit 2</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../known_issues.html" title="Known Issues">
+          <i class="none"></i>
+        Known Issues</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../dos_and_donts.html" title="Dos and don'ts">
+          <i class="none"></i>
+        Dos and don'ts</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../FAQ.html" title="FAQ">
+          <i class="none"></i>
+        FAQ</a>
+            </li>
+                              <li class="nav-header">Developing Oak</li>
+                                
+      <li>
+    
+                          <a href="../../dev_getting_started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../participating.html" title="Participating">
+          <i class="none"></i>
+        Participating</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../../apidocs/index.html" title="API docs">
+          <i class="none"></i>
+        API docs</a>
+            </li>
+                              <li class="nav-header">Links</li>
+                                
+      <li>
+    
+                          <a href="http://jackrabbit.apache.org/oak" class="externalLink" title="Apache Jackrabbit Oak">
+          <i class="none"></i>
+        Apache Jackrabbit Oak</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit">
+          <i class="none"></i>
+        Apache Jackrabbit</a>
+            </li>
+            </ul>
+                
+                    
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                   
+    <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
+
+    
+    <div class="g-plusone" data-href="http://jackrabbit.apache.org/oak-doc/" data-size="tall" ></div>
+
+                   <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <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>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <!-- Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. --><div class="section">
+<div class="section">
+<h3>AccessControl Management : Differences wrt Jackrabbit 2.x<a name="AccessControl_Management_:_Differences_wrt_Jackrabbit_2.x"></a></h3>
+<div class="section">
+<h4>Characteristics of the Default Implementation<a name="Characteristics_of_the_Default_Implementation"></a></h4>
+<div class="section">
+<h5>JCR API<a name="JCR_API"></a></h5>
+<div class="section">
+<h6>AccessControlManager#hasPrivilege and #getPrivileges<a name="AccessControlManagerhasPrivilege_and_getPrivileges"></a></h6>
+<p>As of OAK those methods throw <tt>PathNotFoundException</tt> if the corresponding node is not accessible by the editing session. This is in accordance with the behavior mandated by JSR 283 and a bug in Jackrabbit 2.x.</p></div>
+<div class="section">
+<h6>AccessControlManager#getEffectivePolicies<a name="AccessControlManagergetEffectivePolicies"></a></h6>
+<p>In contrast to Jackrabbit 2.x the editing session is used to retrieve the effective policies and the policies returned by these methods are guarantueed to only return information that is otherwise accessible by the session. The corresponding methods in Jackrabbit 2.x use to throw an exception in this situation.</p></div>
+<div class="section">
+<h6>AccessControlPolicy<a name="AccessControlPolicy"></a></h6>
+<p>OAK introduces a new type of policy that enforces regular read-access for everyone on the trees that hold this new <tt>ReadPolicy</tt> (see <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-951">OAK-951</a>). The main usage of this new policy is to ensure backwards compatible behavior of repository level information (node types, namespace, privileges) that are now kept within the content repository. In Jackrabbit 2.x this information was stored in the file system without the ability to apply or enforce regular access control such as present with items in the repository.</p>
+<p>Currently these special read policies are defined as part of the overall security configuration and cannot be managed/edited using regular access control management API (see (<a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-951">OAK-951</a>)).</p></div>
+<div class="section">
+<h6>AccessControlEntry<a name="AccessControlEntry"></a></h6>
+<p>Validation: as of OAK the implementation of the <tt>AccessControlEntry</tt> interface is no longer in charge of validating the specified privileges. While some validation is still performed in the corresponding <tt>AccessControlList</tt> methods, the complete validation is delegated to the commit phase and executed by a specific <tt>Validator</tt> implementation.</p>
+<p>The default behavior with respect to principal validation is compliant with the specification and the same as in Jackrabbit 2.x.: Adding an ACE for an principal unknown to the repository will fail. However in order to be consistent with the ability have a more relaxed behavior upon XML import that validation will be relaxed if the import behavior is being changed to allow for unknown principals (see (<a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-1350">OAK-1350</a>)) and the section Import below.</p>
+<p>Restrictions: as of OAK the optional restrictions present with a given <tt>JackrabbitAccessControlEntry</tt> can be multivalued (see below).</p></div></div>
+<div class="section">
+<h5>Jackrabbit API<a name="Jackrabbit_API"></a></h5>
+<div class="section">
+<h6>Principal-based Access Control<a name="Principal-based_Access_Control"></a></h6>
+<p>The principal-based access control management as present in Jackrabbit-core is no longer present with OAK. The main benefit of the principal-based approach has been incorporated with the changes in the default <a href="differences_permissions.html">permission evaluation</a>). In addition the default access control manager implementation supports all methods defined by <tt>JackrabbitAccessControlManager</tt>; i.e. editing access control information by principal is possible as long as the editing session has sufficient permission on the target node(s). Similarly, the per principal policies exposed to a given session will always respect that access rights of that session.</p></div>
+<div class="section">
+<h6>Restrictions<a name="Restrictions"></a></h6>
+<p>The implementation of the additional restrictions associated with an ACE has been modified/extended as follows:</p>
+
+<ul>
+  
+<li>Separate restriction management API (see below) on the OAK level that allows to ease plugging custom restrictions.</li>
+  
+<li>Changed node type definition for storing restrictions in the default implementation.
+  
+<ul>
+    
+<li>as of OAK restrictions are collected underneath a separate child node &#x201c;rep:restrictions&#x201d;</li>
+    
+<li>restrictions can be multi-valued (see <a class="externalLink" href="https://issues.apache.org/jira/browse/JCR-3637">JCR-3637</a>, <a class="externalLink" href="https://issues.apache.org/jira/browse/JCR-3641">JCR-3641</a>)</li>
+    
+<li>backwards compatible behavior for restrictions stored underneath the ACE node directly</li>
+  </ul></li>
+  
+<li>New restrictions:
+  
+<ul>
+    
+<li>&#x201c;rep:ntNames&#x201d;, which allows to limit the affected ACE to nodes of the specified node type(s)</li>
+    
+<li>&#x201c;rep:prefixes&#x201d;, which allows to limit the effect to item names that have a specific namespace prefix.</li>
+  </ul></li>
+</ul></div></div>
+<div class="section">
+<h5>Import<a name="Import"></a></h5>
+
+<ul>
+  
+<li>respects <tt>ImportBehavior</tt> for handling of principals instead of just performing best effort import</li>
+  
+<li>supports both workspace and import</li>
+</ul></div></div>
+<div class="section">
+<h4>Configuration<a name="Configuration"></a></h4>
+
+<ul>
+  
+<li>The &#x201c;omit-default-permission&#x201d; configuration option present with the Jackrabbit&#x2019;s AccessControlProvider implementations is no longer supported with Oak.</li>
+  
+<li>As of OAK no extra access control content is installed by default which renders that flag superfluous.</li>
+</ul></div>
+<div class="section">
+<h4>Important Note<a name="Important_Note"></a></h4>
+<p>The following modification is most likely to have an effect on existing applications:</p>
+
+<ul>
+  
+<li><tt>AccessControlManager#hasPrivilege()</tt> and <tt>AccessControlManager#getPrivileges()</tt> will throw a  <tt>PathNotFoundException</tt> if the node for the specified path is not accessible. The Jackrabbit 2  implementation is wrong and we fixed that in OAK (<a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-886">OAK-886</a>).  If the new behaviour turns out to be a problem with existing applications we might consider  adding backward compatible behaviour.</li>
+</ul>
+<!-- hidden references --></div></div></div>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2012-2014
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                    
+      </div>
+
+        
+        
+          
+    
+    
+    <div id="ohloh" class="pull-right">
+      <script type="text/javascript" src="http://www.ohloh.net/p/jackrabbit-oak/widgets/project_users_logo.js"></script>
+    </div>
+        </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file



Mime
View raw message