You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2017/12/29 16:53:47 UTC
[2/2] juneau-website git commit: Update javadocs.
Update javadocs.
Project: http://git-wip-us.apache.org/repos/asf/juneau-website/repo
Commit: http://git-wip-us.apache.org/repos/asf/juneau-website/commit/64e02320
Tree: http://git-wip-us.apache.org/repos/asf/juneau-website/tree/64e02320
Diff: http://git-wip-us.apache.org/repos/asf/juneau-website/diff/64e02320
Branch: refs/heads/asf-site
Commit: 64e0232024ec16f5fd2892eadebb76b40a6defe0
Parents: a7eb348
Author: JamesBognar <ja...@apache.org>
Authored: Fri Dec 29 11:53:42 2017 -0500
Committer: JamesBognar <ja...@apache.org>
Committed: Fri Dec 29 11:53:42 2017 -0500
----------------------------------------------------------------------
.../juneau/rest/vars/RequestAttributeVar.html | 32 ++-
.../juneau/rest/vars/RequestFormDataVar.html | 34 ++-
.../juneau/rest/vars/RequestHeaderVar.html | 36 ++--
.../apache/juneau/rest/vars/RequestPathVar.html | 33 ++-
.../juneau/rest/vars/RequestQueryVar.html | 33 ++-
.../org/apache/juneau/rest/vars/RequestVar.html | 31 ++-
.../apache/juneau/rest/vars/RestInfoVar.html | 33 ++-
content/site/apidocs/overview-summary.html | 20 +-
.../juneau/rest/vars/RequestAttributeVar.html | 92 +++++----
.../juneau/rest/vars/RequestFormDataVar.html | 92 +++++----
.../juneau/rest/vars/RequestHeaderVar.html | 98 +++++----
.../apache/juneau/rest/vars/RequestPathVar.html | 95 +++++----
.../juneau/rest/vars/RequestQueryVar.html | 95 +++++----
.../org/apache/juneau/rest/vars/RequestVar.html | 205 +++++++++---------
.../apache/juneau/rest/vars/RestInfoVar.html | 207 ++++++++++---------
15 files changed, 652 insertions(+), 484 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestAttributeVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestAttributeVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestAttributeVar.html
index cf3c6c2..ebc50bf 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestAttributeVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestAttributeVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.36">RequestAttributeVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.48">RequestAttributeVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request attribute variable resolver.
@@ -132,10 +132,22 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<p>
Used to resolve values returned by <code>ServletRequest.getAttribute(String)</code>.
+ <br>When multiple keys are used, returns the first non-null/empty value.
+
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ String foo = restRequest.resolveVars(<js>"$RA{foo}"</js>);
+ String fooOrBar = restRequest.resolveVars(<js>"$RA{foo,bar}"</js>);
+ </p>
- <p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -272,7 +284,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.41">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.53">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -286,7 +298,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.45">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.57">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -308,7 +320,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestAttributeVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.50">RequestAttributeVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.62">RequestAttributeVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -326,7 +338,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.55">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.67">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -351,7 +363,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.60">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.72">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -381,7 +393,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.65">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html#line.77">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestFormDataVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestFormDataVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestFormDataVar.html
index 86dae97..72780e8 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestFormDataVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestFormDataVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.33">RequestFormDataVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.45">RequestFormDataVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request form data variable resolver.
@@ -132,10 +132,22 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<p>
Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getFormData-java.lang.String-"><code>RestRequest.getFormData(String)</code></a>.
-
- <p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <br>When multiple keys are used, returns the first non-null/empty value.
+
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ String foo = restRequest.resolveVars(<js>"$RF{foo}"</js>);
+ String fooOrBar = restRequest.resolveVars(<js>"$RF{foo,bar}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -272,7 +284,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.38">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.50">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -286,7 +298,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.42">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.54">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -308,7 +320,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestFormDataVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.47">RequestFormDataVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.59">RequestFormDataVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -326,7 +338,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.52">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.64">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -351,7 +363,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.57">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.69">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -381,7 +393,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.62">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html#line.74">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestHeaderVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestHeaderVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestHeaderVar.html
index 2e0c9a9..197cdbf 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestHeaderVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestHeaderVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.37">RequestHeaderVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.45">RequestHeaderVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request header variable resolver.
@@ -132,14 +132,22 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<p>
Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getHeader-java.lang.String-"><code>RestRequest.getHeader(String)</code></a>.
+ <br>When multiple keys are used, returns the first non-null/empty value.
- <p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.
-
- <p>
- Since this is a <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>, any variables contained in the result will be recursively resolved.
- Likewise, if the arguments contain any variables, those will be resolved before they are passed to this var.</div>
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ String foo = restRequest.resolveVars(<js>"$RH{Foo}"</js>);
+ String fooOrBar = restRequest.resolveVars(<js>"$RH{Foo,Bar}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -276,7 +284,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.42">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.50">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -290,7 +298,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.46">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.54">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -312,7 +320,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestHeaderVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.51">RequestHeaderVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.59">RequestHeaderVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -330,7 +338,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.56">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.64">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -355,7 +363,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.61">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.69">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -385,7 +393,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.66">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestHeaderVar.html#line.74">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestPathVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestPathVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestPathVar.html
index 4b9a2d7..edbb8b4 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestPathVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestPathVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.33">RequestPathVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.46">RequestPathVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request path variable resolver.
@@ -132,10 +132,23 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<p>
Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getPath-java.lang.String-"><code>RestRequest.getPath(String)</code></a>.
+ <br>When multiple keys are used, returns the first non-null/empty value.
- <p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ <jc>// URI path pattern = "/foo/{foo}/bar/{bar}"</jc>
+ String foo = restRequest.resolveVars(<js>"$RP{foo}"</js>);
+ String fooOrBar = restRequest.resolveVars(<js>"$RP{foo,bar}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -272,7 +285,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.38">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.51">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -286,7 +299,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.42">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.55">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -308,7 +321,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestPathVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.47">RequestPathVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.60">RequestPathVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -326,7 +339,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.52">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.65">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -351,7 +364,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.57">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.70">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -381,7 +394,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.62">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestPathVar.html#line.75">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestQueryVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestQueryVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestQueryVar.html
index 5d9b649..892319a 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestQueryVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestQueryVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.33">RequestQueryVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.46">RequestQueryVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request query variable resolver.
@@ -132,10 +132,23 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<p>
Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getQuery-java.lang.String-"><code>RestRequest.getQuery(String)</code></a>.
+ <br>When multiple keys are used, returns the first non-null/empty value.
- <p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ <jc>// URI = "...?foo=X&bar=Y"</jc>
+ String foo = restRequest.resolveVars(<js>"$RQ{foo}"</js>);
+ String fooOrBar = restRequest.resolveVars(<js>"$RQ{foo,bar}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -272,7 +285,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.38">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.51">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -286,7 +299,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.42">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.55">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -308,7 +321,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestQueryVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.47">RequestQueryVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.60">RequestQueryVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -326,7 +339,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.52">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.65">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -351,7 +364,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.57">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.70">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -381,7 +394,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.62">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestQueryVar.html#line.75">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RequestVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RequestVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RequestVar.html
index bfe5bb0..25fd9ad 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RequestVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RequestVar.html
@@ -123,12 +123,13 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.50">RequestVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.63">RequestVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Request attribute variable resolver.
<p>
The format for this var is <js>"$R{key1[,key2...]}"</js>.
+ <br>When multiple keys are used, returns the first non-null/empty value.
<p>
The possible values are:
@@ -149,8 +150,20 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
</ul>
<p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ String servletTitle = restRequest.resolveVars(<js>"$R{servletTitle}"</js>);
+ String servletTitleOrDescription = restRequest.resolveVars(<js>"$R{servletTitle,servletDescription}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -287,7 +300,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.55">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.68">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -301,7 +314,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.59">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.72">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -323,7 +336,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RequestVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.64">RequestVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.77">RequestVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -341,7 +354,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.69">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.82">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -366,7 +379,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.74">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.87">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -396,7 +409,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.79">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.92">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/org/apache/juneau/rest/vars/RestInfoVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/vars/RestInfoVar.html b/content/site/apidocs/org/apache/juneau/rest/vars/RestInfoVar.html
index b98254c..e745393 100644
--- a/content/site/apidocs/org/apache/juneau/rest/vars/RestInfoVar.html
+++ b/content/site/apidocs/org/apache/juneau/rest/vars/RestInfoVar.html
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.55">RestInfoVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.68">RestInfoVar</a>
extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html" title="class in org.apache.juneau.svl">MultipartResolvingVar</a></pre>
<div class="block">Rest info variable resolver.
@@ -131,7 +131,8 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
The format for this var is <js>"$RI{key1[,key2...]}"</js>.
<p>
- Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getInfoProvider--"><code>RestRequest.getInfoProvider()</code></a>.
+ Used to resolve values returned by <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getInfoProvider--"><code>RestRequest.getInfoProvider()</code></a>..
+ <br>When multiple keys are used, returns the first non-null/empty value.
<p>
The possible values are:
@@ -150,8 +151,20 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
</ul>
<p>
- This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver or a
- session object on the resolver session.</div>
+ <h6 class='figure'>Example:</h6>
+ <p class='bcode'>
+ String title = restRequest.resolveVars(<js>"$RI{title}"</js>);
+ String titleOrDescription = restRequest.resolveVars(<js>"$RI{title,description}"</js>);
+ </p>
+
+ <h6 class='topic'>Notes:</h6>
+ <ul class='spaced-list'>
+ <li>
+ This variable resolver requires that a <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object be set as a context object on the resolver
+ or a session object on the resolver session.
+ <li>
+ For security reasons, nested and recursive variables are not resolved.
+ </ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../org/apache/juneau/svl/package-summary.html"><code>org.apache.juneau.svl</code></a></dd>
@@ -288,7 +301,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>SESSION_req</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.60">SESSION_req</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.73">SESSION_req</a></pre>
<div class="block">The name of the session or context object that identifies the <a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest"><code>RestRequest</code></a> object.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -302,7 +315,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>NAME</h4>
-<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.64">NAME</a></pre>
+<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.77">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -324,7 +337,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>RestInfoVar</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.69">RestInfoVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.82">RestInfoVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -342,7 +355,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowNested</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.74">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.87">allowNested</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowNested--">Var</a></code></span></div>
<div class="block">Returns whether nested variables are supported by this variable.
@@ -367,7 +380,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockList">
<li class="blockList">
<h4>allowRecurse</h4>
-<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.79">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.92">allowRecurse</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#allowRecurse--">Var</a></code></span></div>
<div class="block">Returns whether variables in the resolved contents of this variable should also be resolved.
@@ -397,7 +410,7 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<ul class="blockListLast">
<li class="blockList">
<h4>resolve</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.84">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../src-html/org/apache/juneau/rest/vars/RestInfoVar.html#line.97">resolve</a>(<a href="../../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> session,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/svl/Var.html#resolve-org.apache.juneau.svl.VarResolverSession-java.lang.String-">Var</a></code></span></div>
<div class="block">The interface that needs to be implemented for subclasses of <a href="../../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/overview-summary.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/overview-summary.html b/content/site/apidocs/overview-summary.html
index a1790c3..eb1539e 100644
--- a/content/site/apidocs/overview-summary.html
+++ b/content/site/apidocs/overview-summary.html
@@ -8074,14 +8074,14 @@
<ul class='doctree'>
<li class='jp'><a href="org/apache/juneau/httppart/package-summary.html"><code>org.apache.juneau.httppart</code></a>
<ul>
- <li class='je'><a href="org/apache/juneau/httppart/HttpPartType.html" title="enum in org.apache.juneau.httppart"><code>HttpPartType</code></a>
- <li class='ji'><a href="org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart"><code>HttpPartSerializer</code></a>
+ <li class='jc'><a href="org/apache/juneau/httppart/HttpPartType.html" title="enum in org.apache.juneau.httppart"><code>HttpPartType</code></a>
+ <li class='jic'><a href="org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart"><code>HttpPartSerializer</code></a>
<ul>
<li class='jc'><a href="org/apache/juneau/httppart/UonPartSerializer.html" title="class in org.apache.juneau.httppart"><code>UonPartSerializer</code></a>
<li class='jc'><a href="org/apache/juneau/httppart/SimpleUonPartSerializer.html" title="class in org.apache.juneau.httppart"><code>SimpleUonPartSerializer</code></a>
<li class='jc'><a href="org/apache/juneau/httppart/SimplePartSerializer.html" title="class in org.apache.juneau.httppart"><code>SimplePartSerializer</code></a>
</ul>
- <li class='ji'><a href="org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart"><code>HttpPartParser</code></a>
+ <li class='jic'><a href="org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart"><code>HttpPartParser</code></a>
<ul>
<li class='jc'><a href="org/apache/juneau/httppart/UonPartParser.html" title="class in org.apache.juneau.httppart"><code>UonPartParser</code></a>
<li class='jc'><a href="org/apache/juneau/httppart/SimplePartParser.html" title="class in org.apache.juneau.httppart"><code>SimplePartParser</code></a>
@@ -8099,10 +8099,10 @@
<li>
The <js>"$R{...}"</js> variable has been split into the following:
<ul>
- <li><js>"$RA{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestAttributeVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestAttributeVar</code></a>, values returned by <code>HttpServletRequest.getAttribute(String)</code>.
- <li><js>"$RF{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestFormDataVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestFormDataVar</code></a>, values returned by <a href="org/apache/juneau/rest/RestRequest.html#getFormData-java.lang.String-"><code>RestRequest.getFormData(String)</code></a>.
- <li><js>"$RH{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestHeaderVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestHeaderVar</code></a>, values returned by <a href="org/apache/juneau/rest/RestRequest.html#getHeader-java.lang.String-"><code>RestRequest.getHeader(String)</code></a>.
- <li><js>"$RI{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RestInfoVar.html" title="class in org.apache.juneau.rest.vars"><code>RestInfoVar</code></a>, values returned by <a href="org/apache/juneau/rest/RestRequest.html#getInfoProvider--"><code>RestRequest.getInfoProvider()</code></a>.
+ <li><js>"$RA{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestAttributeVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestAttributeVar</code></a>, first non-null value returned by <code>HttpServletRequest.getAttribute(String)</code>.
+ <li><js>"$RF{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestFormDataVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestFormDataVar</code></a>, first non-null value returned by <a href="org/apache/juneau/rest/RestRequest.html#getFormData-java.lang.String-"><code>RestRequest.getFormData(String)</code></a>.
+ <li><js>"$RH{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestHeaderVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestHeaderVar</code></a>, first non-null value returned by <a href="org/apache/juneau/rest/RestRequest.html#getHeader-java.lang.String-"><code>RestRequest.getHeader(String)</code></a>.
+ <li><js>"$RI{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RestInfoVar.html" title="class in org.apache.juneau.rest.vars"><code>RestInfoVar</code></a>, first non-null value returned by <a href="org/apache/juneau/rest/RestRequest.html#getInfoProvider--"><code>RestRequest.getInfoProvider()</code></a>.
<br>The possible values are:
<ul>
<li><js>"contact"</js> - Value returned by <a href="org/apache/juneau/rest/RestInfoProvider.html#getContact-org.apache.juneau.rest.RestRequest-"><code>RestInfoProvider.getContact(RestRequest)</code></a>
@@ -8117,9 +8117,9 @@
<li><js>"title"</js> - See <a href="org/apache/juneau/rest/RestInfoProvider.html#getTitle-org.apache.juneau.rest.RestRequest-"><code>RestInfoProvider.getTitle(RestRequest)</code></a>
<li><js>"version"</js> - See <a href="org/apache/juneau/rest/RestInfoProvider.html#getVersion-org.apache.juneau.rest.RestRequest-"><code>RestInfoProvider.getVersion(RestRequest)</code></a>
</ul>
- <li><js>"$RP{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestPathVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestPathVar</code></a>, values returned by <a href="org/apache/juneau/rest/RestRequest.html#getPath-java.lang.String-"><code>RestRequest.getPath(String)</code></a>.
- <li><js>"$RQ{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestQueryVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestQueryVar</code></a>, values returned by <a href="org/apache/juneau/rest/RestRequest.html#getQuery-java.lang.String-"><code>RestRequest.getQuery(String)</code></a>
- <li><js>"$R{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestVar</code></a>, other request variables.
+ <li><js>"$RP{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestPathVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestPathVar</code></a>, first non-null value returned by <a href="org/apache/juneau/rest/RestRequest.html#getPath-java.lang.String-"><code>RestRequest.getPath(String)</code></a>.
+ <li><js>"$RQ{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestQueryVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestQueryVar</code></a>, first non-null value returned by <a href="org/apache/juneau/rest/RestRequest.html#getQuery-java.lang.String-"><code>RestRequest.getQuery(String)</code></a>
+ <li><js>"$R{key1[,key2...]}"</js> - <a href="org/apache/juneau/rest/vars/RequestVar.html" title="class in org.apache.juneau.rest.vars"><code>RequestVar</code></a>, first non-null other request variable.
<br>The possible values are:
<ul>
<li><js>"contextPath"</js> - Value returned by <a href="org/apache/juneau/rest/RestRequest.html#getContextPath--"><code>RestRequest.getContextPath()</code></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html b/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html
index 0ac60db..41cff0d 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestAttributeVar.html
@@ -34,47 +34,59 @@
<span class="sourceLineNo">026</span> * <a name="line.26"></a>
<span class="sourceLineNo">027</span> * <p><a name="line.27"></a>
<span class="sourceLineNo">028</span> * Used to resolve values returned by {@link HttpServletRequest#getAttribute(String)}.<a name="line.28"></a>
-<span class="sourceLineNo">029</span> *<a name="line.29"></a>
-<span class="sourceLineNo">030</span> * <p><a name="line.30"></a>
-<span class="sourceLineNo">031</span> * This variable resolver requires that a {@link RestRequest} object be set as a context object on the resolver or a<a name="line.31"></a>
-<span class="sourceLineNo">032</span> * session object on the resolver session.<a name="line.32"></a>
-<span class="sourceLineNo">033</span> *<a name="line.33"></a>
-<span class="sourceLineNo">034</span> * @see org.apache.juneau.svl<a name="line.34"></a>
-<span class="sourceLineNo">035</span> */<a name="line.35"></a>
-<span class="sourceLineNo">036</span>public class RequestAttributeVar extends MultipartResolvingVar {<a name="line.36"></a>
-<span class="sourceLineNo">037</span><a name="line.37"></a>
-<span class="sourceLineNo">038</span> /**<a name="line.38"></a>
-<span class="sourceLineNo">039</span> * The name of the session or context object that identifies the {@link RestRequest} object.<a name="line.39"></a>
-<span class="sourceLineNo">040</span> */<a name="line.40"></a>
-<span class="sourceLineNo">041</span> public static final String SESSION_req = "req";<a name="line.41"></a>
-<span class="sourceLineNo">042</span><a name="line.42"></a>
-<span class="sourceLineNo">043</span><a name="line.43"></a>
-<span class="sourceLineNo">044</span> /** The name of this variable. */<a name="line.44"></a>
-<span class="sourceLineNo">045</span> public static final String NAME = "RA";<a name="line.45"></a>
-<span class="sourceLineNo">046</span><a name="line.46"></a>
-<span class="sourceLineNo">047</span> /**<a name="line.47"></a>
-<span class="sourceLineNo">048</span> * Constructor.<a name="line.48"></a>
-<span class="sourceLineNo">049</span> */<a name="line.49"></a>
-<span class="sourceLineNo">050</span> public RequestAttributeVar() {<a name="line.50"></a>
-<span class="sourceLineNo">051</span> super(NAME);<a name="line.51"></a>
-<span class="sourceLineNo">052</span> }<a name="line.52"></a>
-<span class="sourceLineNo">053</span> <a name="line.53"></a>
-<span class="sourceLineNo">054</span> @Override /* Var */<a name="line.54"></a>
-<span class="sourceLineNo">055</span> protected boolean allowNested() {<a name="line.55"></a>
-<span class="sourceLineNo">056</span> return false;<a name="line.56"></a>
-<span class="sourceLineNo">057</span> }<a name="line.57"></a>
+<span class="sourceLineNo">029</span> * <br>When multiple keys are used, returns the first non-null/empty value.<a name="line.29"></a>
+<span class="sourceLineNo">030</span> * <a name="line.30"></a>
+<span class="sourceLineNo">031</span> * <h6 class='figure'>Example:</h6><a name="line.31"></a>
+<span class="sourceLineNo">032</span> * <p class='bcode'><a name="line.32"></a>
+<span class="sourceLineNo">033</span> * String foo = restRequest.resolveVars(<js>"$RA{foo}"</js>); <a name="line.33"></a>
+<span class="sourceLineNo">034</span> * String fooOrBar = restRequest.resolveVars(<js>"$RA{foo,bar}"</js>); <a name="line.34"></a>
+<span class="sourceLineNo">035</span> * </p><a name="line.35"></a>
+<span class="sourceLineNo">036</span> *<a name="line.36"></a>
+<span class="sourceLineNo">037</span> * <h6 class='topic'>Notes:</h6><a name="line.37"></a>
+<span class="sourceLineNo">038</span> * <ul class='spaced-list'><a name="line.38"></a>
+<span class="sourceLineNo">039</span> * <li><a name="line.39"></a>
+<span class="sourceLineNo">040</span> * This variable resolver requires that a {@link RestRequest} object be set as a context object on the resolver <a name="line.40"></a>
+<span class="sourceLineNo">041</span> * or a session object on the resolver session.<a name="line.41"></a>
+<span class="sourceLineNo">042</span> * <li><a name="line.42"></a>
+<span class="sourceLineNo">043</span> * For security reasons, nested and recursive variables are not resolved.<a name="line.43"></a>
+<span class="sourceLineNo">044</span> * </ul><a name="line.44"></a>
+<span class="sourceLineNo">045</span> *<a name="line.45"></a>
+<span class="sourceLineNo">046</span> * @see org.apache.juneau.svl<a name="line.46"></a>
+<span class="sourceLineNo">047</span> */<a name="line.47"></a>
+<span class="sourceLineNo">048</span>public class RequestAttributeVar extends MultipartResolvingVar {<a name="line.48"></a>
+<span class="sourceLineNo">049</span><a name="line.49"></a>
+<span class="sourceLineNo">050</span> /**<a name="line.50"></a>
+<span class="sourceLineNo">051</span> * The name of the session or context object that identifies the {@link RestRequest} object.<a name="line.51"></a>
+<span class="sourceLineNo">052</span> */<a name="line.52"></a>
+<span class="sourceLineNo">053</span> public static final String SESSION_req = "req";<a name="line.53"></a>
+<span class="sourceLineNo">054</span><a name="line.54"></a>
+<span class="sourceLineNo">055</span><a name="line.55"></a>
+<span class="sourceLineNo">056</span> /** The name of this variable. */<a name="line.56"></a>
+<span class="sourceLineNo">057</span> public static final String NAME = "RA";<a name="line.57"></a>
<span class="sourceLineNo">058</span><a name="line.58"></a>
-<span class="sourceLineNo">059</span> @Override /* Var */<a name="line.59"></a>
-<span class="sourceLineNo">060</span> protected boolean allowRecurse() {<a name="line.60"></a>
-<span class="sourceLineNo">061</span> return false;<a name="line.61"></a>
-<span class="sourceLineNo">062</span> }<a name="line.62"></a>
-<span class="sourceLineNo">063</span><a name="line.63"></a>
-<span class="sourceLineNo">064</span> @Override /* Parameter */<a name="line.64"></a>
-<span class="sourceLineNo">065</span> public String resolve(VarResolverSession session, String key) {<a name="line.65"></a>
-<span class="sourceLineNo">066</span> RestRequest req = session.getSessionObject(RestRequest.class, SESSION_req);<a name="line.66"></a>
-<span class="sourceLineNo">067</span> return StringUtils.toString(req.getAttribute(key));<a name="line.67"></a>
-<span class="sourceLineNo">068</span> }<a name="line.68"></a>
-<span class="sourceLineNo">069</span>}<a name="line.69"></a>
+<span class="sourceLineNo">059</span> /**<a name="line.59"></a>
+<span class="sourceLineNo">060</span> * Constructor.<a name="line.60"></a>
+<span class="sourceLineNo">061</span> */<a name="line.61"></a>
+<span class="sourceLineNo">062</span> public RequestAttributeVar() {<a name="line.62"></a>
+<span class="sourceLineNo">063</span> super(NAME);<a name="line.63"></a>
+<span class="sourceLineNo">064</span> }<a name="line.64"></a>
+<span class="sourceLineNo">065</span> <a name="line.65"></a>
+<span class="sourceLineNo">066</span> @Override /* Var */<a name="line.66"></a>
+<span class="sourceLineNo">067</span> protected boolean allowNested() {<a name="line.67"></a>
+<span class="sourceLineNo">068</span> return false;<a name="line.68"></a>
+<span class="sourceLineNo">069</span> }<a name="line.69"></a>
+<span class="sourceLineNo">070</span><a name="line.70"></a>
+<span class="sourceLineNo">071</span> @Override /* Var */<a name="line.71"></a>
+<span class="sourceLineNo">072</span> protected boolean allowRecurse() {<a name="line.72"></a>
+<span class="sourceLineNo">073</span> return false;<a name="line.73"></a>
+<span class="sourceLineNo">074</span> }<a name="line.74"></a>
+<span class="sourceLineNo">075</span><a name="line.75"></a>
+<span class="sourceLineNo">076</span> @Override /* Parameter */<a name="line.76"></a>
+<span class="sourceLineNo">077</span> public String resolve(VarResolverSession session, String key) {<a name="line.77"></a>
+<span class="sourceLineNo">078</span> RestRequest req = session.getSessionObject(RestRequest.class, SESSION_req);<a name="line.78"></a>
+<span class="sourceLineNo">079</span> return StringUtils.toString(req.getAttribute(key));<a name="line.79"></a>
+<span class="sourceLineNo">080</span> }<a name="line.80"></a>
+<span class="sourceLineNo">081</span>}<a name="line.81"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/64e02320/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html b/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html
index 20b420e..0ff602a 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/rest/vars/RequestFormDataVar.html
@@ -31,47 +31,59 @@
<span class="sourceLineNo">023</span> *<a name="line.23"></a>
<span class="sourceLineNo">024</span> * <p><a name="line.24"></a>
<span class="sourceLineNo">025</span> * Used to resolve values returned by {@link RestRequest#getFormData(String)}.<a name="line.25"></a>
-<span class="sourceLineNo">026</span> *<a name="line.26"></a>
-<span class="sourceLineNo">027</span> * <p><a name="line.27"></a>
-<span class="sourceLineNo">028</span> * This variable resolver requires that a {@link RestRequest} object be set as a context object on the resolver or a<a name="line.28"></a>
-<span class="sourceLineNo">029</span> * session object on the resolver session.<a name="line.29"></a>
-<span class="sourceLineNo">030</span> * <a name="line.30"></a>
-<span class="sourceLineNo">031</span> * @see org.apache.juneau.svl<a name="line.31"></a>
-<span class="sourceLineNo">032</span> */<a name="line.32"></a>
-<span class="sourceLineNo">033</span>public class RequestFormDataVar extends MultipartResolvingVar {<a name="line.33"></a>
-<span class="sourceLineNo">034</span><a name="line.34"></a>
-<span class="sourceLineNo">035</span> /**<a name="line.35"></a>
-<span class="sourceLineNo">036</span> * The name of the session or context object that identifies the {@link RestRequest} object.<a name="line.36"></a>
-<span class="sourceLineNo">037</span> */<a name="line.37"></a>
-<span class="sourceLineNo">038</span> public static final String SESSION_req = "req";<a name="line.38"></a>
-<span class="sourceLineNo">039</span><a name="line.39"></a>
-<span class="sourceLineNo">040</span><a name="line.40"></a>
-<span class="sourceLineNo">041</span> /** The name of this variable. */<a name="line.41"></a>
-<span class="sourceLineNo">042</span> public static final String NAME = "RF";<a name="line.42"></a>
-<span class="sourceLineNo">043</span><a name="line.43"></a>
-<span class="sourceLineNo">044</span> /**<a name="line.44"></a>
-<span class="sourceLineNo">045</span> * Constructor.<a name="line.45"></a>
-<span class="sourceLineNo">046</span> */<a name="line.46"></a>
-<span class="sourceLineNo">047</span> public RequestFormDataVar() {<a name="line.47"></a>
-<span class="sourceLineNo">048</span> super(NAME);<a name="line.48"></a>
-<span class="sourceLineNo">049</span> }<a name="line.49"></a>
-<span class="sourceLineNo">050</span> <a name="line.50"></a>
-<span class="sourceLineNo">051</span> @Override /* Var */<a name="line.51"></a>
-<span class="sourceLineNo">052</span> protected boolean allowNested() {<a name="line.52"></a>
-<span class="sourceLineNo">053</span> return false;<a name="line.53"></a>
-<span class="sourceLineNo">054</span> }<a name="line.54"></a>
+<span class="sourceLineNo">026</span> * <br>When multiple keys are used, returns the first non-null/empty value.<a name="line.26"></a>
+<span class="sourceLineNo">027</span> * <a name="line.27"></a>
+<span class="sourceLineNo">028</span> * <h6 class='figure'>Example:</h6><a name="line.28"></a>
+<span class="sourceLineNo">029</span> * <p class='bcode'><a name="line.29"></a>
+<span class="sourceLineNo">030</span> * String foo = restRequest.resolveVars(<js>"$RF{foo}"</js>); <a name="line.30"></a>
+<span class="sourceLineNo">031</span> * String fooOrBar = restRequest.resolveVars(<js>"$RF{foo,bar}"</js>); <a name="line.31"></a>
+<span class="sourceLineNo">032</span> * </p><a name="line.32"></a>
+<span class="sourceLineNo">033</span> * <a name="line.33"></a>
+<span class="sourceLineNo">034</span> * <h6 class='topic'>Notes:</h6><a name="line.34"></a>
+<span class="sourceLineNo">035</span> * <ul class='spaced-list'><a name="line.35"></a>
+<span class="sourceLineNo">036</span> * <li><a name="line.36"></a>
+<span class="sourceLineNo">037</span> * This variable resolver requires that a {@link RestRequest} object be set as a context object on the resolver <a name="line.37"></a>
+<span class="sourceLineNo">038</span> * or a session object on the resolver session.<a name="line.38"></a>
+<span class="sourceLineNo">039</span> * <li><a name="line.39"></a>
+<span class="sourceLineNo">040</span> * For security reasons, nested and recursive variables are not resolved.<a name="line.40"></a>
+<span class="sourceLineNo">041</span> * </ul><a name="line.41"></a>
+<span class="sourceLineNo">042</span> * <a name="line.42"></a>
+<span class="sourceLineNo">043</span> * @see org.apache.juneau.svl<a name="line.43"></a>
+<span class="sourceLineNo">044</span> */<a name="line.44"></a>
+<span class="sourceLineNo">045</span>public class RequestFormDataVar extends MultipartResolvingVar {<a name="line.45"></a>
+<span class="sourceLineNo">046</span><a name="line.46"></a>
+<span class="sourceLineNo">047</span> /**<a name="line.47"></a>
+<span class="sourceLineNo">048</span> * The name of the session or context object that identifies the {@link RestRequest} object.<a name="line.48"></a>
+<span class="sourceLineNo">049</span> */<a name="line.49"></a>
+<span class="sourceLineNo">050</span> public static final String SESSION_req = "req";<a name="line.50"></a>
+<span class="sourceLineNo">051</span><a name="line.51"></a>
+<span class="sourceLineNo">052</span><a name="line.52"></a>
+<span class="sourceLineNo">053</span> /** The name of this variable. */<a name="line.53"></a>
+<span class="sourceLineNo">054</span> public static final String NAME = "RF";<a name="line.54"></a>
<span class="sourceLineNo">055</span><a name="line.55"></a>
-<span class="sourceLineNo">056</span> @Override /* Var */<a name="line.56"></a>
-<span class="sourceLineNo">057</span> protected boolean allowRecurse() {<a name="line.57"></a>
-<span class="sourceLineNo">058</span> return false;<a name="line.58"></a>
-<span class="sourceLineNo">059</span> }<a name="line.59"></a>
-<span class="sourceLineNo">060</span><a name="line.60"></a>
-<span class="sourceLineNo">061</span> @Override /* Parameter */<a name="line.61"></a>
-<span class="sourceLineNo">062</span> public String resolve(VarResolverSession session, String key) {<a name="line.62"></a>
-<span class="sourceLineNo">063</span> RestRequest req = session.getSessionObject(RestRequest.class, SESSION_req);<a name="line.63"></a>
-<span class="sourceLineNo">064</span> return req.getFormData(key);<a name="line.64"></a>
-<span class="sourceLineNo">065</span> }<a name="line.65"></a>
-<span class="sourceLineNo">066</span>}<a name="line.66"></a>
+<span class="sourceLineNo">056</span> /**<a name="line.56"></a>
+<span class="sourceLineNo">057</span> * Constructor.<a name="line.57"></a>
+<span class="sourceLineNo">058</span> */<a name="line.58"></a>
+<span class="sourceLineNo">059</span> public RequestFormDataVar() {<a name="line.59"></a>
+<span class="sourceLineNo">060</span> super(NAME);<a name="line.60"></a>
+<span class="sourceLineNo">061</span> }<a name="line.61"></a>
+<span class="sourceLineNo">062</span> <a name="line.62"></a>
+<span class="sourceLineNo">063</span> @Override /* Var */<a name="line.63"></a>
+<span class="sourceLineNo">064</span> protected boolean allowNested() {<a name="line.64"></a>
+<span class="sourceLineNo">065</span> return false;<a name="line.65"></a>
+<span class="sourceLineNo">066</span> }<a name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span> @Override /* Var */<a name="line.68"></a>
+<span class="sourceLineNo">069</span> protected boolean allowRecurse() {<a name="line.69"></a>
+<span class="sourceLineNo">070</span> return false;<a name="line.70"></a>
+<span class="sourceLineNo">071</span> }<a name="line.71"></a>
+<span class="sourceLineNo">072</span><a name="line.72"></a>
+<span class="sourceLineNo">073</span> @Override /* Parameter */<a name="line.73"></a>
+<span class="sourceLineNo">074</span> public String resolve(VarResolverSession session, String key) {<a name="line.74"></a>
+<span class="sourceLineNo">075</span> RestRequest req = session.getSessionObject(RestRequest.class, SESSION_req);<a name="line.75"></a>
+<span class="sourceLineNo">076</span> return req.getFormData(key);<a name="line.76"></a>
+<span class="sourceLineNo">077</span> }<a name="line.77"></a>
+<span class="sourceLineNo">078</span>}<a name="line.78"></a>