You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by ca...@apache.org on 2019/06/13 15:52:33 UTC
svn commit: r1861272 - in /jackrabbit/site/live/oak/docs/query:
grammar-sql2.html grammar-xpath.html
Author: catholicon
Date: Thu Jun 13 15:52:33 2019
New Revision: 1861272
URL: http://svn.apache.org/viewvc?rev=1861272&view=rev
Log:
OAK-301: Oak docu
Modified:
jackrabbit/site/live/oak/docs/query/grammar-sql2.html
jackrabbit/site/live/oak/docs/query/grammar-xpath.html
Modified: jackrabbit/site/live/oak/docs/query/grammar-sql2.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/grammar-sql2.html?rev=1861272&r1=1861271&r2=1861272&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/grammar-sql2.html (original)
+++ jackrabbit/site/live/oak/docs/query/grammar-sql2.html Thu Jun 13 15:52:33 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 at 2019-06-12
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 at 2019-06-13
| Rendered using Apache Maven Fluido Skin 1.6
-->
<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="20190612" />
+ <meta name="Date-Revision-yyyymmdd" content="20190613" />
<meta http-equiv="Content-Language" content="en" />
<title>Jackrabbit Oak – Oak SQL-2 Query Grammar</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.6.min.css" />
@@ -86,7 +86,16 @@
<li><a href="../query/solr.html" title="Solr Index">Solr Index</a></li>
</ul>
</li>
- <li><a href="../security/overview.html" title="Security">Security</a></li>
+ <li class="dropdown-submenu">
+<a href="../security/overview.html" title="Security">Security</a>
+ <ul class="dropdown-menu">
+ <li><a href="../security/introduction.html" title="Introduction">Introduction</a></li>
+ <li><a href="../security/authentication.html" title="Authentication">Authentication</a></li>
+ <li><a href="../security/authorization.html" title="Authorization">Authorization</a></li>
+ <li><a href="../security/principal.html" title="Principal Management">Principal Management</a></li>
+ <li><a href="../security/user.html" title="User Management">User Management</a></li>
+ </ul>
+ </li>
<li><a href="../features/atomic-counter.html" title="Atomic Counter">Atomic Counter</a></li>
<li><a href="../features/observation.html" title="Observation">Observation</a></li>
</ul>
@@ -142,7 +151,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-12<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2019-06-13<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.14-SNAPSHOT</li>
</ul>
@@ -198,7 +207,15 @@
<li><a href="../query/solr.html" title="Solr Index"><span class="none"></span>Solr Index</a> </li>
</ul>
</li>
- <li><a href="../security/overview.html" title="Security"><span class="none"></span>Security</a> </li>
+ <li><a href="../security/overview.html" title="Security"><span class="icon-chevron-down"></span>Security</a>
+ <ul class="nav nav-list">
+ <li><a href="../security/introduction.html" title="Introduction"><span class="none"></span>Introduction</a> </li>
+ <li><a href="../security/authentication.html" title="Authentication"><span class="icon-chevron-right"></span>Authentication</a> </li>
+ <li><a href="../security/authorization.html" title="Authorization"><span class="icon-chevron-right"></span>Authorization</a> </li>
+ <li><a href="../security/principal.html" title="Principal Management"><span class="icon-chevron-right"></span>Principal Management</a> </li>
+ <li><a href="../security/user.html" title="User Management"><span class="icon-chevron-right"></span>User Management</a> </li>
+ </ul>
+ </li>
<li><a href="../features/atomic-counter.html" title="Atomic Counter"><span class="none"></span>Atomic Counter</a> </li>
<li><a href="../features/observation.html" title="Observation"><span class="none"></span>Observation</a> </li>
<li class="nav-header">Using Oak</li>
@@ -407,7 +424,7 @@ cast('2020-12-01T20:00:00.000' as date)
<hr /><h2><a name="dynamic_operand"></a>Dynamic Operand</h2><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"> </td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c"><a href="#name">selectorName</a> .</code></td></tr></table></td><td class="le"></td></tr></table></td><td class="d"><code class="c"><a href="#name">propertyName</a></code></td></tr></table></td><td class="te"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c">LENGTH ( <a href="#dynamic_operand">dynamicOperand</a> )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="rail
road"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><code class="c">NAME</code></td><td class="te"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><code class="c">LOCALNAME</code></td><td class="ke"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">SCORE</code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">(</code></td><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"> </td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c"><a href="#name">selectorName</a></code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">)</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td clas
s="d"><code class="c">LOWER</code></td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">UPPER</code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">( <a href="#dynamic_operand">dynamicOperand</a> )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c">COALESCE ( <a href="#dynamic_operand">dynamicOperand</a> , <a href="#dynamic_operand">dynamicOperand</a> )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c">PROPERTY ( <a href="#name">propertyName</a> , <a href="#type">type</a> )</code></td></tr></table></td><td class="le"></td></tr></table>
<p>The selector name is only needed if the query contains multiple selectors.</p>
-<p>Property names can be relative, so that for example ‘jcr:content/test’ means the property names ‘test’ in the child node ‘jcr:content’.</p>
+<p>Property names can be relative, so that for example ‘jcr:content/test’ means the property names ‘test’ in the child node ‘jcr:content’. Relative path fragments can also contain <tt>*</tt> to represent ‘any’ node at that point. <tt>//</tt> is <i>not</i> supported as part of relative path. So, <tt>a/*/test</tt>, <tt>*/a/test</tt>, <tt>a/*/*/test</tt> etc are valid while <tt>a//test</tt>, <tt>a/*/b//test</tt>, etc are <i>not</i>.</p>
<p>The wildcard ‘*’ means any property.</p>
<p>“coalesce”: this returns the first operand if it is not null, and the second operand otherwise. <tt>@since Oak 1.8</tt></p>
<p>“property”: This feature is rarely used. It allows to filter for all properties with a given type. Example: the condition <tt>property(*, Reference) = $uuid</tt> will search for any property of type <tt>Reference</tt>.</p>
Modified: jackrabbit/site/live/oak/docs/query/grammar-xpath.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/grammar-xpath.html?rev=1861272&r1=1861271&r2=1861272&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/grammar-xpath.html (original)
+++ jackrabbit/site/live/oak/docs/query/grammar-xpath.html Thu Jun 13 15:52:33 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 at 2019-06-12
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 at 2019-06-13
| Rendered using Apache Maven Fluido Skin 1.6
-->
<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="20190612" />
+ <meta name="Date-Revision-yyyymmdd" content="20190613" />
<meta http-equiv="Content-Language" content="en" />
<title>Jackrabbit Oak – Oak XPath Query Grammar - Oak Documentation</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.6.min.css" />
@@ -86,7 +86,16 @@
<li><a href="../query/solr.html" title="Solr Index">Solr Index</a></li>
</ul>
</li>
- <li><a href="../security/overview.html" title="Security">Security</a></li>
+ <li class="dropdown-submenu">
+<a href="../security/overview.html" title="Security">Security</a>
+ <ul class="dropdown-menu">
+ <li><a href="../security/introduction.html" title="Introduction">Introduction</a></li>
+ <li><a href="../security/authentication.html" title="Authentication">Authentication</a></li>
+ <li><a href="../security/authorization.html" title="Authorization">Authorization</a></li>
+ <li><a href="../security/principal.html" title="Principal Management">Principal Management</a></li>
+ <li><a href="../security/user.html" title="User Management">User Management</a></li>
+ </ul>
+ </li>
<li><a href="../features/atomic-counter.html" title="Atomic Counter">Atomic Counter</a></li>
<li><a href="../features/observation.html" title="Observation">Observation</a></li>
</ul>
@@ -142,7 +151,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-12<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2019-06-13<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.14-SNAPSHOT</li>
</ul>
@@ -198,7 +207,15 @@
<li><a href="../query/solr.html" title="Solr Index"><span class="none"></span>Solr Index</a> </li>
</ul>
</li>
- <li><a href="../security/overview.html" title="Security"><span class="none"></span>Security</a> </li>
+ <li><a href="../security/overview.html" title="Security"><span class="icon-chevron-down"></span>Security</a>
+ <ul class="nav nav-list">
+ <li><a href="../security/introduction.html" title="Introduction"><span class="none"></span>Introduction</a> </li>
+ <li><a href="../security/authentication.html" title="Authentication"><span class="icon-chevron-right"></span>Authentication</a> </li>
+ <li><a href="../security/authorization.html" title="Authorization"><span class="icon-chevron-right"></span>Authorization</a> </li>
+ <li><a href="../security/principal.html" title="Principal Management"><span class="icon-chevron-right"></span>Principal Management</a> </li>
+ <li><a href="../security/user.html" title="User Management"><span class="icon-chevron-right"></span>User Management</a> </li>
+ </ul>
+ </li>
<li><a href="../features/atomic-counter.html" title="Atomic Counter"><span class="none"></span>Atomic Counter</a> </li>
<li><a href="../features/observation.html" title="Observation"><span class="none"></span>Observation</a> </li>
<li class="nav-header">Using Oak</li>
@@ -464,7 +481,7 @@ xs:dateTime('2020-12-01T20:00:00.000')
</pre></div></div>
<hr /><h2><a name="dynamic_operand"></a>Dynamic Operand</h2><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"> </td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c"><a href="#path">relativePath</a> /</code></td></tr></table></td><td class="le"></td></tr></table></td><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><code class="c"><a href="#name">@propertyName</a></code></td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">*</code></td><td class="le"></td></tr></table></td></tr></table></td><td class="te"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td clas
s="d"><code class="c">fn:string-length ( <a href="#dynamic_operand">dynamicOperand</a> )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><code class="c">fn:name</code></td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">fn:local-name</code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">(</code></td><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"> </td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">.</code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">)</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr clas
s="railroad"><td class="d"><code class="c">jcr:score ( )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ks"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><table class="railroad"><tr class="railroad"><td class="ts"></td><td class="d"><code class="c">fn:lower-case</code></td><td class="te"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><code class="c">fn:upper-case</code></td><td class="le"></td></tr></table></td><td class="d"><code class="c">( <a href="#dynamic_operand">dynamicOperand</a> )</code></td></tr></table></td><td class="ke"></td></tr><tr class="railroad"><td class="ls"></td><td class="d"><table class="railroad"><tr class="railroad"><td class="d"><code class="c">fn:coalesce ( <a href="#dynamic_operand">firstDynamicOperand</a> , <a href="#dynamic_operand">secondDynamicOperand</a> )</code></td></tr></table></td><td class="le"></td></tr></table>
-<p>The “*” stands for any property. Using it in a condition requires a relative path. For example: <tt>[./* = 'test']</tt> means where any property matches the word ‘test’.</p>
+<p>The “*” stands for any property. Using it in a condition requires a relative path. For example: <tt>[./* = 'test']</tt> means where any property matches the word ‘test’. Relative path fragments can also contain <tt>*</tt> to represent ‘any’ node at that point. <tt>//</tt> is <i>not</i> supported as part of relative path. So, <tt>a/*/@test</tt>, <tt>*/a/@test</tt>, <tt>a/*/*/@test</tt> etc are valid while <tt>a//@test</tt>, <tt>a/*/b//@test</tt>, etc are <i>not</i>.</p>
<p>“jcr:score()” is the score returned by the index.</p>
<p>“fn:coalesce”: this returns the first operand if it is not null, and the second operand otherwise. <tt>@since Oak 1.8</tt></p>
<p>Examples:</p>