Author: buildbot
Date: Thu Sep 22 12:17:18 2016
New Revision: 997995
Log:
Staging update by buildbot for sling
Modified:
websites/staging/sling/trunk/content/ (props changed)
websites/staging/sling/trunk/content/documentation/the-sling-engine/resources.html
Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 22 12:17:18 2016
@@ -1 +1 @@
-1761920
+1761921
Modified:
websites/staging/sling/trunk/content/documentation/the-sling-engine/resources.html
==============================================================================
---
websites/staging/sling/trunk/content/documentation/the-sling-engine/resources.html
(original)
+++
websites/staging/sling/trunk/content/documentation/the-sling-engine/resources.html
Thu Sep 22 12:17:18 2016
@@ -240,6 +240,7 @@ and <code>getResource(Resource base, Str
<p>The virtual path mapping may be used to create shortcut URLs for otherwise
long and complicated URLs. An example of such an URL might be the main
administrative page of a CMS system. So, administrators may access the root of
the web application and directed to the main administrative page.</p>
<p>The path mapping functionality may be used to hide internal resource
organization from the request URL space. For example to better control the
structure of your repository, you might decide to store all accessible data
inside a <code>/content</code> subtree. To hide this fact from the users, a
mapping may be defined to prefix all incoming paths with <code>/content</code>
to get at the actual Resource.</p>
<p>The <code>map(String)</code> applies the path mapping algorithm in the
reverse order. That is, first the path mappings are reversed and then any
virtual mappings are checked. So, a path <code>/content/sample</code> might be
mapped <code>/sample</code> to revers the <code>/content</code> prefixing. Or
the main administrative page - say <code>/system/admin/main.html</code> - may
be mapped to the virtual URL <code>/</code>.</p>
+<p>More details on mappings can be found at <a
href="/documentation/the-sling-engine/mappings-for-resource-resolution.html">Mappings
for Resource Resolution</a>.</p>
<h3 id="relative-path-resolution">Relative Path Resolution<a
class="headerlink" href="#relative-path-resolution" title="Permanent
link">¶</a></h3>
<p>Sometimes it is required to resolve relative paths to Resources. An example
of such a use case is Script and Servlet resolution which starts with a
relative path consisting of the Resource type, optional selectors and the
request extension or method name. By scanning a search path for these relative
paths a system provided Resource may be overwritten with some user defined
implementation.</p>
<p>Consider for example, the system would provide a Servlet to render
Resources of type <code>nt:file</code>. This Servlet would be registered under
the path <code>/libs/nt/file/html</code>. For a certain web application, this
default HTML rendering might not be appropriate, so a Script is created as
<code>/apps/nt/file/html.jsp</code> with a customized HTML rendering. By
defining the search path to be <em>[</em> <code>*/apps{*}{</code>}<em>,</em>
<code>*/libs{*</code>} <em>]()</em> the Servlet resolver would call the
<code>ResourceResolver.getResource(String)</code> method with the relative path
<code>nt/file/html</code> and be provided with the first matching resource -
<code>/apps/nt/file/html.jsp</code> in this example.</p>
@@ -287,7 +288,7 @@ and <code>getResource(Resource base, Str
<h2 id="wrapdecorate-resources">Wrap/Decorate Resources<a class="headerlink"
href="#wrapdecorate-resources" title="Permanent link">¶</a></h2>
<p>The Sling API provides an easy way to wrap or decorate a resource before
returning. Details see <a
href="/documentation/the-sling-engine/wrap-or-decorate-resources.html">Wrap or
Decorate Resources</a>.</p>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1728165 by kwin on Tue, 2 Feb 2016 18:02:28 +0000
+ Rev. 1761921 by kwin on Thu, 22 Sep 2016 12:17:08 +0000
</div>
<div class="trademarkFooter">
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache
Sling project
