You are viewing a plain text version of this content. The canonical link for it is here.
Posted to oak-commits@jackrabbit.apache.org by th...@apache.org on 2017/11/07 12:17:39 UTC
svn commit: r1814497 -
/jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md
Author: thomasm
Date: Tue Nov 7 12:17:39 2017
New Revision: 1814497
URL: http://svn.apache.org/viewvc?rev=1814497&view=rev
Log:
OAK-301 Document Oak
Modified:
jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md
Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md?rev=1814497&r1=1814496&r2=1814497&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/query/query-engine.md Tue Nov 7 12:17:39 2017
@@ -203,10 +203,13 @@ For NodeIterator.getSize(), some version
Lucene result set size, including nodes that are not accessible.
By default, Oak does not do this; it either returns the correct result size, or -1.
-Oak 1.2.x and newer supports a compatibility flag so that it works in the same way
+Oak 1.2.x and newer supports a compatibility flag so that it works in a similar way
as Jackrabbit 2.x, by returning an estimate (see OAK-2926).
-The estimate will be larger or equal the actual result size,
-as it includes unindexed properties and nodes that are not accessible.
+Specially, only query restrictions that are part of the used index are considered when calculating the size.
+Additionally, ACLs are not applied to the results,
+so nodes which are not visible to the current session will still be included in the count returned.
+As such, the count returned can be higher than the actual number of results
+and the accurate count can only be determined by iterating through the results.
This only works with the Lucene `compatVersion=2` right now,
so even if enabled, getSize may still return -1 if the index used does not support the feature.