Return-Path: X-Original-To: apmail-jackrabbit-commits-archive@www.apache.org Delivered-To: apmail-jackrabbit-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id E97161023E for ; Tue, 5 Nov 2013 16:32:42 +0000 (UTC) Received: (qmail 85585 invoked by uid 500); 5 Nov 2013 16:32:42 -0000 Delivered-To: apmail-jackrabbit-commits-archive@jackrabbit.apache.org Received: (qmail 85555 invoked by uid 500); 5 Nov 2013 16:32:42 -0000 Mailing-List: contact commits-help@jackrabbit.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@jackrabbit.apache.org Delivered-To: mailing list commits@jackrabbit.apache.org Received: (qmail 85547 invoked by uid 99); 5 Nov 2013 16:32:42 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 05 Nov 2013 16:32:42 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 05 Nov 2013 16:32:36 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 03EEB23888FE; Tue, 5 Nov 2013 16:32:14 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1539051 - /jackrabbit/site/live/oak/docs/ Date: Tue, 05 Nov 2013 16:32:13 -0000 To: commits@jackrabbit.apache.org From: mduerig@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20131105163214.03EEB23888FE@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mduerig Date: Tue Nov 5 16:32:12 2013 New Revision: 1539051 URL: http://svn.apache.org/r1539051 Log: OAK-936: Site checkin for project Oak Documentation-0.11-SNAPSHOT Modified: jackrabbit/site/live/oak/docs/blobstore.html jackrabbit/site/live/oak/docs/construct.html jackrabbit/site/live/oak/docs/dev_getting_started.html jackrabbit/site/live/oak/docs/differences.html jackrabbit/site/live/oak/docs/dos_and_donts.html jackrabbit/site/live/oak/docs/downloads.html jackrabbit/site/live/oak/docs/from_here.html jackrabbit/site/live/oak/docs/index.html jackrabbit/site/live/oak/docs/jsop-diff.html jackrabbit/site/live/oak/docs/known_issues.html jackrabbit/site/live/oak/docs/license.html jackrabbit/site/live/oak/docs/microkernel.html jackrabbit/site/live/oak/docs/mongomk.html jackrabbit/site/live/oak/docs/nodestate.html jackrabbit/site/live/oak/docs/overview.html jackrabbit/site/live/oak/docs/participating.html jackrabbit/site/live/oak/docs/query.html jackrabbit/site/live/oak/docs/segmentmk.html jackrabbit/site/live/oak/docs/use_getting_started.html jackrabbit/site/live/oak/docs/when_things_go_wrong.html Modified: jackrabbit/site/live/oak/docs/blobstore.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/blobstore.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/blobstore.html (original) +++ jackrabbit/site/live/oak/docs/blobstore.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
    -
  • Last Published: 2013-10-29
    • +
  • Last Published: 2013-11-05
  • |
  • Version: 0.11-SNAPSHOT
    • Modified: jackrabbit/site/live/oak/docs/construct.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/construct.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/construct.html (original) +++ jackrabbit/site/live/oak/docs/construct.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
      -
    • Last Published: 2013-10-29
      • +
    • Last Published: 2013-11-05
    • |
    • Version: 0.11-SNAPSHOT
      • Modified: jackrabbit/site/live/oak/docs/dev_getting_started.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/dev_getting_started.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/dev_getting_started.html (original) +++ jackrabbit/site/live/oak/docs/dev_getting_started.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
        -
      • Last Published: 2013-10-29
        • +
      • Last Published: 2013-11-05
      • |
      • Version: 0.11-SNAPSHOT
        • Modified: jackrabbit/site/live/oak/docs/differences.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/differences.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/differences.html (original) +++ jackrabbit/site/live/oak/docs/differences.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
          -
        • Last Published: 2013-10-29
          • +
        • Last Published: 2013-11-05
        • |
        • Version: 0.11-SNAPSHOT
          • @@ -364,8 +364,8 @@

          On Oak Item.save() is deprecated and will per default log a warning and fall back to Session.save(). This behaviour can be tweaked with -Ditem-save-does-session-save=false in which case no fall back to Session#save() will happen but an UnsupportedRepositoryException is thrown if the sub-tree rooted at the respective item does not contain all transient changes. See OAK-993 for details.

          Query

          -

          Oak does not index content by default as does Jackrabbit 2. You need to create custom indexes when necessary, much like in traditional RDBMSs. If there is no index for a specific query then the repository will be traversed. That is, the query will still work but probably be very slow.

          -

          See the query overview page for how to create a custom index.

          +

          Oak does not index content by default as does Jackrabbit 2. You need to create custom indexes when necessary, much like in traditional RDBMSs. If there is no index for a specific query then the repository will be traversed. That is, the query will still work but probably be very slow. See the query overview page for how to create a custom index.

          +

          There were some smaller bugfixes in the query parser which might lead to incompatibility. See the query overview page for details.

          Observation

          @@ -382,22 +382,32 @@
            -
          • Event.NODE_MOVED is not supported. Instead Event.NODE_ADDED and Event.Node_REMOVED events are reported for the respective subtrees.
            • +
          • Touched properties: Jackrabbit 2 used to generate a PROPERTY_CHANGED event when touching a property (i.e. setting a property to its current value). Oak keeps closer to the specification and omits such events. More generally removing a subtree and replacing it with the same subtree will not generate any event.
            -
          • Reordering nodes will not report any event.
            • +
          • Removing a referenceable node and adding it again will result in a PROPERTY_CHANGED event for jcr:uuid; the same applies for other built-in protected and mandatory properties such as e.g. jcr:versionHistory if the corresponding versionable node was removed and a versionable node with the same name is being created.
            -
          • Touched properties: Jackrabbit 2 used to generate a PROPERTY_CHANGED event when touching a property (i.e. setting a property to its current value). Oak keeps closer to the specification and omits such events. More generally removing a subtree and replacing it with the same subtree will not generate any event.
            • +
          • Limited support for Event.NODE_MOVED:
            -
          • Removing a referenceable node and adding it again will result in a PROPERTY_CHANGED event for jcr:uuid; the same applies for other built-in protected and mandatory properties such as e.g. jcr:versionHistory if the corresponding versionable node was removed and a versionable node with the same name is being created.
            • +
          • NODE_MOVED are only reported for nodes whose source location is not transient. A source location is transient if it is transiently added or a child node of a transiently moved tree.
            • +
          + +
            + +
          • Removing a node and adding a node with the same name at the same parent will be reported as NODE_MOVED event as if it where caused by Node.orderBefore().
            • +
          + +
            + +
          • The exact sequence of Node.orderBefore() will not be reflected through NODE_MOVED events: given two child nodes a and b, ordering a after b may be reported as ordering b before a.
        • Modified: jackrabbit/site/live/oak/docs/dos_and_donts.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/dos_and_donts.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/dos_and_donts.html (original) +++ jackrabbit/site/live/oak/docs/dos_and_donts.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
            -
          • Last Published: 2013-10-29
            • +
          • Last Published: 2013-11-05
          • |
          • Version: 0.11-SNAPSHOT
            • Modified: jackrabbit/site/live/oak/docs/downloads.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/downloads.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/downloads.html (original) +++ jackrabbit/site/live/oak/docs/downloads.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
              -
            • Last Published: 2013-10-29
              • +
            • Last Published: 2013-11-05
            • |
            • Version: 0.11-SNAPSHOT
              • Modified: jackrabbit/site/live/oak/docs/from_here.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/from_here.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/from_here.html (original) +++ jackrabbit/site/live/oak/docs/from_here.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                -
              • Last Published: 2013-10-29
                • +
              • Last Published: 2013-11-05
              • |
              • Version: 0.11-SNAPSHOT
                • Modified: jackrabbit/site/live/oak/docs/index.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/index.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/index.html (original) +++ jackrabbit/site/live/oak/docs/index.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                  -
                • Last Published: 2013-10-29
                  • +
                • Last Published: 2013-11-05
                • |
                • Version: 0.11-SNAPSHOT
                  • Modified: jackrabbit/site/live/oak/docs/jsop-diff.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/jsop-diff.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/jsop-diff.html (original) +++ jackrabbit/site/live/oak/docs/jsop-diff.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                    -
                  • Last Published: 2013-10-29
                    • +
                  • Last Published: 2013-11-05
                  • |
                  • Version: 0.11-SNAPSHOT
                    • Modified: jackrabbit/site/live/oak/docs/known_issues.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/known_issues.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/known_issues.html (original) +++ jackrabbit/site/live/oak/docs/known_issues.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                      -
                    • Last Published: 2013-10-29
                      • +
                    • Last Published: 2013-11-05
                    • |
                    • Version: 0.11-SNAPSHOT
                      • Modified: jackrabbit/site/live/oak/docs/license.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/license.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/license.html (original) +++ jackrabbit/site/live/oak/docs/license.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                        -
                      • Last Published: 2013-10-29
                        • +
                      • Last Published: 2013-11-05
                      • |
                      • Version: 0.11-SNAPSHOT
                        • Modified: jackrabbit/site/live/oak/docs/microkernel.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/microkernel.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/microkernel.html (original) +++ jackrabbit/site/live/oak/docs/microkernel.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                          -
                        • Last Published: 2013-10-29
                          • +
                        • Last Published: 2013-11-05
                        • |
                        • Version: 0.11-SNAPSHOT
                          • Modified: jackrabbit/site/live/oak/docs/mongomk.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/mongomk.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/mongomk.html (original) +++ jackrabbit/site/live/oak/docs/mongomk.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                            -
                          • Last Published: 2013-10-29
                            • +
                          • Last Published: 2013-11-05
                          • |
                          • Version: 0.11-SNAPSHOT
                            • Modified: jackrabbit/site/live/oak/docs/nodestate.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/nodestate.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/nodestate.html (original) +++ jackrabbit/site/live/oak/docs/nodestate.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                              -
                            • Last Published: 2013-10-29
                              • +
                            • Last Published: 2013-11-05
                            • |
                            • Version: 0.11-SNAPSHOT
                              • Modified: jackrabbit/site/live/oak/docs/overview.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/overview.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/overview.html (original) +++ jackrabbit/site/live/oak/docs/overview.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                                -
                              • Last Published: 2013-10-29
                                • +
                              • Last Published: 2013-11-05
                              • |
                              • Version: 0.11-SNAPSHOT
                                • Modified: jackrabbit/site/live/oak/docs/participating.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/participating.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/participating.html (original) +++ jackrabbit/site/live/oak/docs/participating.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                                  -
                                • Last Published: 2013-10-29
                                  • +
                                • Last Published: 2013-11-05
                                • |
                                • Version: 0.11-SNAPSHOT
                                  • Modified: jackrabbit/site/live/oak/docs/query.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/query.html (original) +++ jackrabbit/site/live/oak/docs/query.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                                    -
                                  • Last Published: 2013-10-29
                                    • +
                                  • Last Published: 2013-11-05
                                  • |
                                  • Version: 0.11-SNAPSHOT
                                    • @@ -365,6 +365,20 @@ org.apache.jackrabbit.oak.query.QueryEng

          • Each transformed SQL2 query contains the original XPath query as a comment.

          +

          Compatibility

          +

          The query parser is now generally more strict about invalid syntax. The following query used to work in Jackrabbit 2.x, but not in Oak, because multiple way to quote the path are used at the same time:

          + +
          +
          SELECT * FROM [nt:base] AS s 
+WHERE ISDESCENDANTNODE(s, ["/libs/sling/config"])
+
          +

          Instead, the query now needs to be:

          + +
          +
          SELECT * FROM [nt:base] AS s 
+WHERE ISDESCENDANTNODE(s, [/libs/sling/config])
+
          +

          Query Processing

          Internally, the query engine uses a cost based query optimizer that asks all the available query indexes for the estimated cost to process the query. It then uses the index with the lowest cost.

          By default, the following indexes are available:

          Modified: jackrabbit/site/live/oak/docs/segmentmk.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/segmentmk.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/segmentmk.html (original) +++ jackrabbit/site/live/oak/docs/segmentmk.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
            -
          • Last Published: 2013-10-29
            • +
          • Last Published: 2013-11-05
          • |
          • Version: 0.11-SNAPSHOT
            • Modified: jackrabbit/site/live/oak/docs/use_getting_started.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/use_getting_started.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/use_getting_started.html (original) +++ jackrabbit/site/live/oak/docs/use_getting_started.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
              -
            • Last Published: 2013-10-29
              • +
            • Last Published: 2013-11-05
            • |
            • Version: 0.11-SNAPSHOT
              • Modified: jackrabbit/site/live/oak/docs/when_things_go_wrong.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/when_things_go_wrong.html?rev=1539051&r1=1539050&r2=1539051&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/when_things_go_wrong.html (original) +++ jackrabbit/site/live/oak/docs/when_things_go_wrong.html Tue Nov 5 16:32:12 2013 @@ -1,13 +1,13 @@ - + Jackrabbit Oak - @@ -154,7 +154,7 @@
                -
              • Last Published: 2013-10-29
                • +
              • Last Published: 2013-11-05
              • |
              • Version: 0.11-SNAPSHOT