This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 5ca8189 Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/139/
5ca8189 is described below
commit 5ca8189878f480b643849dda5ca5e58bca757741
Author: jenkins <[email protected]>
AuthorDate: Thu Apr 15 06:55:21 2021 +0000
Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/139/
---
.../bundles/content-loading-jcr-contentloader.html | 24 +++++++++++++---------
sitemap.html | 2 +-
sitemap.xml | 2 +-
tags/contentloading.html | 2 +-
tags/nodetypes.html | 2 +-
5 files changed, 18 insertions(+), 14 deletions(-)
diff --git a/documentation/bundles/content-loading-jcr-contentloader.html
b/documentation/bundles/content-loading-jcr-contentloader.html
index d5f6373..444c22d 100644
--- a/documentation/bundles/content-loading-jcr-contentloader.html
+++ b/documentation/bundles/content-loading-jcr-contentloader.html
@@ -1,7 +1,7 @@
<!DOCTYPE html><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling :: Content Loading and Nodetype Support
(jcr.contentloader)</title>
+ <title>Apache Sling :: Content Loading and Nodetype/Namespace Support
(jcr.contentloader)</title>
<link rel="icon" href="/res/favicon.ico"/>
<link rel="stylesheet"
href="https://cdnjs.cloudflare.com/ajax/libs/bulma/0.7.5/css/bulma.min.css"/>
<link rel="stylesheet" href="/res/css/site.css"/>
@@ -106,7 +106,7 @@
</span>
</div>
</div><h1 class="title">
- Content Loading and Nodetype Support
(jcr.contentloader)
+ Content Loading and Nodetype/Namespace Support
(jcr.contentloader)
</h1><nav class="menu">
<ul class="menu-list box is-shadowless
is-paddingless">
<li id="generatedToC">
@@ -116,7 +116,7 @@
</li>
</ul>
</nav><script src='/res/jquery-3.2.1.min.js'
type='text/javascript'></script><script src='/res/tocjs-1-1-2.js'
type='text/javascript'></script><script
type='text/javascript'>$(document).ready(function() {
$('#generatedToC').toc({'selector':'h1[class!=title],h2,h3','ulClass':'menu-list'});
} );</script><div class="content is-marginless">
-<div class="row"><div><section><p>Apache Sling provides support for initial
content loading into a repository and for registering node types. The
<code>sling-jcr-contentloader</code> bundle provides loading of content from a
bundle into the repository and the <code>sling-jcr-base</code> bundle provides
node type registration. See <a
href="/documentation/development/content-packages.html">Content-Package based
development</a> for an alternative for deploying content to the repository.</p>
+<div class="row"><div><section><p>Apache Sling provides support for initial
content loading into a repository and for registering node types. The <a
href="https://github.com/apache/sling-org-apache-sling-jcr-contentloader";><code>sling-jcr-contentloader</code></a>
bundle provides loading of content from a bundle into the repository and the
<a
href="https://github.com/apache/sling-org-apache-sling-jcr-base";><code>sling-jcr-base</code></a>
bundle provides node type and namespace registratio [...]
<h2><a href="#initial-content-loading" id="initial-content-loading">Initial
Content Loading</a></h2>
<p>Bundles can provide initial content, which is loaded into the repository
when the bundle has entered the <em>started</em> state. Such content is
expected to be contained in the bundles accessible through the Bundle entry API
methods. Content to be loaded is declared in the
<code>Sling-Initial-Content</code> bundle manifest header. This header takes a
comma-separated list of bundle entry paths. Each entry and all its child
entries are accessed and entered into starting with the child e [...]
<p>Adding this content preserves the paths of the entries as shown in this
table, which assumes a <code>Sling-Initial-Content</code> header entry of
<code>SLING-INF/content</code> (with no further directives):</p>
@@ -316,7 +316,7 @@
<h3><a href="#extractors" id="extractors">Extractors</a></h3>
<p>By default, the <code>sling-jcr-contentloader</code> bundle tries to
extract certain file types during content loading. These include
<code>json</code>, <code>xml</code>, <code>zip</code>, and <code>jar</code>
files. Therefore all available extractors are used for content processing.
However if some files should be put into the repository unextracted, the
<code>ignoreImportProviders</code> directive can be used with a comma separated
list of extensions that should not be extracted, li [...]
<h3><a href="#file-name-escaping" id="file-name-escaping">File name
escaping</a></h3>
-<p>When the node name you want to import with the JCR ContentLoader contains
characters that are not allowed in typical file systems (e.g. a ":"
is not allowed on windows file systems), you can URL-encode the file name. It
uses the <a
href="https://docs.oracle.com/javase/8/docs/api/java/net/URLDecoder.html";>Java
URLDecoder</a> internally.</p>
+<p>When the node name you want to import with the JCR ContentLoader contains
characters that are not allowed in typical file systems (e.g. a ":"
is not allowed on windows file systems), you can URL-encode the file name. It
uses the <a
href="https://docs.oracle.com/javase/8/docs/api/java/net/URLDecoder.html";>Java
URLDecoder</a> with UTF-8 character encoding internally.</p>
<p>Example: <code>jcr%3Acontent.txt</code> will be loaded into a node named
<code>jcr:content.txt</code>.</p>
<h3><a href="#workspace-targetting" id="workspace-targetting">Workspace
Targetting</a></h3>
<p>By default, initial content will be loaded into the default workspace. To
override this, add a <code>Sling-Initial-Content-Workspace</code> bundle
manifest header to specify the workspace. Note that <em>all</em> content from a
bundle will be loaded into the same workspace.</p>
@@ -345,16 +345,20 @@
</property>
</node>
</code></pre>
-<h2><a href="#declared-node-type-registration"
id="declared-node-type-registration">Declared Node Type Registration</a></h2>
-<p>The <code>sling-jcr-base</code> bundle provides low-level repository
operations which are at the heart of the functionality of Sling: * <em>Node
Type Definitions</em> - The class
<code>org.apache.sling.content.jcr.base.NodeTypeLoader</code> provides methods
to register custom node types with a repository given a repository session and
a node type definition file in CND format. This class is also used by this
bundle to register node types on behalf of other bundles.</p>
-<p>Bundles may list node type definition files in CND format in the
<code>Sling-Nodetypes</code> bundle header. This header is a comma-separated
list of resources in the respective bundle. Each resource is taken and fed to
the <code>NodeTypeLoader</code> to define the node types.</p>
+<h2><a href="#declared-node-type-and-namespace-registration"
id="declared-node-type-and-namespace-registration">Declared Node Type and
Namespace Registration</a></h2>
+<p>The <code>sling-jcr-base</code> bundle provides low-level repository
operations which are at the heart of the functionality of Sling:</p>
+<h3><a href="#node-type-and-namespace-definitions-cnd"
id="node-type-and-namespace-definitions-cnd">Node Type and Namespace
Definitions (CND)</a></h3>
+<p>The class <code>org.apache.sling.content.jcr.base.NodeTypeLoader</code>
provides methods to register custom node types and namespace with a repository
given a repository session and a node type definition file in <a
href="https://jackrabbit.apache.org/jcr/node-type-notation.html";>CND
format</a>. This class is also used by this bundle to register node types on
behalf of other bundles.</p>
+<p>Bundles may list node type definition files in CND format in the
<code>Sling-Nodetypes</code> bundle header. This header is a comma-separated
list of resource names in the respective bundle. Each resource is taken and fed
to the <code>NodeTypeLoader</code> to define the node types.</p>
<p>After a bundle has entered the <em>resolved</em> state, the node types
listed in the <code>Sling-Nodetypes</code> bundle header are registered with
the repository.</p>
<p>Node types installed by this mechanism will never be removed again by the
<code>sling-jcr-base</code> bundle.</p>
-<p>Starting with revision 911430, re-registration of existing node types is
enabled by default. To disable this, add <code>;rereigster:=false</code> to the
resource names for which re-registration should be disabled.</p>
+<p>Starting with revision 911430, re-registration of existing node types is
enabled by default. To disable this, add <code>;reregister:=false</code> to the
resource names for which re-registration should be disabled.</p>
<div class="warning">
Support for re-registration of node types is relatively limited. In
Jackrabbit, for example, only "trivial" changes are allowed.
</div>
-<h3><a href="#automated-tests" id="automated-tests">Automated tests</a></h3>
+<h3><a href="#namespace-defition" id="namespace-defition">Namespace
Defition</a></h3>
+<p>Instead of using a CND file for defining namespace one can use the bundle
header <code>Sling-Namespaces</code> as well. It contains a comma-separated
list of <code><prefix>=<uri></code> strings. Those are processed in
<a
href="https://github.com/apache/sling-org-apache-sling-jcr-base/blob/66be360910c265473799635fcac0e23895898913/src/main/java/org/apache/sling/jcr/base/internal/loader/Loader.java#L192";><code>org.apache.sling.content.jcr.base.internal.loader.Loader</code></a>.</p>
+<h2><a href="#automated-tests" id="automated-tests">Automated tests</a></h2>
<p>The initial content found in the <a
href="https://github.com/apache/sling-org-apache-sling-launchpad-content/tree/master/src/main/resources/content/sling-test";>sling-test
folder of the launchpad initial content</a> is verified by the <a
href="https://github.com/apache/sling-org-apache-sling-launchpad-integration-tests/blob/master/src/main/java/org/apache/sling/launchpad/webapp/integrationtest/InitialContentTest.java";>InitialContentTest</a>
when running the <em>launchpad testing</em> i [...]
<p>Those tests can be used as verified examples of initial content loading.
Contributions are welcome to improve the coverage of those tests.</p>
<h2><a href="#acls-and-principals" id="acls-and-principals">ACLs and
Principals</a></h2>
@@ -419,7 +423,7 @@ Support for re-registration of node types is relatively
limited. In Jackrabbit,
</div><footer class="footer">
<div class="content has-text-centered is-small">
<div class="revisionInfo">
- Last modified by <span class="author">Robert
Munteanu</span> on <span class="comment">Fri May 8 15:49:05 2020 +0200</span>
+ Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">Thu Apr 15 08:51:56 2021 +0200</span>
</div> <p>
Apache Sling, Sling, Apache, the Apache feather logo,
and the Apache Sling project logo are trademarks of The Apache Software
Foundation. All other marks mentioned may be trademarks or registered
trademarks of their respective owners.
</p><p>
diff --git a/sitemap.html b/sitemap.html
index 0ffa004..3bd6be9 100644
--- a/sitemap.html
+++ b/sitemap.html
@@ -120,7 +120,7 @@
<li><a
href="/documentation/bundles/connection-timeout-agent.html">Connection Timeout
Agent</a></li>
<li><a
href="/documentation/bundles/distribution.html">Content Distribution</a></li>
<li><a
href="/documentation/bundles/content-distribution.html">Content Distribution
(org.apache.sling.distribution)</a></li>
- <li><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype Support (jcr.contentloader)</a></li>
+ <li><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype/Namespace Support (jcr.contentloader)</a></li>
<li><a
href="/documentation/bundles/content-package-installer-factory.html">Content
Package Installer Factory</a></li>
<li><a
href="/documentation/development/content-packages.html">Content-Package based
development</a></li>
<li><a
href="/contributing.html">Contributing</a></li>
diff --git a/sitemap.xml b/sitemap.xml
index 08c4e5e..ca01e30 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -118,7 +118,7 @@
<li><a
href="/documentation/bundles/connection-timeout-agent.html">Connection Timeout
Agent</a></li>
<li><a
href="/documentation/bundles/distribution.html">Content Distribution</a></li>
<li><a
href="/documentation/bundles/content-distribution.html">Content Distribution
(org.apache.sling.distribution)</a></li>
- <li><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype Support (jcr.contentloader)</a></li>
+ <li><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype/Namespace Support (jcr.contentloader)</a></li>
<li><a
href="/documentation/bundles/content-package-installer-factory.html">Content
Package Installer Factory</a></li>
<li><a
href="/documentation/development/content-packages.html">Content-Package based
development</a></li>
<li><a
href="/contributing.html">Contributing</a></li>
diff --git a/tags/contentloading.html b/tags/contentloading.html
index a199470..fac738b 100644
--- a/tags/contentloading.html
+++ b/tags/contentloading.html
@@ -80,7 +80,7 @@
<breadcrumbs/>
</div><tags/>
</div><tableOfContents/><div class="content
is-marginless">
-<div class="taglinks"><h2>Tagged with 'contentloading'</h2><div
class="taglink"><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype Support (jcr.contentloader)</a></div><div
class="taglink"><a
href="/documentation/bundles/content-package-installer-factory.html">Content
Package Installer Factory</a></div><div class="taglink"><a
href="/documentation/development/content-packages.html">Content-Package based
development</a></div><h2>All tags</h2>
+<div class="taglinks"><h2>Tagged with 'contentloading'</h2><div
class="taglink"><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype/Namespace Support (jcr.contentloader)</a></div><div
class="taglink"><a
href="/documentation/bundles/content-package-installer-factory.html">Content
Package Installer Factory</a></div><div class="taglink"><a
href="/documentation/development/content-packages.html">Content-Package based
development</a></div><h2>A [...]
<div class="field is-grouped
is-grouped-multiline"><div class="control"><div class="tags has-addons"><span
class="tag"><a href="/tags/adaptTo.html">adaptTo</a></span><span
class="tag">1</span></div></div>
<div class="control"><div class="tags
has-addons"><span class="tag"><a href="/tags/api.html">api</a></span><span
class="tag">3</span></div></div>
<div class="control"><div class="tags
has-addons"><span class="tag"><a
href="/tags/authentication.html">authentication</a></span><span
class="tag">8</span></div></div>
diff --git a/tags/nodetypes.html b/tags/nodetypes.html
index 0b387f5..ff249e1 100644
--- a/tags/nodetypes.html
+++ b/tags/nodetypes.html
@@ -80,7 +80,7 @@
<breadcrumbs/>
</div><tags/>
</div><tableOfContents/><div class="content
is-marginless">
-<div class="taglinks"><h2>Tagged with 'nodetypes'</h2><div class="taglink"><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype Support (jcr.contentloader)</a></div><h2>All tags</h2>
+<div class="taglinks"><h2>Tagged with 'nodetypes'</h2><div class="taglink"><a
href="/documentation/bundles/content-loading-jcr-contentloader.html">Content
Loading and Nodetype/Namespace Support (jcr.contentloader)</a></div><h2>All
tags</h2>
<div class="field is-grouped
is-grouped-multiline"><div class="control"><div class="tags has-addons"><span
class="tag"><a href="/tags/adaptTo.html">adaptTo</a></span><span
class="tag">1</span></div></div>
<div class="control"><div class="tags
has-addons"><span class="tag"><a href="/tags/api.html">api</a></span><span
class="tag">3</span></div></div>
<div class="control"><div class="tags
has-addons"><span class="tag"><a
href="/tags/authentication.html">authentication</a></span><span
class="tag">8</span></div></div>
