incubator-sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r873664 - in /websites/staging/sling/trunk/content: ./ documentation/bundles.html documentation/bundles/sling-scripting-jsp-taglib.html documentation/bundles/sling-tag-library.html documentation/tutorials-how-tos.html sitemap.html
Date Fri, 09 Aug 2013 02:32:05 GMT
Author: buildbot
Date: Fri Aug  9 02:32:05 2013
New Revision: 873664

Log:
Staging update by buildbot for sling

Added:
    websites/staging/sling/trunk/content/documentation/bundles/sling-scripting-jsp-taglib.html
Removed:
    websites/staging/sling/trunk/content/documentation/bundles/sling-tag-library.html
Modified:
    websites/staging/sling/trunk/content/   (props changed)
    websites/staging/sling/trunk/content/documentation/bundles.html
    websites/staging/sling/trunk/content/documentation/tutorials-how-tos.html
    websites/staging/sling/trunk/content/sitemap.html

Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Aug  9 02:32:05 2013
@@ -1 +1 @@
-1512126
+1512128

Modified: websites/staging/sling/trunk/content/documentation/bundles.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/bundles.html (original)
+++ websites/staging/sling/trunk/content/documentation/bundles.html Fri Aug  9 02:32:05 2013
@@ -114,6 +114,7 @@
 <li><a href="/documentation/bundles/mime-type-support-commons-mime.html">MIME
Type Support (commons.mime)</a></li>
 <li><a href="/documentation/bundles/output-rewriting-pipelines-org-apache-sling-rewriter.html">Output
Rewriting Pipelines (org.apache.sling.rewriter)</a></li>
 <li><a href="/documentation/bundles/request-analysis.html">Request Processing
Analyzer (org.apache.sling.reqanalyzer)</a></li>
+<li><a href="/documentation/bundles/sling-scripting-jsp-taglib.html">Scripting
JSP Taglib</a></li>
 <li><a href="/documentation/bundles/sling-settings-org-apache-sling-settings.html">Sling
Settings (org.apache.sling.settings)</a></li>
 <li><a href="/documentation/bundles/sling-health-check-tool.html">Sling Health
Check Tool</a></li>
 <li><a href="/documentation/bundles/scheduler-service-commons-scheduler.html">Scheduler
Service (commons scheduler)</a></li>
@@ -122,7 +123,7 @@
 <li><a href="/documentation/bundles/xml-support.html">XML Support</a></li>
 </ul>
       <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
-        Rev. 1505908 by cziegeler on Tue, 23 Jul 2013 06:24:46 +0000
+        Rev. 1512128 by dklco on Fri, 9 Aug 2013 02:31:53 +0000
       </div>
       <div class="trademarkFooter"> 
         Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project

Added: websites/staging/sling/trunk/content/documentation/bundles/sling-scripting-jsp-taglib.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/bundles/sling-scripting-jsp-taglib.html
(added)
+++ websites/staging/sling/trunk/content/documentation/bundles/sling-scripting-jsp-taglib.html
Fri Aug  9 02:32:05 2013
@@ -0,0 +1,434 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE- 2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+  <head>
+    <title>Apache Sling - Sling Tag Library</title>
+    <link rel="icon" href="/res/favicon.ico">
+    <link rel="stylesheet" href="/res/site.css" type="text/css" media="all">
+    <link rel="stylesheet" href="/res/codehilite.css" type="text/css" media="all">
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </head>
+  <body>
+    <div class="title">
+      <div class="logo">
+        <a href="http://sling.apache.org/">
+          <img border="0" alt="Apache Sling" src="/res/logo.png">
+        </a>
+      </div>
+      <div class="header">
+        <a href="http://www.apache.org/">
+          <img border="0" alt="Apache" src="/res/apache.png">
+        </a>
+      </div>
+    </div>
+    
+    <div class="menu"> 
+      <p><strong><a href="/documentation.html">Documentation</a></strong>
<br />
+<a href="/documentation/getting-started.html">Getting Started</a> <br />
+<a href="/documentation/the-sling-engine.html">The Sling Engine</a> <br />
+<a href="/documentation/development.html">Development</a> <br />
+<a href="/documentation/bundles.html">Bundles</a> <br />
+<a href="/documentation/tutorials-how-tos.html">Tutorials &amp; How-Tos</a>
<br />
+<a href="/documentation/configuration.html">Configuration</a> <br />
+<a href="http://s.apache.org/sling.wiki">Wiki</a> <br />
+<a href="http://s.apache.org/sling.faq">FAQ</a> <br />
+<a href="/sitemap.html">Site Map</a></p>
+<p><strong>API Docs</strong>  <br />
+<a href="/apidocs/sling6/index.html">Sling 6</a> <br />
+<a href="/apidocs/sling5/index.html">Sling 5</a>   </p>
+<p><strong>Project info</strong> <br />
+<a href="/downloads.cgi">Downloads</a> <br />
+<a href="http://www.apache.org/licenses/">License</a> <br />
+<a href="/contributing.html">Contributing</a> <br />
+<a href="/news.html">News</a> <br />
+<a href="/links.html">Links</a> <br />
+<a href="/project-information.html">Project Information</a> <br />
+<a href="https://issues.apache.org/jira/browse/SLING">Issue Tracker</a> <br
/>
+<a href="http://svn.apache.org/viewvc/sling/trunk">Browse Source Repository</a>
<br />
+<a href="/project-information/security.html">Security</a>   </p>
+<p><strong>Sponsorship</strong> <br />
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a> <br />
+<a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a>
<br />
+<a href="http://www.apache.org/foundation/buy_stuff.html">Buy Stuff</a>   </p>
+<!-- no valid ads for now, we'll  reactivate this when needed
+<iframe 
+    src="http://www.apache.org/ads/button.html"
+    style="border-width:0; float: left" frameborder="0" 
+    scrolling="no"
+    width="135" 
+    height="135">
+</iframe>
+-->
+    </div>
+    
+    <div class="main">
+      <div class="breadcrump" style="font-size: 80%;">
+        <a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/documentation.html">Documentation</a>&nbsp;&raquo&nbsp;<a
href="/documentation/bundles.html">Bundles</a>
+      </div>
+
+      
+      
+      <h1>Sling Tag Library</h1>
+      <p>The Sling Tag Library(TagLib) supports the use of Sling as an application
in JSP pages.  The Sling TagLib provides the
+ ability to invoke JSP scripts, include Resources and interact with the Sling Repository,
all with JSP tags and 
+ <a href="http://docs.oracle.com/javaee/6/tutorial/doc/gjddd.html">Expression Language
(EL)</a> functions.</p>
+<h2 id="use">Use</h2>
+<p>Using the Sling TagLib in a JSP page is as simple as including the TagLib include
in your JSP, with the correct URI for the
+version of the Sling TagLib installed.</p>
+<div class="codehilite"><pre><span class="cp">&lt;%</span><span
class="vi">@taglib</span> <span class="n">prefix</span><span class="o">=</span><span
class="s2">&quot;sling&quot;</span> <span class="n">uri</span><span
class="o">=</span><span class="s2">&quot;http://sling.apache.org/taglibs/sling&quot;</span>
<span class="cp">%&gt;</span><span class="x"></span>
+</pre></div>
+
+
+<p>Generally, the prefix to use is <code>sling</code>.  Often applications
include a global JSP file which includes the Sling Taglib 
+and sets up all of the application variables and methods.</p>
+<p>The Sling TagLib does not attempt to reproduce the functionality of other Tag Libraries,
such as 
+<a href="http://www.oracle.com/technetwork/java/index-jsp-135995.html">JSTL</a>;
additional Tag Libraries may be required to fully leverage 
+the Sling TagLib.</p>
+<h2 id="taglib-versions">TagLib Versions</h2>
+<p>There have been a number of releases of the Sling TagLibs, including versions with
different URIs.</p>
+<table>
+<thead>
+<tr>
+<th>TagLib Version</th>
+<th>Bundle Version</th>
+<th>URI</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>1.0</td>
+<td>2.0.6</td>
+<td>http://sling.apache.org/taglibs/sling/1.0</td>
+</tr>
+<tr>
+<td>1.1</td>
+<td>2.1.0</td>
+<td>http://sling.apache.org/taglibs/sling/1.1</td>
+</tr>
+<tr>
+<td>1.2</td>
+<td>2.1.8</td>
+<td>http://sling.apache.org/taglibs/sling/1.2</td>
+</tr>
+<tr>
+<td>1.3</td>
+<td>2.2.0</td>
+<td>http://sling.apache.org/taglibs/sling</td>
+</tr>
+</tbody>
+</table>
+<p>All releases from 1.3 onward are expected to use the URI <code>http://sling.apache.org/taglibs/sling</code>
to ensure ease of 
+upgrading to newer versions of the TagLib.</p>
+<h2 id="expression-language-functions">Expression Language Functions</h2>
+<p>The Sling TagLib includes a number of Expression Language Functions which can be
used to access the repository.</p>
+<h3 id="adaptto">adaptTo</h3>
+<p>Adapts an Adaptable to another class.</p>
+<ul>
+<li>Returns: <code>java.lang.Object</code></li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.adapter.Adaptable</code> - The object to
adapt</li>
+<li><code>java.lang.String</code> - The name of the class to which to adapt
the adaptable</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:set</span>
<span class="na">var=</span><span class="s">&quot;myProperties&quot;</span>
<span class="na">value=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">adaptTo</span><span class="p">(</span><span class="n">resource</span><span
class="p">,</span><span class="s">&#39;org.apache.sling.api.resource.ValueMap&#39;</span><span
class="p">)</span><span class="cp">}</span><span class="s">&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="findresources">findResources</h3>
+<p>Searches for resources using the given query formulated in the given language.</p>
+<ul>
+<li>Returns: <code>java.util.Iterator</code> - An Iterator of Resource
objects matching the query.</li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.resource.ResourceResolver</code> - The Resource
Resolver to use for the query.</li>
+<li><code>java.lang.String</code> - The query string to use to find the
resources.</li>
+<li><code>java.lang.String</code> - The language in which the query is
formulated.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:forEach</span>
<span class="na">var=</span><span class="s">&quot;found&quot;</span>
<span class="na">items=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">findResources</span><span class="p">(</span><span class="n">resourceResolver</span><span
class="p">,</span><span class="s">&#39;/jcr:root//*[jcr:contains(., &#39;</span><span
class="n">Sling</span><span class="s">&#39;)] order by @jcr:score&#39;</span><span
class="p">,</span><span class="s">&#39;xpath&#39;</span><span
class="p">)</span><span class="s">&quot;&gt;</span>
+    <span class="o">&lt;</span><span class="n">li</span><span
class="o">&gt;</span><span class="err">$</span><span class="p">{</span><span
class="n">found</span><span class="o">.</span><span class="n">path</span><span
class="cp">}</span><span class="s">&lt;/li&gt;</span>
+<span class="s">&lt;/c:forEach&gt;</span>
+</pre></div>
+
+
+<h3 id="getrelativeresource">getRelativeResource</h3>
+<p>Gets the resource at the relative path to the provided resource.</p>
+<ul>
+<li>Returns: <code>org.apache.sling.api.resource.Resource</code> - The
resource at the relative path.</li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.resource.Resource</code> - The resource
relative to which to find the path.</li>
+<li><code>java.lang.String</code> - The relative path at which to find
the resource.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:set</span>
<span class="na">var=</span><span class="s">&quot;content&quot;</span>
<span class="na">value=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">getRelativeResource</span><span class="p">(</span><span
class="n">resource</span><span class="p">,</span><span class="s">&#39;jcr:content&#39;</span><span
class="p">)</span><span class="cp">}</span><span class="s">&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="getresource">getResource</h3>
+<p>Method allow for the retrieval of resources.</p>
+<ul>
+<li>Returns: <code>org.apache.sling.api.resource.Resource</code> - The
resource at the path.</li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.resource.ResourceResolver</code> - The current
resource resolver.</li>
+<li><code>java.lang.String</code> - The path at which to find the resource.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:set</span>
<span class="na">var=</span><span class="s">&quot;content&quot;</span>
<span class="na">value=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">getResource</span><span class="p">(</span><span class="n">resourceResolver</span><span
class="p">,</span><span class="s">&#39;/content&#39;</span><span
class="p">)</span><span class="cp">}</span><span class="s">&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="getvalue">getValue</h3>
+<p>Gets the value of the specified key from the ValueMap and either coerses
+the value into the specified type or uses the specified type as a default
+depending on the parameter passed in.</p>
+<p>If the third parameter is a class, the resulting value will be coersed into the
class, 
+otherwise, the third parameter is used as the default when retrieving the value from the
+<code>ValueMap</code>.</p>
+<ul>
+<li>Returns: <code>java.lang.Object</code> - The value.</li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.resource.ValueMap</code> - The ValueMap
from which to retrieve the value.</li>
+<li><code>java.lang.String</code> - The key for the value to retrieve</li>
+<li><code>java.lang.Object</code> - Either the default value or the class
to which to coerce the value.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:set</span>
<span class="na">var=</span><span class="s">&quot;content&quot;</span>
<span class="na">value=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">getValue</span><span class="p">(</span><span class="n">properties</span><span
class="p">,</span><span class="s">&#39;jcr:title&#39;</span><span
class="p">,</span><span class="n">resource</span><span class="o">.</span><span
class="n">name</span><span class="p">)</span><span class="cp">}</span><span
class="s">&quot;</span> <span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="listchildren">listChildren</h3>
+<p>Method for allowing the invocation of the Sling Resource listChildren method.</p>
+<ul>
+<li>Returns: <code>java.util.Iterator</code> - The children of the resource.</li>
+<li>Accepts:<ul>
+<li><code>org.apache.sling.api.resource.Resource</code> - The resource
of which to list the children.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;c:forEach</span>
<span class="na">var=</span><span class="s">&quot;child&quot;</span>
<span class="na">items=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">sling</span><span class="p">:</span><span
class="n">listChildren</span><span class="p">(</span><span class="n">resource</span><span
class="p">)</span><span class="s">&quot;&gt;</span>
+    <span class="o">&lt;</span><span class="n">li</span><span
class="o">&gt;</span><span class="err">$</span><span class="p">{</span><span
class="n">child</span><span class="o">.</span><span class="n">path</span><span
class="cp">}</span><span class="s">&lt;/li&gt;</span>
+<span class="s">&lt;/c:forEach&gt;</span>
+</pre></div>
+
+
+<h2 id="tags">Tags</h2>
+<p>The Sling TagLib includes a number of Tags which can be used to access the repository,
handle the inclusion of scripts and manage requests.</p>
+<h3 id="adaptto_1">adaptTo</h3>
+<p>Adapts adaptables to objects of other types.</p>
+<ul>
+<li>Attributes<ul>
+<li>adaptable - The adaptable object to adapt.</li>
+<li>adaptTo - The class name to which to adapt the adaptable.</li>
+<li>var - The name of the variable to which to save the adapted object.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;sling:adaptTo</span>
<span class="na">adaptable=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">resource</span><span class="cp">}</span><span
class="s">&quot;</span> <span class="na">adaptTo=</span><span
class="s">&quot;org.apache.sling.api.resource.ValueMap&quot;</span> <span
class="na">var=</span><span class="s">&quot;myProps&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="call">call</h3>
+<p>Execute a script.</p>
+<ul>
+<li>Attributes<ul>
+<li>flush - Whether to flush the output before including the target.</li>
+<li>script - The script to include.</li>
+<li>ignoreComponentHierarchy - Controls if the component hierarchy should be ignored
for script resolution. If true, only the search paths are respected.</li>
+</ul>
+</li>
+<li>Since: 1.2</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">call</span>
<span class="n">script</span><span class="p">=</span>&quot;<span
class="n">myscript</span><span class="p">.</span><span class="n">jsp</span>&quot;
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="defineobjects">defineObjects</h3>
+<p>Defines regularly used scripting variables</p>
+<ul>
+<li>Attributes<ul>
+<li>requestName</li>
+<li>responseName</li>
+<li>resourceName</li>
+<li>nodeName</li>
+<li>logName</li>
+<li>resourceResolverName</li>
+<li>slingName</li>
+</ul>
+</li>
+<li>Since: 1.0</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">defineObjects</span>
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="eval">eval</h3>
+<p>Evaluates a script invocation and includes the result in the current page.</p>
+<ul>
+<li>Attributes<ul>
+<li>flush - Whether to flush the output before including the target.</li>
+<li>script - The path to the script object to include in the current request processing.
By default, the current resource is used for script resolving. This behaviour can be changed
by specifying either resource, resourceType or ignoreResourceTypeHierarchy.</li>
+<li>resource - The resource object to include in the current request processing. This
attribute is optional. If it is specified, resourceType should not be used. If both are used,
resource takes precedence.</li>
+<li>resourceType - The resource type of a resource to include. This attribute is optional.
If it is specified, resource should not be used. If both are used, resource takes precedence.</li>
+<li>ignoreResourceTypeHierarchy - Prevents using the resource type hierarchy for searching
a script.</li>
+</ul>
+</li>
+<li>Since: 1.1</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">eval</span>
<span class="n">script</span><span class="p">=</span>&quot;<span
class="n">myscript</span><span class="p">.</span><span class="n">jsp</span>&quot;
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="findresources_1">findResources</h3>
+<p>Tag for searching for resources using the given query formulated in the given language.</p>
+<ul>
+<li>Attributes<ul>
+<li>query - The query string to find the resources.</li>
+<li>language - The query language to use.</li>
+<li>var - The name of the variable to which to save the resources.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">findResources</span>
<span class="n">query</span><span class="p">=</span>&quot;<span
class="o">/</span><span class="n">jcr</span><span class="p">:</span><span
class="n">root</span><span class="o">//*</span><span class="p">[</span><span
class="n">jcr</span><span class="p">:</span><span class="n">contains</span><span
class="p">(.,</span> <span class="s">&#39;Sling&#39;</span><span
class="p">)]</span> <span class="n">order</span> <span class="n">by</span>
<span class="p">@</span><span class="n">jcr</span><span class="p">:</span><span
class="n">score</span>&quot; <span class="n">language</span><span
class="p">=</span>&quot;<span class="n">xpath</span>&quot; <span
class="n">var</span><span class="p">=</span>&quot;<span class="n">resources</span>&quot;
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="forward">forward</h3>
+<p>Forwards a request to a resource rendering the current page</p>
+<ul>
+<li>Attributes<ul>
+<li>resource - The resource object to forward the request to. Either resource or path
must be specified. If both are specified, the resource takes precedences.</li>
+<li>path - The path to the resource object to forward the request to. If this path
is relative it is appended to the path of the current resource whose script is forwarding
the given resource. Either resource or path must be specified. If both are specified, the
resource takes precedences.</li>
+<li>resourceType - The resource type of a resource to forward. If the resource to be
forwarded is specified with the path attribute, which cannot be resolved to a resource, the
tag may create a synthetic resource object out of the path and this resource type. If the
resource type is set the path must be the exact path to a resource object. That is, adding
parameters, selectors and extensions to the path is not supported if the resource type is
set.</li>
+<li>replaceSelectors - When dispatching, replace selectors by the value provided by
this option.</li>
+<li>addSelectors - When dispatching, add the value provided by this option to the selectors.</li>
+<li>replaceSuffix - When dispatching, replace the suffix by the value provided by this
option.</li>
+</ul>
+</li>
+<li>Since: 1.0</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">forward</span>
<span class="n">path</span><span class="p">=</span>&quot;<span
class="o">/</span><span class="n">content</span><span class="o">/</span><span
class="n">aresource</span>&quot; <span class="n">resourceType</span><span
class="p">=</span>&quot;<span class="n">myapp</span><span class="o">/</span><span
class="n">components</span><span class="o">/</span><span class="n">display</span>&quot;
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="getproperty">getProperty</h3>
+<p>Retrieves the value from the ValueMap, allowing for a default value or coercing
the return value.</p>
+<ul>
+<li>Attributes<ul>
+<li>properties - The ValueMap from which to retrieve the value.</li>
+<li>key - The key to retrieve the value from from the ValueMap.</li>
+<li>defaultValue - The default value to return if no value exists for the key. If specified,
this takes precedence over returnClass.</li>
+<li>returnClass - The class into which to coerce the returned value.</li>
+<li>var - The name of the variable to which to save the value.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;sling:getProperties</span>
<span class="na">properties=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">properties</span><span class="cp">}</span><span
class="s">&quot;</span> <span class="na">key=</span><span class="s">&quot;jcr:title&quot;</span>
<span class="na">defaultValue=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">resource</span><span class="o">.</span><span
class="n">name</span><span class="cp">}</span><span class="s">&quot;</span>
<span class="na">var=</span><span class="s">&quot;title&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="getresource_1">getResource</h3>
+<p>Retrieves resources based on either an absolute path or a relative path and a base
resource.</p>
+<ul>
+<li>Attributes<ul>
+<li>base - The base resource under which to retrieve the child resource, will only
be considered if a relative path is specified.</li>
+<li>path - The path of the resource to retrieve, if relative, the base resource must
be specified.</li>
+<li>defaultValue - The default value to return if no value exists for the key. If specified,
this takes precedence over returnClass.</li>
+<li>returnClass - The class into which to coerce the returned value.</li>
+<li>var - The name of the variable to which to save the resource.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;sling:getResource</span>
<span class="na">base=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">resource</span><span class="cp">}</span><span
class="s">&quot;</span> <span class="na">path=</span><span class="s">&quot;jcr:content&quot;</span>
<span class="na">var=</span><span class="s">&quot;content&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+
+
+<h3 id="include">include</h3>
+<p>Includes a resource rendering into the current page.</p>
+<ul>
+<li>Attributes<ul>
+<li>flush - Whether to flush the output before including the target.</li>
+<li>resource - The resource object to include in the current request processing. Either
resource or path must be specified. If both are specified, the resource takes precedences.</li>
+<li>path - The path to the resource object to include in the current request processing.
If this path is relative it is appended to the path of the current resource whose script is
including the given resource. Either resource or path must be specified. If both are specified,
the resource takes precedences.</li>
+<li>resourceType - The resource type of a resource to include. If the resource to be
included is specified with the path attribute, which cannot be resolved to a resource, the
tag may create a synthetic resource object out of the path and this resource type. If the
resource type is set the path must be the exact path to a resource object. That is, adding
parameters, selectors and extensions to the path is not supported if the resource type is
set.</li>
+<li>replaceSelectors - When dispatching, replace selectors by the value provided by
this option.</li>
+<li>addSelectors - When dispatching, add the value provided by this option to the selectors.</li>
+<li>replaceSuffix - When dispatching, replace the suffix by the value provided by this
option.</li>
+<li>scope - If var is specified, what scope to store the variable in. (Since 1.3)</li>
+<li>var - ariable name to store the resulting markup into (Since 1.3)</li>
+</ul>
+</li>
+<li>Since: 1.0</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="o">&lt;</span><span
class="n">sling</span><span class="p">:</span><span class="n">include</span>
<span class="n">path</span><span class="p">=</span>&quot;<span
class="o">/</span><span class="n">content</span><span class="o">/</span><span
class="n">aresource</span>&quot; <span class="n">resourceType</span><span
class="p">=</span>&quot;<span class="n">myapp</span><span class="o">/</span><span
class="n">components</span><span class="o">/</span><span class="n">display</span>&quot;
<span class="o">/&gt;</span>
+</pre></div>
+
+
+<h3 id="listchildren_1">listChildren</h3>
+<p>Lists the children of a Sling Resource.</p>
+<ul>
+<li>Attributes<ul>
+<li>resource - The resource for which to retrieve the children.</li>
+<li>var - The name of the variable to which to save the child resources.</li>
+</ul>
+</li>
+<li>Since: 1.3</li>
+</ul>
+<p><em>Example Usage</em></p>
+<div class="codehilite"><pre><span class="nt">&lt;sling:listChildren</span>
<span class="na">resource=</span><span class="s">&quot;</span><span
class="cp">${</span><span class="n">resource</span><span class="cp">}</span><span
class="s">&quot;</span> <span class="na">var=</span><span class="s">&quot;children&quot;</span>
<span class="nt">/&gt;</span>
+</pre></div>
+      <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+        Rev. 1512128 by dklco on Fri, 9 Aug 2013 02:31:53 +0000
+      </div>
+      <div class="trademarkFooter"> 
+        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.
+      </div>
+    </div>
+  </body>
+</html>

Modified: websites/staging/sling/trunk/content/documentation/tutorials-how-tos.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/tutorials-how-tos.html (original)
+++ websites/staging/sling/trunk/content/documentation/tutorials-how-tos.html Fri Aug  9 02:32:05
2013
@@ -88,7 +88,7 @@
       <ul>
 <li><a href="/documentation/tutorials-how-tos/46-line-blog.html">46 Line Blog</a></li>
 <li><a href="/documentation/tutorials-how-tos/getting-resources-and-properties-in-sling.html">Getting
Resources and Properties in Sling</a></li>
-<li><a href="/documentation/tutorials-how-tos/how-to-manage-events-in-sling.html">How
to Manage Events in Sling</a></li>
+<li><a href="/documentation/tutorials-how-tos/how-to-manage-events-in-sling.html">How
to Manage Job in Sling</a></li>
 <li><a href="/documentation/tutorials-how-tos/installing-and-upgrading-bundles.html">Installing
and Upgrading Bundles</a></li>
 <li><a href="/documentation/tutorials-how-tos/jackrabbit-persistence.html">Jackrabbit
Persistence</a></li>
 <li><a href="/documentation/tutorials-how-tos/testing-sling-based-applications.html">Testing
Sling-based applications</a></li>

Modified: websites/staging/sling/trunk/content/sitemap.html
==============================================================================
--- websites/staging/sling/trunk/content/sitemap.html (original)
+++ websites/staging/sling/trunk/content/sitemap.html Fri Aug  9 02:32:05 2013
@@ -107,6 +107,7 @@
 <li><a href="/documentation/bundles/request-analysis.html">Request Processing
Analyzer (reqanalyzer)</a></li>
 <li><a href="/documentation/bundles/scheduler-service-commons-scheduler.html">Scheduler
Service (commons scheduler)</a></li>
 <li><a href="/documentation/bundles/sling-health-check-tool.html">Sling Health
Check Tool</a></li>
+<li><a href="/documentation/bundles/sling-scripting-jsp-taglib.html">Sling Tag
Library</a></li>
 <li><a href="/documentation/bundles/sling-settings-org-apache-sling-settings.html">Sling
Settings (org.apache.sling.settings)</a></li>
 <li><a href="/documentation/bundles/web-console-extensions.html">Web Console
Extensions</a></li>
 <li><a href="/documentation/bundles/xml-support.html">XML support</a></li>
@@ -159,6 +160,7 @@
 <li><a href="/documentation/the-sling-engine/request-listeners.html">Request
Listeners</a></li>
 <li><a href="/documentation/the-sling-engine/request-parameters.html">Request
Parameter Handling in Sling</a></li>
 <li><a href="/documentation/the-sling-engine/resources.html">Resources</a></li>
+<li><a href="/documentation/the-sling-engine/service-authentication.html">Service
Authentication</a></li>
 <li><a href="/documentation/the-sling-engine/servlets.html">Servlets and Scripts</a></li>
 <li><a href="/documentation/the-sling-engine/sling-properties.html">Well-known
Sling Properties</a></li>
 <li><a href="/documentation/the-sling-engine/the-sling-launchpad.html">The Sling
Launchpad</a></li>
@@ -170,7 +172,7 @@
 <li><a href="/documentation/tutorials-how-tos.html">Tutorials & How-Tos</a><ul>
 <li><a href="/documentation/tutorials-how-tos/46-line-blog.html">46 Line Blog</a></li>
 <li><a href="/documentation/tutorials-how-tos/getting-resources-and-properties-in-sling.html">Getting
Resources and Properties in Sling</a></li>
-<li><a href="/documentation/tutorials-how-tos/how-to-manage-events-in-sling.html">How
to Manage Events in Sling</a></li>
+<li><a href="/documentation/tutorials-how-tos/how-to-manage-events-in-sling.html">How
to Manage Job in Sling</a></li>
 <li><a href="/documentation/tutorials-how-tos/installing-and-upgrading-bundles.html">Installing
and Upgrading Bundles</a></li>
 <li><a href="/documentation/tutorials-how-tos/jackrabbit-persistence.html">Jackrabbit
Persistence</a></li>
 <li><a href="/documentation/tutorials-how-tos/testing-sling-based-applications.html">Testing
Sling-based applications</a></li>



Mime
View raw message