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