You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by kw...@apache.org on 2020/03/25 16:58:14 UTC
svn commit: r1875661 [29/31] - in /jackrabbit/site/live/filevault: ./
apidocs/ apidocs/org/apache/jackrabbit/vault/cli/
apidocs/org/apache/jackrabbit/vault/cli/class-use/
apidocs/org/apache/jackrabbit/vault/fs/
apidocs/org/apache/jackrabbit/vault/fs/ap...
Modified: jackrabbit/site/live/filevault/apidocs/overview-tree.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/apidocs/overview-tree.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/apidocs/overview-tree.html (original)
+++ jackrabbit/site/live/filevault/apidocs/overview-tree.html Wed Mar 25 16:58:03 2020
@@ -2,10 +2,10 @@
<!-- NewPage -->
<html lang="en">
<head>
-<!-- Generated by javadoc (1.8.0_222) on Wed Jan 15 16:49:11 CET 2020 -->
+<!-- Generated by javadoc (1.8.0_222) on Wed Mar 25 17:54:43 CET 2020 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Class Hierarchy (Apache Jackrabbit FileVault 3.4.2 API)</title>
-<meta name="date" content="2020-01-15">
+<title>Class Hierarchy (Apache Jackrabbit FileVault 3.4.4 API)</title>
+<meta name="date" content="2020-03-25">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
@@ -13,7 +13,7 @@
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
- parent.document.title="Class Hierarchy (Apache Jackrabbit FileVault 3.4.2 API)";
+ parent.document.title="Class Hierarchy (Apache Jackrabbit FileVault 3.4.4 API)";
}
}
catch(err) {
@@ -101,6 +101,7 @@
<li><a href="org/apache/jackrabbit/vault/util/xml/serialize/package-tree.html">org.apache.jackrabbit.vault.util.xml.serialize</a>, </li>
<li><a href="org/apache/jackrabbit/vault/validation/package-tree.html">org.apache.jackrabbit.vault.validation</a>, </li>
<li><a href="org/apache/jackrabbit/vault/validation/spi/package-tree.html">org.apache.jackrabbit.vault.validation.spi</a>, </li>
+<li><a href="org/apache/jackrabbit/vault/validation/spi/util/package-tree.html">org.apache.jackrabbit.vault.validation.spi.util</a>, </li>
<li><a href="org/apache/jackrabbit/vault/vlt/package-tree.html">org.apache.jackrabbit.vault.vlt</a>, </li>
<li><a href="org/apache/jackrabbit/vault/vlt/meta/package-tree.html">org.apache.jackrabbit.vault.vlt.meta</a></li>
</ul>
@@ -117,7 +118,7 @@
<li type="circle">org.apache.jackrabbit.vault.cli.<a href="org/apache/jackrabbit/vault/cli/VaultFsApp.html" title="class in org.apache.jackrabbit.vault.cli"><span class="typeNameLink">VaultFsApp</span></a></li>
</ul>
</li>
-<li type="circle">org.apache.jackrabbit.vault.fs.<a href="org/apache/jackrabbit/vault/fs/AbstractArtifact.html" title="class in org.apache.jackrabbit.vault.fs"><span class="typeNameLink">AbstractArtifact</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/Artifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">Artifact</a>)
+<li type="circle">org.apache.jackrabbit.vault.fs.impl.<a href="org/apache/jackrabbit/vault/fs/impl/AbstractArtifact.html" title="class in org.apache.jackrabbit.vault.fs.impl"><span class="typeNameLink">AbstractArtifact</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/Artifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">Artifact</a>)
<ul>
<li type="circle">org.apache.jackrabbit.vault.fs.<a href="org/apache/jackrabbit/vault/fs/DirectoryArtifact.html" title="class in org.apache.jackrabbit.vault.fs"><span class="typeNameLink">DirectoryArtifact</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/ExportArtifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">ExportArtifact</a>, org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/ImportArtifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">ImportArtifact</a>)</li>
<li type="circle">org.apache.jackrabbit.vault.fs.<a href="org/apache/jackrabbit/vault/fs/HintArtifact.html" title="class in org.apache.jackrabbit.vault.fs"><span class="typeNameLink">HintArtifact</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/ExportArtifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">ExportArtifact</a>, org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/ImportArtifact.html" title="interface in org.apache.jackrabbit.vault.fs.api">ImportArtifact</a>)</li>
@@ -372,6 +373,7 @@
<li type="circle">org.apache.jackrabbit.vault.packaging.impl.<a href="org/apache/jackrabbit/vault/packaging/impl/InstallContextImpl.html" title="class in org.apache.jackrabbit.vault.packaging.impl"><span class="typeNameLink">InstallContextImpl</span></a> (implements org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/InstallContext.html" title="interface in org.apache.jackrabbit.vault.packaging">InstallContext</a>)</li>
<li type="circle">org.apache.jackrabbit.vault.packaging.impl.<a href="org/apache/jackrabbit/vault/packaging/impl/InstallHookProcessorImpl.html" title="class in org.apache.jackrabbit.vault.packaging.impl"><span class="typeNameLink">InstallHookProcessorImpl</span></a> (implements org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/InstallHookProcessor.html" title="interface in org.apache.jackrabbit.vault.packaging">InstallHookProcessor</a>)</li>
<li type="circle">org.apache.jackrabbit.vault.util.<a href="org/apache/jackrabbit/vault/util/ItemNameComparator.html" title="class in org.apache.jackrabbit.vault.util"><span class="typeNameLink">ItemNameComparator</span></a> (implements java.util.<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a><T>)</li>
+<li type="circle">org.apache.jackrabbit.vault.util.<a href="org/apache/jackrabbit/vault/util/ItemNameComparator2.html" title="class in org.apache.jackrabbit.vault.util"><span class="typeNameLink">ItemNameComparator2</span></a> (implements java.util.<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a><T>)</li>
<li type="circle">org.apache.jackrabbit.vault.fs.io.<a href="org/apache/jackrabbit/vault/fs/io/JcrArchive.html" title="class in org.apache.jackrabbit.vault.fs.io"><span class="typeNameLink">JcrArchive</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.packaging.impl.<a href="org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.html" title="class in org.apache.jackrabbit.vault.packaging.impl"><span class="typeNameLink">JcrPackageDefinitionImpl</span></a> (implements org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/JcrPackageDefinition.html" title="interface in org.apache.jackrabbit.vault.packaging">JcrPackageDefinition</a>)</li>
<li type="circle">org.apache.jackrabbit.vault.packaging.impl.<a href="org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.State.html" title="class in org.apache.jackrabbit.vault.packaging.impl"><span class="typeNameLink">JcrPackageDefinitionImpl.State</span></a></li>
@@ -389,6 +391,8 @@
<li type="circle">org.apache.jackrabbit.vault.util.<a href="org/apache/jackrabbit/vault/util/MimeTypes.html" title="class in org.apache.jackrabbit.vault.util"><span class="typeNameLink">MimeTypes</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.<a href="org/apache/jackrabbit/vault/fs/Mounter.html" title="class in org.apache.jackrabbit.vault.fs"><span class="typeNameLink">Mounter</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/MultiPathMapping.html" title="class in org.apache.jackrabbit.vault.fs.api"><span class="typeNameLink">MultiPathMapping</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/PathMapping.html" title="interface in org.apache.jackrabbit.vault.fs.api">PathMapping</a>)</li>
+<li type="circle">org.apache.jackrabbit.vault.validation.spi.util.<a href="org/apache/jackrabbit/vault/validation/spi/util/NameUtil.html" title="class in org.apache.jackrabbit.vault.validation.spi.util"><span class="typeNameLink">NameUtil</span></a></li>
+<li type="circle">org.apache.jackrabbit.vault.validation.spi.util.<a href="org/apache/jackrabbit/vault/validation/spi/util/NodeContextImpl.html" title="class in org.apache.jackrabbit.vault.validation.spi.util"><span class="typeNameLink">NodeContextImpl</span></a> (implements org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/NodeContext.html" title="interface in org.apache.jackrabbit.vault.validation.spi">NodeContext</a>)</li>
<li type="circle">org.apache.jackrabbit.vault.util.<a href="org/apache/jackrabbit/vault/util/NodeNameComparator.html" title="class in org.apache.jackrabbit.vault.util"><span class="typeNameLink">NodeNameComparator</span></a> (implements java.util.<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a><T>)</li>
<li type="circle">org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/NodeNameList.html" title="class in org.apache.jackrabbit.vault.fs.api"><span class="typeNameLink">NodeNameList</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.filter.<a href="org/apache/jackrabbit/vault/fs/filter/NtFileItemFilter.html" title="class in org.apache.jackrabbit.vault.fs.filter"><span class="typeNameLink">NtFileItemFilter</span></a> (implements org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/ItemFilter.html" title="interface in org.apache.jackrabbit.vault.fs.api">ItemFilter</a>)</li>
@@ -621,6 +625,7 @@
<li type="circle">org.apache.jackrabbit.vault.vlt.meta.<a href="org/apache/jackrabbit/vault/vlt/meta/MetaDirectory.html" title="interface in org.apache.jackrabbit.vault.vlt.meta"><span class="typeNameLink">MetaDirectory</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.vlt.meta.<a href="org/apache/jackrabbit/vault/vlt/meta/MetaFile.html" title="interface in org.apache.jackrabbit.vault.vlt.meta"><span class="typeNameLink">MetaFile</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.config.<a href="org/apache/jackrabbit/vault/fs/config/MetaInf.html" title="interface in org.apache.jackrabbit.vault.fs.config"><span class="typeNameLink">MetaInf</span></a></li>
+<li type="circle">org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/NodeContext.html" title="interface in org.apache.jackrabbit.vault.validation.spi"><span class="typeNameLink">NodeContext</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.spi.<a href="org/apache/jackrabbit/vault/fs/spi/NodeTypeInstaller.html" title="interface in org.apache.jackrabbit.vault.fs.spi"><span class="typeNameLink">NodeTypeInstaller</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.api.<a href="org/apache/jackrabbit/vault/fs/api/NodeTypesCollector.html" title="interface in org.apache.jackrabbit.vault.fs.api"><span class="typeNameLink">NodeTypesCollector</span></a>
<ul>
@@ -635,11 +640,7 @@
<li type="circle">org.apache.jackrabbit.vault.packaging.events.<a href="org/apache/jackrabbit/vault/packaging/events/PackageEvent.html" title="interface in org.apache.jackrabbit.vault.packaging.events"><span class="typeNameLink">PackageEvent</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.packaging.events.impl.<a href="org/apache/jackrabbit/vault/packaging/events/impl/PackageEventDispatcher.html" title="interface in org.apache.jackrabbit.vault.packaging.events.impl"><span class="typeNameLink">PackageEventDispatcher</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.packaging.events.<a href="org/apache/jackrabbit/vault/packaging/events/PackageEventListener.html" title="interface in org.apache.jackrabbit.vault.packaging.events"><span class="typeNameLink">PackageEventListener</span></a></li>
-<li type="circle">org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/PackageInfo.html" title="interface in org.apache.jackrabbit.vault.packaging"><span class="typeNameLink">PackageInfo</span></a>
-<ul>
-<li type="circle">org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/ValidationContext.html" title="interface in org.apache.jackrabbit.vault.validation.spi"><span class="typeNameLink">ValidationContext</span></a></li>
-</ul>
-</li>
+<li type="circle">org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/PackageInfo.html" title="interface in org.apache.jackrabbit.vault.packaging"><span class="typeNameLink">PackageInfo</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/PackageManager.html" title="interface in org.apache.jackrabbit.vault.packaging"><span class="typeNameLink">PackageManager</span></a>
<ul>
<li type="circle">org.apache.jackrabbit.vault.packaging.<a href="org/apache/jackrabbit/vault/packaging/JcrPackageManager.html" title="interface in org.apache.jackrabbit.vault.packaging"><span class="typeNameLink">JcrPackageManager</span></a></li>
@@ -667,6 +668,7 @@
<li type="circle">org.apache.jackrabbit.vault.fs.io.<a href="org/apache/jackrabbit/vault/fs/io/Serializer.html" title="interface in org.apache.jackrabbit.vault.fs.io"><span class="typeNameLink">Serializer</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.spi.<a href="org/apache/jackrabbit/vault/fs/spi/ServiceProvider.html" title="interface in org.apache.jackrabbit.vault.fs.spi"><span class="typeNameLink">ServiceProvider</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.fs.spi.<a href="org/apache/jackrabbit/vault/fs/spi/UserManagement.html" title="interface in org.apache.jackrabbit.vault.fs.spi"><span class="typeNameLink">UserManagement</span></a></li>
+<li type="circle">org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/ValidationContext.html" title="interface in org.apache.jackrabbit.vault.validation.spi"><span class="typeNameLink">ValidationContext</span></a></li>
<li type="circle">org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/Validator.html" title="interface in org.apache.jackrabbit.vault.validation.spi"><span class="typeNameLink">Validator</span></a>
<ul>
<li type="circle">org.apache.jackrabbit.vault.validation.spi.<a href="org/apache/jackrabbit/vault/validation/spi/DocumentViewXmlValidator.html" title="interface in org.apache.jackrabbit.vault.validation.spi"><span class="typeNameLink">DocumentViewXmlValidator</span></a></li>
Modified: jackrabbit/site/live/filevault/apidocs/package-list
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/apidocs/package-list?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/apidocs/package-list (original)
+++ jackrabbit/site/live/filevault/apidocs/package-list Wed Mar 25 16:58:03 2020
@@ -25,5 +25,6 @@ org.apache.jackrabbit.vault.util.diff
org.apache.jackrabbit.vault.util.xml.serialize
org.apache.jackrabbit.vault.validation
org.apache.jackrabbit.vault.validation.spi
+org.apache.jackrabbit.vault.validation.spi.util
org.apache.jackrabbit.vault.vlt
org.apache.jackrabbit.vault.vlt.meta
Modified: jackrabbit/site/live/filevault/apidocs/serialized-form.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/apidocs/serialized-form.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/apidocs/serialized-form.html (original)
+++ jackrabbit/site/live/filevault/apidocs/serialized-form.html Wed Mar 25 16:58:03 2020
@@ -2,10 +2,10 @@
<!-- NewPage -->
<html lang="en">
<head>
-<!-- Generated by javadoc (1.8.0_222) on Wed Jan 15 16:49:10 CET 2020 -->
+<!-- Generated by javadoc (1.8.0_222) on Wed Mar 25 17:54:42 CET 2020 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Serialized Form (Apache Jackrabbit FileVault 3.4.2 API)</title>
-<meta name="date" content="2020-01-15">
+<title>Serialized Form (Apache Jackrabbit FileVault 3.4.4 API)</title>
+<meta name="date" content="2020-03-25">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
@@ -13,7 +13,7 @@
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
- parent.document.title="Serialized Form (Apache Jackrabbit FileVault 3.4.2 API)";
+ parent.document.title="Serialized Form (Apache Jackrabbit FileVault 3.4.4 API)";
}
}
catch(err) {
Modified: jackrabbit/site/live/filevault/ci-management.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/ci-management.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/ci-management.html (original)
+++ jackrabbit/site/live/filevault/ci-management.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:ci-management at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:ci-management at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – CI Management</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -155,7 +156,8 @@
<li><a href="distribution-management.html" title="Distribution Management"><span class="none"></span>Distribution Management</a></li>
</ul></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
Modified: jackrabbit/site/live/filevault/config.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/config.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/config.html (original)
+++ jackrabbit/site/live/filevault/config.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from src/site/markdown/config.md at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/config.md at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – Config</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -146,7 +147,8 @@
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
@@ -177,13 +179,12 @@
limitations under the License.
-->
<h1>Config</h1>
-<p>The FileVault Filesystem Configuration can be adjusted with a META-INF/vault/config.xml file.</p>
+<p>The FileVault Filesystem Configuration can be adjusted with a <code>META-INF/vault/config.xml</code> file.</p>
<p>It allows to tweak aggregation settings of the <a href="vaultfs.html">Vault FS</a>. The default config is at <a class="externalLink" href="https://github.com/apache/jackrabbit-filevault/blob/trunk/vault-core/src/main/resources/org/apache/jackrabbit/vault/fs/config/defaultConfig-1.1.xml">https://github.com/apache/jackrabbit-filevault/blob/trunk/vault-core/src/main/resources/org/apache/jackrabbit/vault/fs/config/defaultConfig-1.1.xml</a>.</p>
<p>To exclude binaries from exports/imports you can use the setting</p>
-<div>
-<div>
-<pre class="source"> <properties>
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"> <properties>
<!-- configure binary-less serialization -->
<useBinaryReferences>true</useBinaryReferences>
</properties>
Modified: jackrabbit/site/live/filevault/distribution-management.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/distribution-management.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/distribution-management.html (original)
+++ jackrabbit/site/live/filevault/distribution-management.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:distribution-management at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:distribution-management at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – Project Distribution Management</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -155,7 +156,8 @@
<li class="active"><a href="#"><span class="none"></span>Distribution Management</a></li>
</ul></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
Modified: jackrabbit/site/live/filevault/docview.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/docview.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/docview.html (original)
+++ jackrabbit/site/live/filevault/docview.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from src/site/markdown/docview.md at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/docview.md at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – FileVault DocView</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -146,7 +147,8 @@
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
@@ -177,31 +179,30 @@
limitations under the License.
-->
<h1>FileVault DocView</h1>
-<p>FileVault uses a slightly different version of the Document View specified by <a class="externalLink" href="https://docs.adobe.com/content/docs/en/spec/jcr/2.0/7_Export.html#7.3%20Document%20View">JCR 2.0</a>. In general all nodes can cannot be serialized as plain directories or as plain files are either serialized into DocView XML file. If the node can only be partially mapped to a directory or file, it will be accompanied with a .content.xml containing the residual content.</p>
-<p>For example, a <i>full coverage</i> content tree, starting at the node example will be serialized into a example.xml file, using the (filevault) DocView format.</p>
-<p>For example, a <i>sling:Folder</i> node, named libs will be serialized into a directory libs and a libs/.content.xml file, using the (filevault) DocView format.</p>
+<p>FileVault uses a slightly different version of the Document View specified by <a class="externalLink" href="https://docs.adobe.com/content/docs/en/spec/jcr/2.0/7_Export.html#7.3%20Document%20View">JCR 2.0</a>. In general all nodes can cannot be serialized as plain directories or as plain files are either serialized into DocView XML file. If the node can only be partially mapped to a directory or file, it will be accompanied with a <code>.content.xml</code> containing the residual content.</p>
+<p>For example, a <i>full coverage</i> content tree, starting at the node <code>example</code> will be serialized into a <code>example.xml</code> file, using the (filevault) DocView format.</p>
+<p>For example, a <i>sling:Folder</i> node, named <code>libs</code> will be serialized into a directory <code>libs</code> and a <code>libs/.content.xml</code> file, using the (filevault) DocView format.</p>
<p>Also see the <a href="vaultfs.html">vault-fs</a> article about this.</p><section>
<h2><a name="Deviations_to_the_JCR_DocView"></a>Deviations to the JCR DocView</h2><section>
<h3><a name="Root_Element"></a>Root Element</h3>
-<p>The root element of the filevault DocView is always jcr:root no matter of the node name it serializes. Because the the node name is implicitly given by either the filename or the directory name, it would be redundant to repeat the node name in the document.</p>
+<p>The root element of the filevault DocView is always <code>jcr:root</code> no matter of the node name it serializes. Because the the node name is implicitly given by either the filename or the directory name, it would be redundant to repeat the node name in the document.</p>
<p>Example:</p>
-<div>
-<div>
-<pre class="source"><?xml version="1.0" encoding="UTF-8"?>
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
jcr:primaryType="sling:Folder"
title="Libraries"/>
</pre></div></div>
-</section><section>
+
+<p>As by that the filename implicitly sets the root element name, its namespace is also supposed to be declared in the XML in case it is using a prefix. This is similar to all other elements in the XML.</p></section><section>
<h3><a name="Empty_Elements"></a>Empty Elements</h3>
<p>The deserialization treats empty elements different as the default <a class="externalLink" href="https://docs.adobe.com/content/docs/en/spec/jcr/2.0/11_Import.html#11.1%20Importing%20Document%20View">JCR 2.0 Import</a>, as empty elements never create a new node in the repository but are merely used to define the childnode sort order. Nodes/properties below empty elements will never be removed during import (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-251">JCRVLT-251</a>)</p></section><section>
<h3><a name="Property_Values"></a>Property Values</h3>
<p>The probably biggest different to the <a class="externalLink" href="https://docs.adobe.com/content/docs/en/spec/jcr/2.0/7_Export.html#7.3%20Document%20View">JCR 2.0</a> is the handling of the property values. All properties are serialized as XML attributes as in JCR, but their values have the property type encoded. The format of the attribute value is:</p>
-<div>
-<div>
-<pre class="source">property-value := [ "{" property-type "}" ] ( value | "[" [ value { "," value } ] "]"
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">property-value := [ "{" property-type "}" ] ( value | "[" [ value { "," value } ] "]"
</pre></div></div>
<p>If no type is specified, it defaults to <a class="externalLink" href="https://docs.adobe.com/docs/en/spec/jsr170/javadocs/jcr-2.0/javax/jcr/PropertyType.html#STRING">STRING</a>.</p>
@@ -245,28 +246,28 @@
</thead><tbody>
<tr class="b">
-<td> \ </td>
-<td> \\ </td>
+<td> <code>\</code> </td>
+<td> <code>\\</code> </td>
<td> </td></tr>
<tr class="a">
-<td> , </td>
-<td> \, </td>
+<td> <code>,</code> </td>
+<td> <code>\,</code> </td>
<td> Only for multi value properties </td></tr>
<tr class="b">
-<td> [ </td>
-<td> \[ </td>
+<td> <code>[</code> </td>
+<td> <code>\[</code> </td>
<td> Only at the start of single value properties </td></tr>
<tr class="a">
-<td> { </td>
-<td> \{ </td>
+<td> <code>{</code> </td>
+<td> <code>\{</code> </td>
<td> Only at the start of single value properties </td></tr>
<tr class="b">
<td> invalid xml </td>
-<td> \uXXXX </td>
+<td> <code>\uXXXX</code> </td>
<td> </td></tr>
</tbody>
</table>
-<p>Please note, that this escaping only concerns the raw attribute value. If the value contains characters that cannot be used in XML attributes, like quotes ", they will further be escaped by the XML formatter.</p></section></section>
+<p>Please note, that this escaping only concerns the raw attribute value. If the value contains characters that cannot be used in XML attributes, like quotes <code>"</code>, they will further be escaped by the XML formatter.</p></section></section>
</main>
</div>
</div>
Modified: jackrabbit/site/live/filevault/filter.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/filter.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/filter.html (original)
+++ jackrabbit/site/live/filevault/filter.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from src/site/markdown/filter.md at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/filter.md at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – Workspace Filter</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -146,7 +147,8 @@
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
@@ -177,14 +179,13 @@
limitations under the License.
-->
<h1>Workspace Filter</h1>
-<p>One of the most important meta files of a vault checkout or a content package is the filter.xml which is present in the META-INF/vault directory. The filter.xml is used to load and initialize the <a href="apidocs/org/apache/jackrabbit/vault/fs/api/WorkspaceFilter.html">WorkspaceFilter</a>. The workspace filter defines what parts of the JCR repository are imported or exported during the respective operations through vlt or package management.</p><section>
+<p>One of the most important meta files of a vault checkout or a content package is the <code>filter.xml</code> which is present in the <code>META-INF/vault</code> directory. The <code>filter.xml</code> is used to load and initialize the <a href="apidocs/org/apache/jackrabbit/vault/fs/api/WorkspaceFilter.html">WorkspaceFilter</a>. The workspace filter defines what parts of the JCR repository are imported or exported during the respective operations through <code>vlt</code> or package management.</p><section>
<h2><a name="General_Structure"></a>General Structure</h2>
-<p>The filter.xml consists of a set of filter elements, each with a mandatory root attribute and an optional list of include and exclude child elements.</p>
+<p>The <code>filter.xml</code> consists of a set of <code>filter</code> elements, each with a mandatory <code>root</code> attribute and an optional list of <code>include</code> and <code>exclude</code> child elements.</p>
<p>Example:</p>
-<div>
-<div>
-<pre class="source"><workspaceFilter version="1.0">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><workspaceFilter version="1.0">
<filter root="/apps/project1" />
<filter root="/etc/project1">
<exclude pattern=".*\.gif" />
@@ -195,61 +196,57 @@
</pre></div></div>
<section>
<h3><a name="Filter_Elements"></a>Filter Elements</h3>
-<p>The filter elements are independent of each other and define include and exclude patters for subtrees. The root of a subtree is defined by the root attribute, which must be an absolute path. The filter element can have an optional mode attribute which specified the <a href="apidocs/org/apache/jackrabbit/vault/fs/api/ImportMode.html">import mode</a> used when importing content. the following values are possible:</p>
+<p>The filter elements are independent of each other and define include and exclude patters for subtrees. The root of a subtree is defined by the <code>root</code> attribute, which must be an absolute path. The filter element can have an optional <code>mode</code> attribute which specified the <a href="apidocs/org/apache/jackrabbit/vault/fs/api/ImportMode.html">import mode</a> used when importing content. the following values are possible:</p>
<ol style="list-style-type: decimal">
-<li>replace : This is the normal behavior. Existing content is replaced completely by the imported content, i.e. is overridden or deleted accordingly.</li>
-<li>merge : Existing content is not modified, i.e. only new content is added and none is deleted or modified.</li>
-<li>update : Existing content is updated, new content is added and none is deleted.</li>
+<li><code>replace</code> : This is the normal behavior. Existing content is replaced completely by the imported content, i.e. is overridden or deleted accordingly.</li>
+<li><code>merge</code> : Existing content is not modified, i.e. only new content is added and none is deleted or modified.</li>
+<li><code>update</code> : Existing content is updated, new content is added and none is deleted.</li>
</ol>
<p>For a more detailed description of the import mode, see <a href="importmode.html">here</a>.</p>
-<p>In addition it is possible to influence the auto-detection of the package type (if not explicitly specified in the properties.xml) with the attribute type. The only supported value as of now is cleanup which means that the filter rule is ignored for the auto-detection of the package type (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-220">JCRVLT-220</a>)</p></section><section>
+<p>In addition it is possible to influence the auto-detection of the package type (if not explicitly specified in the <code>properties.xml</code>) with the attribute <code>type</code>. The only supported value as of now is <code>cleanup</code> which means that the filter rule is ignored for the auto-detection of the package type (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-220">JCRVLT-220</a>)</p></section><section>
<h3><a name="Include_and_Exclude_Elements"></a>Include and Exclude Elements</h3>
-<p>The include and exclude elements can be added as optional children to the filter element to allow more fine grained filtering of the subtree during import and export. They have a mandatory pattern attribute which has the format of a <a class="externalLink" href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">regexp</a>. The regexp is matched against the full <i>path</i> of the respective or potential JCR node, so it either must start with / (absolute regex) or a wildcard (relative regex).</p><section>
+<p>The include and exclude elements can be added as optional children to the <code>filter</code> element to allow more fine grained filtering of the subtree during import and export. They have a mandatory <code>pattern</code> attribute which has the format of a <a class="externalLink" href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">regexp</a>. The regexp is matched against the full <i>path</i> of the respective or potential JCR node, so it either must start with <code>/</code> (absolute regex) or a wildcard (relative regex).</p><section>
<h4><a name="Order"></a>Order</h4>
<p>The order of the include and exclude elements is important. The paths are tested in a sequential order against all patterns and the type of the <b>last matching</b> element determines if the path is included or not. One caveat is, that the type of the first pattern defines the default behavior, so that the filter is more natural to write. If the first pattern is include, then the default is exclude and vice versa.</p>
-<p>The following example <i>only</i> includes the nodes in /tmp that end with .gif.</p>
+<p>The following example <i>only</i> includes the nodes in <code>/tmp</code> that end with <code>.gif</code>.</p>
-<div>
-<div>
-<pre class="source"><filter root="/tmp">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/tmp">
<include pattern=".*\.gif"/>
</filter>
</pre></div></div>
-<p>The following example includes <i>all</i> nodes in /tmp except those that end with .gif.</p>
+<p>The following example includes <i>all</i> nodes in <code>/tmp</code> except those that end with <code>.gif</code>.</p>
-<div>
-<div>
-<pre class="source"><filter root="/tmp">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/tmp">
<exclude pattern=".*\.gif"/>
</filter>
</pre></div></div>
</section><section>
<h4><a name="Property_Filtering"></a>Property Filtering</h4>
-<p>Since FileVault 3.1.28 (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-120">JCRVLT-120</a>) it is not only possible to filter on node level but also only include/exclude certain properties below a certain node by setting the attribute matchProperties on the exlude/include element to true.</p>
+<p>Since FileVault 3.1.28 (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-120">JCRVLT-120</a>) it is not only possible to filter on node level but also only include/exclude certain properties below a certain node by setting the attribute <code>matchProperties</code> on the <code>exlude</code>/<code>include</code> element to <code>true</code>.</p>
-<div>
-<div>
-<pre class="source"><filter root="/tmp">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/tmp">
<exclude pattern="/tmp/property1" matchProperties="true"/>
</filter>
</pre></div></div>
-<p>Then the pattern is matched against property paths instead of node paths. If the attribute matchProperties is not set all properties below the given node paths are included/excluded. Otherwise the excluded properties are not contained in the exported package and during import not touched in the repository.</p></section></section></section><section>
+<p>Then the <code>pattern</code> is matched against property paths instead of node paths. If the attribute <code>matchProperties</code> is not set all properties below the given node paths are included/excluded. Otherwise the excluded properties are not contained in the exported package and during import not touched in the repository.</p></section></section></section><section>
<h2><a name="Usage_for_Export"></a>Usage for Export</h2>
<p>When exporting content into the filesystem or a content package, the workspace filter defines which nodes are serialized. It is important to know, that only the nodes that match the filter are actually traversed, which can lead to unexpected results.</p>
<p>for example:</p>
-<div>
-<div>
-<pre class="source"><filter root="/tmp">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/tmp">
<include pattern="/tmp/a(/.*)?"/>
<include pattern="/tmp/b/c(/.*)?"/>
</filter>
</pre></div></div>
-<p>Will include the /tmp/a subtree, but not the /tmp/b/c subtree, since /tmp/b does not match the filter and is therefor not traversed.</p>
+<p>Will include the <code>/tmp/a</code> subtree, but not the <code>/tmp/b/c</code> subtree, since <code>/tmp/b</code> does not match the filter and is therefor not traversed.</p>
<p>There is one exception, if <b>all</b> the pattern are relative (i.e. don’t start with a slash), then the algorithm is:</p>
<ol style="list-style-type: decimal">
@@ -312,12 +309,19 @@
<td> not existing</td></tr>
</tbody>
</table><section>
+<h3><a name="Uncovered_ancestor_nodes"></a>Uncovered ancestor nodes</h3>
+<p>All <i>uncovered</i> ancestor nodes are either</p>
+<ol style="list-style-type: decimal">
+
+<li>created with the node type and properties given in the package (in case the node type <i>is</i> given with a <code>.content.xml</code> at the right location and the node does not yet exist in the repo)</li>
+<li>since version 3.4.4 (<a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT-417">JCRVLT-417</a>) created with the ancestor node type’s default child type or if that is not set or prior to version 3.4.4 created with node type <code>nt:folder</code> (in case the the node type is <i>not</i> given with a <code>.content.xml</code> at the right location and the node does not yet exist in the repo) or</li>
+<li>not touched at all (in case they are already existing in the repo, no matter which node type is given with a <code>.content.xml</code> at the according location)</li>
+</ol></section><section>
<h3><a name="Example"></a>Example</h3>
<p>Content Package Filter</p>
-<div>
-<div>
-<pre class="source"><filter root="/tmp">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/tmp">
<include pattern="/tmp/a(/.*)?"/>
<include pattern="/tmp/b(/.*)?/>
<exclude pattern="/tmp/b/property1" matchProperties="true"/>
@@ -327,9 +331,8 @@
<p>Content Package Serialized Content</p>
-<div>
-<div>
-<pre class="source">+ /jcr_root/
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">+ /jcr_root/
+ tmp/
+ a/
- property1="new"
@@ -340,9 +343,8 @@
<section>
<h4><a name="Repository_State_Before_Installation.2FImport"></a>Repository State Before Installation/Import</h4>
-<div>
-<div>
-<pre class="source">+ /tmp/
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">+ /tmp/
+ b/
- property1="old"
- property2="old"
@@ -352,9 +354,8 @@
</section><section>
<h4><a name="Repository_State_After_Installation.2FImport"></a>Repository State After Installation/Import</h4>
-<div>
-<div>
-<pre class="source">+ /tmp/
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">+ /tmp/
+ a/
- property1="new"
+ b/
Modified: jackrabbit/site/live/filevault/howto_release.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/howto_release.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/howto_release.html (original)
+++ jackrabbit/site/live/filevault/howto_release.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from src/site/markdown/howto_release.md at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/howto_release.md at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – How To Create A Release</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -146,7 +147,8 @@
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
@@ -191,7 +193,7 @@
</li>
<li>
-<p>Create or update a RELEASE-NOTES.txt file in the root folder of the project to be released. When done, commit the file. See previous release notes for examples of what to include. The release note report in <a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT">Jira</a> is a useful source of required information.</p>
+<p>Create or update a <code>RELEASE-NOTES.txt</code> file in the root folder of the project to be released. When done, commit the file. See previous release notes for examples of what to include. The release note report in <a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT">Jira</a> is a useful source of required information.</p>
</li>
<li>
@@ -199,24 +201,23 @@
<p>The release is built using the Maven release plugin. See the <a class="externalLink" href="http://maven.apache.org/developers/release/releasing.html">Releasing a Maven project</a> guide for more details. Make sure you have added the pgp key information in you maven settings file, especially if you have more than one key installed locally. See <a href="#B">Appendix B</a> for the details.</p>
<ol style="list-style-type: decimal">
-<li>(optional, prepare your environment. e.g.: $ export version=3.1.36)</li>
-<li>Execute mvn clean deploy -Papache-release -Dmaven.deploy.skip=true. This tests if the release would work.</li>
-<li>Execute mvn release:prepare. This will update the POM files and tag the release in svn (btw: specifying the release version on the commandline doesn’t update the module poms anymore lately).</li>
-<li>Execute mvn release:perform -Papache-release. This will build the tagged release and deploy the artifacts to a new staging repository on <i>repository.apache.org</i>. After the build, login to <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">https://repository.apache.org/</a> and you should see it there.
-<p>The non-Maven release artifacts are automatically copied to /.../target/checkout/target/$version</p></li>
+<li>(optional, prepare your environment. e.g.: <code>$ export version=3.1.36</code>)</li>
+<li>Execute <code>mvn clean deploy -Papache-release -Dmaven.deploy.skip=true</code>. This tests if the release would work.</li>
+<li>Execute <code>mvn release:prepare</code>. This will update the POM files and tag the release in svn (btw: specifying the release version on the commandline doesn’t update the module poms anymore lately).</li>
+<li>Execute <code>mvn release:perform -Papache-release</code>. This will build the tagged release and deploy the artifacts to a new staging repository on <i>repository.apache.org</i>. After the build, login to <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">https://repository.apache.org/</a> and you should see it there.
+<p>The non-Maven release artifacts are automatically copied to <code>/.../target/checkout/target/$version</code></p></li>
</ol>
</li>
<li>
-<p>Close the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> on <i>repository.apache.org</i>.</p>
+<p>Close the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> on <a class="externalLink" href="https://repository.apache.org">https://repository.apache.org</a>.</p>
</li>
<li>
<p>Upload the artifacts to <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/jackrabbit/filevault">https://dist.apache.org/repos/dist/dev/jackrabbit/filevault</a> via SVN</p>
-<div>
-<div>
-<pre class="source">svn co https://dist.apache.org/repos/dist/dev/jackrabbit/filevault dist-dev-filevault
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">svn co https://dist.apache.org/repos/dist/dev/jackrabbit/filevault dist-dev-filevault
cd dist-dev-filevault
cp -r /path/to/jackrabbit/target/checkout/target/$version $version
svn add $version
@@ -225,7 +226,7 @@ svn commit -m "Apache Jackrabbit Fi
</li>
<li>
-<p>Start the vote thread, wait <b>72 hours</b>. See the vote.txt template generated by the Maven build.</p>
+<p>Start the vote thread, wait <b>72 hours</b>. See the <code>vote.txt</code> template generated by the Maven build.</p>
</li>
<li>
@@ -235,15 +236,14 @@ svn commit -m "Apache Jackrabbit Fi
<li>remove the release tag from svn</li>
</ol>
-<div>
-<div>
-<pre class="source">svn rm https://svn.apache.org/repos/asf/jackrabbit/commons/filevault/tags/jackrabbit-filevault-$version
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">svn rm https://svn.apache.org/repos/asf/jackrabbit/commons/filevault/tags/jackrabbit-filevault-$version
</pre></div></div>
<ol style="list-style-type: decimal">
<li>delete the RC from <i>dist.apache.org</i></li>
-<li>and drop the staged repository</li>
+<li>and drop the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a></li>
<li>done</li>
</ol>
</li>
@@ -253,11 +253,10 @@ svn commit -m "Apache Jackrabbit Fi
</li>
<li>
-<p>copy the release candidate from dev/jackrabbit to release/jackrabbit in <a class="externalLink" href="https://dist.apche.org/repos/dist/">https://dist.apche.org/repos/dist/</a>, and delete any older releases from the same branch (they’re automatically archived):</p>
+<p>copy the release candidate from <code>dev/jackrabbit</code> to <code>release/jackrabbit</code> in <a class="externalLink" href="https://dist.apache.org/repos/dist/">https://dist.apache.org/repos/dist/</a>, and delete any older releases from the same branch (they’re automatically archived):</p>
-<div>
-<div>
-<pre class="source">svn move -m "Apache Jackrabbit Filevault $version" \
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">svn move -m "Apache Jackrabbit Filevault $version" \
https://dist.apache.org/repos/dist/dev/jackrabbit/filevault/$version \
https://dist.apache.org/repos/dist/release/jackrabbit/filevault/$version
</pre></div></div>
@@ -268,6 +267,10 @@ svn commit -m "Apache Jackrabbit Fi
</li>
<li>
+<p>update the website by first checking out the released tag, then execute <code>mvn clean site</code> on the reactor project (this will copy the aggregate javadoc to the <code>vault-doc/target</code> folder). Afterwards check the generated site and push it via <code>mvn site-deploy</code> (only relevant on module <code>vault-doc</code>)</p>
+</li>
+<li>
+
<p>mark the version as released in <a class="externalLink" href="https://issues.apache.org/jira/browse/JCRVLT">Jira</a>: <i>Jira Project Home</i> -> <i>Project Summary</i> -> <i>Administer Project</i>.</p>
<p>Under Versions, you’ll see all the defined project versions. From the settings menu, choose <i>Release</i> on the version.</p>
</li>
@@ -299,15 +302,14 @@ svn commit -m "Apache Jackrabbit Fi
<li>
-<p><a class="externalLink" href="http://www.apache.org/dev/release-signing.html#generate">Generate a code signing key</a> using your <i>@apache.org</i> address as the email and CODE SIGNING KEY as the comment.</p>
+<p><a class="externalLink" href="http://www.apache.org/dev/release-signing.html#generate">Generate a code signing key</a> using your <i>@apache.org</i> address as the email and <code>CODE SIGNING KEY</code> as the comment.</p>
</li>
<li>
-<p>The Jackrabbit KEYS file is managed in <a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS">https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS</a>. To modify the file, first checkout the dist directory:</p>
+<p>The Jackrabbit KEYS file is managed in <a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS">https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS</a>. To modify the file, first checkout the <code>dist</code> directory:</p>
-<div>
-<div>
-<pre class="source">svn checkout https://svn.apache.org/repos/asf/jackrabbit/dist
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">svn checkout https://svn.apache.org/repos/asf/jackrabbit/dist
</pre></div></div>
</li>
<li>
@@ -316,11 +318,10 @@ svn commit -m "Apache Jackrabbit Fi
</li>
<li>
-<p>Once you’ve committed the changes, update the KEYS file on people.apache.org:</p>
+<p>Once you’ve committed the changes, update the KEYS file on <code>people.apache.org</code>:</p>
-<div>
-<div>
-<pre class="source">umask 002; svn update /www/www.apache.org/dist/jackrabbit
+<div class="source">
+<div class="source"><pre class="prettyprint linenums">umask 002; svn update /www/www.apache.org/dist/jackrabbit
</pre></div></div>
</li>
<li>
@@ -331,9 +332,8 @@ svn commit -m "Apache Jackrabbit Fi
<p>You should get your key <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#apache-wot">linked to the Apache web of trust</a>. Once other people have signed your key, you can update the KEYS file with the signatures you’ve received.</p></section><section>
<h2><a name="Appendix_B:_Maven_settings"></a><a name="B"></a> Appendix B: Maven settings</h2>
-<div>
-<div>
-<pre class="source"><settings>
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><settings>
...
<servers>
<!-- To deploy a Jackrabbit snapshot -->
Modified: jackrabbit/site/live/filevault/importmode.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/filevault/importmode.html?rev=1875661&r1=1875660&r2=1875661&view=diff
==============================================================================
--- jackrabbit/site/live/filevault/importmode.html (original)
+++ jackrabbit/site/live/filevault/importmode.html Wed Mar 25 16:58:03 2020
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.1 from src/site/markdown/importmode.md at 2020-01-15
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/importmode.md at 2020-03-25
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Jackrabbit Filevault – Import Mode</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
@@ -32,7 +32,7 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="index.html" title="Jackrabbit Filevault">Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault">Jackrabbit FileVault</a></li>
</ul>
</li>
<li class="dropdown">
@@ -89,7 +89,8 @@
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Links <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" title="Apache Jackrabbit">Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" title="Apache Jackrabbit FileVault - Package Maven Plugin">Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</li>
</ul>
@@ -108,9 +109,9 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2020-01-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2020-03-25<span class="divider">|</span>
</li>
- <li id="projectVersion">Version: 3.4.2</li>
+ <li id="projectVersion">Version: 3.4.4</li>
</ul>
</div>
</header>
@@ -119,7 +120,7 @@
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
- <li><a href="index.html" title="Jackrabbit Filevault"><span class="none"></span>Jackrabbit Filevault</a></li>
+ <li><a href="index.html" title="Jackrabbit FileVault"><span class="none"></span>Jackrabbit FileVault</a></li>
<li class="nav-header">Concepts and architecture</li>
<li><a href="overview.html" title="Overview"><span class="none"></span>Overview</a></li>
<li><a href="vaultfs.html" title="Vault FS"><span class="none"></span>Vault FS</a></li>
@@ -146,7 +147,8 @@
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li class="nav-header">Links</li>
- <li><a href="http://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/" class="externalLink" title="Apache Jackrabbit"><span class="none"></span>Apache Jackrabbit</a></li>
+ <li><a href="https://jackrabbit.apache.org/filevault-package-maven-plugin" class="externalLink" title="Apache Jackrabbit FileVault - Package Maven Plugin"><span class="none"></span>Apache Jackrabbit FileVault - Package Maven Plugin</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
@@ -177,60 +179,58 @@
limitations under the License.
-->
<h1>Import Mode</h1>
-<p>The import mode defines how importing content is applied to existing content in the repository. It is controlled by the [ImportOptions][api.ImportOptions] and the [WorkspaceFilter][api.WorkspaceFilter] and defaults to REPLACE.</p><section>
+<p>The import mode defines how importing content is applied to existing content in the repository. It is controlled by the [ImportOptions][api.ImportOptions] and the [WorkspaceFilter][api.WorkspaceFilter] and defaults to <code>REPLACE</code>.</p><section>
<h2><a name="Modes"></a>Modes</h2>
-<p>It is important to note, that the import mode always operates on entire nodes and subtrees, and never just on properties (with an exception of the group membership). For example an ImportMode.MERGE does <b>not</b> merge the properties from an existing node with those of the package.</p>
+<p>It is important to note, that the import mode always operates on entire nodes and subtrees, and never just on properties (with an exception of the group membership). For example an <code>ImportMode.MERGE</code> does <b>not</b> merge the properties from an existing node with those of the package.</p>
<dl>
-<dt><b>ImportMode.REPLACE</b></dt>
+<dt><b><code>ImportMode.REPLACE</code></b></dt>
<dd>This is the normal behaviour. Existing content is replaced completely by the imported content, i.e. is overridden or deleted accordingly.</dd>
-<dt><b>ImportMode.UPDATE</b></dt>
+<dt><b><code>ImportMode.UPDATE</code></b></dt>
<dd>Existing content is updated. Existing content is replaced, new content is added and none is deleted.</dd>
-<dt><b>ImportMode.MERGE</b></dt>
+<dt><b><code>ImportMode.MERGE</code></b></dt>
<dd>Existing content is not modified, i.e. only new content is added and none is deleted or modified.</dd>
</dl></section><section>
<h2><a name="Nested_import_modes_.28not_implemented.29"></a>Nested import modes (not implemented)</h2>
<p>If 2 filters overlap, import modes can nest. The filter root that is closest to the node defines which import mode is relevant. for example:</p>
-<div>
-<div>
-<pre class="source"><filter root="/content/foo" mode="replace"/>
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/content/foo" mode="replace"/>
<filter root="/content/foo/custom" mode="merge"/>
</pre></div></div>
-<p>this has the effect, that the node /content/foo is replaced, but the subtree at /content/foo/custom is merged. however, this only works if the package contains /content/foo. if it is missing, the entire subtree at /content/foo is removed.</p></section><section>
+<p>this has the effect, that the node <code>/content/foo</code> is replaced, but the subtree at <code>/content/foo/custom</code> is merged. however, this only works if the package contains <code>/content/foo</code>. if it is missing, the entire subtree at <code>/content/foo</code> is removed.</p></section><section>
<h2><a name="Import_Mode_behaviour_on_authorizables:"></a>Import Mode behaviour on authorizables:</h2>
-<p>If an authorizable with the same name already exists, the active ImportMode controls how the existing authorizables are affected:</p>
+<p>If an authorizable with the same name already exists, the active <code>ImportMode</code> controls how the existing authorizables are affected:</p>
<dl>
-<dt><b>ImportMode.REPLACE</b></dt>
-<dd>Replaces the authorizable node completely with the content in the package. The importer effectively deletes and re-creates the authorizable at the path specified in the package (internally the content is imported using the content handler with IMPORT_UUID_COLLISION_REMOVE_EXISTING). Note that any sub-nodes of the authorizable are treated like normal content and obey the normal filter rules. so the following filter should only replace the users’s node, but not its sub nodes:</dd>
+<dt><b><code>ImportMode.REPLACE</code></b></dt>
+<dd>Replaces the authorizable node completely with the content in the package. The importer effectively deletes and re-creates the authorizable at the path specified in the package (internally the content is imported using the content handler with <code>IMPORT_UUID_COLLISION_REMOVE_EXISTING</code>). Note that any sub-nodes of the authorizable are treated like normal content and obey the normal filter rules. so the following filter should only replace the users’s node, but not its sub nodes:</dd>
</dl>
-<div>
-<div>
-<pre class="source"><filter root="/home/users/test">
+<div class="source">
+<div class="source"><pre class="prettyprint linenums"><filter root="/home/users/test">
<exclude pattern="/home/users/test/.*" />
</filter>
</pre></div></div>
<dl>
-<dt><b>ImportMode.UPDATE</b></dt>
-<dd>Replaces the authorizable node completely with the content in the package <b>in place</b>. The importer effectively deletes and re-creates the authorizable at the path specified in the package (internally the content is imported using the content handler with IMPORT_UUID_COLLISION_REPLACE_EXISTING). Note that any sub-nodes of the authorizable are treated like normal content and obey the normal filter rules. However, if the authorizable existed at a different path as specified in the repository, the importer keeps track of the remapping and calculates the filters accordingly.</dd>
-<dt><b>ImportMode.MERGE</b></dt>
+<dt><b><code>ImportMode.UPDATE</code></b></dt>
+<dd>Replaces the authorizable node completely with the content in the package <b>in place</b>. The importer effectively deletes and re-creates the authorizable at the path specified in the package (internally the content is imported using the content handler with <code>IMPORT_UUID_COLLISION_REPLACE_EXISTING</code>). Note that any sub-nodes of the authorizable are treated like normal content and obey the normal filter rules. However, if the authorizable existed at a different path as specified in the repository, the importer keeps track of the remapping and calculates the filters accordingly.</dd>
+<dt><b><code>ImportMode.MERGE</code></b></dt>
<dd>Has no effect if the authorizable already existed except for group memberships (see below). Note that any sub-nodes of the authorizable are treated like normal content and obey the normal filter rules. However, if the authorizable existed at a different path as specified in the repository, the importer keeps track of the remapping and calculates the filters accordingly.</dd>
</dl><section>
<h3><a name="Implementation_Detail"></a>Implementation Detail</h3>
<p>The authorizable are imported using the JCR import content handler and rely on the fact that authorizables have a their UUID computed based on their id. If a repository implementation does not follow this assumption, filevault will need to find a different strategy to import authorizables.</p></section></section><section>
<h2><a name="Merging_Group_Members"></a>Merging Group Members</h2>
-<p>ImportMode.MERGE has special semantics for Groups. In this case, the group members of the package are merged with the existing group members in the repository. This is especially useful when adding a new authorizable including its group membership.</p></section><section>
+<p><code>ImportMode.MERGE</code> has special semantics for Groups. In this case, the group members of the package are merged with the existing group members in the repository. This is especially useful when adding a new authorizable including its group membership.</p></section><section>
<h2><a name="Merging_of_normal_content"></a>Merging of normal content</h2>
-<p>ImportMode.MERGE is not implemented completely (see [JCRVLT-255]). Merging works for generic artifacts (docview xmls) that represent authorizable or policy nodes (see aboce). Other generic artifacts are ignored when merging, which causes the entire subtree not to be updated. eg:</p>
-<p>if foo.xml contains /foo/bar/a and the repository already contains /foo/bar/b and the import mode is MERGE on /foo, then the content is not imported, i.e. /foo/bar/a is not created. however, if the import mode is MERGE on only on /foo/bar then /foo/bar/a is imported. Although it then rather behaves like UPDATE.</p>
+<p><code>ImportMode.MERGE</code> is not implemented completely (see [JCRVLT-255]). Merging works for generic artifacts (docview xmls) that represent authorizable or policy nodes (see aboce). Other generic artifacts are ignored when merging, which causes the entire subtree not to be updated. eg:</p>
+<p>if <code>foo.xml</code> contains <code>/foo/bar/a</code> and the repository already contains <code>/foo/bar/b</code> and the import mode is MERGE on <code>/foo</code>, then the content is not imported, i.e. <code>/foo/bar/a</code> is not created. however, if the import mode is MERGE on only on <code>/foo/bar</code> then <code>/foo/bar/a</code> is imported. Although it then rather behaves like UPDATE.</p>
<p>The merging import mode is also respected for pure file artifacts, so that the node is not removed if the file is missing in the import.</p></section><section>
<h2><a name="Scope_of_the_workspace_filter"></a>Scope of the workspace filter</h2>
-<p>Note that the workspace filter of the package refers on the content of the package and not the existing authorizable. For example, if the package contains a user at /home/users/t/test which already exists in the repository at /home/users/custom/te/test then the workspace filter /home/users/t covers the user, but not /home/users/custom.</p>
+<p>Note that the workspace filter of the package refers on the content of the package and not the existing authorizable. For example, if the package contains a user at <code>/home/users/t/test</code> which already exists in the repository at <code>/home/users/custom/te/test</code> then the workspace filter <code>/home/users/t</code> covers the user, but not <code>/home/users/custom</code>.</p>
<p>However, the importer keeps track of potential remapping of existing users and tries to calculate the filters accordingly.</p><!-- references -->
[api.WorkspaceFilter]: apidocs/org/apache/jackrabbit/vault/fs/api/WorkspaceFilter.html
[api.ImportMode]: apidocs/org/apache/jackrabbit/vault/fs/api/ImportMode.html