Author: buildbot
Date: Fri Mar 10 16:40:14 2017
New Revision: 1008092
Log:
Staging update by buildbot for sling
Modified:
websites/staging/sling/trunk/content/ (props changed)
websites/staging/sling/trunk/content/documentation/bundles/accessing-filesystem-resources-extensions-fsresource.html
Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 10 16:40:14 2017
@@ -1 +1 @@
-1786381
+1786383
Modified:
websites/staging/sling/trunk/content/documentation/bundles/accessing-filesystem-resources-extensions-fsresource.html
==============================================================================
---
websites/staging/sling/trunk/content/documentation/bundles/accessing-filesystem-resources-extensions-fsresource.html
(original)
+++
websites/staging/sling/trunk/content/documentation/bundles/accessing-filesystem-resources-extensions-fsresource.html
Fri Mar 10 16:40:14 2017
@@ -128,7 +128,7 @@ h2:hover > .headerlink, h3:hover > .head
</ul>
</div>
<h2 id="introduction">Introduction<a class="headerlink" href="#introduction"
title="Permanent link">¶</a></h2>
-<p>The File System Resource Provider provides access to the operating system's
file system through the Sling <code>ResourceResolver</code>. Multiple locations
may be mapped into the resource tree by configuring the file system location
and the resource tree root path for each location to be mapped. The provider
supports mapping folders and files as binaries, and content structures stored
in JSON files or FileVault XML format.</p>
+<p>The Apache Sling File System Resource Provider provides access to the
operating system's file system through the Sling <code>ResourceResolver</code>.
Multiple locations may be mapped into the resource tree by configuring the file
system location and the resource tree root path for each location to be mapped.
The provider supports mapping folders and files as binaries, and content
structures stored in JSON files or FileVault XML format.</p>
<p>To activate this feature, install the
<code>org.apache.sling.fsresource</code> bundle. You can get it from the Sling
downloads page or from <a
href="https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.sling%22%20AND%20a%3A%22org.apache.sling.fsresource%22">Maven
Central</a>.</p>
<p>Currently two major versions are maintained - choose the correct version
depending on your Sling environment:</p>
<ul>
@@ -141,7 +141,7 @@ h2:hover > .headerlink, h3:hover > .head
<li>Regular files are assigned the <code>nt:file</code> resource type</li>
<li>Directories are assigned the <code>nt:folder</code> resource type</li>
</ul>
-<p>Content stored in JSON or FileVault XML files are mapped with the resource
type stored in the files. If a resource type is missing `nt:unstructured' is
used as fallback.</p>
+<p>Content stored in JSON or FileVault XML files are mapped with the resource
type stored in the files. If a resource type is missing
<code>nt:unstructured</code> is used as fallback.</p>
<h2 id="adapters">Adapters<a class="headerlink" href="#adapters"
title="Permanent link">¶</a></h2>
<p>File system resources extend from Sling's <code>AbstractResource</code>
class and thus are adaptable to any type for which an
<code>AdapterFactory</code> is registered supporting file system resources. In
addition File system Resources support the following adapters natively:</p>
<ul>
@@ -157,7 +157,7 @@ h2:hover > .headerlink, h3:hover > .head
<li>INITIAL_CONTENT: Sling-Initial-Content filesystem layout, supports file
and folders ant content files in JSON and jcr.xml format.</li>
<li>FILEVAULT_XML: FileVault XML format (expanded content package).</li>
</ul>
-<p>Further configuration parameters:</p>
+<p>Configuration parameters for each mapping:</p>
<table class="table">
<thead>
<tr>
@@ -206,7 +206,11 @@ h2:hover > .headerlink, h3:hover > .head
</table>
<h3 id="files_folders-file-system-layout">FILES_FOLDERS file system layout<a
class="headerlink" href="#files_folders-file-system-layout" title="Permanent
link">¶</a></h3>
<p>The mode maps only files and folders. This was the only mode supported in
fsresource versions before 1.3.</p>
-<p>No caching is used for this mode. Resource events are sent when file oder
folder changes are detected.</p>
+<p>Notes:</p>
+<ul>
+<li>No caching is used for this mode.</li>
+<li>Resource events are sent when file oder folder changes are detected.</li>
+</ul>
<h3 id="initial_content-file-system-layout">INITIAL_CONTENT file system
layout<a class="headerlink" href="#initial_content-file-system-layout"
title="Permanent link">¶</a></h3>
<p>The mode maps files and folders, and content files stored in JSON or
jcr.xml files. The layout has to match the conventions of the <a
href="content-loading-jcr-contentloader.html">Apache Sling JCR Content
Loader</a>. The bundle header <code>Sling-Initial-Content</code> defines where
and how the content should be loaded to.</p>
<p>This mode is best use together with the <a
href="http://sling.apache.org/components/maven-sling-plugin/">Maven Sling
Plugin</a>, which automatically creates the appropriate File System Resource
Provider configurations for a Maven bundle project containing content
structures. For each path an individual configuration is created.</p>
@@ -251,7 +255,7 @@ h2:hover > .headerlink, h3:hover > .head
<li>Content excluded by the filter definition is not mounted by the resource
provider, if a resource of the relevant path is requested the resource provider
falls back to the parent resource provider (e.g. JCR repository).</li>
</ul>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1786381 by sseifert on Fri, 10 Mar 2017 16:34:11 +0000
+ Rev. 1786383 by sseifert on Fri, 10 Mar 2017 16:40:06 +0000
</div>
<div class="trademarkFooter">
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache
Sling project