From commits-return-22247-archive-asf-public=cust-asf.ponee.io@jackrabbit.apache.org Fri Dec 20 11:37:46 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 51A9E180660 for ; Fri, 20 Dec 2019 12:37:45 +0100 (CET) Received: (qmail 17850 invoked by uid 500); 20 Dec 2019 11:37:44 -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 17829 invoked by uid 99); 20 Dec 2019 11:37:44 -0000 Received: from Unknown (HELO svn01-us-east.apache.org) (13.90.137.153) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 20 Dec 2019 11:37:44 +0000 Received: from svn01-us-east.apache.org (svn01-us-east.apache.org [127.0.0.1]) by svn01-us-east.apache.org (ASF Mail Server at svn01-us-east.apache.org) with ESMTP id 5039617A012 for ; Fri, 20 Dec 2019 11:37:44 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1871853 [2/2] - in /jackrabbit/site/live/filevault: ./ wip/ Date: Fri, 20 Dec 2019 11:37:44 -0000 To: commits@jackrabbit.apache.org From: kwin@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20191220113744.5039617A012@svn01-us-east.apache.org> Added: jackrabbit/site/live/filevault/privileges.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/privileges.html?rev=1871853&view=auto ============================================================================== --- jackrabbit/site/live/filevault/privileges.html (added) +++ jackrabbit/site/live/filevault/privileges.html Fri Dec 20 11:37:43 2019 @@ -0,0 +1,211 @@ + + + + + + + + Jackrabbit Filevault – Privileges + + + + + + + +

+ + +

+ +

+ + +

+ +

Privileges

Packages can register custom JCR privileges during import by carrying a META-INF/vault/privileges.xml file.

+ +

<!DOCTYPE privileges [
+<!ELEMENT privileges (privilege)+>
+<!ELEMENT privilege (contains)+>
+<!ATTLIST privilege abstract (true|false) false>
+<!ATTLIST privilege name NMTOKEN #REQUIRED>
+<!ELEMENT contains EMPTY>
+<!ATTLIST contains name NMTOKEN #REQUIRED>
+]>
+

+ +

Aggregate privileges can be registered with the additional element contains which should reference an existing privilege name.

+ + + \ No newline at end of file Modified: jackrabbit/site/live/filevault/project-info.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/project-info.html?rev=1871853&r1=1871852&r2=1871853&view=diff ============================================================================== --- jackrabbit/site/live/filevault/project-info.html (original) +++ jackrabbit/site/live/filevault/project-info.html Fri Dec 20 11:37:43 2019 @@ -1,6 +1,6 @@ @@ -48,9 +48,17 @@ @@ -100,7 +108,7 @@

@@ -119,9 +127,18 @@

Metadata +

Modified: jackrabbit/site/live/filevault/properties.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/properties.html?rev=1871853&r1=1871852&r2=1871853&view=diff ============================================================================== --- jackrabbit/site/live/filevault/properties.html (original) +++ jackrabbit/site/live/filevault/properties.html Fri Dec 20 11:37:43 2019 @@ -1,6 +1,6 @@ @@ -48,9 +48,17 @@ @@ -100,7 +108,7 @@

@@ -119,9 +127,18 @@

Metadata +

@@ -162,7 +179,7 @@

Content Package Properties

One of the most important meta files of a content package is the properties.xml which is present in the META-INF/vault directory. It defines defines several meta data around the content package itself which are just used for informational purpose (like lastModifiedBy) and other properties which actually influence how the package is installed (like subPackageHandling). In addition to that there is the MANIFEST.MF within META-INF which contains only informational metadata.

properties.xml

The properties.xml follows the format of a Java properties file in XML format as defined by java.util.Properties. The individual keys are defined within [PackageProperties][api.PackageProperties].

The properties.xml follows the format of a Java properties file in XML format as defined by java.util.Properties. The individual keys are defined within PackageProperties.

Example:

@@ -223,7 +240,7 @@ empty lastModified - A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been last modified (see also [ISO8601][api.ISO8601]) + A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been last modified (see also ISO8601) no empty @@ -238,72 +255,70 @@ empty dependencies - Comma-separated list of dependencies. Each dependency has the format <group>:<name>:<version or versionrange>. See [Dependencies][api.Dependency]. + Comma-separated list of dependencies. Each dependency has the format <group>:<name>:<version or versionrange>. See Dependencies. no empty dependencies-locations - Optional comma-separated list of dependencies’ locations. Each item has the format <package-id>=<uri>. Currently FileVault Package Maven Plugin is using a URI scheme for Maven coordinates like - -maven:<groupId>:<artifactId>:<version>[[:<classifier>]:packaging]. + Optional comma-separated list of dependencies’ locations. Each item has the format <package-id>=<uri>. Currently FileVault Package Maven Plugin is using a URI scheme for Maven coordinates like maven:<groupId>:<artifactId>:<version>[[:<classifier>]:packaging]. no empty - + created - A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been created initially (see also [ISO8601][api.ISO8601]) + A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been created initially (see also ISO8601) no empty - + createdBy A user name indicating who initially created this package no empty - + lastWrapped - A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been last wrapped (i.e. rebuilt) (see also [ISO8601][api.ISO8601]) + A date string in the format ±YYYY-MM-DDThh:mm:ss.SSSTZD specifying when the package has been last wrapped (i.e. rebuilt) (see also ISO8601) no empty - + lastWrappedBy A user name indicating who last modified this package no empty - + acHandling - See [AccessControlHandling][api.AccessControlHandling]. + See AccessControlHandling. no ignore - + cndPattern A Java regular expression pattern which specifies where to look for CND files within the given package no ^/(apps|libs)/([^/]+/){1,2}nodetypes/.+\\.cnd$ - + requiresRoot If set to true indicates that only admin sessions can install this package no false - + requiresRestart If set to true indicates that the system should be restarted after this package has been installed no false - + noIntermediateSaves If set to true indicates no intermediate saves should be performed while installing this package no false - + subPackageHandling - see [SubPackageHandling][api.SubPackageHandling] + see SubPackageHandling no *;install - + useBinaryReferences If set to true indicates that binary references should be used instead of the actual binary no false - + packageType Possible values:

mixed: Catch all type for a combination of the above.

Compare with JCRVLT-170 no ? - + installhook.* The FQN of the class which acts as an InstallHook (code being executed while this package is being installed) no n/a - + packageFormatVersion The version of this package as integer value. Versions newer than 2 are not yet supported during installation. no 2 - + allowIndexDefinitions If set to true indicates that the package contains an Oak Index Definition. Otherwise the package is not supposed to contain an index definition. This may be important to know prior to installation as installing/updating an index definition might have a severe performance impact especially on large repositories no false - + groupId The Maven groupId of the underlying Maven module from which this package was built. Only set if built via the FileVault Package Maven Plugin no n/a - + artifactId The Maven artifactId of the underlying Maven module from which this package was built. Only set if built via the FileVault Package Maven Plugin no @@ -341,7 +356,7 @@

Manifest File

Since version 3.1.40 (JCRVLT-32) properties are now also partly stored within the MANIFEST.MF of the ZIP content package. Currently those are not evaluated during installation, though. All attributes which are currently being generated are listed in [AbstractExporter][api.AbstractExporter].

@@ -364,7 +379,7 @@ - + @@ -372,14 +387,7 @@ -

Same as packageType within the properties.xml
Content-Package-Id	The string format of the [PackageId][api.PackageId]
The string format of the PackageId
Content-Package-Roots	All filter roots coming from the filter.xml in a string. The individual roots are concatenated by ,
Import-Package	Taken over from the OSGi specification. Contains a list of all Java packages being used by scripts/classes contained in this content package. Currently only being generated by the filevault-package-maven-plugin but not through the exporter API.

-[api.PackageProperties]: apidocs/org/apache/jackrabbit/vault/packaging/PackageProperties.html -[api.AccessControlHandling]: apidocs/org/apache/jackrabbit/vault/fs/io/AccessControlHandling -[api.SubPackageHandling]: apidocs/org/apache/jackrabbit/vault/packaging/SubPackageHandling.html -[api.ISO8601]: https://jackrabbit.apache.org/api/2.12/org/apache/jackrabbit/util/ISO8601.html -[api.Dependency]: apidocs/org/apache/jackrabbit/vault/packaging/Dependency.html -[api.AbstractExporter]: apidocs/org/apache/jackrabbit/vault/fs/io/AbstractExporter.html -[api.PackageId]: apidocs/org/apache/jackrabbit/vault/packaging/PackageId.html

Modified: jackrabbit/site/live/filevault/rcp.html URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/rcp.html?rev=1871853&r1=1871852&r2=1871853&view=diff ============================================================================== --- jackrabbit/site/live/filevault/rcp.html (original) +++ jackrabbit/site/live/filevault/rcp.html Fri Dec 20 11:37:43 2019 @@ -1,6 +1,6 @@ @@ -48,9 +48,17 @@ @@ -100,7 +108,7 @@

Privileges

Content Package Properties

properties.xml

Manifest File

Settings