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 9cf3e57 Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/29/
9cf3e57 is described below
commit 9cf3e579b9199cee6c66315526b6695296ccbb29
Author: jenkins <[email protected]>
AuthorDate: Mon Sep 21 07:16:57 2020 +0000
Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/29/
---
documentation/the-sling-engine/resources.html | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/documentation/the-sling-engine/resources.html
b/documentation/the-sling-engine/resources.html
index 29cd6f8..6b628f6 100644
--- a/documentation/the-sling-engine/resources.html
+++ b/documentation/the-sling-engine/resources.html
@@ -139,7 +139,7 @@
</table>
<p>For a complete description of the <code>Resource</code> interface, please
refer to the <a
href="http://sling.apache.org/apidocs/sling8/org/apache/sling/api/resource/Resource.html";><code>Resource</code></a>
JavaDoc.</p>
<p>The properties are either exposed via the <code>ValueMap</code> or
<code>ModifiableValueMap</code> adaptable or by calling
<code>Resource.getValueMap()</code>.</p>
-<p>To get the main binary property from a given resource one can adapt it to
an <code>InputStream</code>. Most resource providers return the underlying
wrapper binary in that case.</p>
+<p>To get the <em>main</em> binary property from a given resource one can
adapt it to an <code>InputStream</code>. Most resource providers return the
underlying wrapper binary in that case. For arbitrary binary properties one
must use the <code>ValueMap</code> which will return <code>InputStream</code>
for such properties.</p>
<h3><a href="#resource-types" id="resource-types">Resource Types</a></h3>
<p>The exact method of setting the resource type for a Resource depends on the
actual Resource Provider. For the four main Resource Provider implementations
provided by Sling, the assignments are as follows:</p>
<table>
@@ -234,6 +234,13 @@
<tr><td> <code>v</code> </td><td> <code>1.0</code> </td><td> Retrieves the
underlying JCR node from the <a
href="https://docs.adobe.com/docs/en/spec/jcr/2.0/15_Versioning.html";>version
history</a> leveraging the version label given in the value. </td><td> <a
href="https://issues.apache.org/jira/browse/SLING-848";>SLING-848</a></td></tr>
</tbody>
</table>
+<h4><a href="#main-binary-property" id="main-binary-property">Main Binary
Property</a></h4>
+<p>The main binary property (i.e. the one being exposed by
<code>Resource.adaptTo(InputStream.class)</code>) is determined like
follows:</p>
+<ol>
+<li><code>jcr:data</code> is such a property exists, otherwise</li>
+<li>the primary item of the underlying node (as defined by <a
href="https://docs.adobe.com/docs/en/spec/jsr170/javadocs/jcr-2.0/javax/jcr/Node.html#getPrimaryItem()">Node.getPrimaryItem()</a>).</li>
+</ol>
+<p>For node type <code>nt:file</code> the property is looked up in the child
node <code>jcr:content</code> for both cases. For all other node types it is
looked up in the underlying node of the current resource.</p>
<h3><a href="#bundle-based-resources" id="bundle-based-resources">Bundle-based
Resources</a></h3>
<p>Resources may by provided by OSGi bundles. Providing bundles have a Bundle
manifest header <code>Sling-Bundle-Resources</code> containing a list of
absolute paths provided by the bundle. The path are separated by comma or
whitespace (SP, TAB, VTAB, CR, LF).</p>
<p>The <code>BundleResourceProvider</code> supporting bundle-based Resources
provides directories as Resources of type <code>nt:folder</code> and files as
Resources of type <code>nt:file</code>. This matches the default primary node
types intended to be used for directories and files in JCR repositories.</p>
@@ -271,7 +278,7 @@
</div><footer class="footer">
<div class="content has-text-centered is-small">
<div class="revisionInfo">
- Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">Thu Aug 6 10:00:58 2020 +0200</span>
+ Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">Mon Sep 21 09:12:52 2020 +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>
