From commits-return-14579-apmail-jackrabbit-commits-archive=jackrabbit.apache.org@jackrabbit.apache.org Thu Oct 24 10:42:42 2013 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 B940110C25 for ; Thu, 24 Oct 2013 10:42:42 +0000 (UTC) Received: (qmail 89779 invoked by uid 500); 24 Oct 2013 10:42:39 -0000 Delivered-To: apmail-jackrabbit-commits-archive@jackrabbit.apache.org Received: (qmail 89614 invoked by uid 500); 24 Oct 2013 10:42:38 -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 89558 invoked by uid 99); 24 Oct 2013 10:42:30 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 24 Oct 2013 10:42:30 +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; Thu, 24 Oct 2013 10:42:25 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id C5E372388AAA; Thu, 24 Oct 2013 10:42:04 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1535337 [3/11] - in /jackrabbit/site/live/oak/docs: ./ css/ js/ Date: Thu, 24 Oct 2013 10:42:03 -0000 To: commits@jackrabbit.apache.org From: mduerig@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20131024104204.C5E372388AAA@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org 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=1535337&r1=1535336&r2=1535337&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/dos_and_donts.html (original) +++ jackrabbit/site/live/oak/docs/dos_and_donts.html Thu Oct 24 10:42:02 2013 @@ -1,382 +1,382 @@ - - - - - - - - - Jackrabbit Oak - - - - - - - - - - - - - - - - - - - Fork me on GitHub - - - - - - - - - -
- - - - - -
-
- -
- - -
- -

TODO Document patterns and anti patterns:

- -
    - -
  • Observation
  • - -
  • Session live time, explicit refresh
  • - -
  • Use admin session
  • - -
  • -
-
-

Session refresh behavior

-

Oak is based on the MVCC model where each session starts with a snapshot view of the repository. Concurrent changes from other sessions are not visible to a session until it gets refreshed. A session can be refreshed either explicitly by calling the refresh() method or implicitly by direct-to-workspace methods or by the auto-refresh mode. Also observation event delivery causes a session to be refreshed.

-

By default the auto-refresh mode automatically refreshes all sessions that have been idle for more than one second, and it’s also possible to explicitly set the auto-refresh parameters. A typical approach would be for long-lived admin sessions to set the auto-refresh mode to keep the session always up to date with latest changes from the repository.

-
-

Pattern: One session for one request/operation

-

One of the key patterns targeted by Oak is a web application that serves HTTP requests. The recommended way to handle such cases is to use a separate session for each HTTP request, and never to refresh that session.

-
-
-
- -
- - - + + + + + + + + + Jackrabbit Oak - + + + + + + + + + + + + + + + + + + Fork me on GitHub + + + + + + + + + +
+ + + + + +
+
+ +
+ + +
+ +

TODO Document patterns and anti patterns:

+ +
    + +
  • Observation
  • + +
  • Session live time, explicit refresh
  • + +
  • Use admin session
  • + +
  • +
+
+

Session refresh behavior

+

Oak is based on the MVCC model where each session starts with a snapshot view of the repository. Concurrent changes from other sessions are not visible to a session until it gets refreshed. A session can be refreshed either explicitly by calling the refresh() method or implicitly by direct-to-workspace methods or by the auto-refresh mode. Also observation event delivery causes a session to be refreshed.

+

By default the auto-refresh mode automatically refreshes all sessions that have been idle for more than one second, and it’s also possible to explicitly set the auto-refresh parameters. A typical approach would be for long-lived admin sessions to set the auto-refresh mode to keep the session always up to date with latest changes from the repository.

+
+

Pattern: One session for one request/operation

+

One of the key patterns targeted by Oak is a web application that serves HTTP requests. The recommended way to handle such cases is to use a separate session for each HTTP request, and never to refresh that session.

+
+
+
+ +
+ + + \ No newline at end of file Modified: jackrabbit/site/live/oak/docs/downloads.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/downloads.html?rev=1535337&r1=1535336&r2=1535337&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/downloads.html (original) +++ jackrabbit/site/live/oak/docs/downloads.html Thu Oct 24 10:42:02 2013 @@ -1,366 +1,366 @@ - - - - - - - - - Jackrabbit Oak - - - - - - - - - - - - - - - - - - - Fork me on GitHub - - - - - - - - - -
- - - - - -
-
- -
- - -
- -

Downloads

-

The latest Oak sources are available for checkout from svn, or you can fork them on GitHub.

-

See also our monthly releases on the Jackrabbit download page for slightly more stable versions of the codebase.

-
-
-
- -
- - - + + + + + + + + + Jackrabbit Oak - + + + + + + + + + + + + + + + + + + Fork me on GitHub + + + + + + + + + +
+ + + + + +
+
+ +
+ + +
+ +

Downloads

+

The latest Oak sources are available for checkout from svn, or you can fork them on GitHub.

+

See also our monthly releases on the Jackrabbit download page for slightly more stable versions of the codebase.

+
+
+
+ +
+ + + \ No newline at end of file Modified: jackrabbit/site/live/oak/docs/from_here.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/from_here.html?rev=1535337&r1=1535336&r2=1535337&view=diff ============================================================================== --- jackrabbit/site/live/oak/docs/from_here.html (original) +++ jackrabbit/site/live/oak/docs/from_here.html Thu Oct 24 10:42:02 2013 @@ -1,364 +1,364 @@ - - - - - - - - - Jackrabbit Oak - - - - - - - - - - - - - - - - - - - Fork me on GitHub - - - - - - - - - -
- - - - - -
-
- -
- - -
- -

TODO

-
-
-
- -
- - - + + + + + + + + + Jackrabbit Oak - + + + + + + + + + + + + + + + + + + Fork me on GitHub + + + + + + + + + +
+ + + + + +
+
+ +
+ + +
+ +

TODO

+
+
+
+ +
+ + + \ No newline at end of file