Return-Path: X-Original-To: apmail-jackrabbit-oak-commits-archive@minotaur.apache.org Delivered-To: apmail-jackrabbit-oak-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9248411D92 for ; Wed, 14 May 2014 04:37:53 +0000 (UTC) Received: (qmail 59130 invoked by uid 500); 10 May 2014 22:53:44 -0000 Delivered-To: apmail-jackrabbit-oak-commits-archive@jackrabbit.apache.org Received: (qmail 45200 invoked by uid 500); 10 May 2014 22:52:43 -0000 Mailing-List: contact oak-commits-help@jackrabbit.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: oak-dev@jackrabbit.apache.org Delivered-To: mailing list oak-commits@jackrabbit.apache.org Received: (qmail 34937 invoked by uid 99); 10 May 2014 22:51:59 -0000 Received: from Unknown (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 10 May 2014 22:51:59 +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, 08 May 2014 16:36:29 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 232482388868; Thu, 8 May 2014 16:36:06 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1593325 - in /jackrabbit/oak/branches/1.0: ./ oak-doc/ oak-doc/src/site/markdown/security/overview.md oak-doc/src/site/markdown/security/user/membership.md Date: Thu, 08 May 2014 16:36:06 -0000 To: oak-commits@jackrabbit.apache.org From: mduerig@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140508163606.232482388868@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mduerig Date: Thu May 8 16:36:05 2014 New Revision: 1593325 URL: http://svn.apache.org/r1593325 Log: OAK-301: oak docu Merged r1593317 Modified: jackrabbit/oak/branches/1.0/ (props changed) jackrabbit/oak/branches/1.0/oak-doc/ (props changed) jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/overview.md jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/user/membership.md Propchange: jackrabbit/oak/branches/1.0/ ------------------------------------------------------------------------------ Merged /jackrabbit/oak/trunk:r1593317 Propchange: jackrabbit/oak/branches/1.0/oak-doc/ ------------------------------------------------------------------------------ Merged /jackrabbit/oak/trunk/oak-doc:r1593317 Modified: jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/overview.md URL: http://svn.apache.org/viewvc/jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/overview.md?rev=1593325&r1=1593324&r2=1593325&view=diff ============================================================================== --- jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/overview.md (original) +++ jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/overview.md Thu May 8 16:36:05 2014 @@ -55,5 +55,6 @@ The Oak Security Layer * [Overview](user.html) * [Differences wrt Jackrabbit 2.x](user/differences.html) + * [Group Membership](user/membership.html) * [Authorizable Actions](user/authorizableaction.html) * [Searching Users and Groups](user/query.html) Modified: jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/user/membership.md URL: http://svn.apache.org/viewvc/jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/user/membership.md?rev=1593325&r1=1593324&r2=1593325&view=diff ============================================================================== --- jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/user/membership.md (original) +++ jackrabbit/oak/branches/1.0/oak-doc/src/site/markdown/security/user/membership.md Thu May 8 16:36:05 2014 @@ -18,6 +18,14 @@ Group Membership -------------------------------------------------------------------------------- +### Jackrabbit API + +_todo_ + +### Characteristics of the Default Implementation + +#### Member Representation in the Repository + ##### Behavior in Jackrabbit 2.x With the default configuration Jackrabbit 2.x stores the group members as _weak references_ in a `rep:members` multi value property in the group node. @@ -93,9 +101,11 @@ will limit the size of the multi value p } } -*Note*: The exact threshold value that determines the storage strategy is an implementation detail and might even vary depending on the underlying persistence layer. +*Note*: The exact threshold value that determines the storage strategy is an +implementation detail and might even vary depending on the underlying persistence layer. +In Oak 1.0 the threshold value is set to 100. -##### Upgrading Groups from Jackrabbit 2.x to OAK content structure +#### Upgrading Groups from Jackrabbit 2.x to OAK content structure Upon upgrade from a Jackrabbit 2.x repository to OAK the group member lists that adjusted to reflect the new content structure as created by the OAK user management @@ -104,10 +114,12 @@ by the migration process. Applications t details of Jackrabbit 2.x user management instead of use the corresponding API calls will need to be modified accordingly. -##### Importing Group Members +#### XML Import of Group Members + Importing group members through the import methods in `javax.jcr.Session` or `javax.jcr.Workspace` is storage agnostic and supports both, property based and node based, strategies and is backward compatible to content exported from Jackrabbit 2.x. The group member lists that are modified during an import are internally processed using the normal user manager APIs. This implies that the -node structure after the import might not be the same as the one represented in the input. \ No newline at end of file +node structure after the import might not be the same as the one represented in +the input. \ No newline at end of file