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 2018/09/10 23:32:33 UTC
[juneau-website] branch asf-site updated: Javadocs
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/juneau-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 8598331 Javadocs
8598331 is described below
commit 8598331347d4fcb5df3075c9fce8abd58e9819c3
Author: JamesBognar <ja...@apache.org>
AuthorDate: Mon Sep 10 19:31:57 2018 -0400
Javadocs
---
content/site/apidocs_preview/constant-values.html | 26 +-
.../doc-files/juneau-rest-server.Swagger.1.png | Bin 0 -> 174380 bytes
.../doc-files/juneau-rest-server.Swagger.2.png | Bin 0 -> 194455 bytes
.../doc-files/juneau-rest-server.Swagger.3.png | Bin 0 -> 79498 bytes
.../doc-files/juneau-rest-server.Swagger.4.png | Bin 0 -> 99968 bytes
.../doc-files/juneau-rest-server.Swagger.5.png | Bin 0 -> 63056 bytes
content/site/apidocs_preview/index-all.html | 20 +-
.../juneau/jsonschema/JsonSchemaGenerator.html | 145 +-
.../jsonschema/JsonSchemaGeneratorSession.html | 24 +-
.../apache/juneau/rest/BasicRestInfoProvider.html | 90 +-
.../org/apache/juneau/rest/BasicRestServlet.html | 15 +-
.../apache/juneau/rest/RestContext.StaticFile.html | 4 +-
.../org/apache/juneau/rest/RestContext.html | 295 +-
.../org/apache/juneau/rest/RestInfoProvider.html | 70 +-
.../org/apache/juneau/rest/RestJavaMethod.html | 16 +-
.../org/apache/juneau/rest/RestRequest.html | 190 +-
.../org/apache/juneau/rest/vars/RequestVar.html | 15 +-
.../rest/widget/doc-files/ContentTypeMenuItem.png | Bin 137327 -> 0 bytes
.../widget/doc-files/PoweredByApacheWidget.png | Bin 4368 -> 0 bytes
.../widget/doc-files/PoweredByJuneauWidget.png | Bin 5081 -> 0 bytes
.../rest/widget/doc-files/QueryMenuItem_1.png | Bin 68449 -> 0 bytes
.../rest/widget/doc-files/QueryMenuItem_2.png | Bin 253370 -> 0 bytes
content/site/apidocs_preview/overview-summary.html | 693 +-
.../org/apache/juneau/BeanTraverseSession.html | 4 +-
.../juneau/jsonschema/JsonSchemaGenerator.html | 769 +-
.../jsonschema/JsonSchemaGeneratorSession.html | 665 +-
.../apache/juneau/rest/BasicRestInfoProvider.html | 829 +-
.../org/apache/juneau/rest/BasicRestServlet.html | 424 +-
.../apache/juneau/rest/RestContext.StaticFile.html | 9392 ++++++++++----------
.../org/apache/juneau/rest/RestContext.html | 9392 ++++++++++----------
.../apache/juneau/rest/RestInfoProvider.Null.html | 178 +-
.../org/apache/juneau/rest/RestInfoProvider.html | 178 +-
.../org/apache/juneau/rest/RestJavaMethod.html | 1258 ++-
.../org/apache/juneau/rest/RestRequest.html | 2486 +++---
.../org/apache/juneau/rest/vars/RequestVar.html | 191 +-
35 files changed, 13917 insertions(+), 13452 deletions(-)
diff --git a/content/site/apidocs_preview/constant-values.html b/content/site/apidocs_preview/constant-values.html
index b37fc18..dd182dd 100644
--- a/content/site/apidocs_preview/constant-values.html
+++ b/content/site/apidocs_preview/constant-values.html
@@ -1810,6 +1810,13 @@
<td class="colLast"><code>"JsonSchemaGenerator.defaultSchemas.smo"</code></td>
</tr>
<tr class="altColor">
+<td class="colFirst"><a name="org.apache.juneau.jsonschema.JsonSchemaGenerator.JSONSCHEMA_ignoreTypes">
+<!-- -->
+</a><code>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></code></td>
+<td><code><a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_ignoreTypes">JSONSCHEMA_ignoreTypes</a></code></td>
+<td class="colLast"><code>"JsonSchemaGenerator.ignoreTypes.s"</code></td>
+</tr>
+<tr class="rowColor">
<td class="colFirst"><a name="org.apache.juneau.jsonschema.JsonSchemaGenerator.JSONSCHEMA_useBeanDefs">
<!-- -->
</a><code>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></code></td>
@@ -2034,25 +2041,6 @@
<ul class="blockList">
<li class="blockList">
<table class="constantsSummary" border="0" cellpadding="3" cellspacing="0" summary="Constant Field Values table, listing constant fields, and values">
-<caption><span>org.apache.juneau.rest.<a href="org/apache/juneau/rest/BasicRestInfoProvider.html" title="class in org.apache.juneau.rest">BasicRestInfoProvider</a></span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colFirst" scope="col">Modifier and Type</th>
-<th scope="col">Constant Field</th>
-<th class="colLast" scope="col">Value</th>
-</tr>
-<tbody>
-<tr class="altColor">
-<td class="colFirst"><a name="org.apache.juneau.rest.BasicRestInfoProvider.INFOPROVIDER_ignoreTypes">
-<!-- -->
-</a><code>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></code></td>
-<td><code><a href="org/apache/juneau/rest/BasicRestInfoProvider.html#INFOPROVIDER_ignoreTypes">INFOPROVIDER_ignoreTypes</a></code></td>
-<td class="colLast"><code>"BasicRestInfoProvider.ignoreTypes.s"</code></td>
-</tr>
-</tbody>
-</table>
-</li>
-<li class="blockList">
-<table class="constantsSummary" border="0" cellpadding="3" cellspacing="0" summary="Constant Field Values table, listing constant fields, and values">
<caption><span>org.apache.juneau.rest.<a href="org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a></span><span class="tabEnd"> </span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
diff --git a/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.1.png b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.1.png
new file mode 100644
index 0000000..69b656f
Binary files /dev/null and b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.1.png differ
diff --git a/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.2.png b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.2.png
new file mode 100644
index 0000000..284fa85
Binary files /dev/null and b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.2.png differ
diff --git a/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.3.png b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.3.png
new file mode 100644
index 0000000..c642c41
Binary files /dev/null and b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.3.png differ
diff --git a/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.4.png b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.4.png
new file mode 100644
index 0000000..42762e0
Binary files /dev/null and b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.4.png differ
diff --git a/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.5.png b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.5.png
new file mode 100644
index 0000000..d889fa7
Binary files /dev/null and b/content/site/apidocs_preview/doc-files/juneau-rest-server.Swagger.5.png differ
diff --git a/content/site/apidocs_preview/index-all.html b/content/site/apidocs_preview/index-all.html
index 86d8f1d..6ae1f95 100644
--- a/content/site/apidocs_preview/index-all.html
+++ b/content/site/apidocs_preview/index-all.html
@@ -14615,10 +14615,6 @@
<dd>
<div class="block">[GET /jetty/dump] - Generates and retrieves the jetty thread dump.</div>
</dd>
-<dt><span class="memberNameLink"><a href="org/apache/juneau/rest/RestContext.html#getJsonSchemaGenerator--">getJsonSchemaGenerator()</a></span> - Method in class org.apache.juneau.rest.<a href="org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a></dt>
-<dd>
-<div class="block">Returns the JSON-Schema serializer associated with this resource.</div>
-</dd>
<dt><span class="memberNameLink"><a href="org/apache/juneau/json/JsonSerializerSession.html#getJsonWriter-org.apache.juneau.serializer.SerializerPipe-">getJsonWriter(SerializerPipe)</a></span> - Method in class org.apache.juneau.json.<a href="org/apache/juneau/json/JsonSerializerSession.html" title="class in org.apache.juneau.json">JsonSerializerSession</a></dt>
<dd>
<div class="block">Converts the specified output target object to an <a href="org/apache/juneau/json/JsonWriter.html" title="class in org.apache.juneau.json"><code>JsonWriter</code></a>.</div>
@@ -16319,6 +16315,10 @@
<dd>
<div class="block">Returns a read-only snapshot of the current property store on this builder.</div>
</dd>
+<dt><span class="memberNameLink"><a href="org/apache/juneau/rest/RestRequest.html#getPropertyStore--">getPropertyStore()</a></span> - Method in class org.apache.juneau.rest.<a href="org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a></dt>
+<dd>
+<div class="block">Returns the <a href="org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau"><code>PropertyStore</code></a> for this request.</div>
+</dd>
<dt><span class="memberNameLink"><a href="org/apache/juneau/ContextBuilder.html#getPropertyStoreBuilder--">getPropertyStoreBuilder()</a></span> - Method in class org.apache.juneau.<a href="org/apache/juneau/ContextBuilder.html" title="class in org.apache.juneau">ContextBuilder</a></dt>
<dd>
<div class="block">Returns access to the inner property store builder.</div>
@@ -20869,10 +20869,6 @@
<dd>
<div class="block">Configuration property: REST info provider.</div>
</dd>
-<dt><span class="memberNameLink"><a href="org/apache/juneau/rest/BasicRestInfoProvider.html#INFOPROVIDER_ignoreTypes">INFOPROVIDER_ignoreTypes</a></span> - Static variable in class org.apache.juneau.rest.<a href="org/apache/juneau/rest/BasicRestInfoProvider.html" title="class in org.apache.juneau.rest">BasicRestInfoProvider</a></dt>
-<dd>
-<div class="block">Configuration property: Ignore types from schema definitions.</div>
-</dd>
<dt><a href="org/apache/juneau/rest/Inherit.html" title="class in org.apache.juneau.rest"><span class="typeNameLink">Inherit</span></a> - Class in <a href="org/apache/juneau/rest/package-summary.html">org.apache.juneau.rest</a></dt>
<dd>
<div class="block">Dummy class that indicates that serializers, parsers, or transforms should be inherited from parent-class-to-class or class-to-method.</div>
@@ -21901,6 +21897,10 @@
<dd>
<div class="block">The ignore-case flag.</div>
</dd>
+<dt><span class="memberNameLink"><a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html#isIgnoredType-org.apache.juneau.ClassMeta-">isIgnoredType(ClassMeta<?>)</a></span> - Method in class org.apache.juneau.jsonschema.<a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a></dt>
+<dd>
+<div class="block">Returns <jk>true</jk> if the specified type is ignored.</div>
+</dd>
<dt><span class="memberNameLink"><a href="org/apache/juneau/BeanContext.html#isIgnoreInvocationExceptionsOnGetters--">isIgnoreInvocationExceptionsOnGetters()</a></span> - Method in class org.apache.juneau.<a href="org/apache/juneau/BeanContext.html" title="class in org.apache.juneau">BeanContext</a></dt>
<dd>
<div class="block">Configuration property: Ignore invocation errors on getters.</div>
@@ -22960,6 +22960,10 @@
<dd>
<div class="block">Configuration property: Default schemas.</div>
</dd>
+<dt><span class="memberNameLink"><a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_ignoreTypes">JSONSCHEMA_ignoreTypes</a></span> - Static variable in class org.apache.juneau.jsonschema.<a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a></dt>
+<dd>
+<div class="block">Configuration property: Ignore types from schema definitions.</div>
+</dd>
<dt><span class="memberNameLink"><a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_useBeanDefs">JSONSCHEMA_useBeanDefs</a></span> - Static variable in class org.apache.juneau.jsonschema.<a href="org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a></dt>
<dd>
<div class="block">Configuration property: Use bean definitions.</div>
diff --git a/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGenerator.html b/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
index ecfdda1..2f89212 100644
--- a/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
+++ b/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10};
+var methods = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10};
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -123,7 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.24">JsonSchemaGenerator</a>
+<pre>public class <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.27">JsonSchemaGenerator</a>
extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="class in org.apache.juneau">BeanTraverseContext</a></pre>
<div class="block">Generates JSON-schema metadata about POJOs.</div>
</li>
@@ -188,6 +188,12 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <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></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_ignoreTypes">JSONSCHEMA_ignoreTypes</a></span></code>
+<div class="block">Configuration property: Ignore types from schema definitions.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>static <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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_useBeanDefs">JSONSCHEMA_useBeanDefs</a></span></code>
<div class="block">Configuration property: Use bean definitions.</div>
</td>
@@ -302,6 +308,12 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
</td>
</tr>
<tr id="i10" class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html#isIgnoredType-org.apache.juneau.ClassMeta-">isIgnoredType</a></span>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</code>
+<div class="block">Returns <jk>true</jk> if the specified type is ignored.</div>
+</td>
+</tr>
+<tr id="i11" class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html#isUseBeanDefs--">isUseBeanDefs</a></span>()</code>
<div class="block">Configuration property: Use bean definitions.</div>
@@ -356,18 +368,18 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_addDescriptionsTo</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/jsonschema/JsonSchemaGenerator.html#line.67">JSONSCHEMA_addDescriptionsTo</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/jsonschema/JsonSchemaGenerator.html#line.70">JSONSCHEMA_addDescriptionsTo</a></pre>
<div class="block">Configuration property: Add descriptions to types.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.addDescriptionsTo.s"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.addDescriptionsTo.s"</js>
<li><b>Data type:</b> <code>String</code>
<li><b>Default:</b> Empty string.
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#addDescriptionsTo-java.lang.String-"><code>JsonSchemaSerializerBuilder.addDescriptionsTo(String)</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#addDescriptionsTo-java.lang.String-"><code>JsonSchemaGeneratorBuilder.addDescriptionsTo(String)</code></a>
</ul>
</ul>
@@ -402,18 +414,18 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_addExamplesTo</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/jsonschema/JsonSchemaGenerator.html#line.110">JSONSCHEMA_addExamplesTo</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/jsonschema/JsonSchemaGenerator.html#line.113">JSONSCHEMA_addExamplesTo</a></pre>
<div class="block">Configuration property: Add examples.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.addExamplesTo.s"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.addExamplesTo.s"</js>
<li><b>Data type:</b> <code>String</code>
<li><b>Default:</b> Empty string.
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#addExamplesTo-java.lang.String-"><code>JsonSchemaSerializerBuilder.addExamplesTo(String)</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#addExamplesTo-java.lang.String-"><code>JsonSchemaGeneratorBuilder.addExamplesTo(String)</code></a>
</ul>
</ul>
@@ -454,18 +466,18 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_allowNestedDescriptions</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/jsonschema/JsonSchemaGenerator.html#line.131">JSONSCHEMA_allowNestedDescriptions</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/jsonschema/JsonSchemaGenerator.html#line.134">JSONSCHEMA_allowNestedDescriptions</a></pre>
<div class="block">Configuration property: Allow nested descriptions.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.allowNestedDescriptions.b"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.allowNestedDescriptions.b"</js>
<li><b>Data type:</b> <code>Boolean</code>
<li><b>Default:</b> <jk>false</jk>
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#allowNestedDescriptions--"><code>JsonSchemaSerializerBuilder.allowNestedDescriptions()</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#allowNestedDescriptions--"><code>JsonSchemaGeneratorBuilder.allowNestedDescriptions()</code></a>
</ul>
</ul>
@@ -484,18 +496,18 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_allowNestedExamples</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/jsonschema/JsonSchemaGenerator.html#line.152">JSONSCHEMA_allowNestedExamples</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/jsonschema/JsonSchemaGenerator.html#line.155">JSONSCHEMA_allowNestedExamples</a></pre>
<div class="block">Configuration property: Allow nested examples.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.allowNestedExamples.b"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.allowNestedExamples.b"</js>
<li><b>Data type:</b> <code>Boolean</code>
<li><b>Default:</b> <jk>false</jk>
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#allowNestedExamples--"><code>JsonSchemaSerializerBuilder.allowNestedExamples()</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#allowNestedExamples--"><code>JsonSchemaGeneratorBuilder.allowNestedExamples()</code></a>
</ul>
</ul>
@@ -514,19 +526,19 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_beanDefMapper</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/jsonschema/JsonSchemaGenerator.html#line.178">JSONSCHEMA_beanDefMapper</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/jsonschema/JsonSchemaGenerator.html#line.181">JSONSCHEMA_beanDefMapper</a></pre>
<div class="block">Configuration property: Bean schema definition mapper.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.beanDefMapper.o"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.beanDefMapper.o"</js>
<li><b>Data type:</b> <a href="../../../../org/apache/juneau/jsonschema/BeanDefMapper.html" title="interface in org.apache.juneau.jsonschema"><code>BeanDefMapper</code></a>
<li><b>Default:</b> <a href="../../../../org/apache/juneau/jsonschema/BasicBeanDefMapper.html" title="class in org.apache.juneau.jsonschema"><code>BasicBeanDefMapper</code></a>
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#beanDefMapper-java.lang.Class-"><code>JsonSchemaSerializerBuilder.beanDefMapper(Class)</code></a>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#beanDefMapper-org.apache.juneau.jsonschema.BeanDefMapper-"><code>JsonSchemaSerializerBuilder.beanDefMapper(BeanDefMapper)</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#beanDefMapper-java.lang.Class-"><code>JsonSchemaGeneratorBuilder.beanDefMapper(Class)</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#beanDefMapper-org.apache.juneau.jsonschema.BeanDefMapper-"><code>JsonSchemaGeneratorBuilder.beanDefMapper(BeanDefMapper)</code></a>
</ul>
</ul>
@@ -549,18 +561,18 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_defaultSchemas</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/jsonschema/JsonSchemaGenerator.html#line.201">JSONSCHEMA_defaultSchemas</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/jsonschema/JsonSchemaGenerator.html#line.204">JSONSCHEMA_defaultSchemas</a></pre>
<div class="block">Configuration property: Default schemas.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.defaultSchema.smo"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.defaultSchema.smo"</js>
<li><b>Data type:</b> <code>Map<String,ObjectMap></code>
<li><b>Default:</b> Empty map.
<li><b>Session property:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#defaultSchema-java.lang.Class-org.apache.juneau.ObjectMap-"><code>JsonSchemaSerializerBuilder.defaultSchema(Class,ObjectMap)</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#defaultSchema-java.lang.Class-org.apache.juneau.ObjectMap-"><code>JsonSchemaGeneratorBuilder.defaultSchema(Class,ObjectMap)</code></a>
</ul>
</ul>
@@ -575,23 +587,60 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
</dl>
</li>
</ul>
+<a name="JSONSCHEMA_ignoreTypes">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>JSONSCHEMA_ignoreTypes</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/jsonschema/JsonSchemaGenerator.html#line.232">JSONSCHEMA_ignoreTypes</a></pre>
+<div class="block">Configuration property: Ignore types from schema definitions.
+
+ <h5 class='section'>Property:</h5>
+ <ul>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.ignoreTypes.s"</js>
+ <li><b>Data type:</b> <code>String</code> (comma-delimited)
+ <li><b>Default:</b> <jk>null</jk>.
+ <li><b>Session property:</b> <jk>false</jk>
+ </ul>
+
+ <h5 class='section'>Description:</h5>
+ <p>
+ Defines class name patterns that should be ignored when generating schema definitions in the generated
+ Swagger documentation.
+
+ <h5 class='section'>Example:</h5>
+ <p class='bcode w800'>
+ <jc>// Don't generate schema for any prototype packages or the class named 'Swagger'.
+ <ja>@RestResource</ja>(
+ properties={
+ <ja>@Property</ja>(name=<jsf>INFOPROVIDER_ignoreTypes</jsf>, value=<js>"Swagger,*.proto.*"</js>)
+ }
+ <jk>public class</jk> MyResource {...}
+ </p></div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../../../constant-values.html#org.apache.juneau.jsonschema.JsonSchemaGenerator.JSONSCHEMA_ignoreTypes">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
<a name="JSONSCHEMA_useBeanDefs">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>JSONSCHEMA_useBeanDefs</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/jsonschema/JsonSchemaGenerator.html#line.232">JSONSCHEMA_useBeanDefs</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/jsonschema/JsonSchemaGenerator.html#line.263">JSONSCHEMA_useBeanDefs</a></pre>
<div class="block">Configuration property: Use bean definitions.
<h5 class='section'>Property:</h5>
<ul>
- <li><b>Name:</b> <js>"JsonSchemaSerializer.useBeanDefs.o"</js>
+ <li><b>Name:</b> <js>"JsonSchemaGenerator.useBeanDefs.o"</js>
<li><b>Data type:</b> <code>Boolean</code>
<li><b>Default:</b> <jk>false</jk>
<li><b>Methods:</b>
<ul>
- <li class='jm'><a href="../../../../org/apache/juneau/json/JsonSchemaSerializerBuilder.html#useBeanDefs--"><code>JsonSchemaSerializerBuilder.useBeanDefs()</code></a>
+ <li class='jm'><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html#useBeanDefs--"><code>JsonSchemaGeneratorBuilder.useBeanDefs()</code></a>
</ul>
</ul>
@@ -621,7 +670,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockListLast">
<li class="blockList">
<h4>DEFAULT</h4>
-<pre>public static final <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.240">DEFAULT</a></pre>
+<pre>public static final <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.271">DEFAULT</a></pre>
<div class="block">Default serializer, all default settings.</div>
</li>
</ul>
@@ -639,7 +688,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockListLast">
<li class="blockList">
<h4>JsonSchemaGenerator</h4>
-<pre>public <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.258">JsonSchemaGenerator</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> ps)</pre>
+<pre>public <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.290">JsonSchemaGenerator</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> ps)</pre>
<div class="block">Constructor.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -661,7 +710,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>builder</h4>
-<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorBuilder</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.272">builder</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorBuilder</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.310">builder</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/Context.html#builder--">Context</a></code></span></div>
<div class="block">Creates a builder from this context object.
@@ -681,7 +730,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>create</h4>
-<pre>public static <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorBuilder</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.284">create</a>()</pre>
+<pre>public static <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorBuilder.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorBuilder</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.322">create</a>()</pre>
<div class="block">Instantiates a new clean-slate <a href="../../../../org/apache/juneau/json/JsonSerializerBuilder.html" title="class in org.apache.juneau.json"><code>JsonSerializerBuilder</code></a> object.
<p>
@@ -698,7 +747,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.289">createSession</a>(<a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> args)</pre>
+<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.327">createSession</a>(<a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> args)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/BeanContext.html#createSession-org.apache.juneau.BeanSessionArgs-">BeanContext</a></code></span></div>
<div class="block">Create a new bean session based on the properties defined on this context combined with the specified
runtime args.
@@ -722,7 +771,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.294">createSession</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.332">createSession</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/BeanContext.html#createSession--">BeanContext</a></code></span></div>
<div class="block">Create a new bean session based on the properties defined on this context.
@@ -743,7 +792,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isUseBeanDefs</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.313">isUseBeanDefs</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.351">isUseBeanDefs</a>()</pre>
<div class="block">Configuration property: Use bean definitions.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -759,7 +808,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isAllowNestedExamples</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.324">isAllowNestedExamples</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.362">isAllowNestedExamples</a>()</pre>
<div class="block">Configuration property: Allow nested examples.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -775,7 +824,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isAllowNestedDescriptions</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.335">isAllowNestedDescriptions</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.373">isAllowNestedDescriptions</a>()</pre>
<div class="block">Configuration property: Allow nested descriptions.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -791,7 +840,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefMapper</h4>
-<pre>protected final <a href="../../../../org/apache/juneau/jsonschema/BeanDefMapper.html" title="interface in org.apache.juneau.jsonschema">BeanDefMapper</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.346">getBeanDefMapper</a>()</pre>
+<pre>protected final <a href="../../../../org/apache/juneau/jsonschema/BeanDefMapper.html" title="interface in org.apache.juneau.jsonschema">BeanDefMapper</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.384">getBeanDefMapper</a>()</pre>
<div class="block">Configuration property: Bean schema definition mapper.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -807,7 +856,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getAddExamplesTo</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.357">getAddExamplesTo</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.395">getAddExamplesTo</a>()</pre>
<div class="block">Configuration property: Add examples.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -823,7 +872,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getAddDescriptionsTo</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.368">getAddDescriptionsTo</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.406">getAddDescriptionsTo</a>()</pre>
<div class="block">Configuration property: Add descriptions to types.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -836,10 +885,10 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
<a name="getDefaultSchemas--">
<!-- -->
</a>
-<ul class="blockListLast">
+<ul class="blockList">
<li class="blockList">
<h4>getDefaultSchemas</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGener [...]
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGener [...]
<div class="block">Configuration property: Default schemas.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -849,6 +898,26 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseContext.html" title="
</dl>
</li>
</ul>
+<a name="isIgnoredType-org.apache.juneau.ClassMeta-">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>isIgnoredType</h4>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html#line.431">isIgnoredType</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</pre>
+<div class="block">Returns <jk>true</jk> if the specified type is ignored.
+
+ <p>
+ The type is ignored if it's specified in the <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html#JSONSCHEMA_ignoreTypes"><code>JSONSCHEMA_ignoreTypes</code></a> setting.
+ <br>Ignored types return <jk>null</jk> on the call to <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#getSchema-org.apache.juneau.ClassMeta-"><code>JsonSchemaGeneratorSession.getSchema(ClassMeta)</code></a>.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>cm</code> - The type to check.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd><jk>true</jk> if the specified type is ignored.</dd>
+</dl>
+</li>
+</ul>
</li>
</ul>
</li>
diff --git a/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html b/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
index 8c90123..6aec7da 100644
--- a/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
+++ b/content/site/apidocs_preview/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
@@ -411,7 +411,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefId</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/jsonschema/JsonSchemaGeneratorSession.html#line.303">getBeanDefId</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</pre>
+<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/jsonschema/JsonSchemaGeneratorSession.html#line.306">getBeanDefId</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</pre>
<div class="block">Returns the definition ID for the specified class.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -427,7 +427,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefUri</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.313">getBeanDefUri</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.316">getBeanDefUri</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm)</pre>
<div class="block">Returns the definition URI for the specified class.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -443,7 +443,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefUri</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.323">getBeanDefUri</a>(<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> id)</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.326">getBeanDefUri</a>(<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> id)</pre>
<div class="block">Returns the definition URI for the specified class.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -459,7 +459,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefs</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSessi [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSessi [...]
<div class="block">Returns the definitions that were gathered during this session.
<p>
@@ -476,7 +476,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>addBeanDef</h4>
-<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.347">addBeanDef</a>(<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> id,
+<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGeneratorSession</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.350">addBeanDef</a>(<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> id,
<a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> def)</pre>
<div class="block">Adds a schema definition to this session.</div>
<dl>
@@ -494,7 +494,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isUseBeanDefs</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.364">isUseBeanDefs</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.367">isUseBeanDefs</a>()</pre>
<div class="block">Configuration property: Use bean definitions.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -510,7 +510,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isAllowNestedExamples</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.375">isAllowNestedExamples</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.378">isAllowNestedExamples</a>()</pre>
<div class="block">Configuration property: Allow nested examples.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -526,7 +526,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>isAllowNestedDescriptions</h4>
-<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.386">isAllowNestedDescriptions</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.389">isAllowNestedDescriptions</a>()</pre>
<div class="block">Configuration property: Allow nested descriptions.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -542,7 +542,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getBeanDefMapper</h4>
-<pre>protected final <a href="../../../../org/apache/juneau/jsonschema/BeanDefMapper.html" title="interface in org.apache.juneau.jsonschema">BeanDefMapper</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.397">getBeanDefMapper</a>()</pre>
+<pre>protected final <a href="../../../../org/apache/juneau/jsonschema/BeanDefMapper.html" title="interface in org.apache.juneau.jsonschema">BeanDefMapper</a> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.400">getBeanDefMapper</a>()</pre>
<div class="block">Configuration property: Bean schema definition mapper.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -558,7 +558,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getAddExamplesTo</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.408">getAddExamplesTo</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.411">getAddExamplesTo</a>()</pre>
<div class="block">Configuration property: Add examples.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -574,7 +574,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockList">
<li class="blockList">
<h4>getAddDescriptionsTo</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.419">getAddDescriptionsTo</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="../../../../org/apache/juneau/jsonschema/TypeCategory.html" title="enum in org.apache.juneau.jsonschema">TypeCategory</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html#line.422">getAddDescriptionsTo</a>()</pre>
<div class="block">Configuration property: Add descriptions to types.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -590,7 +590,7 @@ extends <a href="../../../../org/apache/juneau/BeanTraverseSession.html" title="
<ul class="blockListLast">
<li class="blockList">
<h4>getDefaultSchemas</h4>
-<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGener [...]
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a>> <a href="../../../../src-html/org/apache/juneau/jsonschema/JsonSchemaGener [...]
<div class="block">Configuration property: Default schemas.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestInfoProvider.html b/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestInfoProvider.html
index a59830b..affd27d 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestInfoProvider.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestInfoProvider.html
@@ -74,13 +74,13 @@ var activeTableTab = "activeTableTab";
<ul class="subNavList">
<li>Summary: </li>
<li>Nested | </li>
-<li><a href="#field.summary">Field</a> | </li>
+<li>Field | </li>
<li><a href="#constructor.summary">Constr</a> | </li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
-<li><a href="#field.detail">Field</a> | </li>
+<li>Field | </li>
<li><a href="#constructor.detail">Constr</a> | </li>
<li><a href="#method.detail">Method</a></li>
</ul>
@@ -112,7 +112,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>public class <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.41">BasicRestInfoProvider</a>
+<pre>public class <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.39">BasicRestInfoProvider</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest">RestInfoProvider</a></pre>
<div class="block">Default implementation of <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest"><code>RestInfoProvider</code></a>.
@@ -146,27 +146,6 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
</ul>
</li>
</ul>
-<!-- =========== FIELD SUMMARY =========== -->
-<ul class="blockList">
-<li class="blockList"><a name="field.summary">
-<!-- -->
-</a>
-<h3>Field Summary</h3>
-<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
-<caption><span>Fields</span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colFirst" scope="col">Modifier and Type</th>
-<th class="colLast" scope="col">Field and Description</th>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>static <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></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/BasicRestInfoProvider.html#INFOPROVIDER_ignoreTypes">INFOPROVIDER_ignoreTypes</a></span></code>
-<div class="block">Configuration property: Ignore types from schema definitions.</div>
-</td>
-</tr>
-</table>
-</li>
-</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
@@ -252,51 +231,6 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<div class="details">
<ul class="blockList">
<li class="blockList">
-<!-- ============ FIELD DETAIL =========== -->
-<ul class="blockList">
-<li class="blockList"><a name="field.detail">
-<!-- -->
-</a>
-<h3>Field Detail</h3>
-<a name="INFOPROVIDER_ignoreTypes">
-<!-- -->
-</a>
-<ul class="blockListLast">
-<li class="blockList">
-<h4>INFOPROVIDER_ignoreTypes</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/BasicRestInfoProvider.html#line.75">INFOPROVIDER_ignoreTypes</a></pre>
-<div class="block">Configuration property: Ignore types from schema definitions.
-
- <h5 class='section'>Property:</h5>
- <ul>
- <li><b>Name:</b> <js>"BasicRestInfoProvider.ignoreTypes.s"</js>
- <li><b>Data type:</b> <code>String</code> (comma-delimited)
- <li><b>Default:</b> <jk>null</jk>.
- <li><b>Session property:</b> <jk>false</jk>
- </ul>
-
- <h5 class='section'>Description:</h5>
- <p>
- Defines class name patterns that should be ignored when generating schema definitions in the generated
- Swagger documentation.
-
- <h5 class='section'>Example:</h5>
- <p class='bcode w800'>
- <jc>// Don't generate schema for any prototype packages or the class named 'Swagger'.
- <ja>@RestResource</ja>(
- properties={
- <ja>@Property</ja>(name=<jsf>INFOPROVIDER_ignoreTypes</jsf>, value=<js>"Swagger,*.proto.*"</js>)
- }
- <jk>public class</jk> MyResource {...}
- </p></div>
-<dl>
-<dt><span class="seeLabel">See Also:</span></dt>
-<dd><a href="../../../../constant-values.html#org.apache.juneau.rest.BasicRestInfoProvider.INFOPROVIDER_ignoreTypes">Constant Field Values</a></dd>
-</dl>
-</li>
-</ul>
-</li>
-</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
@@ -309,7 +243,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockListLast">
<li class="blockList">
<h4>BasicRestInfoProvider</h4>
-<pre>public <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.91">BasicRestInfoProvider</a>(<a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> context)</pre>
+<pre>public <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.53">BasicRestInfoProvider</a>(<a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> context)</pre>
<div class="block">Constructor.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -331,7 +265,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockList">
<li class="blockList">
<h4>getSwagger</h4>
-<pre>public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.136">getSwagger</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<pre>public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/BasicRestInfoProvider.html#line.93">getSwagger</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized swagger for this REST resource.
@@ -356,7 +290,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockList">
<li class="blockList">
<h4>getMethodSummary</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/BasicRestInfoProvider.html#line.206">getMethodSummary</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
+<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/BasicRestInfoProvider.html#line.163">getMethodSummary</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized summary of the specified java method on this servlet.
@@ -413,7 +347,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockList">
<li class="blockList">
<h4>getMethodDescription</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/BasicRestInfoProvider.html#line.262">getMethodDescription</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
+<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/BasicRestInfoProvider.html#line.219">getMethodDescription</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized description of the specified java method on this servlet.
@@ -470,7 +404,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockList">
<li class="blockList">
<h4>getSiteName</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/BasicRestInfoProvider.html#line.317">getSiteName</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<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/BasicRestInfoProvider.html#line.274">getSiteName</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized site name of this REST resource.
@@ -525,7 +459,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockList">
<li class="blockList">
<h4>getTitle</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/BasicRestInfoProvider.html#line.370">getTitle</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<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/BasicRestInfoProvider.html#line.327">getTitle</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized title of this REST resource.
@@ -581,7 +515,7 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="blockListLast">
<li class="blockList">
<h4>getDescription</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/BasicRestInfoProvider.html#line.426">getDescription</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<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/BasicRestInfoProvider.html#line.383">getDescription</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns the localized description of this REST resource.
@@ -684,13 +618,13 @@ implements <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" ti
<ul class="subNavList">
<li>Summary: </li>
<li>Nested | </li>
-<li><a href="#field.summary">Field</a> | </li>
+<li>Field | </li>
<li><a href="#constructor.summary">Constr</a> | </li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
-<li><a href="#field.detail">Field</a> | </li>
+<li>Field | </li>
<li><a href="#constructor.detail">Constr</a> | </li>
<li><a href="#method.detail">Method</a></li>
</ul>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestServlet.html b/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestServlet.html
index 35f724d..f89ab83 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestServlet.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/BasicRestServlet.html
@@ -131,8 +131,9 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre><a href="../../../../org/apache/juneau/rest/annotation/RestResource.html" title="annotation in org.apache.juneau.rest.annotation">@RestResource</a>(<a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#allowedMethodParams--">allowedMethodParams</a>="OPTIONS",<a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#htmldoc--">htmldoc</a>=<a href="../../../../org/apache/juneau/rest/annotation/HtmlDoc.html" title="annotation in org.apache.juneau.rest. [...]
-public abstract class <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.206">BasicRestServlet</a>
+<pre><a href="../../../../org/apache/juneau/rest/annotation/RestResource.html" title="annotation in org.apache.juneau.rest.annotation">@RestResource</a>(<a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#allowedMethodParams--">allowedMethodParams</a>="OPTIONS",
+ <a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#htmldoc--">htmldoc</a>=)
+public abstract class <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.181">BasicRestServlet</a>
extends <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest">RestServlet</a>
implements <a href="../../../../org/apache/juneau/rest/BasicRestConfig.html" title="interface in org.apache.juneau.rest">BasicRestConfig</a></pre>
<div class="block">Subclass of <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest"><code>RestServlet</code></a> with default serializers and parsers defined.
@@ -363,7 +364,7 @@ implements <a href="../../../../org/apache/juneau/rest/BasicRestConfig.html" tit
<ul class="blockListLast">
<li class="blockList">
<h4>BasicRestServlet</h4>
-<pre>public <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.206">BasicRestServlet</a>()</pre>
+<pre>public <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.181">BasicRestServlet</a>()</pre>
</li>
</ul>
</li>
@@ -380,12 +381,8 @@ implements <a href="../../../../org/apache/juneau/rest/BasicRestConfig.html" tit
<ul class="blockListLast">
<li class="blockList">
<h4>getOptions</h4>
-<pre><a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html" title="annotation in org.apache.juneau.rest.annotation">@RestMethod</a>(<a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#name--">name</a>="OPTIONS",
- <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#path--">path</a>="/*",
- <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#summary--">summary</a>="Swagger documentation",
- <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#description--">description</a>="Swagger documentation for this resource.",
- <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#htmldoc--">htmldoc</a>=)
-public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.228">getOptions</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)</pre>
+<pre><a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html" title="annotation in org.apache.juneau.rest.annotation">@RestMethod</a>(<a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#name--">name</a>="OPTIONS",<a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#path--">path</a>="/*",<a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html#summary--">summary</a>="Swagger documentation",<a href="../../../../org/apache/ju [...]
+public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/BasicRestServlet.html#line.230">getOptions</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)</pre>
<div class="block">[OPTIONS /*] - Show resource options.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.StaticFile.html b/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.StaticFile.html
index 213081b..24c7e9f 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.StaticFile.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.StaticFile.html
@@ -106,7 +106,7 @@
</dl>
<hr>
<br>
-<pre>protected class <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3599">RestContext.StaticFile</a>
+<pre>protected class <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3596">RestContext.StaticFile</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">A cached static file instance.</div>
</li>
@@ -169,7 +169,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<ul class="blockListLast">
<li class="blockList">
<h4>StaticFile</h4>
-<pre>protected <a href="../../../../src-html/org/apache/juneau/rest/RestContext.StaticFile.html#line.3608">StaticFile</a>(<a href="../../../../org/apache/juneau/rest/helper/StreamResource.html" title="class in org.apache.juneau.rest.helper">StreamResource</a> resource)</pre>
+<pre>protected <a href="../../../../src-html/org/apache/juneau/rest/RestContext.StaticFile.html#line.3605">StaticFile</a>(<a href="../../../../org/apache/juneau/rest/helper/StreamResource.html" title="class in org.apache.juneau.rest.helper">StreamResource</a> resource)</pre>
<div class="block">Constructor.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.html b/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.html
index 5418b59..867cc82 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/RestContext.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":10,"i2":9,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i [...]
+var methods = {"i0":10,"i1":10,"i2":9,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i [...]
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -118,7 +118,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public final class <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.75">RestContext</a>
+<pre>public final class <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.74">RestContext</a>
extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in org.apache.juneau">BeanContext</a></pre>
<div class="block">Contains all the configuration on a REST resource and the entry points for handling REST calls.
@@ -617,211 +617,205 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
</td>
</tr>
<tr id="i29" class="rowColor">
-<td class="colFirst"><code><a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getJsonSchemaGenerator--">getJsonSchemaGenerator</a></span>()</code>
-<div class="block">Returns the JSON-Schema serializer associated with this resource.</div>
-</td>
-</tr>
-<tr id="i30" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestLogger.html" title="interface in org.apache.juneau.rest">RestLogger</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getLogger--">getLogger</a></span>()</code>
<div class="block">Returns the logger to use for this resource.</div>
</td>
</tr>
-<tr id="i31" class="rowColor">
+<tr id="i30" class="altColor">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getMaxInput--">getMaxInput</a></span>()</code>
<div class="block">Returns the maximum request input size in bytes.</div>
</td>
</tr>
-<tr id="i32" class="altColor">
+<tr id="i31" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getMediaTypeForName-java.lang.String-">getMediaTypeForName</a></span>(<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> name)</code>
<div class="block">Returns the media type for the specified file name.</div>
</td>
</tr>
-<tr id="i33" class="rowColor">
+<tr id="i32" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/utils/MessageBundle.html" title="class in org.apache.juneau.utils">MessageBundle</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getMessages--">getMessages</a></span>()</code>
<div class="block">Returns the resource bundle used by this resource.</div>
</td>
</tr>
-<tr id="i34" class="altColor">
+<tr id="i33" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getParentContext--">getParentContext</a></span>()</code>
<div class="block">Returns the parent resource context (if this resource was initialized from a parent).</div>
</td>
</tr>
-<tr id="i35" class="rowColor">
+<tr id="i34" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getParsers--">getParsers</a></span>()</code>
<div class="block">Returns the parsers registered with this resource.</div>
</td>
</tr>
-<tr id="i36" class="altColor">
+<tr id="i35" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getPartParser--">getPartParser</a></span>()</code>
<div class="block">Returns the HTTP-part parser associated with this resource.</div>
</td>
</tr>
-<tr id="i37" class="rowColor">
+<tr id="i36" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getPartSerializer--">getPartSerializer</a></span>()</code>
<div class="block">Returns the HTTP-part serializer associated with this resource.</div>
</td>
</tr>
-<tr id="i38" class="altColor">
+<tr id="i37" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getPath--">getPath</a></span>()</code>
<div class="block">Returns the path for this resource as defined by the <a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#path--"><code>@RestResource(path)</code></a> annotation or
<a href="../../../../org/apache/juneau/rest/RestContextBuilder.html#path-java.lang.String-"><code>RestContextBuilder.path(String)</code></a> method concatenated with those on all parent classes.</div>
</td>
</tr>
-<tr id="i39" class="rowColor">
+<tr id="i38" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getProduces--">getProduces</a></span>()</code>
<div class="block">Returns the explicit list of supported accept types for this resource.</div>
</td>
</tr>
-<tr id="i40" class="altColor">
+<tr id="i39" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestContextProperties.html" title="class in org.apache.juneau.rest">RestContextProperties</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getProperties--">getProperties</a></span>()</code>
<div class="block">Returns the class-level properties associated with this servlet.</div>
</td>
</tr>
-<tr id="i41" class="rowColor">
+<tr id="i40" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getResource--">getResource</a></span>()</code>
<div class="block">Returns the resource object.</div>
</td>
</tr>
-<tr id="i42" class="altColor">
+<tr id="i41" class="rowColor">
<td class="colFirst"><code>protected <a href="../../../../org/apache/juneau/rest/RestResourceResolver.html" title="interface in org.apache.juneau.rest">RestResourceResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getResourceResolver--">getResourceResolver</a></span>()</code>
<div class="block">Returns the resource resolver associated with this context.</div>
</td>
</tr>
-<tr id="i43" class="rowColor">
+<tr id="i42" class="altColor">
<td class="colFirst"><code>protected <a href="../../../../org/apache/juneau/rest/ResponseHandler.html" title="interface in org.apache.juneau.rest">ResponseHandler</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getResponseHandlers--">getResponseHandlers</a></span>()</code>
<div class="block">Returns the response handlers associated with this resource.</div>
</td>
</tr>
-<tr id="i44" class="altColor">
+<tr id="i43" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestMethodParam.html" title="class in org.apache.juneau.rest">RestMethodParam</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getRestMethodParams-java.lang.reflect.Method-">getRestMethodParams</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method)</code>
<div class="block">Returns the parameters defined on the specified Java method.</div>
</td>
</tr>
-<tr id="i45" class="rowColor">
+<tr id="i44" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest">RestServlet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getRestServlet--">getRestServlet</a></span>()</code>
<div class="block">Returns the resource object as a <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest"><code>RestServlet</code></a>.</div>
</td>
</tr>
-<tr id="i46" class="altColor">
+<tr id="i45" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getSerializers--">getSerializers</a></span>()</code>
<div class="block">Returns the serializers registered with this resource.</div>
</td>
</tr>
-<tr id="i47" class="rowColor">
+<tr id="i46" class="altColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getServletInitParameter-java.lang.String-">getServletInitParameter</a></span>(<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> name)</code>
<div class="block">Returns the servlet init parameter returned by <code>ServletConfig.getInitParameter(String)</code>.</div>
</td>
</tr>
-<tr id="i48" class="altColor">
+<tr id="i47" class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getStackTraceOccurrence-java.lang.Throwable-">getStackTraceOccurrence</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> e)</code>
<div class="block">Returns the number of times this exception was thrown based on a hash of its stacktrace.</div>
</td>
</tr>
-<tr id="i49" class="rowColor">
+<tr id="i48" class="altColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getUriAuthority--">getUriAuthority</a></span>()</code>
<div class="block">Returns the authority path of the resource.</div>
</td>
</tr>
-<tr id="i50" class="altColor">
+<tr id="i49" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getUriContext--">getUriContext</a></span>()</code>
<div class="block">Returns the context path of the resource.</div>
</td>
</tr>
-<tr id="i51" class="rowColor">
+<tr id="i50" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/UriRelativity.html" title="enum in org.apache.juneau">UriRelativity</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getUriRelativity--">getUriRelativity</a></span>()</code>
<div class="block">Returns the setting on how relative URIs should be interpreted as relative to.</div>
</td>
</tr>
-<tr id="i52" class="altColor">
+<tr id="i51" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getUriResolution--">getUriResolution</a></span>()</code>
<div class="block">Returns the setting on how relative URIs should be resolved.</div>
</td>
</tr>
-<tr id="i53" class="rowColor">
+<tr id="i52" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl">VarResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getVarResolver--">getVarResolver</a></span>()</code>
<div class="block">Returns the variable resolver for this servlet.</div>
</td>
</tr>
-<tr id="i54" class="altColor">
+<tr id="i53" class="rowColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#getWidgets--">getWidgets</a></span>()</code>
<div class="block">The widgets used for resolving <js>"$W{...}"<js> variables.</div>
</td>
</tr>
-<tr id="i55" class="rowColor">
+<tr id="i54" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#hasChildResources--">hasChildResources</a></span>()</code>
<div class="block">Returns <jk>true</jk> if this resource has any child resources associated with it.</div>
</td>
</tr>
-<tr id="i56" class="altColor">
+<tr id="i55" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#isAllowBodyParam--">isAllowBodyParam</a></span>()</code>
<div class="block">Returns whether it's safe to pass the HTTP body as a <js>"body"</js> GET parameter.</div>
</td>
</tr>
-<tr id="i57" class="rowColor">
+<tr id="i56" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#isAllowHeaderParams--">isAllowHeaderParams</a></span>()</code>
<div class="block">Returns whether it's safe to pass header values in as GET parameters.</div>
</td>
</tr>
-<tr id="i58" class="altColor">
+<tr id="i57" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#isDebug--">isDebug</a></span>()</code>
<div class="block">Returns <jk>true</jk> if debug mode is enabled on this resource.</div>
</td>
</tr>
-<tr id="i59" class="rowColor">
+<tr id="i58" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#isRenderResponseStackTraces--">isRenderResponseStackTraces</a></span>()</code>
<div class="block">Returns whether it's safe to render stack traces in HTTP responses.</div>
</td>
</tr>
-<tr id="i60" class="altColor">
+<tr id="i59" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#isStaticFile-java.lang.String-">isStaticFile</a></span>(<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> p)</code>
<div class="block">Returns <jk>true</jk> if the specified path refers to a static file.</div>
</td>
</tr>
-<tr id="i61" class="rowColor">
+<tr id="i60" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#postInit--">postInit</a></span>()</code>
<div class="block">Calls all @RestHook(POST_INIT) methods in parent-to-child order.</div>
</td>
</tr>
-<tr id="i62" class="altColor">
+<tr id="i61" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#postInitChildFirst--">postInitChildFirst</a></span>()</code>
<div class="block">Calls all @RestHook(POST_INIT_CHILD_FIRST) methods in child-to-parent order.</div>
</td>
</tr>
-<tr id="i63" class="rowColor">
+<tr id="i62" class="altColor">
<td class="colFirst"><code>protected <a href="../../../../org/apache/juneau/rest/RestContext.StaticFile.html" title="class in org.apache.juneau.rest">RestContext.StaticFile</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestContext.html#resolveStaticFile-java.lang.String-">resolveStaticFile</a></span>(<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> pathInfo)</code>
<div class="block">Resolve a static resource file.</div>
@@ -869,7 +863,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_allowBodyParam</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/RestContext.html#line.144">REST_allowBodyParam</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/RestContext.html#line.143">REST_allowBodyParam</a></pre>
<div class="block">Configuration property: Allow body URL parameter.
<h5 class='section'>Property:</h5>
@@ -941,7 +935,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_allowedMethodParams</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/RestContext.html#line.213">REST_allowedMethodParams</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/RestContext.html#line.212">REST_allowedMethodParams</a></pre>
<div class="block">Configuration property: Allowed method parameters.
<h5 class='section'>Property:</h5>
@@ -1019,7 +1013,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_allowHeaderParams</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/RestContext.html#line.276">REST_allowHeaderParams</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/RestContext.html#line.275">REST_allowHeaderParams</a></pre>
<div class="block">Configuration property: Allow header URL parameters.
<h5 class='section'>Property:</h5>
@@ -1091,7 +1085,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_callHandler</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/RestContext.html#line.366">REST_callHandler</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/RestContext.html#line.365">REST_callHandler</a></pre>
<div class="block">Configuration property: REST call handler.
<h5 class='section'>Property:</h5>
@@ -1190,7 +1184,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_children</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/RestContext.html#line.479">REST_children</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/RestContext.html#line.478">REST_children</a></pre>
<div class="block">Configuration property: Children.
<h5 class='section'>Property:</h5>
@@ -1312,7 +1306,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_classpathResourceFinder</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/RestContext.html#line.581">REST_classpathResourceFinder</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/RestContext.html#line.580">REST_classpathResourceFinder</a></pre>
<div class="block">Configuration property: Classpath resource finder.
<h5 class='section'>Property:</h5>
@@ -1423,7 +1417,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_clientVersionHeader</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/RestContext.html#line.654">REST_clientVersionHeader</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/RestContext.html#line.653">REST_clientVersionHeader</a></pre>
<div class="block">Configuration property: Client version header.
<h5 class='section'>Property:</h5>
@@ -1505,7 +1499,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_converters</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/RestContext.html#line.752">REST_converters</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/RestContext.html#line.751">REST_converters</a></pre>
<div class="block">Configuration property: Class-level response converters.
<h5 class='section'>Property:</h5>
@@ -1612,7 +1606,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_debug</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/RestContext.html#line.780">REST_debug</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/RestContext.html#line.779">REST_debug</a></pre>
<div class="block">Configuration property: Debug mode.
<h5 class='section'>Property:</h5>
@@ -1649,7 +1643,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_defaultCharset</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/RestContext.html#line.835">REST_defaultCharset</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/RestContext.html#line.834">REST_defaultCharset</a></pre>
<div class="block">Configuration property: Default character encoding.
<h5 class='section'>Property:</h5>
@@ -1713,7 +1707,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_defaultRequestHeaders</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/RestContext.html#line.903">REST_defaultRequestHeaders</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/RestContext.html#line.902">REST_defaultRequestHeaders</a></pre>
<div class="block">Configuration property: Default request headers.
<h5 class='section'>Property:</h5>
@@ -1790,7 +1784,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_defaultResponseHeaders</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/RestContext.html#line.968">REST_defaultResponseHeaders</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/RestContext.html#line.967">REST_defaultResponseHeaders</a></pre>
<div class="block">Configuration property: Default response headers.
<h5 class='section'>Property:</h5>
@@ -1864,7 +1858,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_encoders</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/RestContext.html#line.1040">REST_encoders</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/RestContext.html#line.1039">REST_encoders</a></pre>
<div class="block">Configuration property: Compression encoders.
<h5 class='section'>Property:</h5>
@@ -1945,7 +1939,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_guards</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/RestContext.html#line.1125">REST_guards</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/RestContext.html#line.1124">REST_guards</a></pre>
<div class="block">Configuration property: Class-level guards.
<h5 class='section'>Property:</h5>
@@ -2039,7 +2033,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_infoProvider</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/RestContext.html#line.1214">REST_infoProvider</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/RestContext.html#line.1213">REST_infoProvider</a></pre>
<div class="block">Configuration property: REST info provider.
<h5 class='section'>Property:</h5>
@@ -2137,7 +2131,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_logger</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/RestContext.html#line.1292">REST_logger</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/RestContext.html#line.1291">REST_logger</a></pre>
<div class="block">Configuration property: REST logger.
<h5 class='section'>Property:</h5>
@@ -2224,7 +2218,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_maxInput</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/RestContext.html#line.1358">REST_maxInput</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/RestContext.html#line.1357">REST_maxInput</a></pre>
<div class="block">Configuration property: The maximum allowed input size (in bytes) on HTTP requests.
<h5 class='section'>Property:</h5>
@@ -2299,7 +2293,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_messages</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/RestContext.html#line.1445">REST_messages</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/RestContext.html#line.1444">REST_messages</a></pre>
<div class="block">Configuration property: Messages.
<h5 class='section'>Property:</h5>
@@ -2395,7 +2389,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_mimeTypes</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/RestContext.html#line.1513">REST_mimeTypes</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/RestContext.html#line.1512">REST_mimeTypes</a></pre>
<div class="block">Configuration property: MIME types.
<h5 class='section'>Property:</h5>
@@ -2472,7 +2466,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_paramResolvers</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/RestContext.html#line.1603">REST_paramResolvers</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/RestContext.html#line.1602">REST_paramResolvers</a></pre>
<div class="block">Configuration property: Java method parameter resolvers.
<h5 class='section'>Property:</h5>
@@ -2571,7 +2565,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_parsers</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/RestContext.html#line.1698">REST_parsers</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/RestContext.html#line.1697">REST_parsers</a></pre>
<div class="block">Configuration property: Parsers.
<h5 class='section'>Property:</h5>
@@ -2675,7 +2669,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_partParser</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/RestContext.html#line.1766">REST_partParser</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/RestContext.html#line.1765">REST_partParser</a></pre>
<div class="block">Configuration property: HTTP part parser.
<h5 class='section'>Property:</h5>
@@ -2752,7 +2746,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_partSerializer</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/RestContext.html#line.1839">REST_partSerializer</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/RestContext.html#line.1838">REST_partSerializer</a></pre>
<div class="block">Configuration property: HTTP part serializer.
<h5 class='section'>Property:</h5>
@@ -2834,7 +2828,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_path</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/RestContext.html#line.1911">REST_path</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/RestContext.html#line.1910">REST_path</a></pre>
<div class="block">Configuration property: Resource path.
<h5 class='section'>Property:</h5>
@@ -2915,7 +2909,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_renderResponseStackTraces</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/RestContext.html#line.1974">REST_renderResponseStackTraces</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/RestContext.html#line.1973">REST_renderResponseStackTraces</a></pre>
<div class="block">Configuration property: Render response stack traces in responses.
<h5 class='section'>Property:</h5>
@@ -2987,7 +2981,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_resourceResolver</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/RestContext.html#line.2062">REST_resourceResolver</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/RestContext.html#line.2061">REST_resourceResolver</a></pre>
<div class="block">Configuration property: REST resource resolver.
<h5 class='section'>Property:</h5>
@@ -3084,7 +3078,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_responseHandlers</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/RestContext.html#line.2156">REST_responseHandlers</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/RestContext.html#line.2155">REST_responseHandlers</a></pre>
<div class="block">Configuration property: Response handlers.
<h5 class='section'>Property:</h5>
@@ -3187,7 +3181,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_serializers</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/RestContext.html#line.2259">REST_serializers</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/RestContext.html#line.2258">REST_serializers</a></pre>
<div class="block">Configuration property: Serializers.
<h5 class='section'>Property:</h5>
@@ -3299,7 +3293,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_staticFileResponseHeaders</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/RestContext.html#line.2324">REST_staticFileResponseHeaders</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/RestContext.html#line.2323">REST_staticFileResponseHeaders</a></pre>
<div class="block">Configuration property: Static file response headers.
<h5 class='section'>Property:</h5>
@@ -3373,7 +3367,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_staticFiles</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/RestContext.html#line.2397">REST_staticFiles</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/RestContext.html#line.2396">REST_staticFiles</a></pre>
<div class="block">Configuration property: Static file mappings.
<h5 class='section'>Property:</h5>
@@ -3455,7 +3449,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_produces</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/RestContext.html#line.2458">REST_produces</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/RestContext.html#line.2457">REST_produces</a></pre>
<div class="block">Configuration property: Supported accept media types.
<h5 class='section'>Property:</h5>
@@ -3525,7 +3519,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_consumes</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/RestContext.html#line.2519">REST_consumes</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/RestContext.html#line.2518">REST_consumes</a></pre>
<div class="block">Configuration property: Supported content media types.
<h5 class='section'>Property:</h5>
@@ -3595,7 +3589,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_useClasspathResourceCaching</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/RestContext.html#line.2574">REST_useClasspathResourceCaching</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/RestContext.html#line.2573">REST_useClasspathResourceCaching</a></pre>
<div class="block">Configuration property: Use classpath resource caching.
<h5 class='section'>Property:</h5>
@@ -3659,7 +3653,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_useStackTraceHashes</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/RestContext.html#line.2631">REST_useStackTraceHashes</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/RestContext.html#line.2630">REST_useStackTraceHashes</a></pre>
<div class="block">Configuration property: Use stack trace hashes.
<h5 class='section'>Property:</h5>
@@ -3725,7 +3719,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_uriAuthority</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/RestContext.html#line.2701">REST_uriAuthority</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/RestContext.html#line.2700">REST_uriAuthority</a></pre>
<div class="block">Configuration property: Resource URI authority path.
<h5 class='section'>Property:</h5>
@@ -3804,7 +3798,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_uriContext</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/RestContext.html#line.2764">REST_uriContext</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/RestContext.html#line.2763">REST_uriContext</a></pre>
<div class="block">Configuration property: Resource URI context path.
<h5 class='section'>Property:</h5>
@@ -3876,7 +3870,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_uriRelativity</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/RestContext.html#line.2825">REST_uriRelativity</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/RestContext.html#line.2824">REST_uriRelativity</a></pre>
<div class="block">Configuration property: URI resolution relativity.
<h5 class='section'>Property:</h5>
@@ -3946,7 +3940,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>REST_uriResolution</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/RestContext.html#line.2886">REST_uriResolution</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/RestContext.html#line.2885">REST_uriResolution</a></pre>
<div class="block">Configuration property: URI resolution.
<h5 class='section'>Property:</h5>
@@ -4016,7 +4010,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockListLast">
<li class="blockList">
<h4>REST_widgets</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/RestContext.html#line.2956">REST_widgets</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/RestContext.html#line.2955">REST_widgets</a></pre>
<div class="block">Configuration property: HTML Widgets.
<h5 class='section'>Property:</h5>
@@ -4103,7 +4097,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>create</h4>
-<pre>public static <a href="../../../../org/apache/juneau/rest/RestContextBuilder.html" title="class in org.apache.juneau.rest">RestContextBuilder</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3055">create</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> resource)
+<pre>public static <a href="../../../../org/apache/juneau/rest/RestContextBuilder.html" title="class in org.apache.juneau.rest">RestContextBuilder</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3053">create</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> resource)
throws javax.servlet.ServletException</pre>
<div class="block">Constructor.</div>
<dl>
@@ -4122,7 +4116,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getResourceResolver</h4>
-<pre>protected <a href="../../../../org/apache/juneau/rest/RestResourceResolver.html" title="interface in org.apache.juneau.rest">RestResourceResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3465">getResourceResolver</a>()</pre>
+<pre>protected <a href="../../../../org/apache/juneau/rest/RestResourceResolver.html" title="interface in org.apache.juneau.rest">RestResourceResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3462">getResourceResolver</a>()</pre>
<div class="block">Returns the resource resolver associated with this context.
<p>
@@ -4144,7 +4138,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getVarResolver</h4>
-<pre>public <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl">VarResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3524">getVarResolver</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl">VarResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3521">getVarResolver</a>()</pre>
<div class="block">Returns the variable resolver for this servlet.
<p>
@@ -4208,7 +4202,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getConfig</h4>
-<pre>public <a href="../../../../org/apache/juneau/config/Config.html" title="class in org.apache.juneau.config">Config</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3542">getConfig</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/config/Config.html" title="class in org.apache.juneau.config">Config</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3539">getConfig</a>()</pre>
<div class="block">Returns the config file associated with this servlet.
<p>
@@ -4230,7 +4224,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>resolveStaticFile</h4>
-<pre>protected <a href="../../../../org/apache/juneau/rest/RestContext.StaticFile.html" title="class in org.apache.juneau.rest">RestContext.StaticFile</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3560">resolveStaticFile</a>(<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> pathInfo)
+<pre>protected <a href="../../../../org/apache/juneau/rest/RestContext.StaticFile.html" title="class in org.apache.juneau.rest">RestContext.StaticFile</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3557">resolveStaticFile</a>(<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> pathInfo)
throws <a href="../../../../org/apache/juneau/rest/exception/NotFound.html" title="class in org.apache.juneau.rest.exception">NotFound</a>,
<a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Resolve a static resource file.
@@ -4257,7 +4251,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResource</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3653">getClasspathResource</a>(<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> name,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3650">getClasspathResource</a>(<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Same as <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true#getResourceAsStream-java.lang.String-" title="class or interface in java.lang"><code>Class.getResourceAsStream(String)</code></a> except if it doesn't find the resource on this class, searches
@@ -4308,7 +4302,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResource</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3686">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3683">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
@@ -4349,7 +4343,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResourceAsString</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/RestContext.html#line.3715">getClasspathResourceAsString</a>(<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> name,
+<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/RestContext.html#line.3712">getClasspathResourceAsString</a>(<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Reads the input stream from <a href="../../../../org/apache/juneau/rest/RestContext.html#getClasspathResource-java.lang.String-java.util.Locale-"><code>getClasspathResource(String, Locale)</code></a> into a String.
@@ -4386,7 +4380,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResourceAsString</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/RestContext.html#line.3748">getClasspathResourceAsString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
+<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/RestContext.html#line.3745">getClasspathResourceAsString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
@@ -4427,7 +4421,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResource</h4>
-<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3784">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c,
+<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3781">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c,
<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> mediaType,
<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale)
@@ -4474,7 +4468,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClasspathResource</h4>
-<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3820">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
+<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3817">getClasspathResource</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> baseClass,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c,
<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> mediaType,
<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> name,
@@ -4521,7 +4515,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getPath</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/RestContext.html#line.3870">getPath</a>()</pre>
+<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/RestContext.html#line.3867">getPath</a>()</pre>
<div class="block">Returns the path for this resource as defined by the <a href="../../../../org/apache/juneau/rest/annotation/RestResource.html#path--"><code>@RestResource(path)</code></a> annotation or
<a href="../../../../org/apache/juneau/rest/RestContextBuilder.html#path-java.lang.String-"><code>RestContextBuilder.path(String)</code></a> method concatenated with those on all parent classes.
@@ -4545,7 +4539,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getWidgets</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext. [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext. [...]
<div class="block">The widgets used for resolving <js>"$W{...}"<js> variables.
<h5 class='section'>See Also:</h5>
@@ -4564,7 +4558,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getLogger</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestLogger.html" title="interface in org.apache.juneau.rest">RestLogger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3900">getLogger</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestLogger.html" title="interface in org.apache.juneau.rest">RestLogger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3897">getLogger</a>()</pre>
<div class="block">Returns the logger to use for this resource.
<h5 class='section'>See Also:</h5>
@@ -4584,7 +4578,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getMessages</h4>
-<pre>public <a href="../../../../org/apache/juneau/utils/MessageBundle.html" title="class in org.apache.juneau.utils">MessageBundle</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3916">getMessages</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/utils/MessageBundle.html" title="class in org.apache.juneau.utils">MessageBundle</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3913">getMessages</a>()</pre>
<div class="block">Returns the resource bundle used by this resource.
<h5 class='section'>See Also:</h5>
@@ -4604,7 +4598,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getInfoProvider</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest">RestInfoProvider</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3932">getInfoProvider</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest">RestInfoProvider</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3929">getInfoProvider</a>()</pre>
<div class="block">Returns the REST information provider used by this resource.
<h5 class='section'>See Also:</h5>
@@ -4624,7 +4618,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getCallHandler</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestCallHandler.html" title="interface in org.apache.juneau.rest">RestCallHandler</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3948">getCallHandler</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestCallHandler.html" title="interface in org.apache.juneau.rest">RestCallHandler</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3945">getCallHandler</a>()</pre>
<div class="block">Returns the REST call handler used by this resource.
<h5 class='section'>See Also:</h5>
@@ -4644,7 +4638,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getCallRouters</h4>
-<pre>protected <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestCallRouter.html" title="class in org.apache.juneau.rest">RestCallRouter</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestCon [...]
+<pre>protected <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestCallRouter.html" title="class in org.apache.juneau.rest">RestCallRouter</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestCon [...]
<div class="block">Returns a map of HTTP method names to call routers.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -4658,7 +4652,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getResource</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3972">getResource</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3969">getResource</a>()</pre>
<div class="block">Returns the resource object.
<p>
@@ -4677,7 +4671,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getRestServlet</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest">RestServlet</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3983">getRestServlet</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest">RestServlet</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3980">getRestServlet</a>()</pre>
<div class="block">Returns the resource object as a <a href="../../../../org/apache/juneau/rest/RestServlet.html" title="class in org.apache.juneau.rest"><code>RestServlet</code></a>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -4692,7 +4686,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>checkForInitException</h4>
-<pre>protected void <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3992">checkForInitException</a>()
+<pre>protected void <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.3989">checkForInitException</a>()
throws <a href="../../../../org/apache/juneau/rest/RestException.html" title="class in org.apache.juneau.rest">RestException</a></pre>
<div class="block">Throws a <a href="../../../../org/apache/juneau/rest/RestException.html" title="class in org.apache.juneau.rest"><code>RestException</code></a> if an exception occurred in the constructor of this object.</div>
<dl>
@@ -4707,7 +4701,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getParentContext</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4006">getParentContext</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4003">getParentContext</a>()</pre>
<div class="block">Returns the parent resource context (if this resource was initialized from a parent).
<p>
@@ -4725,7 +4719,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getBeanContext</h4>
-<pre>public <a href="../../../../org/apache/juneau/BeanContext.html" title="class in org.apache.juneau">BeanContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4015">getBeanContext</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/BeanContext.html" title="class in org.apache.juneau">BeanContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4012">getBeanContext</a>()</pre>
<div class="block">Returns the <a href="../../../../org/apache/juneau/BeanContext.html" title="class in org.apache.juneau"><code>BeanContext</code></a> object used for parsing path variables and header values.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -4739,7 +4733,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getProperties</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContextProperties.html" title="class in org.apache.juneau.rest">RestContextProperties</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4039">getProperties</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContextProperties.html" title="class in org.apache.juneau.rest">RestContextProperties</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4036">getProperties</a>()</pre>
<div class="block">Returns the class-level properties associated with this servlet.
<p>
@@ -4768,7 +4762,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getSerializers</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4053">getSerializers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4050">getSerializers</a>()</pre>
<div class="block">Returns the serializers registered with this resource.
<h5 class='section'>See Also:</h5>
@@ -4787,7 +4781,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getParsers</h4>
-<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4068">getParsers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4065">getParsers</a>()</pre>
<div class="block">Returns the parsers registered with this resource.
<p>
@@ -4807,7 +4801,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getServletInitParameter</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/RestContext.html#line.4078">getServletInitParameter</a>(<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> name)</pre>
+<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/RestContext.html#line.4075">getServletInitParameter</a>(<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> name)</pre>
<div class="block">Returns the servlet init parameter returned by <code>ServletConfig.getInitParameter(String)</code>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -4823,7 +4817,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getChildResources</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html [...]
<div class="block">Returns the child resources associated with this servlet.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -4838,7 +4832,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getStackTraceOccurrence</h4>
-<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4106">getStackTraceOccurrence</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> e)</pre>
+<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4103">getStackTraceOccurrence</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> e)</pre>
<div class="block">Returns the number of times this exception was thrown based on a hash of its stacktrace.
<h5 class='section'>See Also:</h5>
@@ -4860,7 +4854,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isRenderResponseStackTraces</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4124">isRenderResponseStackTraces</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4121">isRenderResponseStackTraces</a>()</pre>
<div class="block">Returns whether it's safe to render stack traces in HTTP responses.
<h5 class='section'>See Also:</h5>
@@ -4879,7 +4873,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isAllowHeaderParams</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4138">isAllowHeaderParams</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4135">isAllowHeaderParams</a>()</pre>
<div class="block">Returns whether it's safe to pass header values in as GET parameters.
<h5 class='section'>See Also:</h5>
@@ -4898,7 +4892,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isAllowBodyParam</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4152">isAllowBodyParam</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4149">isAllowBodyParam</a>()</pre>
<div class="block">Returns whether it's safe to pass the HTTP body as a <js>"body"</js> GET parameter.
<h5 class='section'>See Also:</h5>
@@ -4917,7 +4911,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isDebug</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4167">isDebug</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4164">isDebug</a>()</pre>
<div class="block">Returns <jk>true</jk> if debug mode is enabled on this resource.
<h5 class='section'>See Also:</h5>
@@ -4940,7 +4934,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getDefaultCharset</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/RestContext.html#line.4183">getDefaultCharset</a>()</pre>
+<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/RestContext.html#line.4180">getDefaultCharset</a>()</pre>
<div class="block">Returns the default charset to use on requests and responses when not specified on the request.
<h5 class='section'>See Also:</h5>
@@ -4960,7 +4954,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getMaxInput</h4>
-<pre>public long <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4197">getMaxInput</a>()</pre>
+<pre>public long <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4194">getMaxInput</a>()</pre>
<div class="block">Returns the maximum request input size in bytes.
<h5 class='section'>See Also:</h5>
@@ -4979,7 +4973,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClientVersionHeader</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/RestContext.html#line.4213">getClientVersionHeader</a>()</pre>
+<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/RestContext.html#line.4210">getClientVersionHeader</a>()</pre>
<div class="block">Returns the name of the client version header name used by this resource.
<h5 class='section'>See Also:</h5>
@@ -4999,7 +4993,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>allowMethodParam</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4229">allowMethodParam</a>(<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> m)</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4226">allowMethodParam</a>(<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> m)</pre>
<div class="block">Returns <jk>true</jk> if the specified <code>Method</code> GET parameter value can be used to override
the method name in the HTTP header.
@@ -5021,7 +5015,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getPartParser</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4245">getPartParser</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4242">getPartParser</a>()</pre>
<div class="block">Returns the HTTP-part parser associated with this resource.
<h5 class='section'>See Also:</h5>
@@ -5035,28 +5029,13 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
</dl>
</li>
</ul>
-<a name="getJsonSchemaGenerator--">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>getJsonSchemaGenerator</h4>
-<pre>public <a href="../../../../org/apache/juneau/jsonschema/JsonSchemaGenerator.html" title="class in org.apache.juneau.jsonschema">JsonSchemaGenerator</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4256">getJsonSchemaGenerator</a>()</pre>
-<div class="block">Returns the JSON-Schema serializer associated with this resource.</div>
-<dl>
-<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The JSON-Schema serializer associated with this resource.
- <br>Never <jk>null</jk>.</dd>
-</dl>
-</li>
-</ul>
<a name="getPartSerializer--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPartSerializer</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4272">getPartSerializer</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4258">getPartSerializer</a>()</pre>
<div class="block">Returns the HTTP-part serializer associated with this resource.
<h5 class='section'>See Also:</h5>
@@ -5076,7 +5055,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getEncoders</h4>
-<pre>public <a href="../../../../org/apache/juneau/encoders/EncoderGroup.html" title="class in org.apache.juneau.encoders">EncoderGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4288">getEncoders</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/encoders/EncoderGroup.html" title="class in org.apache.juneau.encoders">EncoderGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4274">getEncoders</a>()</pre>
<div class="block">Returns the encoders associated with this resource.
<h5 class='section'>See Also:</h5>
@@ -5096,7 +5075,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getProduces</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4305">getProduces</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4291">getProduces</a>()</pre>
<div class="block">Returns the explicit list of supported accept types for this resource.
<h5 class='section'>See Also:</h5>
@@ -5117,7 +5096,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getConsumes</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4322">getConsumes</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4308">getConsumes</a>()</pre>
<div class="block">Returns the explicit list of supported content types for this resource.
<h5 class='section'>See Also:</h5>
@@ -5138,7 +5117,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getDefaultRequestHeaders</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/junea [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/junea [...]
<div class="block">Returns the default request headers for this resource.
<h5 class='section'>See Also:</h5>
@@ -5158,7 +5137,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getDefaultResponseHeaders</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/junea [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/junea [...]
<div class="block">Returns the default response headers for this resource.
<h5 class='section'>See Also:</h5>
@@ -5178,7 +5157,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getConverters</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestConverter.html" title="interface in org.apache.juneau.rest">RestConverter</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4370">getConverters</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestConverter.html" title="interface in org.apache.juneau.rest">RestConverter</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4356">getConverters</a>()</pre>
<div class="block">Returns the converters associated with this resource at the class level.
<h5 class='section'>See Also:</h5>
@@ -5198,7 +5177,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getGuards</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestGuard.html" title="class in org.apache.juneau.rest">RestGuard</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4386">getGuards</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestGuard.html" title="class in org.apache.juneau.rest">RestGuard</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4372">getGuards</a>()</pre>
<div class="block">Returns the guards associated with this resource at the class level.
<h5 class='section'>See Also:</h5>
@@ -5218,7 +5197,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getResponseHandlers</h4>
-<pre>protected <a href="../../../../org/apache/juneau/rest/ResponseHandler.html" title="interface in org.apache.juneau.rest">ResponseHandler</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4402">getResponseHandlers</a>()</pre>
+<pre>protected <a href="../../../../org/apache/juneau/rest/ResponseHandler.html" title="interface in org.apache.juneau.rest">ResponseHandler</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4388">getResponseHandlers</a>()</pre>
<div class="block">Returns the response handlers associated with this resource.
<h5 class='section'>See Also:</h5>
@@ -5238,7 +5217,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>hasChildResources</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4416">hasChildResources</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4402">hasChildResources</a>()</pre>
<div class="block">Returns <jk>true</jk> if this resource has any child resources associated with it.
<h5 class='section'>See Also:</h5>
@@ -5257,7 +5236,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getChildResource</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4431">getChildResource</a>(<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> path)</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4417">getChildResource</a>(<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> path)</pre>
<div class="block">Returns the context of the child resource associated with the specified path.
<h5 class='section'>See Also:</h5>
@@ -5278,7 +5257,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getUriAuthority</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/RestContext.html#line.4447">getUriAuthority</a>()</pre>
+<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/RestContext.html#line.4433">getUriAuthority</a>()</pre>
<div class="block">Returns the authority path of the resource.
<h5 class='section'>See Also:</h5>
@@ -5298,7 +5277,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getUriContext</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/RestContext.html#line.4467">getUriContext</a>()</pre>
+<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/RestContext.html#line.4453">getUriContext</a>()</pre>
<div class="block">Returns the context path of the resource.
<h5 class='section'>See Also:</h5>
@@ -5318,7 +5297,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getUriRelativity</h4>
-<pre>public <a href="../../../../org/apache/juneau/UriRelativity.html" title="enum in org.apache.juneau">UriRelativity</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4487">getUriRelativity</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/UriRelativity.html" title="enum in org.apache.juneau">UriRelativity</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4473">getUriRelativity</a>()</pre>
<div class="block">Returns the setting on how relative URIs should be interpreted as relative to.
<h5 class='section'>See Also:</h5>
@@ -5338,7 +5317,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getUriResolution</h4>
-<pre>public <a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4503">getUriResolution</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4489">getUriResolution</a>()</pre>
<div class="block">Returns the setting on how relative URIs should be resolved.
<h5 class='section'>See Also:</h5>
@@ -5358,7 +5337,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getRestMethodParams</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestMethodParam.html" title="class in org.apache.juneau.rest">RestMethodParam</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4513">getRestMethodParams</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method)</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestMethodParam.html" title="class in org.apache.juneau.rest">RestMethodParam</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4499">getRestMethodParams</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method)</pre>
<div class="block">Returns the parameters defined on the specified Java method.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -5374,7 +5353,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getMediaTypeForName</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/RestContext.html#line.4528">getMediaTypeForName</a>(<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> name)</pre>
+<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/RestContext.html#line.4514">getMediaTypeForName</a>(<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> name)</pre>
<div class="block">Returns the media type for the specified file name.
<h5 class='section'>See Also:</h5>
@@ -5395,7 +5374,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isStaticFile</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4546">isStaticFile</a>(<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> p)</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4532">isStaticFile</a>(<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> p)</pre>
<div class="block">Returns <jk>true</jk> if the specified path refers to a static file.
<p>
@@ -5419,7 +5398,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getCallMethods</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestJavaMethod.html" title="class in org.apache.juneau.rest">RestJavaMethod</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContex [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/RestJavaMethod.html" title="class in org.apache.juneau.rest">RestJavaMethod</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestContex [...]
<div class="block">Returns the REST Java methods defined in this resource.
<p>
@@ -5436,7 +5415,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>findParams</h4>
-<pre>protected <a href="../../../../org/apache/juneau/rest/RestMethodParam.html" title="class in org.apache.juneau.rest">RestMethodParam</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4572">findParams</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
+<pre>protected <a href="../../../../org/apache/juneau/rest/RestMethodParam.html" title="class in org.apache.juneau.rest">RestMethodParam</a>[] <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4558">findParams</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
<a href="../../../../org/apache/juneau/rest/util/UrlPathPattern.html" title="class in org.apache.juneau.rest.util">UrlPathPattern</a> pathPattern,
boolean isPreOrPost)
throws javax.servlet.ServletException</pre>
@@ -5459,7 +5438,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>postInit</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4703">postInit</a>()
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4689">postInit</a>()
throws javax.servlet.ServletException</pre>
<div class="block">Calls all @RestHook(POST_INIT) methods in parent-to-child order.</div>
<dl>
@@ -5476,7 +5455,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>postInitChildFirst</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4717">postInitChildFirst</a>()
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4703">postInitChildFirst</a>()
throws javax.servlet.ServletException</pre>
<div class="block">Calls all @RestHook(POST_INIT_CHILD_FIRST) methods in child-to-parent order.</div>
<dl>
@@ -5493,7 +5472,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>destroy</h4>
-<pre>protected void <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4749">destroy</a>()</pre>
+<pre>protected void <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4735">destroy</a>()</pre>
<div class="block">Calls <code>Servlet.destroy()</code> on any child resources defined on this resource.</div>
</li>
</ul>
@@ -5503,7 +5482,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4769">createSession</a>(<a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> args)</pre>
+<pre>public <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4755">createSession</a>(<a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> args)</pre>
<div class="block">Unused.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
@@ -5521,7 +5500,7 @@ extends <a href="../../../../org/apache/juneau/BeanContext.html" title="class in
<ul class="blockListLast">
<li class="blockList">
<h4>createDefaultSessionArgs</h4>
-<pre>public <a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4777">createDefaultSessionArgs</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/BeanSessionArgs.html" title="class in org.apache.juneau">BeanSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestContext.html#line.4763">createDefaultSessionArgs</a>()</pre>
<div class="block">Unused.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/RestInfoProvider.html b/content/site/apidocs_preview/org/apache/juneau/rest/RestInfoProvider.html
index 9757641..a4e7dcd 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/RestInfoProvider.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/RestInfoProvider.html
@@ -217,9 +217,15 @@ var activeTableTab = "activeTableTab";
<ul class="blockList">
<li class="blockList">
<h4>getSwagger</h4>
-<pre><a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestInfoProvider.html#line.54">getSwagger</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<pre><a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestInfoProvider.html#line.60">getSwagger</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized swagger for the REST resource.</div>
+<div class="block">Returns the localized swagger for the REST resource.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSwagger--"><code>RestRequest.getSwagger()</code></a>
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>req</code> - The incoming HTTP request.</dd>
@@ -238,9 +244,17 @@ var activeTableTab = "activeTableTab";
<ul class="blockList">
<li class="blockList">
<h4>getSiteName</h4>
-<pre><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/RestInfoProvider.html#line.65">getSiteName</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<pre><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/RestInfoProvider.html#line.79">getSiteName</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized site name of the REST resource.</div>
+<div class="block">Returns the localized site name of the REST resource.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSiteName--"><code>RestRequest.getSiteName()</code></a>
+ <li><code>$RI{siteName}</code> variable.
+ <li><code>$R{siteName}</code> variable.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>req</code> - The current request.</dd>
@@ -258,9 +272,17 @@ var activeTableTab = "activeTableTab";
<ul class="blockList">
<li class="blockList">
<h4>getTitle</h4>
-<pre><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/RestInfoProvider.html#line.76">getTitle</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<pre><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/RestInfoProvider.html#line.98">getTitle</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized title of the REST resource.</div>
+<div class="block">Returns the localized title of the REST resource.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResourceTitle--"><code>RestRequest.getResourceTitle()</code></a>
+ <li><code>$RI{title}</code> variable.
+ <li><code>$R{resourceTitle}</code> variable.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>req</code> - The current request.</dd>
@@ -278,9 +300,17 @@ var activeTableTab = "activeTableTab";
<ul class="blockList">
<li class="blockList">
<h4>getDescription</h4>
-<pre><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/RestInfoProvider.html#line.87">getDescription</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
+<pre><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/RestInfoProvider.html#line.117">getDescription</a>(<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized description of the REST resource.</div>
+<div class="block">Returns the localized description of the REST resource.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResourceDescription--"><code>RestRequest.getResourceDescription()</code></a>
+ <li><code>$RI{description}</code> variable.
+ <li><code>$R{resourceDescription}</code> variable.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>req</code> - The current request.</dd>
@@ -298,10 +328,18 @@ var activeTableTab = "activeTableTab";
<ul class="blockList">
<li class="blockList">
<h4>getMethodSummary</h4>
-<pre><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/RestInfoProvider.html#line.99">getMethodSummary</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
+<pre><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/RestInfoProvider.html#line.137">getMethodSummary</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized summary of the specified java method.</div>
+<div class="block">Returns the localized summary of the specified java method.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getMethodSummary--"><code>RestRequest.getMethodSummary()</code></a>
+ <li><code>$RI{methodSummary}</code> variable.
+ <li><code>$R{methodSummary}</code> variable.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>method</code> - The Java method annotated with <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html" title="annotation in org.apache.juneau.rest.annotation"><code>@RestMethod</code></a>.</dd>
@@ -320,10 +358,18 @@ var activeTableTab = "activeTableTab";
<ul class="blockListLast">
<li class="blockList">
<h4>getMethodDescription</h4>
-<pre><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/RestInfoProvider.html#line.111">getMethodDescription</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
+<pre><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/RestInfoProvider.html#line.157">getMethodDescription</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method,
<a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Returns the localized description of the specified java method on this servlet.</div>
+<div class="block">Returns the localized description of the specified java method on this servlet.
+
+ <p>
+ This object is made available through the following:
+ <ul>
+ <li class='jm'><a href="../../../../org/apache/juneau/rest/RestRequest.html#getMethodDescription--"><code>RestRequest.getMethodDescription()</code></a>
+ <li><code>$RI{methodDescription}</code> variable.
+ <li><code>$R{methodDescription}</code> variable.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>method</code> - The Java method annotated with <a href="../../../../org/apache/juneau/rest/annotation/RestMethod.html" title="annotation in org.apache.juneau.rest.annotation"><code>@RestMethod</code></a>.</dd>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/RestJavaMethod.html b/content/site/apidocs_preview/org/apache/juneau/rest/RestJavaMethod.html
index 269a8e7..c1b773e 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/RestJavaMethod.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/RestJavaMethod.html
@@ -202,7 +202,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>toString</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/RestJavaMethod.html#line.612">toString</a>()</pre>
+<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/RestJavaMethod.html#line.602">toString</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
@@ -215,7 +215,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>compareTo</h4>
-<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.621">compareTo</a>(<a href="../../../../org/apache/juneau/rest/RestJavaMethod.html" title="class in org.apache.juneau.rest">RestJavaMethod</a> o)</pre>
+<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.611">compareTo</a>(<a href="../../../../org/apache/juneau/rest/RestJavaMethod.html" title="class in org.apache.juneau.rest">RestJavaMethod</a> o)</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true#compareTo-T-" title="class or interface in java.lang">compareTo</a></code> in interface <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../../org/apache/juneau/rest/RestJavaMethod.html" title="class in org.apache.juneau.rest">RestJavaMethod</a>></code></dd>
@@ -228,7 +228,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>getSerializers</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.652">getSerializers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.642">getSerializers</a>()</pre>
<div class="block">Bean property getter: <property>serializers</property>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -242,7 +242,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>getParsers</h4>
-<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.661">getParsers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.651">getParsers</a>()</pre>
<div class="block">Bean property getter: <property>parsers</property>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -256,7 +256,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>getPartSerializer</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.670">getPartSerializer</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.660">getPartSerializer</a>()</pre>
<div class="block">Bean property getter: <property>partSerializer</property>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -270,7 +270,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>getPartParser</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.679">getPartParser</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.669">getPartParser</a>()</pre>
<div class="block">Bean property getter: <property>partParser</property>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -284,7 +284,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockList">
<li class="blockList">
<h4>equals</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.684">equals</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.674">equals</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
@@ -297,7 +297,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<ul class="blockListLast">
<li class="blockList">
<h4>hashCode</h4>
-<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.691">hashCode</a>()</pre>
+<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestJavaMethod.html#line.681">hashCode</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/RestRequest.html b/content/site/apidocs_preview/org/apache/juneau/rest/RestRequest.html
index 9d3043c..642bb4a 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/RestRequest.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/RestRequest.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10," [...]
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10," [...]
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -423,158 +423,164 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
</td>
</tr>
<tr id="i41" class="rowColor">
+<td class="colFirst"><code><a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getPropertyStore--">getPropertyStore</a></span>()</code>
+<div class="block">Returns the <a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau"><code>PropertyStore</code></a> for this request.</div>
+</td>
+</tr>
+<tr id="i42" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RequestQuery.html" title="class in org.apache.juneau.rest">RequestQuery</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getQuery--">getQuery</a></span>()</code>
<div class="block">Query parameters.</div>
</td>
</tr>
-<tr id="i42" class="altColor">
+<tr id="i43" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getQuery-java.lang.String-">getQuery</a></span>(<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> name)</code>
<div class="block">Shortcut for calling <code>getQuery().getString(name)</code>.</div>
</td>
</tr>
-<tr id="i43" class="rowColor">
+<tr id="i44" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io">BufferedReader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getReader--">getReader</a></span>()</code>
<div class="block">Returns the HTTP body content as a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>.</div>
</td>
</tr>
-<tr id="i44" class="altColor">
+<tr id="i45" class="rowColor">
<td class="colFirst"><code><T> T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getRequest-java.lang.Class-">getRequest</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c)</code>
<div class="block">Creates a proxy interface to retrieve HTTP parts of this request as a proxy bean.</div>
</td>
</tr>
-<tr id="i45" class="rowColor">
+<tr id="i46" class="altColor">
<td class="colFirst"><code><T> T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getRequest-org.apache.juneau.httppart.bean.RequestBeanMeta-">getRequest</a></span>(<a href="../../../../org/apache/juneau/httppart/bean/RequestBeanMeta.html" title="class in org.apache.juneau.httppart.bean">RequestBeanMeta</a> rbm)</code>
<div class="block">Same as <a href="../../../../org/apache/juneau/rest/RestRequest.html#getRequest-java.lang.Class-"><code>getRequest(Class)</code></a> but used on pre-instantiated <a href="../../../../org/apache/juneau/httppart/bean/RequestBeanMeta.html" title="class in org.apache.juneau.httppart.bean"><code>RequestBeanMeta</code></a> objects.</div>
</td>
</tr>
-<tr id="i46" class="altColor">
+<tr id="i47" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResourceDescription--">getResourceDescription</a></span>()</code>
<div class="block">Returns the localized resource description.</div>
</td>
</tr>
-<tr id="i47" class="rowColor">
+<tr id="i48" class="altColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResourceTitle--">getResourceTitle</a></span>()</code>
<div class="block">Returns the localized resource title.</div>
</td>
</tr>
-<tr id="i48" class="altColor">
+<tr id="i49" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/httppart/bean/ResponseBeanMeta.html" title="class in org.apache.juneau.httppart.bean">ResponseBeanMeta</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResponseBeanMeta-java.lang.Object-">getResponseBeanMeta</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</code>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/Response.html" title="annotation in org.apache.juneau.http.annotation"><code>@Response</code></a>.</div>
</td>
</tr>
-<tr id="i49" class="rowColor">
+<tr id="i50" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResponseBodyMeta-java.lang.Object-">getResponseBodyMeta</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</code>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/ResponseBody.html" title="annotation in org.apache.juneau.http.annotation"><code>@ResponseBody</code></a>.</div>
</td>
</tr>
-<tr id="i50" class="altColor">
+<tr id="i51" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getResponseHeaderMeta-java.lang.Object-">getResponseHeaderMeta</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</code>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/ResponseHeader.html" title="annotation in org.apache.juneau.http.annotation"><code>@ResponseHeader</code></a>.</div>
</td>
</tr>
-<tr id="i51" class="rowColor">
+<tr id="i52" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSerializers--">getSerializers</a></span>()</code>
<div class="block">Returns the serializers associated with this request.</div>
</td>
</tr>
-<tr id="i52" class="altColor">
+<tr id="i53" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSerializerSessionArgs--">getSerializerSessionArgs</a></span>()</code>
<div class="block">Returns the session arguments to pass to serializers.</div>
</td>
</tr>
-<tr id="i53" class="rowColor">
+<tr id="i54" class="altColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getServletPath--">getServletPath</a></span>()</code> </td>
</tr>
-<tr id="i54" class="altColor">
+<tr id="i55" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSiteName--">getSiteName</a></span>()</code>
<div class="block">Returns the localized site name.</div>
</td>
</tr>
-<tr id="i55" class="rowColor">
+<tr id="i56" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getSwagger--">getSwagger</a></span>()</code>
<div class="block">Returns the localized swagger associated with the resource.</div>
</td>
</tr>
-<tr id="i56" class="altColor">
+<tr id="i57" class="rowColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getUri-boolean-java.util.Map-">getUri</a></span>(boolean includeQuery,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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>,?> addQueryParams)</code>
<div class="block">Returns the URI for this request.</div>
</td>
</tr>
-<tr id="i57" class="rowColor">
+<tr id="i58" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/UriContext.html" title="class in org.apache.juneau">UriContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getUriContext--">getUriContext</a></span>()</code>
<div class="block">Returns the URI context of the request.</div>
</td>
</tr>
-<tr id="i58" class="altColor">
+<tr id="i59" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getUriResolver--">getUriResolver</a></span>()</code>
<div class="block">Shortcut for calling <a href="../../../../org/apache/juneau/rest/RestRequest.html#getUriResolver--"><code>getUriResolver()</code></a> using <a href="../../../../org/apache/juneau/UriResolution.html#ROOT_RELATIVE"><code>UriResolution.ROOT_RELATIVE</code></a> and
<a href="../../../../org/apache/juneau/UriRelativity.html#RESOURCE"><code>UriRelativity.RESOURCE</code></a></div>
</td>
</tr>
-<tr id="i59" class="rowColor">
+<tr id="i60" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getUriResolver-org.apache.juneau.UriResolution-org.apache.juneau.UriRelativity-">getUriResolver</a></span>(<a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a> resolution,
<a href="../../../../org/apache/juneau/UriRelativity.html" title="enum in org.apache.juneau">UriRelativity</a> relativity)</code>
<div class="block">Returns a URI resolver that can be used to convert URIs to absolute or root-relative form.</div>
</td>
</tr>
-<tr id="i60" class="altColor">
+<tr id="i61" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getVarResolverSession--">getVarResolverSession</a></span>()</code>
<div class="block">Request-level variable resolver session.</div>
</td>
</tr>
-<tr id="i61" class="rowColor">
+<tr id="i62" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#getWidgets--">getWidgets</a></span>()</code>
<div class="block">Returns the widgets used for resolving <js>"$W{...}"</js> string variables.</div>
</td>
</tr>
-<tr id="i62" class="altColor">
+<tr id="i63" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#isDebug--">isDebug</a></span>()</code>
<div class="block">Returns <jk>true</jk> if debug mode is enabled.</div>
</td>
</tr>
-<tr id="i63" class="rowColor">
+<tr id="i64" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#isPlainText--">isPlainText</a></span>()</code>
<div class="block">Returns <jk>true</jk> if <code>&plainText=true</code> was specified as a URL parameter.</div>
</td>
</tr>
-<tr id="i64" class="altColor">
+<tr id="i65" class="rowColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#prop-java.lang.String-java.lang.Object-">prop</a></span>(<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> name,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value)</code>
<div class="block">Shortcut for calling <code>getProperties().append(name, value);</code> fluently.</div>
</td>
</tr>
-<tr id="i65" class="rowColor">
+<tr id="i66" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#setCharacterEncoding-java.lang.String-">setCharacterEncoding</a></span>(<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> charset)</code>
<div class="block">Sets the charset to expect on the request body.</div>
</td>
</tr>
-<tr id="i66" class="altColor">
+<tr id="i67" class="rowColor">
<td class="colFirst"><code><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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/rest/RestRequest.html#toString--">toString</a></span>()</code> </td>
</tr>
@@ -851,13 +857,31 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
</dl>
</li>
</ul>
+<a name="getPropertyStore--">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getPropertyStore</h4>
+<pre>public <a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.396">getPropertyStore</a>()</pre>
+<div class="block">Returns the <a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau"><code>PropertyStore</code></a> for this request.
+
+ <p>
+ Consists of a read-only roll-up of all configuration properties defined on this method and class.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>The property store for this request.
+ <br>Never <jk>null</jk>.</dd>
+</dl>
+</li>
+</ul>
<a name="setCharacterEncoding-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setCharacterEncoding</h4>
-<pre>public void <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.390">setCharacterEncoding</a>(<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> charset)</pre>
+<pre>public void <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.404">setCharacterEncoding</a>(<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> charset)</pre>
<div class="block">Sets the charset to expect on the request body.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
@@ -873,7 +897,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getCharacterEncoding</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/RestRequest.html#line.398">getCharacterEncoding</a>()
+<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/RestRequest.html#line.412">getCharacterEncoding</a>()
throws <a href="../../../../org/apache/juneau/rest/exception/UnsupportedMediaType.html" title="class in org.apache.juneau.rest.exception">UnsupportedMediaType</a></pre>
<div class="block">Returns the charset specified on the <code>Content-Type</code> header, or <js>"UTF-8"</js> if not specified.</div>
<dl>
@@ -892,7 +916,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getLocale</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.420">getLocale</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.434">getLocale</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>getLocale</code> in interface <code>javax.servlet.ServletRequest</code></dd>
@@ -907,7 +931,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getLocales</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.431">getLocales</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.445">getLocales</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>getLocales</code> in interface <code>javax.servlet.ServletRequest</code></dd>
@@ -922,7 +946,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getQuery</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RequestQuery.html" title="class in org.apache.juneau.rest">RequestQuery</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.497">getQuery</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RequestQuery.html" title="class in org.apache.juneau.rest">RequestQuery</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.511">getQuery</a>()</pre>
<div class="block">Query parameters.
<p>
@@ -977,7 +1001,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getQuery</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/RestRequest.html#line.507">getQuery</a>(<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> name)</pre>
+<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/RestRequest.html#line.521">getQuery</a>(<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> name)</pre>
<div class="block">Shortcut for calling <code>getQuery().getString(name)</code>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -993,7 +1017,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getFormData</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RequestFormData.html" title="class in org.apache.juneau.rest">RequestFormData</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.563">getFormData</a>()
+<pre>public <a href="../../../../org/apache/juneau/rest/RequestFormData.html" title="class in org.apache.juneau.rest">RequestFormData</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.577">getFormData</a>()
throws <a href="../../../../org/apache/juneau/rest/exception/InternalServerError.html" title="class in org.apache.juneau.rest.exception">InternalServerError</a></pre>
<div class="block">Form-data.
@@ -1051,7 +1075,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getFormData</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/RestRequest.html#line.590">getFormData</a>(<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> name)</pre>
+<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/RestRequest.html#line.604">getFormData</a>(<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> name)</pre>
<div class="block">Shortcut for calling <code>getFormData().getString(name)</code>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -1067,7 +1091,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getPathMatch</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RequestPath.html" title="class in org.apache.juneau.rest">RequestPath</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.643">getPathMatch</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RequestPath.html" title="class in org.apache.juneau.rest">RequestPath</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.657">getPathMatch</a>()</pre>
<div class="block">Request path match.
<p>
@@ -1119,7 +1143,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getPath</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/RestRequest.html#line.653">getPath</a>(<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> name)</pre>
+<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/RestRequest.html#line.667">getPath</a>(<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> name)</pre>
<div class="block">Shortcut for calling <code>getPathMatch().get(name)</code>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -1135,7 +1159,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getPathRemainder</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/RestRequest.html#line.662">getPathRemainder</a>()</pre>
+<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/RestRequest.html#line.676">getPathRemainder</a>()</pre>
<div class="block">Shortcut for calling <code>getPathMatch().getRemainder()</code>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1149,7 +1173,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getBody</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RequestBody.html" title="class in org.apache.juneau.rest">RequestBody</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.704">getBody</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RequestBody.html" title="class in org.apache.juneau.rest">RequestBody</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.718">getBody</a>()</pre>
<div class="block">Request body.
<p>
@@ -1191,7 +1215,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getReader</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io">BufferedReader</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.719">getReader</a>()
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io">BufferedReader</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.733">getReader</a>()
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Returns the HTTP body content as a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>.
@@ -1217,7 +1241,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getInputStream</h4>
-<pre>public javax.servlet.ServletInputStream <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.733">getInputStream</a>()
+<pre>public javax.servlet.ServletInputStream <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.747">getInputStream</a>()
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Returns the HTTP body content as an <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>.
@@ -1241,7 +1265,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getContextPath</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/RestRequest.html#line.747">getContextPath</a>()</pre>
+<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/RestRequest.html#line.761">getContextPath</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>getContextPath</code> in interface <code>javax.servlet.http.HttpServletRequest</code></dd>
@@ -1256,7 +1280,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getAuthorityPath</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/RestRequest.html#line.757">getAuthorityPath</a>()</pre>
+<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/RestRequest.html#line.771">getAuthorityPath</a>()</pre>
<div class="block">Returns the URI authority portion of the request.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1270,7 +1294,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getServletPath</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/RestRequest.html#line.772">getServletPath</a>()</pre>
+<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/RestRequest.html#line.786">getServletPath</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>getServletPath</code> in interface <code>javax.servlet.http.HttpServletRequest</code></dd>
@@ -1285,7 +1309,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getUriContext</h4>
-<pre>public <a href="../../../../org/apache/juneau/UriContext.html" title="class in org.apache.juneau">UriContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.787">getUriContext</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/UriContext.html" title="class in org.apache.juneau">UriContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.801">getUriContext</a>()</pre>
<div class="block">Returns the URI context of the request.
<p>
@@ -1303,7 +1327,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getUriResolver</h4>
-<pre>public <a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.800">getUriResolver</a>(<a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a> resolution,
+<pre>public <a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.814">getUriResolver</a>(<a href="../../../../org/apache/juneau/UriResolution.html" title="enum in org.apache.juneau">UriResolution</a> resolution,
<a href="../../../../org/apache/juneau/UriRelativity.html" title="enum in org.apache.juneau">UriRelativity</a> relativity)</pre>
<div class="block">Returns a URI resolver that can be used to convert URIs to absolute or root-relative form.</div>
<dl>
@@ -1321,7 +1345,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getUriResolver</h4>
-<pre>public <a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.810">getUriResolver</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau">UriResolver</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.824">getUriResolver</a>()</pre>
<div class="block">Shortcut for calling <a href="../../../../org/apache/juneau/rest/RestRequest.html#getUriResolver--"><code>getUriResolver()</code></a> using <a href="../../../../org/apache/juneau/UriResolution.html#ROOT_RELATIVE"><code>UriResolution.ROOT_RELATIVE</code></a> and
<a href="../../../../org/apache/juneau/UriRelativity.html#RESOURCE"><code>UriRelativity.RESOURCE</code></a></div>
<dl>
@@ -1336,7 +1360,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getUri</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.826">getUri</a>(boolean includeQuery,
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.840">getUri</a>(boolean includeQuery,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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>,?> addQueryParams)</pre>
<div class="block">Returns the URI for this request.
@@ -1359,7 +1383,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getInfoProvider</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest">RestInfoProvider</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.895">getInfoProvider</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest">RestInfoProvider</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.909">getInfoProvider</a>()</pre>
<div class="block">Resource information provider.
<p>
@@ -1412,7 +1436,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getSwagger</h4>
-<pre>public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.933">getSwagger</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger">Swagger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.947">getSwagger</a>()</pre>
<div class="block">Returns the localized swagger associated with the resource.
<p>
@@ -1455,7 +1479,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getSiteName</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/RestRequest.html#line.970">getSiteName</a>()</pre>
+<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/RestRequest.html#line.984">getSiteName</a>()</pre>
<div class="block">Returns the localized site name.
<p>
@@ -1490,7 +1514,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getResourceTitle</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/RestRequest.html#line.990">getResourceTitle</a>()</pre>
+<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/RestRequest.html#line.1004">getResourceTitle</a>()</pre>
<div class="block">Returns the localized resource title.
<p>
@@ -1510,7 +1534,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getResourceDescription</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/RestRequest.html#line.1010">getResourceDescription</a>()</pre>
+<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/RestRequest.html#line.1024">getResourceDescription</a>()</pre>
<div class="block">Returns the localized resource description.
<p>
@@ -1530,7 +1554,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getMethodSummary</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/RestRequest.html#line.1030">getMethodSummary</a>()</pre>
+<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/RestRequest.html#line.1044">getMethodSummary</a>()</pre>
<div class="block">Returns the localized method summary.
<p>
@@ -1550,7 +1574,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getMethodDescription</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/RestRequest.html#line.1050">getMethodDescription</a>()
+<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/RestRequest.html#line.1064">getMethodDescription</a>()
throws <a href="../../../../org/apache/juneau/rest/RestException.html" title="class in org.apache.juneau.rest">RestException</a>,
<a href="../../../../org/apache/juneau/rest/exception/InternalServerError.html" title="class in org.apache.juneau.rest.exception">InternalServerError</a></pre>
<div class="block">Returns the localized method description.
@@ -1572,7 +1596,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getSerializers</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1074">getSerializers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerGroup.html" title="class in org.apache.juneau.serializer">SerializerGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1088">getSerializers</a>()</pre>
<div class="block">Returns the serializers associated with this request.
<h5 class='section'>See Also:</h5>
@@ -1591,7 +1615,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getParsers</h4>
-<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1088">getParsers</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/parser/ParserGroup.html" title="class in org.apache.juneau.parser">ParserGroup</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1102">getParsers</a>()</pre>
<div class="block">Returns the parsers associated with this request.
<h5 class='section'>See Also:</h5>
@@ -1610,7 +1634,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getPartParser</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1097">getPartParser</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartParser.html" title="interface in org.apache.juneau.httppart">HttpPartParser</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1111">getPartParser</a>()</pre>
<div class="block">Returns the part serializer associated with this request.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1624,7 +1648,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getPartSerializer</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1106">getPartSerializer</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/HttpPartSerializer.html" title="interface in org.apache.juneau.httppart">HttpPartSerializer</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1120">getPartSerializer</a>()</pre>
<div class="block">Returns the part serializer associated with this request.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1638,7 +1662,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getMethod</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/RestRequest.html#line.1118">getMethod</a>()</pre>
+<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/RestRequest.html#line.1132">getMethod</a>()</pre>
<div class="block">Returns the method of this request.
<p>
@@ -1658,7 +1682,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getHttpMethod</h4>
-<pre>public <a href="../../../../org/apache/juneau/http/HttpMethod.html" title="enum in org.apache.juneau.http">HttpMethod</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1130">getHttpMethod</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/http/HttpMethod.html" title="enum in org.apache.juneau.http">HttpMethod</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1144">getHttpMethod</a>()</pre>
<div class="block">Returns the HTTP 1.1 method name of the request as an enum.
<p>
@@ -1675,7 +1699,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getContentLength</h4>
-<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1135">getContentLength</a>()</pre>
+<pre>public int <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1149">getContentLength</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>getContentLength</code> in interface <code>javax.servlet.ServletRequest</code></dd>
@@ -1690,7 +1714,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>isPlainText</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1155">isPlainText</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1169">isPlainText</a>()</pre>
<div class="block">Returns <jk>true</jk> if <code>&plainText=true</code> was specified as a URL parameter.
<p>
@@ -1711,7 +1735,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getMessageBundle</h4>
-<pre>public <a href="../../../../org/apache/juneau/utils/MessageBundle.html" title="class in org.apache.juneau.utils">MessageBundle</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1192">getMessageBundle</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/utils/MessageBundle.html" title="class in org.apache.juneau.utils">MessageBundle</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1206">getMessageBundle</a>()</pre>
<div class="block">Returns the resource bundle for the request locale.
<h5 class='section'>Example:</h5>
@@ -1752,7 +1776,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getMessage</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/RestRequest.html#line.1203">getMessage</a>(<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>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/RestRequest.html#line.1217">getMessage</a>(<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,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>... args)</pre>
<div class="block">Shortcut method for calling <a href="../../../../org/apache/juneau/utils/MessageBundle.html#getString-java.util.Locale-java.lang.String-java.lang.Object...-"><code>MessageBundle.getString(Locale, String, Object...)</code></a> based on the request locale.</div>
<dl>
@@ -1770,7 +1794,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getContext</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1216">getContext</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestContext.html" title="class in org.apache.juneau.rest">RestContext</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1230">getContext</a>()</pre>
<div class="block">Returns the resource context handling the request.
<p>
@@ -1788,7 +1812,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getJavaMethod</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1236">getJavaMethod</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1250">getJavaMethod</a>()</pre>
<div class="block">Returns the java method handling the request.
<p>
@@ -1813,7 +1837,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getBeanSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1245">getBeanSession</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1259">getBeanSession</a>()</pre>
<div class="block">Returns the <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau"><code>BeanSession</code></a> associated with this request.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1827,7 +1851,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>isDebug</h4>
-<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1256">isDebug</a>()</pre>
+<pre>public boolean <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1270">isDebug</a>()</pre>
<div class="block">Returns <jk>true</jk> if debug mode is enabled.
Debug mode is enabled by simply adding <js>"?debug=true"</js> to the query string or adding a <code>Debug: true</code> header on the request.</div>
@@ -1843,7 +1867,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getVarResolverSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1293">getVarResolverSession</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1307">getVarResolverSession</a>()</pre>
<div class="block">Request-level variable resolver session.
<p>
@@ -1885,7 +1909,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getClasspathReaderResource</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1330">getClasspathReaderResource</a>(<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> name,
+<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1344">getClasspathReaderResource</a>(<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> name,
boolean resolveVars,
<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> mediaType)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
@@ -1929,7 +1953,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getClasspathReaderResource</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1352">getClasspathReaderResource</a>(<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> name,
+<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1366">getClasspathReaderResource</a>(<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> name,
boolean resolveVars)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Same as <a href="../../../../org/apache/juneau/rest/RestRequest.html#getClasspathReaderResource-java.lang.String-boolean-org.apache.juneau.http.MediaType-"><code>getClasspathReaderResource(String, boolean, MediaType)</code></a> except uses the resource mime-type map
@@ -1953,7 +1977,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getClasspathReaderResource</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1363">getClasspathReaderResource</a>(<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> name)
+<pre>public <a href="../../../../org/apache/juneau/rest/helper/ReaderResource.html" title="class in org.apache.juneau.rest.helper">ReaderResource</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1377">getClasspathReaderResource</a>(<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> name)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Same as <a href="../../../../org/apache/juneau/rest/RestRequest.html#getClasspathReaderResource-java.lang.String-boolean-"><code>getClasspathReaderResource(String, boolean)</code></a> with <code>resolveVars == <jk>false</jk></code></div>
<dl>
@@ -1972,7 +1996,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getConfig</h4>
-<pre>public <a href="../../../../org/apache/juneau/config/Config.html" title="class in org.apache.juneau.config">Config</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1410">getConfig</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/config/Config.html" title="class in org.apache.juneau.config">Config</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1424">getConfig</a>()</pre>
<div class="block">Config file associated with the resource.
<p>
@@ -2023,7 +2047,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getWidgets</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest. [...]
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<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="../../../../org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget">Widget</a>> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest. [...]
<div class="block">Returns the widgets used for resolving <js>"$W{...}"</js> string variables.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -2038,7 +2062,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getRequest</h4>
-<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1468">getRequest</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c)</pre>
+<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1482">getRequest</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c)</pre>
<div class="block">Creates a proxy interface to retrieve HTTP parts of this request as a proxy bean.
<h5 class='section'>Examples:</h5>
@@ -2089,7 +2113,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getRequest</h4>
-<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1478">getRequest</a>(<a href="../../../../org/apache/juneau/httppart/bean/RequestBeanMeta.html" title="class in org.apache.juneau.httppart.bean">RequestBeanMeta</a> rbm)</pre>
+<pre>public <T> T <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1492">getRequest</a>(<a href="../../../../org/apache/juneau/httppart/bean/RequestBeanMeta.html" title="class in org.apache.juneau.httppart.bean">RequestBeanMeta</a> rbm)</pre>
<div class="block">Same as <a href="../../../../org/apache/juneau/rest/RestRequest.html#getRequest-java.lang.Class-"><code>getRequest(Class)</code></a> but used on pre-instantiated <a href="../../../../org/apache/juneau/httppart/bean/RequestBeanMeta.html" title="class in org.apache.juneau.httppart.bean"><code>RequestBeanMeta</code></a> objects.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -2105,7 +2129,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>toString</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/RestRequest.html#line.1516">toString</a>()</pre>
+<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/RestRequest.html#line.1530">toString</a>()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
@@ -2118,7 +2142,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getSerializerSessionArgs</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1548">getSerializerSessionArgs</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1562">getSerializerSessionArgs</a>()</pre>
<div class="block">Returns the session arguments to pass to serializers.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -2132,7 +2156,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getParserSessionArgs</h4>
-<pre>public <a href="../../../../org/apache/juneau/parser/ParserSessionArgs.html" title="class in org.apache.juneau.parser">ParserSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1559">getParserSessionArgs</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/parser/ParserSessionArgs.html" title="class in org.apache.juneau.parser">ParserSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1573">getParserSessionArgs</a>()</pre>
<div class="block">Returns the session arguments to pass to parsers.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -2146,7 +2170,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getLogger</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/RestLogger.html" title="interface in org.apache.juneau.rest">RestLogger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1599">getLogger</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/RestLogger.html" title="interface in org.apache.juneau.rest">RestLogger</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1613">getLogger</a>()</pre>
<div class="block">Logger.
<p>
@@ -2188,7 +2212,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getResponseBeanMeta</h4>
-<pre>public <a href="../../../../org/apache/juneau/httppart/bean/ResponseBeanMeta.html" title="class in org.apache.juneau.httppart.bean">ResponseBeanMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1619">getResponseBeanMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
+<pre>public <a href="../../../../org/apache/juneau/httppart/bean/ResponseBeanMeta.html" title="class in org.apache.juneau.httppart.bean">ResponseBeanMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1633">getResponseBeanMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/Response.html" title="annotation in org.apache.juneau.http.annotation"><code>@Response</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -2204,7 +2228,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockList">
<li class="blockList">
<h4>getResponseHeaderMeta</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1629">getResponseHeaderMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1643">getResponseHeaderMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/ResponseHeader.html" title="annotation in org.apache.juneau.http.annotation"><code>@ResponseHeader</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -2220,7 +2244,7 @@ extends javax.servlet.http.HttpServletRequestWrapper</pre>
<ul class="blockListLast">
<li class="blockList">
<h4>getResponseBodyMeta</h4>
-<pre>public <a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1639">getResponseBodyMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
+<pre>public <a href="../../../../org/apache/juneau/rest/ResponsePartMeta.html" title="class in org.apache.juneau.rest">ResponsePartMeta</a> <a href="../../../../src-html/org/apache/juneau/rest/RestRequest.html#line.1653">getResponseBodyMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)</pre>
<div class="block">Returns metadata about the specified response object if it's annotated with <a href="../../../../org/apache/juneau/http/annotation/ResponseBody.html" title="annotation in org.apache.juneau.http.annotation"><code>@ResponseBody</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/vars/RequestVar.html b/content/site/apidocs_preview/org/apache/juneau/rest/vars/RequestVar.html
index 118fd25..e8e7aaf 100644
--- a/content/site/apidocs_preview/org/apache/juneau/rest/vars/RequestVar.html
+++ b/content/site/apidocs_preview/org/apache/juneau/rest/vars/RequestVar.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/RequestVar.html#line.66">RequestVar</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.65">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.
@@ -147,7 +147,6 @@ extends <a href="../../../../../org/apache/juneau/svl/MultipartResolvingVar.html
<li><js>"servletParentURI"</js> - Value returned by <a href="../../../../../org/apache/juneau/UriContext.html#getRootRelativeServletPathParent--"><code>UriContext.getRootRelativeServletPathParent()</code></a>
<li><js>"servletPath"</js> - See <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getServletPath--"><code>RestRequest.getServletPath()</code></a>
<li><js>"servletURI"</js> - See <a href="../../../../../org/apache/juneau/UriContext.html#getRootRelativeServletPath--"><code>UriContext.getRootRelativeServletPath()</code></a>
- <li><js>"siteName"</js> - See <a href="../../../../../org/apache/juneau/rest/RestRequest.html#getSiteName--"><code>RestRequest.getSiteName()</code></a>
</ul>
<h5 class='section'>Example:</h5>
@@ -301,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.71">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.70">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>
@@ -315,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.75">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.74">NAME</a></pre>
<div class="block">The name of this variable.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
@@ -337,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.80">RequestVar</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.79">RequestVar</a>()</pre>
<div class="block">Constructor.</div>
</li>
</ul>
@@ -355,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.85">allowNested</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.84">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.
@@ -380,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.90">allowRecurse</a>()</pre>
+<pre>protected boolean <a href="../../../../../src-html/org/apache/juneau/rest/vars/RequestVar.html#line.89">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.
@@ -410,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.95">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.94">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>
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/ContentTypeMenuItem.png b/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/ContentTypeMenuItem.png
deleted file mode 100644
index 6c8db5c..0000000
Binary files a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/ContentTypeMenuItem.png and /dev/null differ
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByApacheWidget.png b/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByApacheWidget.png
deleted file mode 100644
index dd3d63f..0000000
Binary files a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByApacheWidget.png and /dev/null differ
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByJuneauWidget.png b/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByJuneauWidget.png
deleted file mode 100644
index 7273413..0000000
Binary files a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/PoweredByJuneauWidget.png and /dev/null differ
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_1.png b/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_1.png
deleted file mode 100644
index a577695..0000000
Binary files a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_1.png and /dev/null differ
diff --git a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_2.png b/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_2.png
deleted file mode 100644
index 71679f9..0000000
Binary files a/content/site/apidocs_preview/org/apache/juneau/rest/widget/doc-files/QueryMenuItem_2.png and /dev/null differ
diff --git a/content/site/apidocs_preview/overview-summary.html b/content/site/apidocs_preview/overview-summary.html
index f1b972d..2ace060 100644
--- a/content/site/apidocs_preview/overview-summary.html
+++ b/content/site/apidocs_preview/overview-summary.html
@@ -803,10 +803,21 @@
<li><p class=''><a class='doclink' href='#juneau-rest-server.ConfigurationFiles'>Configuration Files</a></p>
<li><p class=''><a class='doclink' href='#juneau-rest-server.StaticFiles'>Static files</a></p>
<li><p class=''><a class='doclink' href='#juneau-rest-server.ClientVersioning'>Client Versioning</a></p>
- <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger'>Swagger</a></p>
+ <li><p class='updated'><a class='doclink' href='#juneau-rest-server.RestInfoProvider'>RestInfoProvider</a></p>
<ol>
- <li><p class=''><a class='doclink' href='#juneau-rest-server.Swagger.RestInfoProvider'>RestInfoProvider</a></p>
- <li><p class=''><a class='doclink' href='#juneau-rest-server.Swagger.BasicRestInfoProvider'>BasicRestInfoProvider</a></p>
+ <li><p class='updated'><a class='doclink' href='#juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'>BasicRestInfoProvider</a></p>
+ </ol>
+ <li><p class='new'><a class='doclink' href='#juneau-rest-server.Swagger'>Swagger</a></p>
+ <ol>
+ <li><p class='new'><a class='doclink' href='#juneau-rest-server.Swagger.BasicRestServlet'>BasicRestServlet</a></p>
+ <li><p class='new'><a class='doclink' href='#juneau-rest-server.Swagger.BasicSwaggerInfo'>Basic Swagger Info</a></p>
+ <li><p class='new'><a class='doclink' href='#juneau-rest-server.Swagger.Tags'>Tags</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.Operations'>Operations</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.Parameters'>Parameters</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.ParameterExamples'>Parameter Examples</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.Responses'>Responses</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.ResponseExamples'>Response Examples</a></p>
+ <li><p class='todo'><a class='doclink' href='#juneau-rest-server.Swagger.Models'>Response Examples</a></p>
</ol>
<li><p class=''><a class='doclink' href='#juneau-rest-server.HtmlDocAnnotation'>@HtmlDoc</a></p>
<ol>
@@ -13465,43 +13476,21 @@
<js>"up: request:/.."</js>,
<js>"options: servlet:/?method=OPTIONS"</js>
}
- ),
-
- <jc>// POJO swaps to apply to all serializers/parsers.</jc>
- pojoSwaps={
- <jc>// Use the SwaggerUI swap when rendering Swagger beans.</jc>
- SwaggerUI.<jk>class</jk>
- },
-
- <jc>// Properties to apply to all serializers/parsers and REST-specific API objects.</jc>
- properties={
- <jc>// Add descriptions to the following types when not specified:</jc>
- <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>, value=<js>"bean,collection,array,map,enum"</js>),
-
- <jc>// Automatically add examples to the following types:</jc>
- <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>, value=<js>"bean,collection,array,map"</js>),
-
- <jc>// Don't generate schema information on the Swagger bean itself or HTML beans.</jc>
- <ja>@Property</ja>(name=<jsf>INFOPROVIDER_ignoreTypes</jsf>, value="<js>Swagger,org.apache.juneau.dto.html5.*"</js>)
- },
-
- <jc>// Shortcut for boolean properties.</jc>
- flags={
- <jc>// Use $ref references for bean definitions to reduce duplication in Swagger.</jc>
- <jsf>JSONSCHEMA_useBeanDefs</jsf>
- }
+ )
)
<jk>public abstract class</jk> BasicRestServlet <jk>extends</jk> RestServlet <jk>implements</jk> BasicRestConfig {
<jd>/**
* [OPTIONS /*] - Show resource options.
*
- * @param req The HTTP request.
- * @return A bean containing the contents for the OPTIONS page.
+ * <ja>@param</ja> req The HTTP request.
+ * <ja>@return</ja> A bean containing the contents for the OPTIONS page.
*/</jd>
<ja>@RestMethod</ja>(name=<jsf>OPTIONS</jsf>, path=<js>"/*"</js>,
+
summary=<js>"Swagger documentation"</js>,
description=<js>"Swagger documentation for this resource."</js>,
+
htmldoc=<ja>@HtmlDoc</ja>(
<jc>// Override the nav links for the swagger page.</jc>
navlinks={
@@ -13510,7 +13499,31 @@
},
<jc>// Never show aside contents of page inherited from class.</jc>
aside=<js>"NONE"</js>
- )
+ ),
+
+ <jc>// POJO swaps to apply to all serializers/parsers.</jc>
+ pojoSwaps={
+ <jc>// Use the SwaggerUI swap when rendering Swagger beans.</jc>
+ SwaggerUI.<jk>class</jk>
+ },
+
+ <jc>// Properties to apply to all serializers/parsers and REST-specific API objects.</jc>
+ properties={
+ <jc>// Add descriptions to the following types when not specified:</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>, value=<js>"bean,collection,array,map,enum"</js>),
+
+ <jc>// Automatically add examples to the following types:</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>, value=<js>"bean,collection,array,map"</js>),
+
+ <jc>// Don't generate schema information on the Swagger bean itself or HTML beans.</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_ignoreTypes</jsf>, value="<js>Swagger,org.apache.juneau.dto.html5.*"</js>)
+ },
+
+ <jc>// Shortcut for boolean properties.</jc>
+ flags={
+ <jc>// Use $ref references for bean definitions to reduce duplication in Swagger.</jc>
+ <jsf>JSONSCHEMA_useBeanDefs</jsf>
+ }
)
<jk>public</jk> Swagger getOptions(RestRequest req) {
<jc>// Localized Swagger for this resource is available through the RestRequest object.</jc>
@@ -18809,47 +18822,8 @@
<!-- ==================================================================================================== -->
-<h3 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger' id='juneau-rest-server.Swagger'>7.26 - Swagger</a></h3>
-<div class='topic'><!-- START: 7.26 - juneau-rest-server.Swagger -->
-<p>
- One of the most useful features of Juneau is the ability to generate Swagger-based OPTIONS pages for self-documenting designs
- (i.e. REST interfaces that document themselves).
-</p>
-<h5 class='figure'>OPTIONS page for HelloWorld sample resource</h5>
-<p class='bpcode w800'>
- http://localhost:10000/helloWorld/?method=OPTIONS
-</p>
-<img class='bordered w800' src='doc-files/juneau-rest-server.OptionsPages.1.png'>
-<p>
- The <a href="org/apache/juneau/rest/BasicRestServlet.html" title="class in org.apache.juneau.rest"><code>BasicRestServlet</code></a> class implements the page by creating a method
- mapped to the <l>OPTIONS</l> HTTP method that simply returns a Swagger bean:
-</p>
-<p class='bpcode w800'>
- <ja>@RestResource</ja>(...)
- <jk>public class</jk> BasicRestServlet <jk>extends</jk> RestServlet {
-
- <ja>@RestMethod</ja>(name=<jsf>OPTIONS</jsf>, path=<js>"/*"</js>,
- summary=<js>"Resource options"</js>,
- htmldoc=<ja>@HtmlDoc</ja>(
- navlinks={
- <js>"back: servlet:/,"</js>,
- <js>"json: servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
- }
- )
- )
- <jk>public</jk> Swagger getOptions(RestRequest req) {
- <jk>return</jk> req.getSwagger();
- }
- }
-</p>
-<p>
- This page is constructed using the Info Provider API described next.
-</p>
-
-<!-- ==================================================================================================== -->
-
-<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.RestInfoProvider' id='juneau-rest-server.Swagger.RestInfoProvider'>7.26.1 - RestInfoProvider</a></h4>
-<div class='topic'><!-- START: 7.26.1 - juneau-rest-server.Swagger.RestInfoProvider -->
+<h3 class='topic updated' onclick='toggle(this)'><a href='#juneau-rest-server.RestInfoProvider' id='juneau-rest-server.RestInfoProvider'>7.26 - RestInfoProvider</a></h3>
+<div class='topic'><!-- START: 7.26 - juneau-rest-server.RestInfoProvider -->
<p>
The <a href="org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest"><code>RestInfoProvider</code></a> class is used to find the title
and description for your resource and also generate the Swagger documentation.
@@ -18893,12 +18867,11 @@
While you can implement this interface from scratch, you may want to instead consider extending
from the <l>BasicRestInfoProvider</l> class described next.
</p>
-</div><!-- END: 7.26.1 - juneau-rest-server.Swagger.RestInfoProvider -->
<!-- ==================================================================================================== -->
-<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.BasicRestInfoProvider' id='juneau-rest-server.Swagger.BasicRestInfoProvider'>7.26.2 - BasicRestInfoProvider</a></h4>
-<div class='topic'><!-- START: 7.26.2 - juneau-rest-server.Swagger.BasicRestInfoProvider -->
+<h4 class='topic updated' onclick='toggle(this)'><a href='#juneau-rest-server.RestInfoProvider.BasicRestInfoProvider' id='juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'>7.26.1 - BasicRestInfoProvider</a></h4>
+<div class='topic'><!-- START: 7.26.1 - juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
<p>
The <a href="org/apache/juneau/rest/BasicRestInfoProvider.html" title="class in org.apache.juneau.rest"><code>BasicRestInfoProvider</code></a> class is the default implementation of the
<a href="org/apache/juneau/rest/RestInfoProvider.html" title="interface in org.apache.juneau.rest"><code>RestInfoProvider</code></a> interface.
@@ -18909,77 +18882,445 @@
<ul>
<li>Localized JSON Swagger files in the classpath.
<li>Reflection.
- <li> annotations.
- <li>Info provided in properties files.
+ <li>Annotations.
+ <li>Properties files.
</ul>
<p>
The class itself is designed to be extended if you wish to rely mostly on the default behavior, but tweak
certain aspects.
</p>
+</div><!-- END: 7.26.1 - juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
+</div><!-- END: 7.26 - juneau-rest-server.RestInfoProvider -->
+
+<!-- ==================================================================================================== -->
+
+<h3 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger' id='juneau-rest-server.Swagger'>7.27 - Swagger</a></h3>
+<div class='topic'><!-- START: 7.27 - juneau-rest-server.Swagger -->
<p>
- The default provider provides several options for defining Swagger documentation on your resource:
+ One of the most useful features of Juneau is the ability to generate Swagger-based OPTIONS pages for self-documenting designs
+ (i.e. REST interfaces that document themselves).
</p>
-<ul class='spaced-list'>
- <li>
- Provide nothing.
- <br>You'll still get an auto-generated Swagger doc with information gather solely through reflection, including methods, parameters, consumes/produces, etc...
- <li>
- Specify localized JSON Swagger files on your classpath.
- <br><h5 class='figure'>Example:</h5>
- <p class='bcode w800'>
- MyResource_ja_JP.json
- </p>
- <li>
- Use <a href="org/apache/juneau/rest/annotation/RestResource.html#swagger--"><code>@RestResource(swagger)</code></a> and <a href="org/apache/juneau/rest/annotation/RestMethod.html#swagger--"><code>@RestMethod(swagger)</code></a>
- annotations on your resource classes and methods.
- <br><h5 class='figure'>Example:</h5>
- <p class='bcode w800'>
- <ja>@RestMethod</ja>(
- swagger=<js>"{tags:'foo,bar,baz'}</js>
+<p>
+ As described previously, the <code>PetStore</code> example provides an example of auto-generated Swagger JSON:
+</p>
+<img class='bordered' style='width:900px' src='doc-files/juneau-rest-server.Swagger.1.png'>
+<p>
+ Using <a href="org/apache/juneau/dto/swagger/ui/SwaggerUI.html" title="class in org.apache.juneau.dto.swagger.ui"><code>SwaggerUI</code></a>, we're able to render that JSON as a Swagger user interface:
+</p>
+<img class='bordered' style='width:900px' src='doc-files/juneau-rest-server.Swagger.2.png'>
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.BasicRestServlet' id='juneau-rest-server.Swagger.BasicRestServlet'>7.27.1 - BasicRestServlet</a></h4>
+<div class='topic'><!-- START: 7.27.1 - juneau-rest-server.Swagger.BasicRestServlet -->
+<p>
+ Any subclass of <a href="org/apache/juneau/rest/BasicRestServlet.html" title="class in org.apache.juneau.rest"><code>BasicRestServlet</code></a> gets an auto-generated Swagger UI when performing an <code>OPTIONS</code>
+ request with <code>Accept:text/html</code>.
+</p>
+<p>
+ The underlying mechanics are simple.
+ The <a href="org/apache/juneau/rest/BasicRestServlet.html#getOptions-org.apache.juneau.rest.RestRequest-"><code>BasicRestServlet.getOptions(RestRequest)</code></a> method returns a <a href="org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger"><code>Swagger</code></a> bean
+ consisting of information gathered from annotations and other sources.
+ Then that bean is swapped for a <a href="org/apache/juneau/dto/swagger/ui/SwaggerUI.html" title="class in org.apache.juneau.dto.swagger.ui"><code>SwaggerUI</code></a> bean when rendered as HTML.
+</p>
+<p>
+ Here's the class that defines the behavior:
+</p>
+<p class='bpcode w800'>
+ <ja>@RestResource</ja>(
+
+ <jc>// Allow OPTIONS requests to be simulated using ?method=OPTIONS query parameter.</jc>
+ allowedMethodParams=<js>"OPTIONS"</js>,
+
+ ...
)
- <jk>public</jk> Object myMethod() {...}
- </p>
- <li>
- Use properties files identified by the <a href="org/apache/juneau/rest/annotation/RestResource.html#messages--"><code>@RestResource(messages)</code></a> annotation.
- <br><h5 class='figure'>Example:</h5>
- <p class='bcode w800'>
- <ck>MyResource.myMethod.tags</ck> = <cv>foo,bar,baz</cv>
- </p>
- <li>
- Use any combination of the above.
- <li>
- Extend the <l>BasicRestInfoProvider</l> and provide customized behavior.
- <br><h5 class='figure'>Example:</h5>
- <p class='bcode w800'>
- <jc>// Our customized info provider.</jc>
- <jc>// Extend from the default implementation and selectively override values.</jc>
- <jk>public class</jk> MyRestInfoProvider <jk>extends</jk> BasicRestInfoProvider {
+ <jk>public abstract class</jk> BasicRestServlet <jk>extends</jk> RestServlet <jk>implements</jk> BasicRestConfig {
+
+ <jd>/**
+ * [OPTIONS /*] - Show resource options.
+ *
+ * <ja>@param</ja> req The HTTP request.
+ * <ja>@return</ja> A bean containing the contents for the OPTIONS page.
+ */</jd>
+ <ja>@RestMethod</ja>(name=<jsf>OPTIONS</jsf>, path=<js>"/*"</js>,
+
+ summary=<js>"Swagger documentation"</js>,
+ description=<js>"Swagger documentation for this resource."</js>,
+
+ htmldoc=<ja>@HtmlDoc</ja>(
+ <jc>// Override the nav links for the swagger page.</jc>
+ navlinks={
+ <js>"back: servlet:/"</js>,
+ <js>"json: servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
+ },
+ <jc>// Never show aside contents of page inherited from class.</jc>
+ aside=<js>"NONE"</js>
+ ),
+
+ <jc>// POJO swaps to apply to all serializers/parsers.</jc>
+ pojoSwaps={
+ <jc>// Use the SwaggerUI swap when rendering Swagger beans.</jc>
+ <jc>// This is a per-media-type swap that only applies to text/html requests.</jc>
+ SwaggerUI.<jk>class</jk>
+ },
+
+ <jc>// Properties to apply to all serializers/parsers and REST-specific API objects.</jc>
+ properties={
+ <jc>// Add descriptions to the following types when not specified:</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>, value=<js>"bean,collection,array,map,enum"</js>),
+
+ <jc>// Add x-example to the following types:</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>, value=<js>"bean,collection,array,map"</js>),
+
+ <jc>// Don't generate schema information on the Swagger bean itself or HTML beans.</jc>
+ <ja>@Property</ja>(name=<jsf>JSONSCHEMA_ignoreTypes</jsf>, value=<js>"Swagger,org.apache.juneau.dto.html5.*"</js>)
+ },
- <jc>// Must provide this constructor!</jc>
- <jk>public</jk> MyRestInfoProvider(RestContext context) {
- <jk>super</jk>(context);
+ <jc>// Shortcut for boolean properties.</jc>
+ flags={
+ <jc>// Use $ref references for bean definitions to reduce duplication in Swagger.</jc>
+ <jsf>JSONSCHEMA_useBeanDefs</jsf>
+ }
+ )
+ <jk>public</jk> Swagger getOptions(RestRequest req) {
+ <jc>// Localized Swagger for this resource is available through the RestRequest object.</jc>
+ <jk>return</jk> req.getSwagger();
}
+ }
+</p>
+<p>
+ Note that to have your resource create Swagger UI, you must either extend from <a href="org/apache/juneau/rest/BasicRestServlet.html" title="class in org.apache.juneau.rest"><code>BasicRestServlet</code></a> or provide
+ your own <ja>@RestMethod</ja>-annotated method that returns a <a href="org/apache/juneau/dto/swagger/Swagger.html" title="class in org.apache.juneau.dto.swagger"><code>Swagger</code></a> object and a <a href="org/apache/juneau/dto/swagger/ui/SwaggerUI.html" title="class in org.apache.juneau.dto.swagger.ui"><code>SwaggerUI</code></a> swap.
+</p>
+</div><!-- END: 7.27.1 - juneau-rest-server.Swagger.BasicRestServlet -->
- <ja>@Override</ja> <jc>/* RestInfoProvider */</jc>
- <jk>public</jk> Swagger getSwagger(RestRequest req) <jk>throws</jk> RestException {
- Swagger s = <jk>super</jk>.getSwagger(req);
- <jc>// Made inline modifications to generated swagger.</jc>
- <jk>return</jk> s;
- }
+<!-- ==================================================================================================== -->
+
+<h4 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.BasicSwaggerInfo' id='juneau-rest-server.Swagger.BasicSwaggerInfo'>7.27.2 - Basic Swagger Info</a></h4>
+<div class='topic'><!-- START: 7.27.2 - juneau-rest-server.Swagger.BasicSwaggerInfo -->
+<p>
+ Let's look at the various parts of the <code>Petstore</code> application Swagger UI to see how they are defined.
+</p>
+<p>
+ The top part of the page shows general information about the REST interface:
+</p>
+<img class='bordered' style='width:900px' src='doc-files/juneau-rest-server.Swagger.3.png'>
+<p>
+ The information is pulled from the <a href="org/apache/juneau/rest/annotation/RestResource.html#swagger--"><code>@RestResource(swagger)</code></a> annotation.
+</p>
+<h5 class='figure'>org.apache.juneau.examples.rest.petstore.PetStoreResource</h5>
+<p class='bpcode w800'>
+ <ja>@RestResource</ja>(
+ path=<js>"/petstore"</js>,
+ title=<js>"Petstore application"</js>,
+ ...
+ swagger=@ResourceSwagger(<js>"$F{PetStoreResource.json}"</js>),
+ ...
+ )
+ <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServletJena {...}
+</p>
+<p>
+ In this particular case, the Swagger is pulled in from a localized Swagger JSON file located in the
+ <code>org.apache.juneau.examples.rest.petstore</code> package using the <a href="org/apache/juneau/rest/vars/FileVar.html" title="class in org.apache.juneau.rest.vars"><code>$F</code></a> variable.
+</p>
+<h5 class='figure'>PetStoreResource.json</h5>
+<p class='bpcode w800'>
+ {
+ <jok>"swagger"</jok>: <jov>"2.0"</jov>,
+ <jok>"info"</jok>: {
+ <jok>"version"</jok>: <jov>"1.0.0"</jov>,
+ <jok>"title"</jok>: <jov>"Swagger Petstore"</jov>,
+ <jok>"termsOfService"</jok>: <jov>"You are on your own."</jov>,
+ <jok>"contact"</jok>: {
+ <jok>"name"</jok>: <jov>"Juneau Development Team"</jov>,
+ <jok>"email"</jok>: <jov>"dev@juneau.apache.org"</jov>,
+ <jok>"url"</jok>: <jov>"http://juneau.apache.org"</jov>
+ },
+ <jok>"license"</jok>: {
+ <jok>"name"</jok>: <jov>"Apache 2.0"</jov>,
+ <jok>"url"</jok>: <jov>"http://www.apache.org/licenses/LICENSE-2.0.html"</jov>
+ }
+ },
+ <jok>"externalDocs"</jok>: {
+ <jok>"description"</jok>: <jov>"Find out more about Juneau"</jov>,
+ <jok>"url"</jok>: <jov>"http://juneau.apache.org"</jov>
+ },
+ ...
}
+</p>
+<p>
+ Note that the <a href="org/apache/juneau/rest/vars/FileVar.html" title="class in org.apache.juneau.rest.vars"><code>$F</code></a> variable allows for request-locale-sensitive name matching so that you can provide
+ localized Swagger information.
+</p>
+<p>
+ The <a href="org/apache/juneau/rest/vars/FileVar.html" title="class in org.apache.juneau.rest.vars"><code>$F</code></a> variable simply expands to a string to fill the <a href="org/apache/juneau/rest/annotation/ResourceSwagger.html#value--"><code>@ResourceSwagger(value)</code></a>
+ annotation.
+ You could equivalently embed JSON directly into your annotation like so:
+</p>
+<p class='bpcode w800'>
+ <ja>@RestResource</ja>(
+ path=<js>"/petstore"</js>,
+ title=<js>"Petstore application"</js>,
+ ...
+ swagger=<ja>@ResourceSwagger</ja>(
+ <jc>// Raw Simplified JSON.</jc>
+ <jc>// Values are concatenated.
+ <js>"{"</js>,
+ <js>"swagger: '2.0',"</js>,
+ <js>"version: '1.0.0',"</js>,
+ ...
+ <js>"}"</js>
+ ),
+ ...
+ )
+ <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServletJena {...}
+</p>
+<p>
+ However, a more typical (and less error-prone) scenario is to define all of your Swagger as annotations:
+</p>
+<p class='bpcode w800'>
+ <ja>@RestResource</ja>(
+ path=<js>"/petstore"</js>,
+ title=<js>"Petstore application"</js>,
+ ...
+ swagger=<ja>@ResourceSwagger</ja>(
+ version=<js>"1.0.0"</js>,
+ title=<js>"Swagger Petstore"</js>,
+ termsOfService=<js>"You are on your own."</js>,
+ contact=<ja>@Contact</ja>(
+ name=<js>"Juneau Development Team"</js>,
+ email=<js>"dev@juneau.apache.org"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ ),
+ license=<ja>@License</ja>(
+ name=<js>"Apache 2.0"</js>,
+ url=<js>"http://www.apache.org/licenses/LICENSE-2.0.html"</js>
+ ),
+ externalDocs=<ja>@ExternalDocs</ja>(
+ description=<js>"Find out more about Juneau"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ )
+ ),
+ ...
+ )
+ <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServletJena {...}
+</p>
+<p>
+ All annotations support <a class='doclink' href='#DefaultRestSvlVariables'>SVL variables</a>, so you could for example
+ pull localized strings from resource bundles using <a href="org/apache/juneau/rest/vars/LocalizationVar.html" title="class in org.apache.juneau.rest.vars"><code>$L</code></a> variables.
+</p>
+<p class='bpcode w800'>
+ <ja>@RestResource</ja>(
+ path=<js>"/petstore"</js>,
+ title=<js>"Petstore application"</js>,
+ messages=<js>"nls/MyMessages"</js>,
+ ...
+ swagger=<ja>@ResourceSwagger</ja>(
+ version=<js>"1.0.0"</js>,
+ title=<js>"$L{myTitle}"</js>,
+ termsOfService=<js>"$L{myTermsOfService}"</js>,
+ contact=<ja>@Contact</ja>(
+ name=<js>"$L{myTeam}"</js>,
+ email=<js>"dev@juneau.apache.org"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ ),
+ license=<ja>@License</ja>(
+ name=<js>"Apache 2.0"</js>,
+ url=<js>"http://www.apache.org/licenses/LICENSE-2.0.html"</js>
+ ),
+ externalDocs=<ja>@ExternalDocs</ja>(
+ description=<js>"$L{myExternalDocsDescription}"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ )
+ ),
+ ...
+ )
+ <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServletJena {...}
+</p>
+<p>
+ A third option is to define your Swagger information in your <a href="org/apache/juneau/rest/annotation/RestResource.html#messages--"><code>@RestResource(messages)</code></a> resource
+ bundle using predefined Swagger keywords:
+</p>
+<p class='bpcode w800'>
+ <mk>PetStoreResource.version</mk> = <mv>1.0.0</mv>
+ <mk>PetStoreResource.title</mk> = <mv>Swagger Petstore</mv>
+ <mk>PetStoreResource.termsOfService</mk> = <mv>You are on your own.</mv>
+ <mk>PetStoreResource.contact</mk> = <mv>{name:'Juneau Development Team', email:'dev@juneau.apache.org',...}</mv>
+ <mk>PetStoreResource.license</mk> = <mv>{name:'Apache 2.0',...}</mv>
+ <mk>PetStoreResource.externalDocs</mk> = <mv>{description:'Find out more about Juneau',...}</mv>
+</p>
+<p>
+ Information defined in multiple locations are merged into a single set of data.
+ When the same information is provided in multiple locations, the following order-of-precedence is used:
+</p>
+<ol>
+ <li>Java annotations
+ <li>Resource bundle
+ <li>Swagger JSON file
+</ol>
+</div><!-- END: 7.27.2 - juneau-rest-server.Swagger.BasicSwaggerInfo -->
- <jc>// Registered via annotation</jc>
- <ja>@RestResource</ja>(infoProvider=MyRestInfoProvider.<jk>class</jk>)
- <jk>public class</jk> MyResource {...}
- </p>
-</ul>
-</div><!-- END: 7.26.2 - juneau-rest-server.Swagger.BasicRestInfoProvider -->
-</div><!-- END: 7.26 - juneau-rest-server.Swagger -->
+<!-- ==================================================================================================== -->
+
+<h4 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.Tags' id='juneau-rest-server.Swagger.Tags'>7.27.3 - Tags</a></h4>
+<div class='topic'><!-- START: 7.27.3 - juneau-rest-server.Swagger.Tags -->
+<p>
+ Tags allow you to group operations into general categories.
+ In the user interface, these can be expanded/collapsed by clicking on the tag sections.
+ <br>In the example below, the <code>pet</code> and <code>store</code> tag sections are collapsed
+ and the <code>user</code> section is not:
+</p>
+<img class='bordered' style='width:900px' src='doc-files/juneau-rest-server.Swagger.4.png'>
+<p>
+ Tags are also defined in the <ja>@ResourceSwagger</ja> annotation
+</p>
+<h5 class='figure'>PetStoreResource.json</h5>
+<p class='bpcode w800'>
+ <jok>"tags"</jok>: [
+ {
+ <jok>"name"</jok>: <jov>"pet"</jov>,
+ <jok>"description"</jok>: <jov>"Everything about your Pets"</jov>,
+ <jok>"externalDocs"</jok>: {
+ <jok>"description"</jok>: <jov>"Find out more"</jov>,
+ <jok>"url"</jok>: <jov>"http://juneau.apache.org"</jov>
+ }
+ },
+ {
+ <jok>"name"</jok>: <jov>"store"</jov>,
+ <jok>"description"</jok>: <jov>"Access to Petstore orders"</jov>
+ },
+ {
+ <jok>"name"</jok>: <jov>"user",
+ <jok>"description"</jok>: <jov>"Operations about user"</jov>,
+ <jok>"externalDocs"</jok>: {
+ <jok>"description"</jok>: <jov>"Find out more about our store"</jov>,
+ <jok>"url"</jok>: <jov>"http://juneau.apache.org"</jov>
+ }
+ }
+ ],
+
+</p>
+<p>
+ The annotation-only approach is shown here:
+</p>
+<h5 class='figure'>org.apache.juneau.examples.rest.petstore.PetStoreResource</h5>
+<p class='bpcode w800'>
+ swagger=<ja>@ResourceSwagger</ja>(
+ ...
+ tags={
+ <ja>@Tag</ja>(
+ name=<js>"pet"</js>,
+ description=<js>"Everything about your Pets"</js>,
+ externalDocs=<ja>@ExternalDocs</ja>(
+ description=<js>"Find out more"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ )
+ ),
+ <ja>@Tag</ja>(
+ name=<js>"store"</js>,
+ description=<js>"Access to Petstore orders"</js>
+ ),
+ <ja>@Tag</ja>(
+ name=<js>"user"</js>,
+ description=<js>"Operations about user"</js>,
+ externalDocs=<ja>@ExternalDocs</ja>(
+ description=<js>"Find out more about our store"</js>,
+ url=<js>"http://juneau.apache.org"</js>
+ )
+ )
+ }
+ ),
+</p>
+<p>
+ Tags are associated with operations using the <a href="org/apache/juneau/rest/annotation/MethodSwagger.html#tags--"><code>@MethodSwagger(tags)</code></a> annotation:
+</p>
+
+<h5 class='figure'>GET /user operation</h5>
+<p class='bpcode w800'>
+ <ja>@RestMethod</ja>(
+ name=<jsf>GET</jsf>,
+ path=<js>"/user"</js>,
+ summary=<js>"Petstore users"</js>,
+ swagger=<ja>@MethodSwagger</ja>(
+ tags=<js>"user"</js>
+ )
+ )
+ <jk>public</jk> Collection<User> getUsers() <jk>throws</jk> NotAcceptable {...}
+</p>
+<p>
+ Operations can be mapped to multiple tags.
+</p>
+<p>
+ Tags are optional.
+ Operations not mapped to tags are listed in the UI before tagged operations.
+</p>
+<p>
+ For example, the <code>getTopPage()</code> method in <code>PetStoreResource</code> is not tagged,
+ as well as the <code>getOptions()</code> method inherited from <code>BaseRestServlet</code>, so these
+ show up at the top of the page:
+</p>
+<img class='bordered' style='width:900px' src='doc-files/juneau-rest-server.Swagger.5.png'>
+</div><!-- END: 7.27.3 - juneau-rest-server.Swagger.Tags -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.Operations' id='juneau-rest-server.Swagger.Operations'>7.27.4 - Operations</a></h4>
+<div class='topic'><!-- START: 7.27.4 - juneau-rest-server.Swagger.Operations -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.4 - juneau-rest-server.Swagger.Operations -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.Parameters' id='juneau-rest-server.Swagger.Parameters'>7.27.5 - Parameters</a></h4>
+<div class='topic'><!-- START: 7.27.5 - juneau-rest-server.Swagger.Parameters -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.5 - juneau-rest-server.Swagger.Parameters -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.ParameterExamples' id='juneau-rest-server.Swagger.ParameterExamples'>7.27.6 - Parameter Examples</a></h4>
+<div class='topic'><!-- START: 7.27.6 - juneau-rest-server.Swagger.ParameterExamples -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.6 - juneau-rest-server.Swagger.ParameterExamples -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.Responses' id='juneau-rest-server.Swagger.Responses'>7.27.7 - Responses</a></h4>
+<div class='topic'><!-- START: 7.27.7 - juneau-rest-server.Swagger.Responses -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.7 - juneau-rest-server.Swagger.Responses -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.ResponseExamples' id='juneau-rest-server.Swagger.ResponseExamples'>7.27.8 - Response Examples</a></h4>
+<div class='topic'><!-- START: 7.27.8 - juneau-rest-server.Swagger.ResponseExamples -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.8 - juneau-rest-server.Swagger.ResponseExamples -->
+
+<!-- ==================================================================================================== -->
+
+<h4 class='topic todo' onclick='toggle(this)'><a href='#juneau-rest-server.Swagger.Models' id='juneau-rest-server.Swagger.Models'>7.27.9 - Response Examples</a></h4>
+<div class='topic'><!-- START: 7.27.9 - juneau-rest-server.Swagger.Models -->
+<p>
+ TODO
+</p>
+</div><!-- END: 7.27.9 - juneau-rest-server.Swagger.Models -->
+</div><!-- END: 7.27 - juneau-rest-server.Swagger -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation' id='juneau-rest-server.HtmlDocAnnotation'>7.27 - @HtmlDoc</a></h3>
-<div class='topic'><!-- START: 7.27 - juneau-rest-server.HtmlDocAnnotation -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation' id='juneau-rest-server.HtmlDocAnnotation'>7.28 - @HtmlDoc</a></h3>
+<div class='topic'><!-- START: 7.28 - juneau-rest-server.HtmlDocAnnotation -->
<p>
The <a href="org/apache/juneau/rest/annotation/HtmlDoc.html" title="annotation in org.apache.juneau.rest.annotation"><code>@HtmlDoc</code></a> annotation is used to customize the HTML
view of your serialized POJOs.
@@ -19101,8 +19442,8 @@
<!-- ==================================================================================================== -->
-<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.Widgets' id='juneau-rest-server.HtmlDocAnnotation.Widgets'>7.27.1 - Widgets</a></h4>
-<div class='topic'><!-- START: 7.27.1 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
+<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.Widgets' id='juneau-rest-server.HtmlDocAnnotation.Widgets'>7.28.1 - Widgets</a></h4>
+<div class='topic'><!-- START: 7.28.1 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
<p>
The <a href="org/apache/juneau/rest/widget/Widget.html" title="class in org.apache.juneau.rest.widget"><code>Widget</code></a> class allows you to add arbitrary HTML, CSS, and Javascript
to HTML pages.
@@ -19217,12 +19558,12 @@
<ul>
<li class='jf'><a href="org/apache/juneau/rest/RestContext.html#REST_widgets"><code>RestContext.REST_widgets</code></a>
</ul>
-</div><!-- END: 7.27.1 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
+</div><!-- END: 7.28.1 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
<!-- ==================================================================================================== -->
-<h4 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets' id='juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>7.27.2 - Predefined Widgets</a></h4>
-<div class='topic'><!-- START: 7.27.2 - juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
+<h4 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets' id='juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>7.28.2 - Predefined Widgets</a></h4>
+<div class='topic'><!-- START: 7.28.2 - juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
<p>
The <a href="org/apache/juneau/rest/widget/package-summary.html"><code>org.apache.juneau.rest.widget</code></a> package contains predefined reusable widgets.
</p>
@@ -19460,12 +19801,12 @@
}
}
</p>
-</div><!-- END: 7.27.2 - juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
+</div><!-- END: 7.28.2 - juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
<!-- ==================================================================================================== -->
-<h4 class='topic updated' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.UiCustomization' id='juneau-rest-server.HtmlDocAnnotation.UiCustomization'>7.27.3 - UI Customization</a></h4>
-<div class='topic'><!-- START: 7.27.3 - juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
+<h4 class='topic updated' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.UiCustomization' id='juneau-rest-server.HtmlDocAnnotation.UiCustomization'>7.28.3 - UI Customization</a></h4>
+<div class='topic'><!-- START: 7.28.3 - juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
<p>
The HTML views of POJOs can somewhat be considered a rudimentary User Interface.
In reality, a better term for them would be a Developer Interface as they're meant to be used
@@ -19610,12 +19951,12 @@
<ul>
<li class='link'><a class='doclink' href='#juneau-microservice-server.UiCustomization'>Overview > juneau-microservice-server > UI Customization</a>
</ul>
-</div><!-- END: 7.27.3 - juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
+</div><!-- END: 7.28.3 - juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
<!-- ==================================================================================================== -->
-<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets' id='juneau-rest-server.HtmlDocAnnotation.Stylesheets'>7.27.4 - Stylesheets</a></h4>
-<div class='topic'><!-- START: 7.27.4 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
+<h4 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets' id='juneau-rest-server.HtmlDocAnnotation.Stylesheets'>7.28.4 - Stylesheets</a></h4>
+<div class='topic'><!-- START: 7.28.4 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
<p>
The sample root page renders in the default "devops" look-and-feel:
</p>
@@ -19725,13 +20066,13 @@
}
}
</p>
-</div><!-- END: 7.27.4 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
-</div><!-- END: 7.27 - juneau-rest-server.HtmlDocAnnotation -->
+</div><!-- END: 7.28.4 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
+</div><!-- END: 7.28 - juneau-rest-server.HtmlDocAnnotation -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.DefaultHeaders' id='juneau-rest-server.DefaultHeaders'>7.28 - Default Headers</a></h3>
-<div class='topic'><!-- START: 7.28 - juneau-rest-server.DefaultHeaders -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.DefaultHeaders' id='juneau-rest-server.DefaultHeaders'>7.29 - Default Headers</a></h3>
+<div class='topic'><!-- START: 7.29 - juneau-rest-server.DefaultHeaders -->
<p>
The following annotations are provided for specifying default header values for requests and responses:
</p>
@@ -19773,12 +20114,12 @@
</ul>
</li>
</ul>
-</div><!-- END: 7.28 - juneau-rest-server.DefaultHeaders -->
+</div><!-- END: 7.29 - juneau-rest-server.DefaultHeaders -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.LoggingAndErrorHandling' id='juneau-rest-server.LoggingAndErrorHandling'>7.29 - Logging and Error Handling</a></h3>
-<div class='topic'><!-- START: 7.29 - juneau-rest-server.LoggingAndErrorHandling -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.LoggingAndErrorHandling' id='juneau-rest-server.LoggingAndErrorHandling'>7.30 - Logging and Error Handling</a></h3>
+<div class='topic'><!-- START: 7.30 - juneau-rest-server.LoggingAndErrorHandling -->
<p>
The <a href="org/apache/juneau/rest/RestContext.html#REST_logger"><code>RestContext.REST_logger</code></a> property allows you to configure
logging for your resource.
@@ -19837,12 +20178,12 @@
<li class='jm'><a href="org/apache/juneau/rest/RestServlet.html#log-java.util.logging.Level-java.lang.String-java.lang.Object...-"><code>RestServlet.log(Level,String,Object...)</code></a>
<li class='jm'><a href="org/apache/juneau/rest/RestServlet.html#log-java.util.logging.Level-java.lang.Throwable-java.lang.String-java.lang.Object...-"><code>RestServlet.log(Level,Throwable,String,Object...)</code></a>
</ul>
-</div><!-- END: 7.29 - juneau-rest-server.LoggingAndErrorHandling -->
+</div><!-- END: 7.30 - juneau-rest-server.LoggingAndErrorHandling -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HttpStatusCodes' id='juneau-rest-server.HttpStatusCodes'>7.30 - HTTP Status Codes</a></h3>
-<div class='topic'><!-- START: 7.30 - juneau-rest-server.HttpStatusCodes -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HttpStatusCodes' id='juneau-rest-server.HttpStatusCodes'>7.31 - HTTP Status Codes</a></h3>
+<div class='topic'><!-- START: 7.31 - juneau-rest-server.HttpStatusCodes -->
<p>
By default, a 200 (OK) status is automatically set as the HTTP status when a Java method executes
successfully.
@@ -19905,12 +20246,12 @@
<td>The Java method threw an exception other than <a href="org/apache/juneau/rest/RestException.html" title="class in org.apache.juneau.rest"><code>RestException</code></a></td>
</tr>
</table>
-</div><!-- END: 7.30 - juneau-rest-server.HttpStatusCodes -->
+</div><!-- END: 7.31 - juneau-rest-server.HttpStatusCodes -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.OverloadingHttpMethods' id='juneau-rest-server.OverloadingHttpMethods'>7.31 - Overloading HTTP Methods</a></h3>
-<div class='topic'><!-- START: 7.31 - juneau-rest-server.OverloadingHttpMethods -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.OverloadingHttpMethods' id='juneau-rest-server.OverloadingHttpMethods'>7.32 - Overloading HTTP Methods</a></h3>
+<div class='topic'><!-- START: 7.32 - juneau-rest-server.OverloadingHttpMethods -->
<p>
Through the use of the built-in <l>"method"</l> GET parameter, you can implement requests beyond the basic
REST http method types.
@@ -19934,12 +20275,12 @@
allowedMethodParams=<js>"BAR"</js>
)
</p>
-</div><!-- END: 7.31 - juneau-rest-server.OverloadingHttpMethods -->
+</div><!-- END: 7.32 - juneau-rest-server.OverloadingHttpMethods -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.BuiltInParameters' id='juneau-rest-server.BuiltInParameters'>7.32 - Built-in Parameters</a></h3>
-<div class='topic'><!-- START: 7.32 - juneau-rest-server.BuiltInParameters -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.BuiltInParameters' id='juneau-rest-server.BuiltInParameters'>7.33 - Built-in Parameters</a></h3>
+<div class='topic'><!-- START: 7.33 - juneau-rest-server.BuiltInParameters -->
<p>
The following URL parameters have special meaning and can be passed in through the URL of the request:
</p>
@@ -19999,12 +20340,12 @@
</td>
</tr>
</table>
-</div><!-- END: 7.32 - juneau-rest-server.BuiltInParameters -->
+</div><!-- END: 7.33 - juneau-rest-server.BuiltInParameters -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.CustomSerializersAndParsers' id='juneau-rest-server.CustomSerializersAndParsers'>7.33 - Custom Serializers and Parsers</a></h3>
-<div class='topic'><!-- START: 7.33 - juneau-rest-server.CustomSerializersAndParsers -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.CustomSerializersAndParsers' id='juneau-rest-server.CustomSerializersAndParsers'>7.34 - Custom Serializers and Parsers</a></h3>
+<div class='topic'><!-- START: 7.34 - juneau-rest-server.CustomSerializersAndParsers -->
<p>
A very easy-to-use API is provided for defining your own serializers and parsers at both the servlet and
method levels.
@@ -20125,12 +20466,12 @@
}
}
</p>
-</div><!-- END: 7.33 - juneau-rest-server.CustomSerializersAndParsers -->
+</div><!-- END: 7.34 - juneau-rest-server.CustomSerializersAndParsers -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.UsingWithOsgi' id='juneau-rest-server.UsingWithOsgi'>7.34 - Using with OSGi</a></h3>
-<div class='topic'><!-- START: 7.34 - juneau-rest-server.UsingWithOsgi -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.UsingWithOsgi' id='juneau-rest-server.UsingWithOsgi'>7.35 - Using with OSGi</a></h3>
+<div class='topic'><!-- START: 7.35 - juneau-rest-server.UsingWithOsgi -->
<p>
Since REST servlets are basically just <l>HttpServlets</l>, incorporating them into an OSGi environment
is pretty straightforward.
@@ -20192,12 +20533,12 @@
}
}
</p>
-</div><!-- END: 7.34 - juneau-rest-server.UsingWithOsgi -->
+</div><!-- END: 7.35 - juneau-rest-server.UsingWithOsgi -->
<!-- ==================================================================================================== -->
-<h3 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.UnitTesting' id='juneau-rest-server.UnitTesting'>7.35 - Serverless Unit Testing</a></h3>
-<div class='topic'><!-- START: 7.35 - juneau-rest-server.UnitTesting -->
+<h3 class='topic new' onclick='toggle(this)'><a href='#juneau-rest-server.UnitTesting' id='juneau-rest-server.UnitTesting'>7.36 - Serverless Unit Testing</a></h3>
+<div class='topic'><!-- START: 7.36 - juneau-rest-server.UnitTesting -->
<p>
The <a href="org/apache/juneau/rest/mock/MockRest.html" title="class in org.apache.juneau.rest.mock"><code>MockRest</code></a> class is a simple yet powerful interface for creating serverless
unit tests for your REST interfaces.
@@ -20380,12 +20721,12 @@
client-side request and populating the <a href="org/apache/juneau/rest/mock/MockServletRequest.html" title="class in org.apache.juneau.rest.mock"><code>MockServletRequest</code></a> and <a href="org/apache/juneau/rest/mock/MockServletResponse.html" title="class in org.apache.juneau.rest.mock"><code>MockServletResponse</code></a> objects
directly without involving any sockets.
</p>
-</div><!-- END: 7.35 - juneau-rest-server.UnitTesting -->
+</div><!-- END: 7.36 - juneau-rest-server.UnitTesting -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Injection' id='juneau-rest-server.Injection'>7.36 - Using with Spring and Injection frameworks</a></h3>
-<div class='topic'><!-- START: 7.36 - juneau-rest-server.Injection -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Injection' id='juneau-rest-server.Injection'>7.37 - Using with Spring and Injection frameworks</a></h3>
+<div class='topic'><!-- START: 7.37 - juneau-rest-server.Injection -->
<p>
The Juneau REST server API is compatible with dependency injection frameworks such as Spring.
</p>
@@ -20487,24 +20828,24 @@
<jk>this</jk>.<jf>bean3</jf> = bean3;
}
</p>
-</div><!-- END: 7.36 - juneau-rest-server.Injection -->
+</div><!-- END: 7.37 - juneau-rest-server.Injection -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HTTP2' id='juneau-rest-server.HTTP2'>7.37 - Using HTTP/2 features</a></h3>
-<div class='topic'><!-- START: 7.37 - juneau-rest-server.HTTP2 -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HTTP2' id='juneau-rest-server.HTTP2'>7.38 - Using HTTP/2 features</a></h3>
+<div class='topic'><!-- START: 7.38 - juneau-rest-server.HTTP2 -->
<p>
Juneau is built as a veneer on top of the Servlet API, allowing you to use low-level Servlet APIs
whenever needed.
<br>This allows you to take advantage of the newest HTTP/2 features implemented in the new Servlet 4.0
specification.
</p>
-</div><!-- END: 7.37 - juneau-rest-server.HTTP2 -->
+</div><!-- END: 7.38 - juneau-rest-server.HTTP2 -->
<!-- ==================================================================================================== -->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.OtherNotes' id='juneau-rest-server.OtherNotes'>7.38 - Other Notes</a></h3>
-<div class='topic'><!-- START: 7.38 - juneau-rest-server.OtherNotes -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.OtherNotes' id='juneau-rest-server.OtherNotes'>7.39 - Other Notes</a></h3>
+<div class='topic'><!-- START: 7.39 - juneau-rest-server.OtherNotes -->
<ul class='spaced-list'>
<li>
Subclasses can use either <code>GenericServlet.init(ServletConfig)</code>
@@ -20515,7 +20856,7 @@
For example, to add a <l>"Refresh: 1"</l> header to the response to auto-refresh a page, the following
parameter can be specified: <l>"/sample?X-Response-Headers={Refresh=1}"</l>
</ul>
-</div><!-- END: 7.38 - juneau-rest-server.OtherNotes -->
+</div><!-- END: 7.39 - juneau-rest-server.OtherNotes -->
</div><!-- END: 7 - juneau-rest-server -->
<!-- ==================================================================================================== -->
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/BeanTraverseSession.html b/content/site/apidocs_preview/src-html/org/apache/juneau/BeanTraverseSession.html
index 66205ec..c057e2d 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/BeanTraverseSession.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/BeanTraverseSession.html
@@ -118,7 +118,7 @@
<span class="sourceLineNo">110</span> if (o == null)<a name="line.110"></a>
<span class="sourceLineNo">111</span> return null;<a name="line.111"></a>
<span class="sourceLineNo">112</span> Class<?> c = o.getClass();<a name="line.112"></a>
-<span class="sourceLineNo">113</span> ClassMeta<?> cm = (eType != null && c == eType.getInnerClass()) ? eType : getClassMeta(c);<a name="line.113"></a>
+<span class="sourceLineNo">113</span> ClassMeta<?> cm = (eType != null && c == eType.getInnerClass()) ? eType : ((o instanceof ClassMeta) ? (ClassMeta<?>)o : getClassMeta(c));<a name="line.113"></a>
<span class="sourceLineNo">114</span> if (cm.isCharSequence() || cm.isNumber() || cm.isBoolean())<a name="line.114"></a>
<span class="sourceLineNo">115</span> return cm;<a name="line.115"></a>
<span class="sourceLineNo">116</span> if (isDetectRecursions() || isDebug()) {<a name="line.116"></a>
@@ -197,7 +197,7 @@
<span class="sourceLineNo">189</span> }<a name="line.189"></a>
<span class="sourceLineNo">190</span><a name="line.190"></a>
<span class="sourceLineNo">191</span> String toString(boolean simple) {<a name="line.191"></a>
-<span class="sourceLineNo">192</span> StringBuilder sb = new StringBuilder().append('[').append(depth).append(']');<a name="line.192"></a>
+<span class="sourceLineNo">192</span> StringBuilder sb = new StringBuilder().append('[').append(depth).append(']').append(' ');<a name="line.192"></a>
<span class="sourceLineNo">193</span> sb.append(isEmpty(name) ? "<noname>" : name).append(':');<a name="line.193"></a>
<span class="sourceLineNo">194</span> sb.append(aType.toString(simple));<a name="line.194"></a>
<span class="sourceLineNo">195</span> if (aType != aType.getSerializedClassMeta(null))<a name="line.195"></a>
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html b/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
index ef5d5db..45d2aa7 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGenerator.html
@@ -20,374 +20,429 @@
<span class="sourceLineNo">012</span>// ***************************************************************************************************************************<a name="line.12"></a>
<span class="sourceLineNo">013</span>package org.apache.juneau.jsonschema;<a name="line.13"></a>
<span class="sourceLineNo">014</span><a name="line.14"></a>
-<span class="sourceLineNo">015</span>import java.util.*;<a name="line.15"></a>
+<span class="sourceLineNo">015</span>import static org.apache.juneau.internal.StringUtils.*;<a name="line.15"></a>
<span class="sourceLineNo">016</span><a name="line.16"></a>
-<span class="sourceLineNo">017</span>import org.apache.juneau.*;<a name="line.17"></a>
-<span class="sourceLineNo">018</span>import org.apache.juneau.annotation.*;<a name="line.18"></a>
-<span class="sourceLineNo">019</span>import org.apache.juneau.json.*;<a name="line.19"></a>
-<span class="sourceLineNo">020</span><a name="line.20"></a>
-<span class="sourceLineNo">021</span>/**<a name="line.21"></a>
-<span class="sourceLineNo">022</span> * Generates JSON-schema metadata about POJOs.<a name="line.22"></a>
-<span class="sourceLineNo">023</span> */<a name="line.23"></a>
-<span class="sourceLineNo">024</span>public class JsonSchemaGenerator extends BeanTraverseContext {<a name="line.24"></a>
-<span class="sourceLineNo">025</span><a name="line.25"></a>
-<span class="sourceLineNo">026</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.26"></a>
-<span class="sourceLineNo">027</span> // Configurable properties<a name="line.27"></a>
-<span class="sourceLineNo">028</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.28"></a>
-<span class="sourceLineNo">029</span><a name="line.29"></a>
-<span class="sourceLineNo">030</span> private static final String PREFIX = "JsonSchemaGenerator.";<a name="line.30"></a>
-<span class="sourceLineNo">031</span><a name="line.31"></a>
-<span class="sourceLineNo">032</span> /**<a name="line.32"></a>
-<span class="sourceLineNo">033</span> * Configuration property: Add descriptions to types.<a name="line.33"></a>
-<span class="sourceLineNo">034</span> *<a name="line.34"></a>
-<span class="sourceLineNo">035</span> * <h5 class='section'>Property:</h5><a name="line.35"></a>
-<span class="sourceLineNo">036</span> * <ul><a name="line.36"></a>
-<span class="sourceLineNo">037</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.addDescriptionsTo.s"</js><a name="line.37"></a>
-<span class="sourceLineNo">038</span> * <li><b>Data type:</b> <code>String</code><a name="line.38"></a>
-<span class="sourceLineNo">039</span> * <li><b>Default:</b> Empty string.<a name="line.39"></a>
-<span class="sourceLineNo">040</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.40"></a>
-<span class="sourceLineNo">041</span> * <li><b>Methods:</b><a name="line.41"></a>
-<span class="sourceLineNo">042</span> * <ul><a name="line.42"></a>
-<span class="sourceLineNo">043</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#addDescriptionsTo(String)}<a name="line.43"></a>
-<span class="sourceLineNo">044</span> * </ul><a name="line.44"></a>
-<span class="sourceLineNo">045</span> * </ul><a name="line.45"></a>
-<span class="sourceLineNo">046</span> *<a name="line.46"></a>
-<span class="sourceLineNo">047</span> * <h5 class='section'>Description:</h5><a name="line.47"></a>
-<span class="sourceLineNo">048</span> * <p><a name="line.48"></a>
-<span class="sourceLineNo">049</span> * Identifies which categories of types that descriptions should be automatically added to generated schemas.<a name="line.49"></a>
-<span class="sourceLineNo">050</span> * <p><a name="line.50"></a>
-<span class="sourceLineNo">051</span> * The description is the result of calling {@link ClassMeta#getReadableName()}.<a name="line.51"></a>
-<span class="sourceLineNo">052</span> * <p><a name="line.52"></a>
-<span class="sourceLineNo">053</span> * The format is a comma-delimited list of any of the following values:<a name="line.53"></a>
-<span class="sourceLineNo">054</span> *<a name="line.54"></a>
-<span class="sourceLineNo">055</span> * <ul class='doctree'><a name="line.55"></a>
-<span class="sourceLineNo">056</span> * <li class='jf'>{@link TypeCategory#BEAN BEAN}<a name="line.56"></a>
-<span class="sourceLineNo">057</span> * <li class='jf'>{@link TypeCategory#COLLECTION COLLECTION}<a name="line.57"></a>
-<span class="sourceLineNo">058</span> * <li class='jf'>{@link TypeCategory#ARRAY ARRAY}<a name="line.58"></a>
-<span class="sourceLineNo">059</span> * <li class='jf'>{@link TypeCategory#MAP MAP}<a name="line.59"></a>
-<span class="sourceLineNo">060</span> * <li class='jf'>{@link TypeCategory#STRING STRING}<a name="line.60"></a>
-<span class="sourceLineNo">061</span> * <li class='jf'>{@link TypeCategory#NUMBER NUMBER}<a name="line.61"></a>
-<span class="sourceLineNo">062</span> * <li class='jf'>{@link TypeCategory#BOOLEAN BOOLEAN}<a name="line.62"></a>
-<span class="sourceLineNo">063</span> * <li class='jf'>{@link TypeCategory#ANY ANY}<a name="line.63"></a>
-<span class="sourceLineNo">064</span> * <li class='jf'>{@link TypeCategory#OTHER OTHER}<a name="line.64"></a>
-<span class="sourceLineNo">065</span> * </ul><a name="line.65"></a>
-<span class="sourceLineNo">066</span> */<a name="line.66"></a>
-<span class="sourceLineNo">067</span> public static final String JSONSCHEMA_addDescriptionsTo = PREFIX + "addDescriptionsTo.s";<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">070</span> * Configuration property: Add examples.<a name="line.70"></a>
-<span class="sourceLineNo">071</span> *<a name="line.71"></a>
-<span class="sourceLineNo">072</span> * <h5 class='section'>Property:</h5><a name="line.72"></a>
-<span class="sourceLineNo">073</span> * <ul><a name="line.73"></a>
-<span class="sourceLineNo">074</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.addExamplesTo.s"</js><a name="line.74"></a>
-<span class="sourceLineNo">075</span> * <li><b>Data type:</b> <code>String</code><a name="line.75"></a>
-<span class="sourceLineNo">076</span> * <li><b>Default:</b> Empty string.<a name="line.76"></a>
-<span class="sourceLineNo">077</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.77"></a>
-<span class="sourceLineNo">078</span> * <li><b>Methods:</b><a name="line.78"></a>
-<span class="sourceLineNo">079</span> * <ul><a name="line.79"></a>
-<span class="sourceLineNo">080</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#addExamplesTo(String)}<a name="line.80"></a>
-<span class="sourceLineNo">081</span> * </ul><a name="line.81"></a>
-<span class="sourceLineNo">082</span> * </ul><a name="line.82"></a>
-<span class="sourceLineNo">083</span> *<a name="line.83"></a>
-<span class="sourceLineNo">084</span> * <h5 class='section'>Description:</h5><a name="line.84"></a>
-<span class="sourceLineNo">085</span> * <p><a name="line.85"></a>
-<span class="sourceLineNo">086</span> * Identifies which categories of types that examples should be automatically added to generated schemas.<a name="line.86"></a>
-<span class="sourceLineNo">087</span> * <p><a name="line.87"></a>
-<span class="sourceLineNo">088</span> * The examples come from calling {@link ClassMeta#getExample(BeanSession)} which in turn gets examples<a name="line.88"></a>
-<span class="sourceLineNo">089</span> * from the following:<a name="line.89"></a>
-<span class="sourceLineNo">090</span> * <ul class='doctree'><a name="line.90"></a>
-<span class="sourceLineNo">091</span> * <li class='ja'>{@link Example}<a name="line.91"></a>
-<span class="sourceLineNo">092</span> * <li class='jf'>{@link BeanContext#BEAN_examples}<a name="line.92"></a>
-<span class="sourceLineNo">093</span> * </ul><a name="line.93"></a>
-<span class="sourceLineNo">094</span> *<a name="line.94"></a>
-<span class="sourceLineNo">095</span> * <p><a name="line.95"></a>
-<span class="sourceLineNo">096</span> * The format is a comma-delimited list of any of the following values:<a name="line.96"></a>
+<span class="sourceLineNo">017</span>import java.util.*;<a name="line.17"></a>
+<span class="sourceLineNo">018</span>import java.util.regex.*;<a name="line.18"></a>
+<span class="sourceLineNo">019</span><a name="line.19"></a>
+<span class="sourceLineNo">020</span>import org.apache.juneau.*;<a name="line.20"></a>
+<span class="sourceLineNo">021</span>import org.apache.juneau.annotation.*;<a name="line.21"></a>
+<span class="sourceLineNo">022</span>import org.apache.juneau.json.*;<a name="line.22"></a>
+<span class="sourceLineNo">023</span><a name="line.23"></a>
+<span class="sourceLineNo">024</span>/**<a name="line.24"></a>
+<span class="sourceLineNo">025</span> * Generates JSON-schema metadata about POJOs.<a name="line.25"></a>
+<span class="sourceLineNo">026</span> */<a name="line.26"></a>
+<span class="sourceLineNo">027</span>public class JsonSchemaGenerator extends BeanTraverseContext {<a name="line.27"></a>
+<span class="sourceLineNo">028</span><a name="line.28"></a>
+<span class="sourceLineNo">029</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.29"></a>
+<span class="sourceLineNo">030</span> // Configurable properties<a name="line.30"></a>
+<span class="sourceLineNo">031</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.31"></a>
+<span class="sourceLineNo">032</span><a name="line.32"></a>
+<span class="sourceLineNo">033</span> private static final String PREFIX = "JsonSchemaGenerator.";<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> * Configuration property: Add descriptions to types.<a name="line.36"></a>
+<span class="sourceLineNo">037</span> *<a name="line.37"></a>
+<span class="sourceLineNo">038</span> * <h5 class='section'>Property:</h5><a name="line.38"></a>
+<span class="sourceLineNo">039</span> * <ul><a name="line.39"></a>
+<span class="sourceLineNo">040</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.addDescriptionsTo.s"</js><a name="line.40"></a>
+<span class="sourceLineNo">041</span> * <li><b>Data type:</b> <code>String</code><a name="line.41"></a>
+<span class="sourceLineNo">042</span> * <li><b>Default:</b> Empty string.<a name="line.42"></a>
+<span class="sourceLineNo">043</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.43"></a>
+<span class="sourceLineNo">044</span> * <li><b>Methods:</b><a name="line.44"></a>
+<span class="sourceLineNo">045</span> * <ul><a name="line.45"></a>
+<span class="sourceLineNo">046</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#addDescriptionsTo(String)}<a name="line.46"></a>
+<span class="sourceLineNo">047</span> * </ul><a name="line.47"></a>
+<span class="sourceLineNo">048</span> * </ul><a name="line.48"></a>
+<span class="sourceLineNo">049</span> *<a name="line.49"></a>
+<span class="sourceLineNo">050</span> * <h5 class='section'>Description:</h5><a name="line.50"></a>
+<span class="sourceLineNo">051</span> * <p><a name="line.51"></a>
+<span class="sourceLineNo">052</span> * Identifies which categories of types that descriptions should be automatically added to generated schemas.<a name="line.52"></a>
+<span class="sourceLineNo">053</span> * <p><a name="line.53"></a>
+<span class="sourceLineNo">054</span> * The description is the result of calling {@link ClassMeta#getReadableName()}.<a name="line.54"></a>
+<span class="sourceLineNo">055</span> * <p><a name="line.55"></a>
+<span class="sourceLineNo">056</span> * The format is a comma-delimited list of any of the following values:<a name="line.56"></a>
+<span class="sourceLineNo">057</span> *<a name="line.57"></a>
+<span class="sourceLineNo">058</span> * <ul class='doctree'><a name="line.58"></a>
+<span class="sourceLineNo">059</span> * <li class='jf'>{@link TypeCategory#BEAN BEAN}<a name="line.59"></a>
+<span class="sourceLineNo">060</span> * <li class='jf'>{@link TypeCategory#COLLECTION COLLECTION}<a name="line.60"></a>
+<span class="sourceLineNo">061</span> * <li class='jf'>{@link TypeCategory#ARRAY ARRAY}<a name="line.61"></a>
+<span class="sourceLineNo">062</span> * <li class='jf'>{@link TypeCategory#MAP MAP}<a name="line.62"></a>
+<span class="sourceLineNo">063</span> * <li class='jf'>{@link TypeCategory#STRING STRING}<a name="line.63"></a>
+<span class="sourceLineNo">064</span> * <li class='jf'>{@link TypeCategory#NUMBER NUMBER}<a name="line.64"></a>
+<span class="sourceLineNo">065</span> * <li class='jf'>{@link TypeCategory#BOOLEAN BOOLEAN}<a name="line.65"></a>
+<span class="sourceLineNo">066</span> * <li class='jf'>{@link TypeCategory#ANY ANY}<a name="line.66"></a>
+<span class="sourceLineNo">067</span> * <li class='jf'>{@link TypeCategory#OTHER OTHER}<a name="line.67"></a>
+<span class="sourceLineNo">068</span> * </ul><a name="line.68"></a>
+<span class="sourceLineNo">069</span> */<a name="line.69"></a>
+<span class="sourceLineNo">070</span> public static final String JSONSCHEMA_addDescriptionsTo = PREFIX + "addDescriptionsTo.s";<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> * Configuration property: Add examples.<a name="line.73"></a>
+<span class="sourceLineNo">074</span> *<a name="line.74"></a>
+<span class="sourceLineNo">075</span> * <h5 class='section'>Property:</h5><a name="line.75"></a>
+<span class="sourceLineNo">076</span> * <ul><a name="line.76"></a>
+<span class="sourceLineNo">077</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.addExamplesTo.s"</js><a name="line.77"></a>
+<span class="sourceLineNo">078</span> * <li><b>Data type:</b> <code>String</code><a name="line.78"></a>
+<span class="sourceLineNo">079</span> * <li><b>Default:</b> Empty string.<a name="line.79"></a>
+<span class="sourceLineNo">080</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.80"></a>
+<span class="sourceLineNo">081</span> * <li><b>Methods:</b><a name="line.81"></a>
+<span class="sourceLineNo">082</span> * <ul><a name="line.82"></a>
+<span class="sourceLineNo">083</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#addExamplesTo(String)}<a name="line.83"></a>
+<span class="sourceLineNo">084</span> * </ul><a name="line.84"></a>
+<span class="sourceLineNo">085</span> * </ul><a name="line.85"></a>
+<span class="sourceLineNo">086</span> *<a name="line.86"></a>
+<span class="sourceLineNo">087</span> * <h5 class='section'>Description:</h5><a name="line.87"></a>
+<span class="sourceLineNo">088</span> * <p><a name="line.88"></a>
+<span class="sourceLineNo">089</span> * Identifies which categories of types that examples should be automatically added to generated schemas.<a name="line.89"></a>
+<span class="sourceLineNo">090</span> * <p><a name="line.90"></a>
+<span class="sourceLineNo">091</span> * The examples come from calling {@link ClassMeta#getExample(BeanSession)} which in turn gets examples<a name="line.91"></a>
+<span class="sourceLineNo">092</span> * from the following:<a name="line.92"></a>
+<span class="sourceLineNo">093</span> * <ul class='doctree'><a name="line.93"></a>
+<span class="sourceLineNo">094</span> * <li class='ja'>{@link Example}<a name="line.94"></a>
+<span class="sourceLineNo">095</span> * <li class='jf'>{@link BeanContext#BEAN_examples}<a name="line.95"></a>
+<span class="sourceLineNo">096</span> * </ul><a name="line.96"></a>
<span class="sourceLineNo">097</span> *<a name="line.97"></a>
-<span class="sourceLineNo">098</span> * <ul class='doctree'><a name="line.98"></a>
-<span class="sourceLineNo">099</span> * <li class='jf'>{@link TypeCategory#BEAN BEAN}<a name="line.99"></a>
-<span class="sourceLineNo">100</span> * <li class='jf'>{@link TypeCategory#COLLECTION COLLECTION}<a name="line.100"></a>
-<span class="sourceLineNo">101</span> * <li class='jf'>{@link TypeCategory#ARRAY ARRAY}<a name="line.101"></a>
-<span class="sourceLineNo">102</span> * <li class='jf'>{@link TypeCategory#MAP MAP}<a name="line.102"></a>
-<span class="sourceLineNo">103</span> * <li class='jf'>{@link TypeCategory#STRING STRING}<a name="line.103"></a>
-<span class="sourceLineNo">104</span> * <li class='jf'>{@link TypeCategory#NUMBER NUMBER}<a name="line.104"></a>
-<span class="sourceLineNo">105</span> * <li class='jf'>{@link TypeCategory#BOOLEAN BOOLEAN}<a name="line.105"></a>
-<span class="sourceLineNo">106</span> * <li class='jf'>{@link TypeCategory#ANY ANY}<a name="line.106"></a>
-<span class="sourceLineNo">107</span> * <li class='jf'>{@link TypeCategory#OTHER OTHER}<a name="line.107"></a>
-<span class="sourceLineNo">108</span> * </ul><a name="line.108"></a>
-<span class="sourceLineNo">109</span> */<a name="line.109"></a>
-<span class="sourceLineNo">110</span> public static final String JSONSCHEMA_addExamplesTo = PREFIX + "addExamplesTo.s";<a name="line.110"></a>
-<span class="sourceLineNo">111</span><a name="line.111"></a>
-<span class="sourceLineNo">112</span> /**<a name="line.112"></a>
-<span class="sourceLineNo">113</span> * Configuration property: Allow nested descriptions.<a name="line.113"></a>
-<span class="sourceLineNo">114</span> *<a name="line.114"></a>
-<span class="sourceLineNo">115</span> * <h5 class='section'>Property:</h5><a name="line.115"></a>
-<span class="sourceLineNo">116</span> * <ul><a name="line.116"></a>
-<span class="sourceLineNo">117</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.allowNestedDescriptions.b"</js><a name="line.117"></a>
-<span class="sourceLineNo">118</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.118"></a>
-<span class="sourceLineNo">119</span> * <li><b>Default:</b> <jk>false</jk><a name="line.119"></a>
-<span class="sourceLineNo">120</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.120"></a>
-<span class="sourceLineNo">121</span> * <li><b>Methods:</b><a name="line.121"></a>
-<span class="sourceLineNo">122</span> * <ul><a name="line.122"></a>
-<span class="sourceLineNo">123</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#allowNestedDescriptions()}<a name="line.123"></a>
-<span class="sourceLineNo">124</span> * </ul><a name="line.124"></a>
-<span class="sourceLineNo">125</span> * </ul><a name="line.125"></a>
-<span class="sourceLineNo">126</span> *<a name="line.126"></a>
-<span class="sourceLineNo">127</span> * <h5 class='section'>Description:</h5><a name="line.127"></a>
-<span class="sourceLineNo">128</span> * <p><a name="line.128"></a>
-<span class="sourceLineNo">129</span> * Identifies whether nested descriptions are allowed in schema definitions.<a name="line.129"></a>
-<span class="sourceLineNo">130</span> */<a name="line.130"></a>
-<span class="sourceLineNo">131</span> public static final String JSONSCHEMA_allowNestedDescriptions = PREFIX + "allowNestedDescriptions.b";<a name="line.131"></a>
-<span class="sourceLineNo">132</span><a name="line.132"></a>
-<span class="sourceLineNo">133</span> /**<a name="line.133"></a>
-<span class="sourceLineNo">134</span> * Configuration property: Allow nested examples.<a name="line.134"></a>
-<span class="sourceLineNo">135</span> *<a name="line.135"></a>
-<span class="sourceLineNo">136</span> * <h5 class='section'>Property:</h5><a name="line.136"></a>
-<span class="sourceLineNo">137</span> * <ul><a name="line.137"></a>
-<span class="sourceLineNo">138</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.allowNestedExamples.b"</js><a name="line.138"></a>
-<span class="sourceLineNo">139</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.139"></a>
-<span class="sourceLineNo">140</span> * <li><b>Default:</b> <jk>false</jk><a name="line.140"></a>
-<span class="sourceLineNo">141</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.141"></a>
-<span class="sourceLineNo">142</span> * <li><b>Methods:</b><a name="line.142"></a>
-<span class="sourceLineNo">143</span> * <ul><a name="line.143"></a>
-<span class="sourceLineNo">144</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#allowNestedExamples()}<a name="line.144"></a>
-<span class="sourceLineNo">145</span> * </ul><a name="line.145"></a>
-<span class="sourceLineNo">146</span> * </ul><a name="line.146"></a>
-<span class="sourceLineNo">147</span> *<a name="line.147"></a>
-<span class="sourceLineNo">148</span> * <h5 class='section'>Description:</h5><a name="line.148"></a>
-<span class="sourceLineNo">149</span> * <p><a name="line.149"></a>
-<span class="sourceLineNo">150</span> * Identifies whether nested examples are allowed in schema definitions.<a name="line.150"></a>
-<span class="sourceLineNo">151</span> */<a name="line.151"></a>
-<span class="sourceLineNo">152</span> public static final String JSONSCHEMA_allowNestedExamples = PREFIX + "allowNestedExamples.b";<a name="line.152"></a>
-<span class="sourceLineNo">153</span><a name="line.153"></a>
-<span class="sourceLineNo">154</span> /**<a name="line.154"></a>
-<span class="sourceLineNo">155</span> * Configuration property: Bean schema definition mapper.<a name="line.155"></a>
-<span class="sourceLineNo">156</span> *<a name="line.156"></a>
-<span class="sourceLineNo">157</span> * <h5 class='section'>Property:</h5><a name="line.157"></a>
-<span class="sourceLineNo">158</span> * <ul><a name="line.158"></a>
-<span class="sourceLineNo">159</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.beanDefMapper.o"</js><a name="line.159"></a>
-<span class="sourceLineNo">160</span> * <li><b>Data type:</b> {@link BeanDefMapper}<a name="line.160"></a>
-<span class="sourceLineNo">161</span> * <li><b>Default:</b> {@link BasicBeanDefMapper}<a name="line.161"></a>
-<span class="sourceLineNo">162</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.162"></a>
-<span class="sourceLineNo">163</span> * <li><b>Methods:</b><a name="line.163"></a>
-<span class="sourceLineNo">164</span> * <ul><a name="line.164"></a>
-<span class="sourceLineNo">165</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#beanDefMapper(Class)}<a name="line.165"></a>
-<span class="sourceLineNo">166</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#beanDefMapper(BeanDefMapper)}<a name="line.166"></a>
-<span class="sourceLineNo">167</span> * </ul><a name="line.167"></a>
-<span class="sourceLineNo">168</span> * </ul><a name="line.168"></a>
-<span class="sourceLineNo">169</span> *<a name="line.169"></a>
-<span class="sourceLineNo">170</span> * <h5 class='section'>Description:</h5><a name="line.170"></a>
-<span class="sourceLineNo">171</span> * <p><a name="line.171"></a>
-<span class="sourceLineNo">172</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.172"></a>
-<span class="sourceLineNo">173</span> * <p><a name="line.173"></a>
-<span class="sourceLineNo">174</span> * Used primarily for defining common definition sections for beans in Swagger JSON.<a name="line.174"></a>
-<span class="sourceLineNo">175</span> * <p><a name="line.175"></a>
-<span class="sourceLineNo">176</span> * This setting is ignored if {@link #JSONSCHEMA_useBeanDefs} is not enabled.<a name="line.176"></a>
-<span class="sourceLineNo">177</span> */<a name="line.177"></a>
-<span class="sourceLineNo">178</span> public static final String JSONSCHEMA_beanDefMapper = PREFIX + "beanDefMapper.o";<a name="line.178"></a>
-<span class="sourceLineNo">179</span><a name="line.179"></a>
-<span class="sourceLineNo">180</span> /**<a name="line.180"></a>
-<span class="sourceLineNo">181</span> * Configuration property: Default schemas.<a name="line.181"></a>
-<span class="sourceLineNo">182</span> *<a name="line.182"></a>
-<span class="sourceLineNo">183</span> * <h5 class='section'>Property:</h5><a name="line.183"></a>
-<span class="sourceLineNo">184</span> * <ul><a name="line.184"></a>
-<span class="sourceLineNo">185</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.defaultSchema.smo"</js><a name="line.185"></a>
-<span class="sourceLineNo">186</span> * <li><b>Data type:</b> <code>Map&lt;String,ObjectMap&gt;</code><a name="line.186"></a>
-<span class="sourceLineNo">187</span> * <li><b>Default:</b> Empty map.<a name="line.187"></a>
-<span class="sourceLineNo">188</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.188"></a>
-<span class="sourceLineNo">189</span> * <li><b>Methods:</b><a name="line.189"></a>
-<span class="sourceLineNo">190</span> * <ul><a name="line.190"></a>
-<span class="sourceLineNo">191</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#defaultSchema(Class,ObjectMap)}<a name="line.191"></a>
-<span class="sourceLineNo">192</span> * </ul><a name="line.192"></a>
-<span class="sourceLineNo">193</span> * </ul><a name="line.193"></a>
-<span class="sourceLineNo">194</span> *<a name="line.194"></a>
-<span class="sourceLineNo">195</span> * <h5 class='section'>Description:</h5><a name="line.195"></a>
-<span class="sourceLineNo">196</span> * <p><a name="line.196"></a>
-<span class="sourceLineNo">197</span> * Allows you to override or provide custom schema information for particular class types.<a name="line.197"></a>
-<span class="sourceLineNo">198</span> * <p><a name="line.198"></a>
-<span class="sourceLineNo">199</span> * Keys are full class names.<a name="line.199"></a>
-<span class="sourceLineNo">200</span> */<a name="line.200"></a>
-<span class="sourceLineNo">201</span> public static final String JSONSCHEMA_defaultSchemas = PREFIX + "defaultSchemas.smo";<a name="line.201"></a>
-<span class="sourceLineNo">202</span><a name="line.202"></a>
-<span class="sourceLineNo">203</span> /**<a name="line.203"></a>
-<span class="sourceLineNo">204</span> * Configuration property: Use bean definitions.<a name="line.204"></a>
-<span class="sourceLineNo">205</span> *<a name="line.205"></a>
-<span class="sourceLineNo">206</span> * <h5 class='section'>Property:</h5><a name="line.206"></a>
-<span class="sourceLineNo">207</span> * <ul><a name="line.207"></a>
-<span class="sourceLineNo">208</span> * <li><b>Name:</b> <js>"JsonSchemaSerializer.useBeanDefs.o"</js><a name="line.208"></a>
-<span class="sourceLineNo">209</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.209"></a>
-<span class="sourceLineNo">210</span> * <li><b>Default:</b> <jk>false</jk><a name="line.210"></a>
-<span class="sourceLineNo">211</span> * <li><b>Methods:</b><a name="line.211"></a>
-<span class="sourceLineNo">212</span> * <ul><a name="line.212"></a>
-<span class="sourceLineNo">213</span> * <li class='jm'>{@link JsonSchemaSerializerBuilder#useBeanDefs()}<a name="line.213"></a>
-<span class="sourceLineNo">214</span> * </ul><a name="line.214"></a>
+<span class="sourceLineNo">098</span> * <p><a name="line.98"></a>
+<span class="sourceLineNo">099</span> * The format is a comma-delimited list of any of the following values:<a name="line.99"></a>
+<span class="sourceLineNo">100</span> *<a name="line.100"></a>
+<span class="sourceLineNo">101</span> * <ul class='doctree'><a name="line.101"></a>
+<span class="sourceLineNo">102</span> * <li class='jf'>{@link TypeCategory#BEAN BEAN}<a name="line.102"></a>
+<span class="sourceLineNo">103</span> * <li class='jf'>{@link TypeCategory#COLLECTION COLLECTION}<a name="line.103"></a>
+<span class="sourceLineNo">104</span> * <li class='jf'>{@link TypeCategory#ARRAY ARRAY}<a name="line.104"></a>
+<span class="sourceLineNo">105</span> * <li class='jf'>{@link TypeCategory#MAP MAP}<a name="line.105"></a>
+<span class="sourceLineNo">106</span> * <li class='jf'>{@link TypeCategory#STRING STRING}<a name="line.106"></a>
+<span class="sourceLineNo">107</span> * <li class='jf'>{@link TypeCategory#NUMBER NUMBER}<a name="line.107"></a>
+<span class="sourceLineNo">108</span> * <li class='jf'>{@link TypeCategory#BOOLEAN BOOLEAN}<a name="line.108"></a>
+<span class="sourceLineNo">109</span> * <li class='jf'>{@link TypeCategory#ANY ANY}<a name="line.109"></a>
+<span class="sourceLineNo">110</span> * <li class='jf'>{@link TypeCategory#OTHER OTHER}<a name="line.110"></a>
+<span class="sourceLineNo">111</span> * </ul><a name="line.111"></a>
+<span class="sourceLineNo">112</span> */<a name="line.112"></a>
+<span class="sourceLineNo">113</span> public static final String JSONSCHEMA_addExamplesTo = PREFIX + "addExamplesTo.s";<a name="line.113"></a>
+<span class="sourceLineNo">114</span><a name="line.114"></a>
+<span class="sourceLineNo">115</span> /**<a name="line.115"></a>
+<span class="sourceLineNo">116</span> * Configuration property: Allow nested descriptions.<a name="line.116"></a>
+<span class="sourceLineNo">117</span> *<a name="line.117"></a>
+<span class="sourceLineNo">118</span> * <h5 class='section'>Property:</h5><a name="line.118"></a>
+<span class="sourceLineNo">119</span> * <ul><a name="line.119"></a>
+<span class="sourceLineNo">120</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.allowNestedDescriptions.b"</js><a name="line.120"></a>
+<span class="sourceLineNo">121</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.121"></a>
+<span class="sourceLineNo">122</span> * <li><b>Default:</b> <jk>false</jk><a name="line.122"></a>
+<span class="sourceLineNo">123</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.123"></a>
+<span class="sourceLineNo">124</span> * <li><b>Methods:</b><a name="line.124"></a>
+<span class="sourceLineNo">125</span> * <ul><a name="line.125"></a>
+<span class="sourceLineNo">126</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#allowNestedDescriptions()}<a name="line.126"></a>
+<span class="sourceLineNo">127</span> * </ul><a name="line.127"></a>
+<span class="sourceLineNo">128</span> * </ul><a name="line.128"></a>
+<span class="sourceLineNo">129</span> *<a name="line.129"></a>
+<span class="sourceLineNo">130</span> * <h5 class='section'>Description:</h5><a name="line.130"></a>
+<span class="sourceLineNo">131</span> * <p><a name="line.131"></a>
+<span class="sourceLineNo">132</span> * Identifies whether nested descriptions are allowed in schema definitions.<a name="line.132"></a>
+<span class="sourceLineNo">133</span> */<a name="line.133"></a>
+<span class="sourceLineNo">134</span> public static final String JSONSCHEMA_allowNestedDescriptions = PREFIX + "allowNestedDescriptions.b";<a name="line.134"></a>
+<span class="sourceLineNo">135</span><a name="line.135"></a>
+<span class="sourceLineNo">136</span> /**<a name="line.136"></a>
+<span class="sourceLineNo">137</span> * Configuration property: Allow nested examples.<a name="line.137"></a>
+<span class="sourceLineNo">138</span> *<a name="line.138"></a>
+<span class="sourceLineNo">139</span> * <h5 class='section'>Property:</h5><a name="line.139"></a>
+<span class="sourceLineNo">140</span> * <ul><a name="line.140"></a>
+<span class="sourceLineNo">141</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.allowNestedExamples.b"</js><a name="line.141"></a>
+<span class="sourceLineNo">142</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.142"></a>
+<span class="sourceLineNo">143</span> * <li><b>Default:</b> <jk>false</jk><a name="line.143"></a>
+<span class="sourceLineNo">144</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.144"></a>
+<span class="sourceLineNo">145</span> * <li><b>Methods:</b><a name="line.145"></a>
+<span class="sourceLineNo">146</span> * <ul><a name="line.146"></a>
+<span class="sourceLineNo">147</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#allowNestedExamples()}<a name="line.147"></a>
+<span class="sourceLineNo">148</span> * </ul><a name="line.148"></a>
+<span class="sourceLineNo">149</span> * </ul><a name="line.149"></a>
+<span class="sourceLineNo">150</span> *<a name="line.150"></a>
+<span class="sourceLineNo">151</span> * <h5 class='section'>Description:</h5><a name="line.151"></a>
+<span class="sourceLineNo">152</span> * <p><a name="line.152"></a>
+<span class="sourceLineNo">153</span> * Identifies whether nested examples are allowed in schema definitions.<a name="line.153"></a>
+<span class="sourceLineNo">154</span> */<a name="line.154"></a>
+<span class="sourceLineNo">155</span> public static final String JSONSCHEMA_allowNestedExamples = PREFIX + "allowNestedExamples.b";<a name="line.155"></a>
+<span class="sourceLineNo">156</span><a name="line.156"></a>
+<span class="sourceLineNo">157</span> /**<a name="line.157"></a>
+<span class="sourceLineNo">158</span> * Configuration property: Bean schema definition mapper.<a name="line.158"></a>
+<span class="sourceLineNo">159</span> *<a name="line.159"></a>
+<span class="sourceLineNo">160</span> * <h5 class='section'>Property:</h5><a name="line.160"></a>
+<span class="sourceLineNo">161</span> * <ul><a name="line.161"></a>
+<span class="sourceLineNo">162</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.beanDefMapper.o"</js><a name="line.162"></a>
+<span class="sourceLineNo">163</span> * <li><b>Data type:</b> {@link BeanDefMapper}<a name="line.163"></a>
+<span class="sourceLineNo">164</span> * <li><b>Default:</b> {@link BasicBeanDefMapper}<a name="line.164"></a>
+<span class="sourceLineNo">165</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.165"></a>
+<span class="sourceLineNo">166</span> * <li><b>Methods:</b><a name="line.166"></a>
+<span class="sourceLineNo">167</span> * <ul><a name="line.167"></a>
+<span class="sourceLineNo">168</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#beanDefMapper(Class)}<a name="line.168"></a>
+<span class="sourceLineNo">169</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#beanDefMapper(BeanDefMapper)}<a name="line.169"></a>
+<span class="sourceLineNo">170</span> * </ul><a name="line.170"></a>
+<span class="sourceLineNo">171</span> * </ul><a name="line.171"></a>
+<span class="sourceLineNo">172</span> *<a name="line.172"></a>
+<span class="sourceLineNo">173</span> * <h5 class='section'>Description:</h5><a name="line.173"></a>
+<span class="sourceLineNo">174</span> * <p><a name="line.174"></a>
+<span class="sourceLineNo">175</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.175"></a>
+<span class="sourceLineNo">176</span> * <p><a name="line.176"></a>
+<span class="sourceLineNo">177</span> * Used primarily for defining common definition sections for beans in Swagger JSON.<a name="line.177"></a>
+<span class="sourceLineNo">178</span> * <p><a name="line.178"></a>
+<span class="sourceLineNo">179</span> * This setting is ignored if {@link #JSONSCHEMA_useBeanDefs} is not enabled.<a name="line.179"></a>
+<span class="sourceLineNo">180</span> */<a name="line.180"></a>
+<span class="sourceLineNo">181</span> public static final String JSONSCHEMA_beanDefMapper = PREFIX + "beanDefMapper.o";<a name="line.181"></a>
+<span class="sourceLineNo">182</span><a name="line.182"></a>
+<span class="sourceLineNo">183</span> /**<a name="line.183"></a>
+<span class="sourceLineNo">184</span> * Configuration property: Default schemas.<a name="line.184"></a>
+<span class="sourceLineNo">185</span> *<a name="line.185"></a>
+<span class="sourceLineNo">186</span> * <h5 class='section'>Property:</h5><a name="line.186"></a>
+<span class="sourceLineNo">187</span> * <ul><a name="line.187"></a>
+<span class="sourceLineNo">188</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.defaultSchema.smo"</js><a name="line.188"></a>
+<span class="sourceLineNo">189</span> * <li><b>Data type:</b> <code>Map&lt;String,ObjectMap&gt;</code><a name="line.189"></a>
+<span class="sourceLineNo">190</span> * <li><b>Default:</b> Empty map.<a name="line.190"></a>
+<span class="sourceLineNo">191</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.191"></a>
+<span class="sourceLineNo">192</span> * <li><b>Methods:</b><a name="line.192"></a>
+<span class="sourceLineNo">193</span> * <ul><a name="line.193"></a>
+<span class="sourceLineNo">194</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#defaultSchema(Class,ObjectMap)}<a name="line.194"></a>
+<span class="sourceLineNo">195</span> * </ul><a name="line.195"></a>
+<span class="sourceLineNo">196</span> * </ul><a name="line.196"></a>
+<span class="sourceLineNo">197</span> *<a name="line.197"></a>
+<span class="sourceLineNo">198</span> * <h5 class='section'>Description:</h5><a name="line.198"></a>
+<span class="sourceLineNo">199</span> * <p><a name="line.199"></a>
+<span class="sourceLineNo">200</span> * Allows you to override or provide custom schema information for particular class types.<a name="line.200"></a>
+<span class="sourceLineNo">201</span> * <p><a name="line.201"></a>
+<span class="sourceLineNo">202</span> * Keys are full class names.<a name="line.202"></a>
+<span class="sourceLineNo">203</span> */<a name="line.203"></a>
+<span class="sourceLineNo">204</span> public static final String JSONSCHEMA_defaultSchemas = PREFIX + "defaultSchemas.smo";<a name="line.204"></a>
+<span class="sourceLineNo">205</span><a name="line.205"></a>
+<span class="sourceLineNo">206</span> /**<a name="line.206"></a>
+<span class="sourceLineNo">207</span> * Configuration property: Ignore types from schema definitions.<a name="line.207"></a>
+<span class="sourceLineNo">208</span> *<a name="line.208"></a>
+<span class="sourceLineNo">209</span> * <h5 class='section'>Property:</h5><a name="line.209"></a>
+<span class="sourceLineNo">210</span> * <ul><a name="line.210"></a>
+<span class="sourceLineNo">211</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.ignoreTypes.s"</js><a name="line.211"></a>
+<span class="sourceLineNo">212</span> * <li><b>Data type:</b> <code>String</code> (comma-delimited)<a name="line.212"></a>
+<span class="sourceLineNo">213</span> * <li><b>Default:</b> <jk>null</jk>.<a name="line.213"></a>
+<span class="sourceLineNo">214</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.214"></a>
<span class="sourceLineNo">215</span> * </ul><a name="line.215"></a>
<span class="sourceLineNo">216</span> *<a name="line.216"></a>
<span class="sourceLineNo">217</span> * <h5 class='section'>Description:</h5><a name="line.217"></a>
<span class="sourceLineNo">218</span> * <p><a name="line.218"></a>
-<span class="sourceLineNo">219</span> * When enabled, schemas on beans will be serialized as the following:<a name="line.219"></a>
-<span class="sourceLineNo">220</span> * <p class='bcode w800'><a name="line.220"></a>
-<span class="sourceLineNo">221</span> * {<a name="line.221"></a>
-<span class="sourceLineNo">222</span> * type: <js>'object'</js>,<a name="line.222"></a>
-<span class="sourceLineNo">223</span> * <js>'$ref'</js>: <js>'#/definitions/TypeId'</js><a name="line.223"></a>
-<span class="sourceLineNo">224</span> * }<a name="line.224"></a>
-<span class="sourceLineNo">225</span> * </p><a name="line.225"></a>
-<span class="sourceLineNo">226</span> *<a name="line.226"></a>
-<span class="sourceLineNo">227</span> * <p><a name="line.227"></a>
-<span class="sourceLineNo">228</span> * The definitions can then be retrieved from the session using {@link JsonSchemaGeneratorSession#getBeanDefs()}.<a name="line.228"></a>
-<span class="sourceLineNo">229</span> * <p><a name="line.229"></a>
-<span class="sourceLineNo">230</span> * Definitions can also be added programmatically using {@link JsonSchemaGeneratorSession#addBeanDef(String, ObjectMap)}.<a name="line.230"></a>
+<span class="sourceLineNo">219</span> * Defines class name patterns that should be ignored when generating schema definitions in the generated<a name="line.219"></a>
+<span class="sourceLineNo">220</span> * Swagger documentation.<a name="line.220"></a>
+<span class="sourceLineNo">221</span> *<a name="line.221"></a>
+<span class="sourceLineNo">222</span> * <h5 class='section'>Example:</h5><a name="line.222"></a>
+<span class="sourceLineNo">223</span> * <p class='bcode w800'><a name="line.223"></a>
+<span class="sourceLineNo">224</span> * <jc>// Don't generate schema for any prototype packages or the class named 'Swagger'.<a name="line.224"></a>
+<span class="sourceLineNo">225</span> * <ja>@RestResource</ja>(<a name="line.225"></a>
+<span class="sourceLineNo">226</span> * properties={<a name="line.226"></a>
+<span class="sourceLineNo">227</span> * <ja>@Property</ja>(name=<jsf>INFOPROVIDER_ignoreTypes</jsf>, value=<js>"Swagger,*.proto.*"</js>)<a name="line.227"></a>
+<span class="sourceLineNo">228</span> * }<a name="line.228"></a>
+<span class="sourceLineNo">229</span> * <jk>public class</jk> MyResource {...}<a name="line.229"></a>
+<span class="sourceLineNo">230</span> * </p><a name="line.230"></a>
<span class="sourceLineNo">231</span> */<a name="line.231"></a>
-<span class="sourceLineNo">232</span> public static final String JSONSCHEMA_useBeanDefs = PREFIX + "useBeanDefs.b";<a name="line.232"></a>
+<span class="sourceLineNo">232</span> public static final String JSONSCHEMA_ignoreTypes = PREFIX + "ignoreTypes.s";<a name="line.232"></a>
<span class="sourceLineNo">233</span><a name="line.233"></a>
-<span class="sourceLineNo">234</span><a name="line.234"></a>
-<span class="sourceLineNo">235</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.235"></a>
-<span class="sourceLineNo">236</span> // Predefined instances<a name="line.236"></a>
-<span class="sourceLineNo">237</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.237"></a>
-<span class="sourceLineNo">238</span><a name="line.238"></a>
-<span class="sourceLineNo">239</span> /** Default serializer, all default settings.*/<a name="line.239"></a>
-<span class="sourceLineNo">240</span> public static final JsonSchemaGenerator DEFAULT = new JsonSchemaGenerator(PropertyStore.DEFAULT);<a name="line.240"></a>
-<span class="sourceLineNo">241</span><a name="line.241"></a>
-<span class="sourceLineNo">242</span><a name="line.242"></a>
-<span class="sourceLineNo">243</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.243"></a>
-<span class="sourceLineNo">244</span> // Instance<a name="line.244"></a>
-<span class="sourceLineNo">245</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.245"></a>
-<span class="sourceLineNo">246</span><a name="line.246"></a>
-<span class="sourceLineNo">247</span> private final boolean useBeanDefs, allowNestedExamples, allowNestedDescriptions;<a name="line.247"></a>
-<span class="sourceLineNo">248</span> private final BeanDefMapper beanDefMapper;<a name="line.248"></a>
-<span class="sourceLineNo">249</span> private final Set<TypeCategory> addExamplesTo, addDescriptionsTo;<a name="line.249"></a>
-<span class="sourceLineNo">250</span> private final Map<String,ObjectMap> defaultSchemas;<a name="line.250"></a>
-<span class="sourceLineNo">251</span> private final JsonSerializer jsonSerializer;<a name="line.251"></a>
-<span class="sourceLineNo">252</span><a name="line.252"></a>
-<span class="sourceLineNo">253</span> /**<a name="line.253"></a>
-<span class="sourceLineNo">254</span> * Constructor.<a name="line.254"></a>
-<span class="sourceLineNo">255</span> *<a name="line.255"></a>
-<span class="sourceLineNo">256</span> * @param ps Initialize with the specified config property store.<a name="line.256"></a>
-<span class="sourceLineNo">257</span> */<a name="line.257"></a>
-<span class="sourceLineNo">258</span> public JsonSchemaGenerator(PropertyStore ps) {<a name="line.258"></a>
-<span class="sourceLineNo">259</span> super(ps);<a name="line.259"></a>
-<span class="sourceLineNo">260</span><a name="line.260"></a>
-<span class="sourceLineNo">261</span> useBeanDefs = getBooleanProperty(JSONSCHEMA_useBeanDefs, false);<a name="line.261"></a>
-<span class="sourceLineNo">262</span> allowNestedExamples = getBooleanProperty(JSONSCHEMA_allowNestedExamples, false);<a name="line.262"></a>
-<span class="sourceLineNo">263</span> allowNestedDescriptions = getBooleanProperty(JSONSCHEMA_allowNestedDescriptions, false);<a name="line.263"></a>
-<span class="sourceLineNo">264</span> beanDefMapper = getInstanceProperty(JSONSCHEMA_beanDefMapper, BeanDefMapper.class, BasicBeanDefMapper.class);<a name="line.264"></a>
-<span class="sourceLineNo">265</span> addExamplesTo = TypeCategory.parse(getStringProperty(JSONSCHEMA_addExamplesTo, null));<a name="line.265"></a>
-<span class="sourceLineNo">266</span> addDescriptionsTo = TypeCategory.parse(getStringProperty(JSONSCHEMA_addDescriptionsTo, null));<a name="line.266"></a>
-<span class="sourceLineNo">267</span> defaultSchemas = getMapProperty(JSONSCHEMA_defaultSchemas, ObjectMap.class);<a name="line.267"></a>
-<span class="sourceLineNo">268</span> jsonSerializer = new JsonSerializer(ps);<a name="line.268"></a>
-<span class="sourceLineNo">269</span> }<a name="line.269"></a>
-<span class="sourceLineNo">270</span><a name="line.270"></a>
-<span class="sourceLineNo">271</span> @Override /* Context */<a name="line.271"></a>
-<span class="sourceLineNo">272</span> public JsonSchemaGeneratorBuilder builder() {<a name="line.272"></a>
-<span class="sourceLineNo">273</span> return new JsonSchemaGeneratorBuilder(getPropertyStore());<a name="line.273"></a>
-<span class="sourceLineNo">274</span> }<a name="line.274"></a>
-<span class="sourceLineNo">275</span><a name="line.275"></a>
-<span class="sourceLineNo">276</span> /**<a name="line.276"></a>
-<span class="sourceLineNo">277</span> * Instantiates a new clean-slate {@link JsonSerializerBuilder} object.<a name="line.277"></a>
-<span class="sourceLineNo">278</span> *<a name="line.278"></a>
-<span class="sourceLineNo">279</span> * <p><a name="line.279"></a>
-<span class="sourceLineNo">280</span> * This is equivalent to simply calling <code><jk>new</jk> JsonSerializerBuilder()</code>.<a name="line.280"></a>
-<span class="sourceLineNo">281</span> *<a name="line.281"></a>
-<span class="sourceLineNo">282</span> * @return A new {@link JsonSerializerBuilder} object.<a name="line.282"></a>
-<span class="sourceLineNo">283</span> */<a name="line.283"></a>
-<span class="sourceLineNo">284</span> public static JsonSchemaGeneratorBuilder create() {<a name="line.284"></a>
-<span class="sourceLineNo">285</span> return new JsonSchemaGeneratorBuilder();<a name="line.285"></a>
-<span class="sourceLineNo">286</span> }<a name="line.286"></a>
-<span class="sourceLineNo">287</span><a name="line.287"></a>
-<span class="sourceLineNo">288</span> @Override<a name="line.288"></a>
-<span class="sourceLineNo">289</span> public JsonSchemaGeneratorSession createSession(BeanSessionArgs args) {<a name="line.289"></a>
-<span class="sourceLineNo">290</span> return new JsonSchemaGeneratorSession(this, args);<a name="line.290"></a>
-<span class="sourceLineNo">291</span> }<a name="line.291"></a>
+<span class="sourceLineNo">234</span> /**<a name="line.234"></a>
+<span class="sourceLineNo">235</span> * Configuration property: Use bean definitions.<a name="line.235"></a>
+<span class="sourceLineNo">236</span> *<a name="line.236"></a>
+<span class="sourceLineNo">237</span> * <h5 class='section'>Property:</h5><a name="line.237"></a>
+<span class="sourceLineNo">238</span> * <ul><a name="line.238"></a>
+<span class="sourceLineNo">239</span> * <li><b>Name:</b> <js>"JsonSchemaGenerator.useBeanDefs.o"</js><a name="line.239"></a>
+<span class="sourceLineNo">240</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.240"></a>
+<span class="sourceLineNo">241</span> * <li><b>Default:</b> <jk>false</jk><a name="line.241"></a>
+<span class="sourceLineNo">242</span> * <li><b>Methods:</b><a name="line.242"></a>
+<span class="sourceLineNo">243</span> * <ul><a name="line.243"></a>
+<span class="sourceLineNo">244</span> * <li class='jm'>{@link JsonSchemaGeneratorBuilder#useBeanDefs()}<a name="line.244"></a>
+<span class="sourceLineNo">245</span> * </ul><a name="line.245"></a>
+<span class="sourceLineNo">246</span> * </ul><a name="line.246"></a>
+<span class="sourceLineNo">247</span> *<a name="line.247"></a>
+<span class="sourceLineNo">248</span> * <h5 class='section'>Description:</h5><a name="line.248"></a>
+<span class="sourceLineNo">249</span> * <p><a name="line.249"></a>
+<span class="sourceLineNo">250</span> * When enabled, schemas on beans will be serialized as the following:<a name="line.250"></a>
+<span class="sourceLineNo">251</span> * <p class='bcode w800'><a name="line.251"></a>
+<span class="sourceLineNo">252</span> * {<a name="line.252"></a>
+<span class="sourceLineNo">253</span> * type: <js>'object'</js>,<a name="line.253"></a>
+<span class="sourceLineNo">254</span> * <js>'$ref'</js>: <js>'#/definitions/TypeId'</js><a name="line.254"></a>
+<span class="sourceLineNo">255</span> * }<a name="line.255"></a>
+<span class="sourceLineNo">256</span> * </p><a name="line.256"></a>
+<span class="sourceLineNo">257</span> *<a name="line.257"></a>
+<span class="sourceLineNo">258</span> * <p><a name="line.258"></a>
+<span class="sourceLineNo">259</span> * The definitions can then be retrieved from the session using {@link JsonSchemaGeneratorSession#getBeanDefs()}.<a name="line.259"></a>
+<span class="sourceLineNo">260</span> * <p><a name="line.260"></a>
+<span class="sourceLineNo">261</span> * Definitions can also be added programmatically using {@link JsonSchemaGeneratorSession#addBeanDef(String, ObjectMap)}.<a name="line.261"></a>
+<span class="sourceLineNo">262</span> */<a name="line.262"></a>
+<span class="sourceLineNo">263</span> public static final String JSONSCHEMA_useBeanDefs = PREFIX + "useBeanDefs.b";<a name="line.263"></a>
+<span class="sourceLineNo">264</span><a name="line.264"></a>
+<span class="sourceLineNo">265</span><a name="line.265"></a>
+<span class="sourceLineNo">266</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.266"></a>
+<span class="sourceLineNo">267</span> // Predefined instances<a name="line.267"></a>
+<span class="sourceLineNo">268</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.268"></a>
+<span class="sourceLineNo">269</span><a name="line.269"></a>
+<span class="sourceLineNo">270</span> /** Default serializer, all default settings.*/<a name="line.270"></a>
+<span class="sourceLineNo">271</span> public static final JsonSchemaGenerator DEFAULT = new JsonSchemaGenerator(PropertyStore.DEFAULT);<a name="line.271"></a>
+<span class="sourceLineNo">272</span><a name="line.272"></a>
+<span class="sourceLineNo">273</span><a name="line.273"></a>
+<span class="sourceLineNo">274</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.274"></a>
+<span class="sourceLineNo">275</span> // Instance<a name="line.275"></a>
+<span class="sourceLineNo">276</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.276"></a>
+<span class="sourceLineNo">277</span><a name="line.277"></a>
+<span class="sourceLineNo">278</span> private final boolean useBeanDefs, allowNestedExamples, allowNestedDescriptions;<a name="line.278"></a>
+<span class="sourceLineNo">279</span> private final BeanDefMapper beanDefMapper;<a name="line.279"></a>
+<span class="sourceLineNo">280</span> private final Set<TypeCategory> addExamplesTo, addDescriptionsTo;<a name="line.280"></a>
+<span class="sourceLineNo">281</span> private final Map<String,ObjectMap> defaultSchemas;<a name="line.281"></a>
+<span class="sourceLineNo">282</span> private final JsonSerializer jsonSerializer;<a name="line.282"></a>
+<span class="sourceLineNo">283</span> private final Set<Pattern> ignoreTypes;<a name="line.283"></a>
+<span class="sourceLineNo">284</span><a name="line.284"></a>
+<span class="sourceLineNo">285</span> /**<a name="line.285"></a>
+<span class="sourceLineNo">286</span> * Constructor.<a name="line.286"></a>
+<span class="sourceLineNo">287</span> *<a name="line.287"></a>
+<span class="sourceLineNo">288</span> * @param ps Initialize with the specified config property store.<a name="line.288"></a>
+<span class="sourceLineNo">289</span> */<a name="line.289"></a>
+<span class="sourceLineNo">290</span> public JsonSchemaGenerator(PropertyStore ps) {<a name="line.290"></a>
+<span class="sourceLineNo">291</span> super(ps.builder().set(BEANTRAVERSE_detectRecursions, true).set(BEANTRAVERSE_ignoreRecursions, true).build());<a name="line.291"></a>
<span class="sourceLineNo">292</span><a name="line.292"></a>
-<span class="sourceLineNo">293</span> @Override<a name="line.293"></a>
-<span class="sourceLineNo">294</span> public JsonSchemaGeneratorSession createSession() {<a name="line.294"></a>
-<span class="sourceLineNo">295</span> return new JsonSchemaGeneratorSession(this, null);<a name="line.295"></a>
-<span class="sourceLineNo">296</span> }<a name="line.296"></a>
-<span class="sourceLineNo">297</span><a name="line.297"></a>
-<span class="sourceLineNo">298</span> JsonSerializer getJsonSerializer() {<a name="line.298"></a>
-<span class="sourceLineNo">299</span> return jsonSerializer;<a name="line.299"></a>
-<span class="sourceLineNo">300</span> }<a name="line.300"></a>
-<span class="sourceLineNo">301</span><a name="line.301"></a>
-<span class="sourceLineNo">302</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.302"></a>
-<span class="sourceLineNo">303</span> // Properties<a name="line.303"></a>
-<span class="sourceLineNo">304</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.304"></a>
+<span class="sourceLineNo">293</span> useBeanDefs = getBooleanProperty(JSONSCHEMA_useBeanDefs, false);<a name="line.293"></a>
+<span class="sourceLineNo">294</span> allowNestedExamples = getBooleanProperty(JSONSCHEMA_allowNestedExamples, false);<a name="line.294"></a>
+<span class="sourceLineNo">295</span> allowNestedDescriptions = getBooleanProperty(JSONSCHEMA_allowNestedDescriptions, false);<a name="line.295"></a>
+<span class="sourceLineNo">296</span> beanDefMapper = getInstanceProperty(JSONSCHEMA_beanDefMapper, BeanDefMapper.class, BasicBeanDefMapper.class);<a name="line.296"></a>
+<span class="sourceLineNo">297</span> addExamplesTo = TypeCategory.parse(getStringProperty(JSONSCHEMA_addExamplesTo, null));<a name="line.297"></a>
+<span class="sourceLineNo">298</span> addDescriptionsTo = TypeCategory.parse(getStringProperty(JSONSCHEMA_addDescriptionsTo, null));<a name="line.298"></a>
+<span class="sourceLineNo">299</span> defaultSchemas = getMapProperty(JSONSCHEMA_defaultSchemas, ObjectMap.class);<a name="line.299"></a>
+<span class="sourceLineNo">300</span><a name="line.300"></a>
+<span class="sourceLineNo">301</span> Set<Pattern> ignoreTypes = new LinkedHashSet<>();<a name="line.301"></a>
+<span class="sourceLineNo">302</span> for (String s : split(ps.getProperty(JSONSCHEMA_ignoreTypes, String.class, "")))<a name="line.302"></a>
+<span class="sourceLineNo">303</span> ignoreTypes.add(Pattern.compile(s.replace(".", "\\.").replace("*", ".*")));<a name="line.303"></a>
+<span class="sourceLineNo">304</span> this.ignoreTypes = ignoreTypes;<a name="line.304"></a>
<span class="sourceLineNo">305</span><a name="line.305"></a>
-<span class="sourceLineNo">306</span> /**<a name="line.306"></a>
-<span class="sourceLineNo">307</span> * Configuration property: Use bean definitions.<a name="line.307"></a>
-<span class="sourceLineNo">308</span> *<a name="line.308"></a>
-<span class="sourceLineNo">309</span> * @see #JSONSCHEMA_useBeanDefs<a name="line.309"></a>
-<span class="sourceLineNo">310</span> * @return<a name="line.310"></a>
-<span class="sourceLineNo">311</span> * <jk>true</jk> if schemas on beans will be serialized with <js>'$ref'</js> tags.<a name="line.311"></a>
-<span class="sourceLineNo">312</span> */<a name="line.312"></a>
-<span class="sourceLineNo">313</span> protected final boolean isUseBeanDefs() {<a name="line.313"></a>
-<span class="sourceLineNo">314</span> return useBeanDefs;<a name="line.314"></a>
-<span class="sourceLineNo">315</span> }<a name="line.315"></a>
-<span class="sourceLineNo">316</span><a name="line.316"></a>
-<span class="sourceLineNo">317</span> /**<a name="line.317"></a>
-<span class="sourceLineNo">318</span> * Configuration property: Allow nested examples.<a name="line.318"></a>
+<span class="sourceLineNo">306</span> jsonSerializer = new JsonSerializer(ps);<a name="line.306"></a>
+<span class="sourceLineNo">307</span> }<a name="line.307"></a>
+<span class="sourceLineNo">308</span><a name="line.308"></a>
+<span class="sourceLineNo">309</span> @Override /* Context */<a name="line.309"></a>
+<span class="sourceLineNo">310</span> public JsonSchemaGeneratorBuilder builder() {<a name="line.310"></a>
+<span class="sourceLineNo">311</span> return new JsonSchemaGeneratorBuilder(getPropertyStore());<a name="line.311"></a>
+<span class="sourceLineNo">312</span> }<a name="line.312"></a>
+<span class="sourceLineNo">313</span><a name="line.313"></a>
+<span class="sourceLineNo">314</span> /**<a name="line.314"></a>
+<span class="sourceLineNo">315</span> * Instantiates a new clean-slate {@link JsonSerializerBuilder} object.<a name="line.315"></a>
+<span class="sourceLineNo">316</span> *<a name="line.316"></a>
+<span class="sourceLineNo">317</span> * <p><a name="line.317"></a>
+<span class="sourceLineNo">318</span> * This is equivalent to simply calling <code><jk>new</jk> JsonSerializerBuilder()</code>.<a name="line.318"></a>
<span class="sourceLineNo">319</span> *<a name="line.319"></a>
-<span class="sourceLineNo">320</span> * @see #JSONSCHEMA_allowNestedExamples<a name="line.320"></a>
-<span class="sourceLineNo">321</span> * @return<a name="line.321"></a>
-<span class="sourceLineNo">322</span> * <jk>true</jk> if nested examples are allowed in schema definitions.<a name="line.322"></a>
-<span class="sourceLineNo">323</span> */<a name="line.323"></a>
-<span class="sourceLineNo">324</span> protected final boolean isAllowNestedExamples() {<a name="line.324"></a>
-<span class="sourceLineNo">325</span> return allowNestedExamples;<a name="line.325"></a>
-<span class="sourceLineNo">326</span> }<a name="line.326"></a>
-<span class="sourceLineNo">327</span><a name="line.327"></a>
-<span class="sourceLineNo">328</span> /**<a name="line.328"></a>
-<span class="sourceLineNo">329</span> * Configuration property: Allow nested descriptions.<a name="line.329"></a>
-<span class="sourceLineNo">330</span> *<a name="line.330"></a>
-<span class="sourceLineNo">331</span> * @see #JSONSCHEMA_allowNestedDescriptions<a name="line.331"></a>
-<span class="sourceLineNo">332</span> * @return<a name="line.332"></a>
-<span class="sourceLineNo">333</span> * <jk>true</jk> if nested descriptions are allowed in schema definitions.<a name="line.333"></a>
-<span class="sourceLineNo">334</span> */<a name="line.334"></a>
-<span class="sourceLineNo">335</span> protected final boolean isAllowNestedDescriptions() {<a name="line.335"></a>
-<span class="sourceLineNo">336</span> return allowNestedDescriptions;<a name="line.336"></a>
-<span class="sourceLineNo">337</span> }<a name="line.337"></a>
-<span class="sourceLineNo">338</span><a name="line.338"></a>
-<span class="sourceLineNo">339</span> /**<a name="line.339"></a>
-<span class="sourceLineNo">340</span> * Configuration property: Bean schema definition mapper.<a name="line.340"></a>
-<span class="sourceLineNo">341</span> *<a name="line.341"></a>
-<span class="sourceLineNo">342</span> * @see #JSONSCHEMA_beanDefMapper<a name="line.342"></a>
-<span class="sourceLineNo">343</span> * @return<a name="line.343"></a>
-<span class="sourceLineNo">344</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.344"></a>
-<span class="sourceLineNo">345</span> */<a name="line.345"></a>
-<span class="sourceLineNo">346</span> protected final BeanDefMapper getBeanDefMapper() {<a name="line.346"></a>
-<span class="sourceLineNo">347</span> return beanDefMapper;<a name="line.347"></a>
-<span class="sourceLineNo">348</span> }<a name="line.348"></a>
-<span class="sourceLineNo">349</span><a name="line.349"></a>
-<span class="sourceLineNo">350</span> /**<a name="line.350"></a>
-<span class="sourceLineNo">351</span> * Configuration property: Add examples.<a name="line.351"></a>
-<span class="sourceLineNo">352</span> *<a name="line.352"></a>
-<span class="sourceLineNo">353</span> * @see #JSONSCHEMA_addExamplesTo<a name="line.353"></a>
-<span class="sourceLineNo">354</span> * @return<a name="line.354"></a>
-<span class="sourceLineNo">355</span> * Set of categories of types that examples should be automatically added to generated schemas.<a name="line.355"></a>
-<span class="sourceLineNo">356</span> */<a name="line.356"></a>
-<span class="sourceLineNo">357</span> protected final Set<TypeCategory> getAddExamplesTo() {<a name="line.357"></a>
-<span class="sourceLineNo">358</span> return addExamplesTo;<a name="line.358"></a>
-<span class="sourceLineNo">359</span> }<a name="line.359"></a>
-<span class="sourceLineNo">360</span><a name="line.360"></a>
-<span class="sourceLineNo">361</span> /**<a name="line.361"></a>
-<span class="sourceLineNo">362</span> * Configuration property: Add descriptions to types.<a name="line.362"></a>
-<span class="sourceLineNo">363</span> *<a name="line.363"></a>
-<span class="sourceLineNo">364</span> * @see #JSONSCHEMA_addDescriptionsTo<a name="line.364"></a>
-<span class="sourceLineNo">365</span> * @return<a name="line.365"></a>
-<span class="sourceLineNo">366</span> * Set of categories of types that descriptions should be automatically added to generated schemas.<a name="line.366"></a>
-<span class="sourceLineNo">367</span> */<a name="line.367"></a>
-<span class="sourceLineNo">368</span> protected final Set<TypeCategory> getAddDescriptionsTo() {<a name="line.368"></a>
-<span class="sourceLineNo">369</span> return addDescriptionsTo;<a name="line.369"></a>
-<span class="sourceLineNo">370</span> }<a name="line.370"></a>
-<span class="sourceLineNo">371</span><a name="line.371"></a>
-<span class="sourceLineNo">372</span> /**<a name="line.372"></a>
-<span class="sourceLineNo">373</span> * Configuration property: Default schemas.<a name="line.373"></a>
-<span class="sourceLineNo">374</span> *<a name="line.374"></a>
-<span class="sourceLineNo">375</span> * @see #JSONSCHEMA_defaultSchemas<a name="line.375"></a>
-<span class="sourceLineNo">376</span> * @return<a name="line.376"></a>
-<span class="sourceLineNo">377</span> * Custom schema information for particular class types.<a name="line.377"></a>
-<span class="sourceLineNo">378</span> */<a name="line.378"></a>
-<span class="sourceLineNo">379</span> protected final Map<String,ObjectMap> getDefaultSchemas() {<a name="line.379"></a>
-<span class="sourceLineNo">380</span> return defaultSchemas;<a name="line.380"></a>
-<span class="sourceLineNo">381</span> }<a name="line.381"></a>
-<span class="sourceLineNo">382</span>}<a name="line.382"></a>
+<span class="sourceLineNo">320</span> * @return A new {@link JsonSerializerBuilder} object.<a name="line.320"></a>
+<span class="sourceLineNo">321</span> */<a name="line.321"></a>
+<span class="sourceLineNo">322</span> public static JsonSchemaGeneratorBuilder create() {<a name="line.322"></a>
+<span class="sourceLineNo">323</span> return new JsonSchemaGeneratorBuilder();<a name="line.323"></a>
+<span class="sourceLineNo">324</span> }<a name="line.324"></a>
+<span class="sourceLineNo">325</span><a name="line.325"></a>
+<span class="sourceLineNo">326</span> @Override<a name="line.326"></a>
+<span class="sourceLineNo">327</span> public JsonSchemaGeneratorSession createSession(BeanSessionArgs args) {<a name="line.327"></a>
+<span class="sourceLineNo">328</span> return new JsonSchemaGeneratorSession(this, args);<a name="line.328"></a>
+<span class="sourceLineNo">329</span> }<a name="line.329"></a>
+<span class="sourceLineNo">330</span><a name="line.330"></a>
+<span class="sourceLineNo">331</span> @Override<a name="line.331"></a>
+<span class="sourceLineNo">332</span> public JsonSchemaGeneratorSession createSession() {<a name="line.332"></a>
+<span class="sourceLineNo">333</span> return new JsonSchemaGeneratorSession(this, null);<a name="line.333"></a>
+<span class="sourceLineNo">334</span> }<a name="line.334"></a>
+<span class="sourceLineNo">335</span><a name="line.335"></a>
+<span class="sourceLineNo">336</span> JsonSerializer getJsonSerializer() {<a name="line.336"></a>
+<span class="sourceLineNo">337</span> return jsonSerializer;<a name="line.337"></a>
+<span class="sourceLineNo">338</span> }<a name="line.338"></a>
+<span class="sourceLineNo">339</span><a name="line.339"></a>
+<span class="sourceLineNo">340</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.340"></a>
+<span class="sourceLineNo">341</span> // Properties<a name="line.341"></a>
+<span class="sourceLineNo">342</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.342"></a>
+<span class="sourceLineNo">343</span><a name="line.343"></a>
+<span class="sourceLineNo">344</span> /**<a name="line.344"></a>
+<span class="sourceLineNo">345</span> * Configuration property: Use bean definitions.<a name="line.345"></a>
+<span class="sourceLineNo">346</span> *<a name="line.346"></a>
+<span class="sourceLineNo">347</span> * @see #JSONSCHEMA_useBeanDefs<a name="line.347"></a>
+<span class="sourceLineNo">348</span> * @return<a name="line.348"></a>
+<span class="sourceLineNo">349</span> * <jk>true</jk> if schemas on beans will be serialized with <js>'$ref'</js> tags.<a name="line.349"></a>
+<span class="sourceLineNo">350</span> */<a name="line.350"></a>
+<span class="sourceLineNo">351</span> protected final boolean isUseBeanDefs() {<a name="line.351"></a>
+<span class="sourceLineNo">352</span> return useBeanDefs;<a name="line.352"></a>
+<span class="sourceLineNo">353</span> }<a name="line.353"></a>
+<span class="sourceLineNo">354</span><a name="line.354"></a>
+<span class="sourceLineNo">355</span> /**<a name="line.355"></a>
+<span class="sourceLineNo">356</span> * Configuration property: Allow nested examples.<a name="line.356"></a>
+<span class="sourceLineNo">357</span> *<a name="line.357"></a>
+<span class="sourceLineNo">358</span> * @see #JSONSCHEMA_allowNestedExamples<a name="line.358"></a>
+<span class="sourceLineNo">359</span> * @return<a name="line.359"></a>
+<span class="sourceLineNo">360</span> * <jk>true</jk> if nested examples are allowed in schema definitions.<a name="line.360"></a>
+<span class="sourceLineNo">361</span> */<a name="line.361"></a>
+<span class="sourceLineNo">362</span> protected final boolean isAllowNestedExamples() {<a name="line.362"></a>
+<span class="sourceLineNo">363</span> return allowNestedExamples;<a name="line.363"></a>
+<span class="sourceLineNo">364</span> }<a name="line.364"></a>
+<span class="sourceLineNo">365</span><a name="line.365"></a>
+<span class="sourceLineNo">366</span> /**<a name="line.366"></a>
+<span class="sourceLineNo">367</span> * Configuration property: Allow nested descriptions.<a name="line.367"></a>
+<span class="sourceLineNo">368</span> *<a name="line.368"></a>
+<span class="sourceLineNo">369</span> * @see #JSONSCHEMA_allowNestedDescriptions<a name="line.369"></a>
+<span class="sourceLineNo">370</span> * @return<a name="line.370"></a>
+<span class="sourceLineNo">371</span> * <jk>true</jk> if nested descriptions are allowed in schema definitions.<a name="line.371"></a>
+<span class="sourceLineNo">372</span> */<a name="line.372"></a>
+<span class="sourceLineNo">373</span> protected final boolean isAllowNestedDescriptions() {<a name="line.373"></a>
+<span class="sourceLineNo">374</span> return allowNestedDescriptions;<a name="line.374"></a>
+<span class="sourceLineNo">375</span> }<a name="line.375"></a>
+<span class="sourceLineNo">376</span><a name="line.376"></a>
+<span class="sourceLineNo">377</span> /**<a name="line.377"></a>
+<span class="sourceLineNo">378</span> * Configuration property: Bean schema definition mapper.<a name="line.378"></a>
+<span class="sourceLineNo">379</span> *<a name="line.379"></a>
+<span class="sourceLineNo">380</span> * @see #JSONSCHEMA_beanDefMapper<a name="line.380"></a>
+<span class="sourceLineNo">381</span> * @return<a name="line.381"></a>
+<span class="sourceLineNo">382</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.382"></a>
+<span class="sourceLineNo">383</span> */<a name="line.383"></a>
+<span class="sourceLineNo">384</span> protected final BeanDefMapper getBeanDefMapper() {<a name="line.384"></a>
+<span class="sourceLineNo">385</span> return beanDefMapper;<a name="line.385"></a>
+<span class="sourceLineNo">386</span> }<a name="line.386"></a>
+<span class="sourceLineNo">387</span><a name="line.387"></a>
+<span class="sourceLineNo">388</span> /**<a name="line.388"></a>
+<span class="sourceLineNo">389</span> * Configuration property: Add examples.<a name="line.389"></a>
+<span class="sourceLineNo">390</span> *<a name="line.390"></a>
+<span class="sourceLineNo">391</span> * @see #JSONSCHEMA_addExamplesTo<a name="line.391"></a>
+<span class="sourceLineNo">392</span> * @return<a name="line.392"></a>
+<span class="sourceLineNo">393</span> * Set of categories of types that examples should be automatically added to generated schemas.<a name="line.393"></a>
+<span class="sourceLineNo">394</span> */<a name="line.394"></a>
+<span class="sourceLineNo">395</span> protected final Set<TypeCategory> getAddExamplesTo() {<a name="line.395"></a>
+<span class="sourceLineNo">396</span> return addExamplesTo;<a name="line.396"></a>
+<span class="sourceLineNo">397</span> }<a name="line.397"></a>
+<span class="sourceLineNo">398</span><a name="line.398"></a>
+<span class="sourceLineNo">399</span> /**<a name="line.399"></a>
+<span class="sourceLineNo">400</span> * Configuration property: Add descriptions to types.<a name="line.400"></a>
+<span class="sourceLineNo">401</span> *<a name="line.401"></a>
+<span class="sourceLineNo">402</span> * @see #JSONSCHEMA_addDescriptionsTo<a name="line.402"></a>
+<span class="sourceLineNo">403</span> * @return<a name="line.403"></a>
+<span class="sourceLineNo">404</span> * Set of categories of types that descriptions should be automatically added to generated schemas.<a name="line.404"></a>
+<span class="sourceLineNo">405</span> */<a name="line.405"></a>
+<span class="sourceLineNo">406</span> protected final Set<TypeCategory> getAddDescriptionsTo() {<a name="line.406"></a>
+<span class="sourceLineNo">407</span> return addDescriptionsTo;<a name="line.407"></a>
+<span class="sourceLineNo">408</span> }<a name="line.408"></a>
+<span class="sourceLineNo">409</span><a name="line.409"></a>
+<span class="sourceLineNo">410</span> /**<a name="line.410"></a>
+<span class="sourceLineNo">411</span> * Configuration property: Default schemas.<a name="line.411"></a>
+<span class="sourceLineNo">412</span> *<a name="line.412"></a>
+<span class="sourceLineNo">413</span> * @see #JSONSCHEMA_defaultSchemas<a name="line.413"></a>
+<span class="sourceLineNo">414</span> * @return<a name="line.414"></a>
+<span class="sourceLineNo">415</span> * Custom schema information for particular class types.<a name="line.415"></a>
+<span class="sourceLineNo">416</span> */<a name="line.416"></a>
+<span class="sourceLineNo">417</span> protected final Map<String,ObjectMap> getDefaultSchemas() {<a name="line.417"></a>
+<span class="sourceLineNo">418</span> return defaultSchemas;<a name="line.418"></a>
+<span class="sourceLineNo">419</span> }<a name="line.419"></a>
+<span class="sourceLineNo">420</span><a name="line.420"></a>
+<span class="sourceLineNo">421</span> /**<a name="line.421"></a>
+<span class="sourceLineNo">422</span> * Returns <jk>true</jk> if the specified type is ignored.<a name="line.422"></a>
+<span class="sourceLineNo">423</span> *<a name="line.423"></a>
+<span class="sourceLineNo">424</span> * <p><a name="line.424"></a>
+<span class="sourceLineNo">425</span> * The type is ignored if it's specified in the {@link #JSONSCHEMA_ignoreTypes} setting.<a name="line.425"></a>
+<span class="sourceLineNo">426</span> * <br>Ignored types return <jk>null</jk> on the call to {@link JsonSchemaGeneratorSession#getSchema(ClassMeta)}.<a name="line.426"></a>
+<span class="sourceLineNo">427</span> *<a name="line.427"></a>
+<span class="sourceLineNo">428</span> * @param cm The type to check.<a name="line.428"></a>
+<span class="sourceLineNo">429</span> * @return <jk>true</jk> if the specified type is ignored.<a name="line.429"></a>
+<span class="sourceLineNo">430</span> */<a name="line.430"></a>
+<span class="sourceLineNo">431</span> public boolean isIgnoredType(ClassMeta<?> cm) {<a name="line.431"></a>
+<span class="sourceLineNo">432</span> for (Pattern p : ignoreTypes)<a name="line.432"></a>
+<span class="sourceLineNo">433</span> if (p.matcher(cm.getSimpleName()).matches() || p.matcher(cm.getName()).matches())<a name="line.433"></a>
+<span class="sourceLineNo">434</span> return true;<a name="line.434"></a>
+<span class="sourceLineNo">435</span> return false;<a name="line.435"></a>
+<span class="sourceLineNo">436</span> }<a name="line.436"></a>
+<span class="sourceLineNo">437</span>}<a name="line.437"></a>
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html b/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
index e6e4bd2..3749f96 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/jsonschema/JsonSchemaGeneratorSession.html
@@ -102,353 +102,356 @@
<span class="sourceLineNo">094</span> @SuppressWarnings({ "unchecked", "rawtypes" })<a name="line.94"></a>
<span class="sourceLineNo">095</span> private ObjectMap getSchema(ClassMeta<?> eType, String attrName, String[] pNames, boolean exampleAdded, boolean descriptionAdded, JsonSchemaBeanPropertyMeta jsbpm) throws Exception {<a name="line.95"></a>
<span class="sourceLineNo">096</span><a name="line.96"></a>
-<span class="sourceLineNo">097</span> ObjectMap out = new ObjectMap();<a name="line.97"></a>
-<span class="sourceLineNo">098</span><a name="line.98"></a>
-<span class="sourceLineNo">099</span> if (eType == null)<a name="line.99"></a>
-<span class="sourceLineNo">100</span> eType = object();<a name="line.100"></a>
+<span class="sourceLineNo">097</span> if (ctx.isIgnoredType(eType))<a name="line.97"></a>
+<span class="sourceLineNo">098</span> return null;<a name="line.98"></a>
+<span class="sourceLineNo">099</span><a name="line.99"></a>
+<span class="sourceLineNo">100</span> ObjectMap out = new ObjectMap();<a name="line.100"></a>
<span class="sourceLineNo">101</span><a name="line.101"></a>
-<span class="sourceLineNo">102</span> ClassMeta<?> aType; // The actual type (will be null if recursion occurs)<a name="line.102"></a>
-<span class="sourceLineNo">103</span> ClassMeta<?> sType; // The serialized type<a name="line.103"></a>
-<span class="sourceLineNo">104</span> PojoSwap pojoSwap = eType.getPojoSwap(this);<a name="line.104"></a>
-<span class="sourceLineNo">105</span><a name="line.105"></a>
-<span class="sourceLineNo">106</span> aType = push(attrName, eType, null);<a name="line.106"></a>
-<span class="sourceLineNo">107</span><a name="line.107"></a>
-<span class="sourceLineNo">108</span> sType = eType.getSerializedClassMeta(this);<a name="line.108"></a>
-<span class="sourceLineNo">109</span><a name="line.109"></a>
-<span class="sourceLineNo">110</span> String type = null, format = null;<a name="line.110"></a>
-<span class="sourceLineNo">111</span> Object example = null, description = null;<a name="line.111"></a>
+<span class="sourceLineNo">102</span> if (eType == null)<a name="line.102"></a>
+<span class="sourceLineNo">103</span> eType = object();<a name="line.103"></a>
+<span class="sourceLineNo">104</span><a name="line.104"></a>
+<span class="sourceLineNo">105</span> ClassMeta<?> aType; // The actual type (will be null if recursion occurs)<a name="line.105"></a>
+<span class="sourceLineNo">106</span> ClassMeta<?> sType; // The serialized type<a name="line.106"></a>
+<span class="sourceLineNo">107</span> PojoSwap pojoSwap = eType.getPojoSwap(this);<a name="line.107"></a>
+<span class="sourceLineNo">108</span><a name="line.108"></a>
+<span class="sourceLineNo">109</span> aType = push(attrName, eType, null);<a name="line.109"></a>
+<span class="sourceLineNo">110</span><a name="line.110"></a>
+<span class="sourceLineNo">111</span> sType = eType.getSerializedClassMeta(this);<a name="line.111"></a>
<span class="sourceLineNo">112</span><a name="line.112"></a>
-<span class="sourceLineNo">113</span> boolean useDef = isUseBeanDefs() && sType.isBean() && pNames == null;<a name="line.113"></a>
-<span class="sourceLineNo">114</span><a name="line.114"></a>
-<span class="sourceLineNo">115</span> if (useDef) {<a name="line.115"></a>
-<span class="sourceLineNo">116</span> exampleAdded = false;<a name="line.116"></a>
-<span class="sourceLineNo">117</span> descriptionAdded = false;<a name="line.117"></a>
-<span class="sourceLineNo">118</span> }<a name="line.118"></a>
-<span class="sourceLineNo">119</span><a name="line.119"></a>
-<span class="sourceLineNo">120</span> if (useDef && defs.containsKey(getBeanDefId(sType))) {<a name="line.120"></a>
-<span class="sourceLineNo">121</span> pop();<a name="line.121"></a>
-<span class="sourceLineNo">122</span> return new ObjectMap().append("$ref", getBeanDefUri(sType));<a name="line.122"></a>
-<span class="sourceLineNo">123</span> }<a name="line.123"></a>
-<span class="sourceLineNo">124</span><a name="line.124"></a>
-<span class="sourceLineNo">125</span> ObjectMap ds = getDefaultSchemas().get(sType.getInnerClass().getName());<a name="line.125"></a>
-<span class="sourceLineNo">126</span> if (ds != null && ds.containsKey("type")) {<a name="line.126"></a>
-<span class="sourceLineNo">127</span> pop();<a name="line.127"></a>
-<span class="sourceLineNo">128</span> return out.appendAll(ds);<a name="line.128"></a>
-<span class="sourceLineNo">129</span> }<a name="line.129"></a>
-<span class="sourceLineNo">130</span><a name="line.130"></a>
-<span class="sourceLineNo">131</span> JsonSchemaClassMeta jscm = null;<a name="line.131"></a>
-<span class="sourceLineNo">132</span> if (pojoSwap != null && pojoSwap.getClass().getAnnotation(JsonSchema.class) != null)<a name="line.132"></a>
-<span class="sourceLineNo">133</span> jscm = getClassMeta(pojoSwap.getClass()).getExtendedMeta(JsonSchemaClassMeta.class);<a name="line.133"></a>
-<span class="sourceLineNo">134</span> if (jscm == null)<a name="line.134"></a>
-<span class="sourceLineNo">135</span> jscm = sType.getExtendedMeta(JsonSchemaClassMeta.class);<a name="line.135"></a>
-<span class="sourceLineNo">136</span><a name="line.136"></a>
-<span class="sourceLineNo">137</span> TypeCategory tc = null;<a name="line.137"></a>
-<span class="sourceLineNo">138</span><a name="line.138"></a>
-<span class="sourceLineNo">139</span> if (sType.isNumber()) {<a name="line.139"></a>
-<span class="sourceLineNo">140</span> tc = NUMBER;<a name="line.140"></a>
-<span class="sourceLineNo">141</span> if (sType.isDecimal()) {<a name="line.141"></a>
-<span class="sourceLineNo">142</span> type = "number";<a name="line.142"></a>
-<span class="sourceLineNo">143</span> if (sType.isFloat()) {<a name="line.143"></a>
-<span class="sourceLineNo">144</span> format = "float";<a name="line.144"></a>
-<span class="sourceLineNo">145</span> } else if (sType.isDouble()) {<a name="line.145"></a>
-<span class="sourceLineNo">146</span> format = "double";<a name="line.146"></a>
-<span class="sourceLineNo">147</span> }<a name="line.147"></a>
-<span class="sourceLineNo">148</span> } else {<a name="line.148"></a>
-<span class="sourceLineNo">149</span> type = "integer";<a name="line.149"></a>
-<span class="sourceLineNo">150</span> if (sType.isShort()) {<a name="line.150"></a>
-<span class="sourceLineNo">151</span> format = "int16";<a name="line.151"></a>
-<span class="sourceLineNo">152</span> } else if (sType.isInteger()) {<a name="line.152"></a>
-<span class="sourceLineNo">153</span> format = "int32";<a name="line.153"></a>
-<span class="sourceLineNo">154</span> } else if (sType.isLong()) {<a name="line.154"></a>
-<span class="sourceLineNo">155</span> format = "int64";<a name="line.155"></a>
-<span class="sourceLineNo">156</span> }<a name="line.156"></a>
-<span class="sourceLineNo">157</span> }<a name="line.157"></a>
-<span class="sourceLineNo">158</span> } else if (sType.isBoolean()) {<a name="line.158"></a>
-<span class="sourceLineNo">159</span> tc = BOOLEAN;<a name="line.159"></a>
-<span class="sourceLineNo">160</span> type = "boolean";<a name="line.160"></a>
-<span class="sourceLineNo">161</span> } else if (sType.isMap()) {<a name="line.161"></a>
-<span class="sourceLineNo">162</span> tc = MAP;<a name="line.162"></a>
-<span class="sourceLineNo">163</span> type = "object";<a name="line.163"></a>
-<span class="sourceLineNo">164</span> } else if (sType.isBean()) {<a name="line.164"></a>
-<span class="sourceLineNo">165</span> tc = BEAN;<a name="line.165"></a>
+<span class="sourceLineNo">113</span> String type = null, format = null;<a name="line.113"></a>
+<span class="sourceLineNo">114</span> Object example = null, description = null;<a name="line.114"></a>
+<span class="sourceLineNo">115</span><a name="line.115"></a>
+<span class="sourceLineNo">116</span> boolean useDef = isUseBeanDefs() && sType.isBean() && pNames == null;<a name="line.116"></a>
+<span class="sourceLineNo">117</span><a name="line.117"></a>
+<span class="sourceLineNo">118</span> if (useDef) {<a name="line.118"></a>
+<span class="sourceLineNo">119</span> exampleAdded = false;<a name="line.119"></a>
+<span class="sourceLineNo">120</span> descriptionAdded = false;<a name="line.120"></a>
+<span class="sourceLineNo">121</span> }<a name="line.121"></a>
+<span class="sourceLineNo">122</span><a name="line.122"></a>
+<span class="sourceLineNo">123</span> if (useDef && defs.containsKey(getBeanDefId(sType))) {<a name="line.123"></a>
+<span class="sourceLineNo">124</span> pop();<a name="line.124"></a>
+<span class="sourceLineNo">125</span> return new ObjectMap().append("$ref", getBeanDefUri(sType));<a name="line.125"></a>
+<span class="sourceLineNo">126</span> }<a name="line.126"></a>
+<span class="sourceLineNo">127</span><a name="line.127"></a>
+<span class="sourceLineNo">128</span> ObjectMap ds = getDefaultSchemas().get(sType.getInnerClass().getName());<a name="line.128"></a>
+<span class="sourceLineNo">129</span> if (ds != null && ds.containsKey("type")) {<a name="line.129"></a>
+<span class="sourceLineNo">130</span> pop();<a name="line.130"></a>
+<span class="sourceLineNo">131</span> return out.appendAll(ds);<a name="line.131"></a>
+<span class="sourceLineNo">132</span> }<a name="line.132"></a>
+<span class="sourceLineNo">133</span><a name="line.133"></a>
+<span class="sourceLineNo">134</span> JsonSchemaClassMeta jscm = null;<a name="line.134"></a>
+<span class="sourceLineNo">135</span> if (pojoSwap != null && pojoSwap.getClass().getAnnotation(JsonSchema.class) != null)<a name="line.135"></a>
+<span class="sourceLineNo">136</span> jscm = getClassMeta(pojoSwap.getClass()).getExtendedMeta(JsonSchemaClassMeta.class);<a name="line.136"></a>
+<span class="sourceLineNo">137</span> if (jscm == null)<a name="line.137"></a>
+<span class="sourceLineNo">138</span> jscm = sType.getExtendedMeta(JsonSchemaClassMeta.class);<a name="line.138"></a>
+<span class="sourceLineNo">139</span><a name="line.139"></a>
+<span class="sourceLineNo">140</span> TypeCategory tc = null;<a name="line.140"></a>
+<span class="sourceLineNo">141</span><a name="line.141"></a>
+<span class="sourceLineNo">142</span> if (sType.isNumber()) {<a name="line.142"></a>
+<span class="sourceLineNo">143</span> tc = NUMBER;<a name="line.143"></a>
+<span class="sourceLineNo">144</span> if (sType.isDecimal()) {<a name="line.144"></a>
+<span class="sourceLineNo">145</span> type = "number";<a name="line.145"></a>
+<span class="sourceLineNo">146</span> if (sType.isFloat()) {<a name="line.146"></a>
+<span class="sourceLineNo">147</span> format = "float";<a name="line.147"></a>
+<span class="sourceLineNo">148</span> } else if (sType.isDouble()) {<a name="line.148"></a>
+<span class="sourceLineNo">149</span> format = "double";<a name="line.149"></a>
+<span class="sourceLineNo">150</span> }<a name="line.150"></a>
+<span class="sourceLineNo">151</span> } else {<a name="line.151"></a>
+<span class="sourceLineNo">152</span> type = "integer";<a name="line.152"></a>
+<span class="sourceLineNo">153</span> if (sType.isShort()) {<a name="line.153"></a>
+<span class="sourceLineNo">154</span> format = "int16";<a name="line.154"></a>
+<span class="sourceLineNo">155</span> } else if (sType.isInteger()) {<a name="line.155"></a>
+<span class="sourceLineNo">156</span> format = "int32";<a name="line.156"></a>
+<span class="sourceLineNo">157</span> } else if (sType.isLong()) {<a name="line.157"></a>
+<span class="sourceLineNo">158</span> format = "int64";<a name="line.158"></a>
+<span class="sourceLineNo">159</span> }<a name="line.159"></a>
+<span class="sourceLineNo">160</span> }<a name="line.160"></a>
+<span class="sourceLineNo">161</span> } else if (sType.isBoolean()) {<a name="line.161"></a>
+<span class="sourceLineNo">162</span> tc = BOOLEAN;<a name="line.162"></a>
+<span class="sourceLineNo">163</span> type = "boolean";<a name="line.163"></a>
+<span class="sourceLineNo">164</span> } else if (sType.isMap()) {<a name="line.164"></a>
+<span class="sourceLineNo">165</span> tc = MAP;<a name="line.165"></a>
<span class="sourceLineNo">166</span> type = "object";<a name="line.166"></a>
-<span class="sourceLineNo">167</span> } else if (sType.isCollection()) {<a name="line.167"></a>
-<span class="sourceLineNo">168</span> tc = COLLECTION;<a name="line.168"></a>
-<span class="sourceLineNo">169</span> type = "array";<a name="line.169"></a>
-<span class="sourceLineNo">170</span> } else if (sType.isArray()) {<a name="line.170"></a>
-<span class="sourceLineNo">171</span> tc = ARRAY;<a name="line.171"></a>
+<span class="sourceLineNo">167</span> } else if (sType.isBean()) {<a name="line.167"></a>
+<span class="sourceLineNo">168</span> tc = BEAN;<a name="line.168"></a>
+<span class="sourceLineNo">169</span> type = "object";<a name="line.169"></a>
+<span class="sourceLineNo">170</span> } else if (sType.isCollection()) {<a name="line.170"></a>
+<span class="sourceLineNo">171</span> tc = COLLECTION;<a name="line.171"></a>
<span class="sourceLineNo">172</span> type = "array";<a name="line.172"></a>
-<span class="sourceLineNo">173</span> } else if (sType.isEnum()) {<a name="line.173"></a>
-<span class="sourceLineNo">174</span> tc = ENUM;<a name="line.174"></a>
-<span class="sourceLineNo">175</span> type = "string";<a name="line.175"></a>
-<span class="sourceLineNo">176</span> } else if (sType.isCharSequence() || sType.isChar()) {<a name="line.176"></a>
-<span class="sourceLineNo">177</span> tc = STRING;<a name="line.177"></a>
+<span class="sourceLineNo">173</span> } else if (sType.isArray()) {<a name="line.173"></a>
+<span class="sourceLineNo">174</span> tc = ARRAY;<a name="line.174"></a>
+<span class="sourceLineNo">175</span> type = "array";<a name="line.175"></a>
+<span class="sourceLineNo">176</span> } else if (sType.isEnum()) {<a name="line.176"></a>
+<span class="sourceLineNo">177</span> tc = ENUM;<a name="line.177"></a>
<span class="sourceLineNo">178</span> type = "string";<a name="line.178"></a>
-<span class="sourceLineNo">179</span> } else if (sType.isUri()) {<a name="line.179"></a>
+<span class="sourceLineNo">179</span> } else if (sType.isCharSequence() || sType.isChar()) {<a name="line.179"></a>
<span class="sourceLineNo">180</span> tc = STRING;<a name="line.180"></a>
<span class="sourceLineNo">181</span> type = "string";<a name="line.181"></a>
-<span class="sourceLineNo">182</span> format = "uri";<a name="line.182"></a>
-<span class="sourceLineNo">183</span> } else {<a name="line.183"></a>
-<span class="sourceLineNo">184</span> tc = STRING;<a name="line.184"></a>
-<span class="sourceLineNo">185</span> type = "string";<a name="line.185"></a>
-<span class="sourceLineNo">186</span> }<a name="line.186"></a>
-<span class="sourceLineNo">187</span><a name="line.187"></a>
-<span class="sourceLineNo">188</span> // Add info from @JsonSchema on bean property.<a name="line.188"></a>
-<span class="sourceLineNo">189</span> if (jsbpm != null) {<a name="line.189"></a>
-<span class="sourceLineNo">190</span> out.appendIf(false, true, true, "type", jsbpm.getType());<a name="line.190"></a>
-<span class="sourceLineNo">191</span> out.appendIf(false, true, true, "format", jsbpm.getFormat());<a name="line.191"></a>
-<span class="sourceLineNo">192</span> }<a name="line.192"></a>
-<span class="sourceLineNo">193</span><a name="line.193"></a>
-<span class="sourceLineNo">194</span> out.appendIf(false, true, true, "type", jscm.getType());<a name="line.194"></a>
-<span class="sourceLineNo">195</span> out.appendIf(false, true, true, "format", jscm.getFormat());<a name="line.195"></a>
+<span class="sourceLineNo">182</span> } else if (sType.isUri()) {<a name="line.182"></a>
+<span class="sourceLineNo">183</span> tc = STRING;<a name="line.183"></a>
+<span class="sourceLineNo">184</span> type = "string";<a name="line.184"></a>
+<span class="sourceLineNo">185</span> format = "uri";<a name="line.185"></a>
+<span class="sourceLineNo">186</span> } else {<a name="line.186"></a>
+<span class="sourceLineNo">187</span> tc = STRING;<a name="line.187"></a>
+<span class="sourceLineNo">188</span> type = "string";<a name="line.188"></a>
+<span class="sourceLineNo">189</span> }<a name="line.189"></a>
+<span class="sourceLineNo">190</span><a name="line.190"></a>
+<span class="sourceLineNo">191</span> // Add info from @JsonSchema on bean property.<a name="line.191"></a>
+<span class="sourceLineNo">192</span> if (jsbpm != null) {<a name="line.192"></a>
+<span class="sourceLineNo">193</span> out.appendIf(false, true, true, "type", jsbpm.getType());<a name="line.193"></a>
+<span class="sourceLineNo">194</span> out.appendIf(false, true, true, "format", jsbpm.getFormat());<a name="line.194"></a>
+<span class="sourceLineNo">195</span> }<a name="line.195"></a>
<span class="sourceLineNo">196</span><a name="line.196"></a>
-<span class="sourceLineNo">197</span> out.appendIf(false, true, true, "type", type);<a name="line.197"></a>
-<span class="sourceLineNo">198</span> out.appendIf(false, true, true, "format", format);<a name="line.198"></a>
+<span class="sourceLineNo">197</span> out.appendIf(false, true, true, "type", jscm.getType());<a name="line.197"></a>
+<span class="sourceLineNo">198</span> out.appendIf(false, true, true, "format", jscm.getFormat());<a name="line.198"></a>
<span class="sourceLineNo">199</span><a name="line.199"></a>
-<span class="sourceLineNo">200</span> if (aType != null) {<a name="line.200"></a>
-<span class="sourceLineNo">201</span><a name="line.201"></a>
-<span class="sourceLineNo">202</span> example = getExample(sType, tc, exampleAdded);<a name="line.202"></a>
-<span class="sourceLineNo">203</span> description = getDescription(sType, tc, descriptionAdded);<a name="line.203"></a>
-<span class="sourceLineNo">204</span> exampleAdded |= example != null;<a name="line.204"></a>
-<span class="sourceLineNo">205</span> descriptionAdded |= description != null;<a name="line.205"></a>
-<span class="sourceLineNo">206</span><a name="line.206"></a>
-<span class="sourceLineNo">207</span> if (tc == BEAN) {<a name="line.207"></a>
-<span class="sourceLineNo">208</span> ObjectMap properties = new ObjectMap();<a name="line.208"></a>
-<span class="sourceLineNo">209</span> BeanMeta bm = getBeanMeta(sType.getInnerClass());<a name="line.209"></a>
-<span class="sourceLineNo">210</span> if (pNames != null)<a name="line.210"></a>
-<span class="sourceLineNo">211</span> bm = new BeanMetaFiltered(bm, pNames);<a name="line.211"></a>
-<span class="sourceLineNo">212</span> for (Iterator<BeanPropertyMeta> i = bm.getPropertyMetas().iterator(); i.hasNext();) {<a name="line.212"></a>
-<span class="sourceLineNo">213</span> BeanPropertyMeta p = i.next();<a name="line.213"></a>
-<span class="sourceLineNo">214</span> if (p.canRead())<a name="line.214"></a>
-<span class="sourceLineNo">215</span> properties.put(p.getName(), getSchema(p.getClassMeta(), p.getName(), p.getProperties(), exampleAdded, descriptionAdded, p.getExtendedMeta(JsonSchemaBeanPropertyMeta.class)));<a name="line.215"></a>
-<span class="sourceLineNo">216</span> }<a name="line.216"></a>
-<span class="sourceLineNo">217</span> out.put("properties", properties);<a name="line.217"></a>
-<span class="sourceLineNo">218</span><a name="line.218"></a>
-<span class="sourceLineNo">219</span> } else if (tc == COLLECTION) {<a name="line.219"></a>
-<span class="sourceLineNo">220</span> ClassMeta et = sType.getElementType();<a name="line.220"></a>
-<span class="sourceLineNo">221</span> if (sType.isCollection() && isParentClass(Set.class, sType.getInnerClass()))<a name="line.221"></a>
-<span class="sourceLineNo">222</span> out.put("uniqueItems", true);<a name="line.222"></a>
-<span class="sourceLineNo">223</span> out.put("items", getSchema(et, "items", pNames, exampleAdded, descriptionAdded, null));<a name="line.223"></a>
-<span class="sourceLineNo">224</span><a name="line.224"></a>
-<span class="sourceLineNo">225</span> } else if (tc == ARRAY) {<a name="line.225"></a>
-<span class="sourceLineNo">226</span> ClassMeta et = sType.getElementType();<a name="line.226"></a>
-<span class="sourceLineNo">227</span> if (sType.isCollection() && isParentClass(Set.class, sType.getInnerClass()))<a name="line.227"></a>
-<span class="sourceLineNo">228</span> out.put("uniqueItems", true);<a name="line.228"></a>
-<span class="sourceLineNo">229</span> out.put("items", getSchema(et, "items", pNames, exampleAdded, descriptionAdded, null));<a name="line.229"></a>
-<span class="sourceLineNo">230</span><a name="line.230"></a>
-<span class="sourceLineNo">231</span> } else if (tc == ENUM) {<a name="line.231"></a>
-<span class="sourceLineNo">232</span> out.put("enum", getEnums(sType));<a name="line.232"></a>
+<span class="sourceLineNo">200</span> out.appendIf(false, true, true, "type", type);<a name="line.200"></a>
+<span class="sourceLineNo">201</span> out.appendIf(false, true, true, "format", format);<a name="line.201"></a>
+<span class="sourceLineNo">202</span><a name="line.202"></a>
+<span class="sourceLineNo">203</span> if (aType != null) {<a name="line.203"></a>
+<span class="sourceLineNo">204</span><a name="line.204"></a>
+<span class="sourceLineNo">205</span> example = getExample(sType, tc, exampleAdded);<a name="line.205"></a>
+<span class="sourceLineNo">206</span> description = getDescription(sType, tc, descriptionAdded);<a name="line.206"></a>
+<span class="sourceLineNo">207</span> exampleAdded |= example != null;<a name="line.207"></a>
+<span class="sourceLineNo">208</span> descriptionAdded |= description != null;<a name="line.208"></a>
+<span class="sourceLineNo">209</span><a name="line.209"></a>
+<span class="sourceLineNo">210</span> if (tc == BEAN) {<a name="line.210"></a>
+<span class="sourceLineNo">211</span> ObjectMap properties = new ObjectMap();<a name="line.211"></a>
+<span class="sourceLineNo">212</span> BeanMeta bm = getBeanMeta(sType.getInnerClass());<a name="line.212"></a>
+<span class="sourceLineNo">213</span> if (pNames != null)<a name="line.213"></a>
+<span class="sourceLineNo">214</span> bm = new BeanMetaFiltered(bm, pNames);<a name="line.214"></a>
+<span class="sourceLineNo">215</span> for (Iterator<BeanPropertyMeta> i = bm.getPropertyMetas().iterator(); i.hasNext();) {<a name="line.215"></a>
+<span class="sourceLineNo">216</span> BeanPropertyMeta p = i.next();<a name="line.216"></a>
+<span class="sourceLineNo">217</span> if (p.canRead())<a name="line.217"></a>
+<span class="sourceLineNo">218</span> properties.put(p.getName(), getSchema(p.getClassMeta(), p.getName(), p.getProperties(), exampleAdded, descriptionAdded, p.getExtendedMeta(JsonSchemaBeanPropertyMeta.class)));<a name="line.218"></a>
+<span class="sourceLineNo">219</span> }<a name="line.219"></a>
+<span class="sourceLineNo">220</span> out.put("properties", properties);<a name="line.220"></a>
+<span class="sourceLineNo">221</span><a name="line.221"></a>
+<span class="sourceLineNo">222</span> } else if (tc == COLLECTION) {<a name="line.222"></a>
+<span class="sourceLineNo">223</span> ClassMeta et = sType.getElementType();<a name="line.223"></a>
+<span class="sourceLineNo">224</span> if (sType.isCollection() && isParentClass(Set.class, sType.getInnerClass()))<a name="line.224"></a>
+<span class="sourceLineNo">225</span> out.put("uniqueItems", true);<a name="line.225"></a>
+<span class="sourceLineNo">226</span> out.put("items", getSchema(et, "items", pNames, exampleAdded, descriptionAdded, null));<a name="line.226"></a>
+<span class="sourceLineNo">227</span><a name="line.227"></a>
+<span class="sourceLineNo">228</span> } else if (tc == ARRAY) {<a name="line.228"></a>
+<span class="sourceLineNo">229</span> ClassMeta et = sType.getElementType();<a name="line.229"></a>
+<span class="sourceLineNo">230</span> if (sType.isCollection() && isParentClass(Set.class, sType.getInnerClass()))<a name="line.230"></a>
+<span class="sourceLineNo">231</span> out.put("uniqueItems", true);<a name="line.231"></a>
+<span class="sourceLineNo">232</span> out.put("items", getSchema(et, "items", pNames, exampleAdded, descriptionAdded, null));<a name="line.232"></a>
<span class="sourceLineNo">233</span><a name="line.233"></a>
-<span class="sourceLineNo">234</span> } else if (tc == MAP) {<a name="line.234"></a>
-<span class="sourceLineNo">235</span> ObjectMap om = getSchema(sType.getValueType(), "additionalProperties", null, exampleAdded, descriptionAdded, null);<a name="line.235"></a>
-<span class="sourceLineNo">236</span> if (! om.isEmpty())<a name="line.236"></a>
-<span class="sourceLineNo">237</span> out.put("additionalProperties", om);<a name="line.237"></a>
-<span class="sourceLineNo">238</span><a name="line.238"></a>
-<span class="sourceLineNo">239</span> }<a name="line.239"></a>
-<span class="sourceLineNo">240</span> }<a name="line.240"></a>
+<span class="sourceLineNo">234</span> } else if (tc == ENUM) {<a name="line.234"></a>
+<span class="sourceLineNo">235</span> out.put("enum", getEnums(sType));<a name="line.235"></a>
+<span class="sourceLineNo">236</span><a name="line.236"></a>
+<span class="sourceLineNo">237</span> } else if (tc == MAP) {<a name="line.237"></a>
+<span class="sourceLineNo">238</span> ObjectMap om = getSchema(sType.getValueType(), "additionalProperties", null, exampleAdded, descriptionAdded, null);<a name="line.238"></a>
+<span class="sourceLineNo">239</span> if (! om.isEmpty())<a name="line.239"></a>
+<span class="sourceLineNo">240</span> out.put("additionalProperties", om);<a name="line.240"></a>
<span class="sourceLineNo">241</span><a name="line.241"></a>
-<span class="sourceLineNo">242</span> // Add info from @JsonSchema on bean property.<a name="line.242"></a>
-<span class="sourceLineNo">243</span> if (jsbpm != null) {<a name="line.243"></a>
-<span class="sourceLineNo">244</span> out.appendIf(false, true, true, "description", jsbpm.getDescription());<a name="line.244"></a>
-<span class="sourceLineNo">245</span> out.appendIf(false, true, true, "x-example", jsbpm.getExample());<a name="line.245"></a>
-<span class="sourceLineNo">246</span> }<a name="line.246"></a>
-<span class="sourceLineNo">247</span><a name="line.247"></a>
-<span class="sourceLineNo">248</span> out.appendIf(false, true, true, "description", jscm.getDescription());<a name="line.248"></a>
-<span class="sourceLineNo">249</span> out.appendIf(false, true, true, "x-example", jscm.getExample());<a name="line.249"></a>
+<span class="sourceLineNo">242</span> }<a name="line.242"></a>
+<span class="sourceLineNo">243</span> }<a name="line.243"></a>
+<span class="sourceLineNo">244</span><a name="line.244"></a>
+<span class="sourceLineNo">245</span> // Add info from @JsonSchema on bean property.<a name="line.245"></a>
+<span class="sourceLineNo">246</span> if (jsbpm != null) {<a name="line.246"></a>
+<span class="sourceLineNo">247</span> out.appendIf(false, true, true, "description", jsbpm.getDescription());<a name="line.247"></a>
+<span class="sourceLineNo">248</span> out.appendIf(false, true, true, "x-example", jsbpm.getExample());<a name="line.248"></a>
+<span class="sourceLineNo">249</span> }<a name="line.249"></a>
<span class="sourceLineNo">250</span><a name="line.250"></a>
-<span class="sourceLineNo">251</span> out.appendIf(false, true, true, "description", description);<a name="line.251"></a>
-<span class="sourceLineNo">252</span> out.appendIf(false, true, true, "x-example", example);<a name="line.252"></a>
+<span class="sourceLineNo">251</span> out.appendIf(false, true, true, "description", jscm.getDescription());<a name="line.251"></a>
+<span class="sourceLineNo">252</span> out.appendIf(false, true, true, "x-example", jscm.getExample());<a name="line.252"></a>
<span class="sourceLineNo">253</span><a name="line.253"></a>
-<span class="sourceLineNo">254</span> if (ds != null)<a name="line.254"></a>
-<span class="sourceLineNo">255</span> out.appendAll(ds);<a name="line.255"></a>
+<span class="sourceLineNo">254</span> out.appendIf(false, true, true, "description", description);<a name="line.254"></a>
+<span class="sourceLineNo">255</span> out.appendIf(false, true, true, "x-example", example);<a name="line.255"></a>
<span class="sourceLineNo">256</span><a name="line.256"></a>
-<span class="sourceLineNo">257</span> if (useDef) {<a name="line.257"></a>
-<span class="sourceLineNo">258</span> defs.put(getBeanDefId(sType), out);<a name="line.258"></a>
-<span class="sourceLineNo">259</span> out = new ObjectMap().append("$ref", getBeanDefUri(sType));<a name="line.259"></a>
-<span class="sourceLineNo">260</span> }<a name="line.260"></a>
-<span class="sourceLineNo">261</span><a name="line.261"></a>
-<span class="sourceLineNo">262</span> pop();<a name="line.262"></a>
-<span class="sourceLineNo">263</span><a name="line.263"></a>
-<span class="sourceLineNo">264</span> return out;<a name="line.264"></a>
-<span class="sourceLineNo">265</span> }<a name="line.265"></a>
+<span class="sourceLineNo">257</span> if (ds != null)<a name="line.257"></a>
+<span class="sourceLineNo">258</span> out.appendAll(ds);<a name="line.258"></a>
+<span class="sourceLineNo">259</span><a name="line.259"></a>
+<span class="sourceLineNo">260</span> if (useDef) {<a name="line.260"></a>
+<span class="sourceLineNo">261</span> defs.put(getBeanDefId(sType), out);<a name="line.261"></a>
+<span class="sourceLineNo">262</span> out = new ObjectMap().append("$ref", getBeanDefUri(sType));<a name="line.262"></a>
+<span class="sourceLineNo">263</span> }<a name="line.263"></a>
+<span class="sourceLineNo">264</span><a name="line.264"></a>
+<span class="sourceLineNo">265</span> pop();<a name="line.265"></a>
<span class="sourceLineNo">266</span><a name="line.266"></a>
-<span class="sourceLineNo">267</span> private List<String> getEnums(ClassMeta<?> cm) {<a name="line.267"></a>
-<span class="sourceLineNo">268</span> List<String> l = new ArrayList<>();<a name="line.268"></a>
-<span class="sourceLineNo">269</span> for (Enum<?> e : getEnumConstants(cm.getInnerClass()))<a name="line.269"></a>
-<span class="sourceLineNo">270</span> l.add(cm.toString(e));<a name="line.270"></a>
-<span class="sourceLineNo">271</span> return l;<a name="line.271"></a>
-<span class="sourceLineNo">272</span> }<a name="line.272"></a>
-<span class="sourceLineNo">273</span><a name="line.273"></a>
-<span class="sourceLineNo">274</span> private Object getExample(ClassMeta<?> sType, TypeCategory t, boolean exampleAdded) throws Exception {<a name="line.274"></a>
-<span class="sourceLineNo">275</span> boolean canAdd = isAllowNestedExamples() || ! exampleAdded;<a name="line.275"></a>
-<span class="sourceLineNo">276</span> if (canAdd && (getAddExamplesTo().contains(t) || getAddExamplesTo().contains(ANY))) {<a name="line.276"></a>
-<span class="sourceLineNo">277</span> Object example = sType.getExample(this);<a name="line.277"></a>
-<span class="sourceLineNo">278</span> if (example != null)<a name="line.278"></a>
-<span class="sourceLineNo">279</span> return JsonParser.DEFAULT.parse(toJson(example), Object.class);<a name="line.279"></a>
-<span class="sourceLineNo">280</span> }<a name="line.280"></a>
-<span class="sourceLineNo">281</span> return null;<a name="line.281"></a>
-<span class="sourceLineNo">282</span> }<a name="line.282"></a>
-<span class="sourceLineNo">283</span><a name="line.283"></a>
-<span class="sourceLineNo">284</span> private String toJson(Object o) throws SerializeException {<a name="line.284"></a>
-<span class="sourceLineNo">285</span> if (jsSession == null)<a name="line.285"></a>
-<span class="sourceLineNo">286</span> jsSession = ctx.getJsonSerializer().createSession(null);<a name="line.286"></a>
-<span class="sourceLineNo">287</span> return jsSession.serializeToString(o);<a name="line.287"></a>
-<span class="sourceLineNo">288</span> }<a name="line.288"></a>
-<span class="sourceLineNo">289</span><a name="line.289"></a>
-<span class="sourceLineNo">290</span> private Object getDescription(ClassMeta<?> sType, TypeCategory t, boolean descriptionAdded) {<a name="line.290"></a>
-<span class="sourceLineNo">291</span> boolean canAdd = isAllowNestedDescriptions() || ! descriptionAdded;<a name="line.291"></a>
-<span class="sourceLineNo">292</span> if (canAdd && (getAddDescriptionsTo().contains(t) || getAddDescriptionsTo().contains(ANY)))<a name="line.292"></a>
-<span class="sourceLineNo">293</span> return sType.toString();<a name="line.293"></a>
-<span class="sourceLineNo">294</span> return null;<a name="line.294"></a>
-<span class="sourceLineNo">295</span> }<a name="line.295"></a>
-<span class="sourceLineNo">296</span><a name="line.296"></a>
-<span class="sourceLineNo">297</span> /**<a name="line.297"></a>
-<span class="sourceLineNo">298</span> * Returns the definition ID for the specified class.<a name="line.298"></a>
-<span class="sourceLineNo">299</span> *<a name="line.299"></a>
-<span class="sourceLineNo">300</span> * @param cm The class to get the definition ID of.<a name="line.300"></a>
-<span class="sourceLineNo">301</span> * @return The definition ID for the specified class.<a name="line.301"></a>
-<span class="sourceLineNo">302</span> */<a name="line.302"></a>
-<span class="sourceLineNo">303</span> public String getBeanDefId(ClassMeta<?> cm) {<a name="line.303"></a>
-<span class="sourceLineNo">304</span> return getBeanDefMapper().getId(cm);<a name="line.304"></a>
-<span class="sourceLineNo">305</span> }<a name="line.305"></a>
-<span class="sourceLineNo">306</span><a name="line.306"></a>
-<span class="sourceLineNo">307</span> /**<a name="line.307"></a>
-<span class="sourceLineNo">308</span> * Returns the definition URI for the specified class.<a name="line.308"></a>
-<span class="sourceLineNo">309</span> *<a name="line.309"></a>
-<span class="sourceLineNo">310</span> * @param cm The class to get the definition URI of.<a name="line.310"></a>
-<span class="sourceLineNo">311</span> * @return The definition URI for the specified class.<a name="line.311"></a>
-<span class="sourceLineNo">312</span> */<a name="line.312"></a>
-<span class="sourceLineNo">313</span> public java.net.URI getBeanDefUri(ClassMeta<?> cm) {<a name="line.313"></a>
-<span class="sourceLineNo">314</span> return getBeanDefMapper().getURI(cm);<a name="line.314"></a>
-<span class="sourceLineNo">315</span> }<a name="line.315"></a>
-<span class="sourceLineNo">316</span><a name="line.316"></a>
-<span class="sourceLineNo">317</span> /**<a name="line.317"></a>
-<span class="sourceLineNo">318</span> * Returns the definition URI for the specified class.<a name="line.318"></a>
-<span class="sourceLineNo">319</span> *<a name="line.319"></a>
-<span class="sourceLineNo">320</span> * @param id The definition ID to get the definition URI of.<a name="line.320"></a>
-<span class="sourceLineNo">321</span> * @return The definition URI for the specified class.<a name="line.321"></a>
-<span class="sourceLineNo">322</span> */<a name="line.322"></a>
-<span class="sourceLineNo">323</span> public java.net.URI getBeanDefUri(String id) {<a name="line.323"></a>
-<span class="sourceLineNo">324</span> return getBeanDefMapper().getURI(id);<a name="line.324"></a>
-<span class="sourceLineNo">325</span> }<a name="line.325"></a>
-<span class="sourceLineNo">326</span><a name="line.326"></a>
-<span class="sourceLineNo">327</span> /**<a name="line.327"></a>
-<span class="sourceLineNo">328</span> * Returns the definitions that were gathered during this session.<a name="line.328"></a>
-<span class="sourceLineNo">329</span> *<a name="line.329"></a>
-<span class="sourceLineNo">330</span> * <p><a name="line.330"></a>
-<span class="sourceLineNo">331</span> * This map is modifiable and affects the map in the session.<a name="line.331"></a>
+<span class="sourceLineNo">267</span> return out;<a name="line.267"></a>
+<span class="sourceLineNo">268</span> }<a name="line.268"></a>
+<span class="sourceLineNo">269</span><a name="line.269"></a>
+<span class="sourceLineNo">270</span> private List<String> getEnums(ClassMeta<?> cm) {<a name="line.270"></a>
+<span class="sourceLineNo">271</span> List<String> l = new ArrayList<>();<a name="line.271"></a>
+<span class="sourceLineNo">272</span> for (Enum<?> e : getEnumConstants(cm.getInnerClass()))<a name="line.272"></a>
+<span class="sourceLineNo">273</span> l.add(cm.toString(e));<a name="line.273"></a>
+<span class="sourceLineNo">274</span> return l;<a name="line.274"></a>
+<span class="sourceLineNo">275</span> }<a name="line.275"></a>
+<span class="sourceLineNo">276</span><a name="line.276"></a>
+<span class="sourceLineNo">277</span> private Object getExample(ClassMeta<?> sType, TypeCategory t, boolean exampleAdded) throws Exception {<a name="line.277"></a>
+<span class="sourceLineNo">278</span> boolean canAdd = isAllowNestedExamples() || ! exampleAdded;<a name="line.278"></a>
+<span class="sourceLineNo">279</span> if (canAdd && (getAddExamplesTo().contains(t) || getAddExamplesTo().contains(ANY))) {<a name="line.279"></a>
+<span class="sourceLineNo">280</span> Object example = sType.getExample(this);<a name="line.280"></a>
+<span class="sourceLineNo">281</span> if (example != null)<a name="line.281"></a>
+<span class="sourceLineNo">282</span> return JsonParser.DEFAULT.parse(toJson(example), Object.class);<a name="line.282"></a>
+<span class="sourceLineNo">283</span> }<a name="line.283"></a>
+<span class="sourceLineNo">284</span> return null;<a name="line.284"></a>
+<span class="sourceLineNo">285</span> }<a name="line.285"></a>
+<span class="sourceLineNo">286</span><a name="line.286"></a>
+<span class="sourceLineNo">287</span> private String toJson(Object o) throws SerializeException {<a name="line.287"></a>
+<span class="sourceLineNo">288</span> if (jsSession == null)<a name="line.288"></a>
+<span class="sourceLineNo">289</span> jsSession = ctx.getJsonSerializer().createSession(null);<a name="line.289"></a>
+<span class="sourceLineNo">290</span> return jsSession.serializeToString(o);<a name="line.290"></a>
+<span class="sourceLineNo">291</span> }<a name="line.291"></a>
+<span class="sourceLineNo">292</span><a name="line.292"></a>
+<span class="sourceLineNo">293</span> private Object getDescription(ClassMeta<?> sType, TypeCategory t, boolean descriptionAdded) {<a name="line.293"></a>
+<span class="sourceLineNo">294</span> boolean canAdd = isAllowNestedDescriptions() || ! descriptionAdded;<a name="line.294"></a>
+<span class="sourceLineNo">295</span> if (canAdd && (getAddDescriptionsTo().contains(t) || getAddDescriptionsTo().contains(ANY)))<a name="line.295"></a>
+<span class="sourceLineNo">296</span> return sType.toString();<a name="line.296"></a>
+<span class="sourceLineNo">297</span> return null;<a name="line.297"></a>
+<span class="sourceLineNo">298</span> }<a name="line.298"></a>
+<span class="sourceLineNo">299</span><a name="line.299"></a>
+<span class="sourceLineNo">300</span> /**<a name="line.300"></a>
+<span class="sourceLineNo">301</span> * Returns the definition ID for the specified class.<a name="line.301"></a>
+<span class="sourceLineNo">302</span> *<a name="line.302"></a>
+<span class="sourceLineNo">303</span> * @param cm The class to get the definition ID of.<a name="line.303"></a>
+<span class="sourceLineNo">304</span> * @return The definition ID for the specified class.<a name="line.304"></a>
+<span class="sourceLineNo">305</span> */<a name="line.305"></a>
+<span class="sourceLineNo">306</span> public String getBeanDefId(ClassMeta<?> cm) {<a name="line.306"></a>
+<span class="sourceLineNo">307</span> return getBeanDefMapper().getId(cm);<a name="line.307"></a>
+<span class="sourceLineNo">308</span> }<a name="line.308"></a>
+<span class="sourceLineNo">309</span><a name="line.309"></a>
+<span class="sourceLineNo">310</span> /**<a name="line.310"></a>
+<span class="sourceLineNo">311</span> * Returns the definition URI for the specified class.<a name="line.311"></a>
+<span class="sourceLineNo">312</span> *<a name="line.312"></a>
+<span class="sourceLineNo">313</span> * @param cm The class to get the definition URI of.<a name="line.313"></a>
+<span class="sourceLineNo">314</span> * @return The definition URI for the specified class.<a name="line.314"></a>
+<span class="sourceLineNo">315</span> */<a name="line.315"></a>
+<span class="sourceLineNo">316</span> public java.net.URI getBeanDefUri(ClassMeta<?> cm) {<a name="line.316"></a>
+<span class="sourceLineNo">317</span> return getBeanDefMapper().getURI(cm);<a name="line.317"></a>
+<span class="sourceLineNo">318</span> }<a name="line.318"></a>
+<span class="sourceLineNo">319</span><a name="line.319"></a>
+<span class="sourceLineNo">320</span> /**<a name="line.320"></a>
+<span class="sourceLineNo">321</span> * Returns the definition URI for the specified class.<a name="line.321"></a>
+<span class="sourceLineNo">322</span> *<a name="line.322"></a>
+<span class="sourceLineNo">323</span> * @param id The definition ID to get the definition URI of.<a name="line.323"></a>
+<span class="sourceLineNo">324</span> * @return The definition URI for the specified class.<a name="line.324"></a>
+<span class="sourceLineNo">325</span> */<a name="line.325"></a>
+<span class="sourceLineNo">326</span> public java.net.URI getBeanDefUri(String id) {<a name="line.326"></a>
+<span class="sourceLineNo">327</span> return getBeanDefMapper().getURI(id);<a name="line.327"></a>
+<span class="sourceLineNo">328</span> }<a name="line.328"></a>
+<span class="sourceLineNo">329</span><a name="line.329"></a>
+<span class="sourceLineNo">330</span> /**<a name="line.330"></a>
+<span class="sourceLineNo">331</span> * Returns the definitions that were gathered during this session.<a name="line.331"></a>
<span class="sourceLineNo">332</span> *<a name="line.332"></a>
-<span class="sourceLineNo">333</span> * @return<a name="line.333"></a>
-<span class="sourceLineNo">334</span> * The definitions that were gathered during this session, or <jk>null</jk> if {@link JsonSchemaGenerator#JSONSCHEMA_useBeanDefs} was not enabled.<a name="line.334"></a>
-<span class="sourceLineNo">335</span> */<a name="line.335"></a>
-<span class="sourceLineNo">336</span> public Map<String,ObjectMap> getBeanDefs() {<a name="line.336"></a>
-<span class="sourceLineNo">337</span> return defs;<a name="line.337"></a>
-<span class="sourceLineNo">338</span> }<a name="line.338"></a>
-<span class="sourceLineNo">339</span><a name="line.339"></a>
-<span class="sourceLineNo">340</span> /**<a name="line.340"></a>
-<span class="sourceLineNo">341</span> * Adds a schema definition to this session.<a name="line.341"></a>
-<span class="sourceLineNo">342</span> *<a name="line.342"></a>
-<span class="sourceLineNo">343</span> * @param id The definition ID.<a name="line.343"></a>
-<span class="sourceLineNo">344</span> * @param def The definition schema.<a name="line.344"></a>
-<span class="sourceLineNo">345</span> * @return This object (for method chaining).<a name="line.345"></a>
-<span class="sourceLineNo">346</span> */<a name="line.346"></a>
-<span class="sourceLineNo">347</span> public JsonSchemaGeneratorSession addBeanDef(String id, ObjectMap def) {<a name="line.347"></a>
-<span class="sourceLineNo">348</span> if (defs != null)<a name="line.348"></a>
-<span class="sourceLineNo">349</span> defs.put(id, def);<a name="line.349"></a>
-<span class="sourceLineNo">350</span> return this;<a name="line.350"></a>
-<span class="sourceLineNo">351</span> }<a name="line.351"></a>
-<span class="sourceLineNo">352</span><a name="line.352"></a>
-<span class="sourceLineNo">353</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.353"></a>
-<span class="sourceLineNo">354</span> // Properties<a name="line.354"></a>
-<span class="sourceLineNo">355</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.355"></a>
-<span class="sourceLineNo">356</span><a name="line.356"></a>
-<span class="sourceLineNo">357</span> /**<a name="line.357"></a>
-<span class="sourceLineNo">358</span> * Configuration property: Use bean definitions.<a name="line.358"></a>
-<span class="sourceLineNo">359</span> *<a name="line.359"></a>
-<span class="sourceLineNo">360</span> * @see JsonSchemaGenerator#JSONSCHEMA_useBeanDefs<a name="line.360"></a>
-<span class="sourceLineNo">361</span> * @return<a name="line.361"></a>
-<span class="sourceLineNo">362</span> * <jk>true</jk> if schemas on beans will be serialized with <js>'$ref'</js> tags.<a name="line.362"></a>
-<span class="sourceLineNo">363</span> */<a name="line.363"></a>
-<span class="sourceLineNo">364</span> protected final boolean isUseBeanDefs() {<a name="line.364"></a>
-<span class="sourceLineNo">365</span> return ctx.isUseBeanDefs();<a name="line.365"></a>
-<span class="sourceLineNo">366</span> }<a name="line.366"></a>
-<span class="sourceLineNo">367</span><a name="line.367"></a>
-<span class="sourceLineNo">368</span> /**<a name="line.368"></a>
-<span class="sourceLineNo">369</span> * Configuration property: Allow nested examples.<a name="line.369"></a>
-<span class="sourceLineNo">370</span> *<a name="line.370"></a>
-<span class="sourceLineNo">371</span> * @see JsonSchemaGenerator#JSONSCHEMA_allowNestedExamples<a name="line.371"></a>
-<span class="sourceLineNo">372</span> * @return<a name="line.372"></a>
-<span class="sourceLineNo">373</span> * <jk>true</jk> if nested examples are allowed in schema definitions.<a name="line.373"></a>
-<span class="sourceLineNo">374</span> */<a name="line.374"></a>
-<span class="sourceLineNo">375</span> protected final boolean isAllowNestedExamples() {<a name="line.375"></a>
-<span class="sourceLineNo">376</span> return ctx.isAllowNestedExamples();<a name="line.376"></a>
-<span class="sourceLineNo">377</span> }<a name="line.377"></a>
-<span class="sourceLineNo">378</span><a name="line.378"></a>
-<span class="sourceLineNo">379</span> /**<a name="line.379"></a>
-<span class="sourceLineNo">380</span> * Configuration property: Allow nested descriptions.<a name="line.380"></a>
-<span class="sourceLineNo">381</span> *<a name="line.381"></a>
-<span class="sourceLineNo">382</span> * @see JsonSchemaGenerator#JSONSCHEMA_allowNestedDescriptions<a name="line.382"></a>
-<span class="sourceLineNo">383</span> * @return<a name="line.383"></a>
-<span class="sourceLineNo">384</span> * <jk>true</jk> if nested descriptions are allowed in schema definitions.<a name="line.384"></a>
-<span class="sourceLineNo">385</span> */<a name="line.385"></a>
-<span class="sourceLineNo">386</span> protected final boolean isAllowNestedDescriptions() {<a name="line.386"></a>
-<span class="sourceLineNo">387</span> return ctx.isAllowNestedDescriptions();<a name="line.387"></a>
-<span class="sourceLineNo">388</span> }<a name="line.388"></a>
-<span class="sourceLineNo">389</span><a name="line.389"></a>
-<span class="sourceLineNo">390</span> /**<a name="line.390"></a>
-<span class="sourceLineNo">391</span> * Configuration property: Bean schema definition mapper.<a name="line.391"></a>
-<span class="sourceLineNo">392</span> *<a name="line.392"></a>
-<span class="sourceLineNo">393</span> * @see JsonSchemaGenerator#JSONSCHEMA_beanDefMapper<a name="line.393"></a>
-<span class="sourceLineNo">394</span> * @return<a name="line.394"></a>
-<span class="sourceLineNo">395</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.395"></a>
-<span class="sourceLineNo">396</span> */<a name="line.396"></a>
-<span class="sourceLineNo">397</span> protected final BeanDefMapper getBeanDefMapper() {<a name="line.397"></a>
-<span class="sourceLineNo">398</span> return ctx.getBeanDefMapper();<a name="line.398"></a>
-<span class="sourceLineNo">399</span> }<a name="line.399"></a>
-<span class="sourceLineNo">400</span><a name="line.400"></a>
-<span class="sourceLineNo">401</span> /**<a name="line.401"></a>
-<span class="sourceLineNo">402</span> * Configuration property: Add examples.<a name="line.402"></a>
-<span class="sourceLineNo">403</span> *<a name="line.403"></a>
-<span class="sourceLineNo">404</span> * @see JsonSchemaGenerator#JSONSCHEMA_addExamplesTo<a name="line.404"></a>
-<span class="sourceLineNo">405</span> * @return<a name="line.405"></a>
-<span class="sourceLineNo">406</span> * Set of categories of types that examples should be automatically added to generated schemas.<a name="line.406"></a>
-<span class="sourceLineNo">407</span> */<a name="line.407"></a>
-<span class="sourceLineNo">408</span> protected final Set<TypeCategory> getAddExamplesTo() {<a name="line.408"></a>
-<span class="sourceLineNo">409</span> return ctx.getAddExamplesTo();<a name="line.409"></a>
-<span class="sourceLineNo">410</span> }<a name="line.410"></a>
-<span class="sourceLineNo">411</span><a name="line.411"></a>
-<span class="sourceLineNo">412</span> /**<a name="line.412"></a>
-<span class="sourceLineNo">413</span> * Configuration property: Add descriptions to types.<a name="line.413"></a>
-<span class="sourceLineNo">414</span> *<a name="line.414"></a>
-<span class="sourceLineNo">415</span> * @see JsonSchemaGenerator#JSONSCHEMA_addDescriptionsTo<a name="line.415"></a>
-<span class="sourceLineNo">416</span> * @return<a name="line.416"></a>
-<span class="sourceLineNo">417</span> * Set of categories of types that descriptions should be automatically added to generated schemas.<a name="line.417"></a>
-<span class="sourceLineNo">418</span> */<a name="line.418"></a>
-<span class="sourceLineNo">419</span> protected final Set<TypeCategory> getAddDescriptionsTo() {<a name="line.419"></a>
-<span class="sourceLineNo">420</span> return ctx.getAddDescriptionsTo();<a name="line.420"></a>
-<span class="sourceLineNo">421</span> }<a name="line.421"></a>
-<span class="sourceLineNo">422</span><a name="line.422"></a>
-<span class="sourceLineNo">423</span> /**<a name="line.423"></a>
-<span class="sourceLineNo">424</span> * Configuration property: Default schemas.<a name="line.424"></a>
-<span class="sourceLineNo">425</span> *<a name="line.425"></a>
-<span class="sourceLineNo">426</span> * @see JsonSchemaGenerator#JSONSCHEMA_defaultSchemas<a name="line.426"></a>
-<span class="sourceLineNo">427</span> * @return<a name="line.427"></a>
-<span class="sourceLineNo">428</span> * Custom schema information for particular class types.<a name="line.428"></a>
-<span class="sourceLineNo">429</span> */<a name="line.429"></a>
-<span class="sourceLineNo">430</span> protected final Map<String,ObjectMap> getDefaultSchemas() {<a name="line.430"></a>
-<span class="sourceLineNo">431</span> return ctx.getDefaultSchemas();<a name="line.431"></a>
-<span class="sourceLineNo">432</span> }<a name="line.432"></a>
-<span class="sourceLineNo">433</span><a name="line.433"></a>
-<span class="sourceLineNo">434</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.434"></a>
-<span class="sourceLineNo">435</span> // Utility methods<a name="line.435"></a>
-<span class="sourceLineNo">436</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.436"></a>
-<span class="sourceLineNo">437</span><a name="line.437"></a>
-<span class="sourceLineNo">438</span> private ClassMeta<?> toClassMeta(Object o) {<a name="line.438"></a>
-<span class="sourceLineNo">439</span> if (o instanceof Type)<a name="line.439"></a>
-<span class="sourceLineNo">440</span> return getClassMeta((Type)o);<a name="line.440"></a>
-<span class="sourceLineNo">441</span> return getClassMetaForObject(o);<a name="line.441"></a>
-<span class="sourceLineNo">442</span> }<a name="line.442"></a>
-<span class="sourceLineNo">443</span>}<a name="line.443"></a>
+<span class="sourceLineNo">333</span> * <p><a name="line.333"></a>
+<span class="sourceLineNo">334</span> * This map is modifiable and affects the map in the session.<a name="line.334"></a>
+<span class="sourceLineNo">335</span> *<a name="line.335"></a>
+<span class="sourceLineNo">336</span> * @return<a name="line.336"></a>
+<span class="sourceLineNo">337</span> * The definitions that were gathered during this session, or <jk>null</jk> if {@link JsonSchemaGenerator#JSONSCHEMA_useBeanDefs} was not enabled.<a name="line.337"></a>
+<span class="sourceLineNo">338</span> */<a name="line.338"></a>
+<span class="sourceLineNo">339</span> public Map<String,ObjectMap> getBeanDefs() {<a name="line.339"></a>
+<span class="sourceLineNo">340</span> return defs;<a name="line.340"></a>
+<span class="sourceLineNo">341</span> }<a name="line.341"></a>
+<span class="sourceLineNo">342</span><a name="line.342"></a>
+<span class="sourceLineNo">343</span> /**<a name="line.343"></a>
+<span class="sourceLineNo">344</span> * Adds a schema definition to this session.<a name="line.344"></a>
+<span class="sourceLineNo">345</span> *<a name="line.345"></a>
+<span class="sourceLineNo">346</span> * @param id The definition ID.<a name="line.346"></a>
+<span class="sourceLineNo">347</span> * @param def The definition schema.<a name="line.347"></a>
+<span class="sourceLineNo">348</span> * @return This object (for method chaining).<a name="line.348"></a>
+<span class="sourceLineNo">349</span> */<a name="line.349"></a>
+<span class="sourceLineNo">350</span> public JsonSchemaGeneratorSession addBeanDef(String id, ObjectMap def) {<a name="line.350"></a>
+<span class="sourceLineNo">351</span> if (defs != null)<a name="line.351"></a>
+<span class="sourceLineNo">352</span> defs.put(id, def);<a name="line.352"></a>
+<span class="sourceLineNo">353</span> return this;<a name="line.353"></a>
+<span class="sourceLineNo">354</span> }<a name="line.354"></a>
+<span class="sourceLineNo">355</span><a name="line.355"></a>
+<span class="sourceLineNo">356</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.356"></a>
+<span class="sourceLineNo">357</span> // Properties<a name="line.357"></a>
+<span class="sourceLineNo">358</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.358"></a>
+<span class="sourceLineNo">359</span><a name="line.359"></a>
+<span class="sourceLineNo">360</span> /**<a name="line.360"></a>
+<span class="sourceLineNo">361</span> * Configuration property: Use bean definitions.<a name="line.361"></a>
+<span class="sourceLineNo">362</span> *<a name="line.362"></a>
+<span class="sourceLineNo">363</span> * @see JsonSchemaGenerator#JSONSCHEMA_useBeanDefs<a name="line.363"></a>
+<span class="sourceLineNo">364</span> * @return<a name="line.364"></a>
+<span class="sourceLineNo">365</span> * <jk>true</jk> if schemas on beans will be serialized with <js>'$ref'</js> tags.<a name="line.365"></a>
+<span class="sourceLineNo">366</span> */<a name="line.366"></a>
+<span class="sourceLineNo">367</span> protected final boolean isUseBeanDefs() {<a name="line.367"></a>
+<span class="sourceLineNo">368</span> return ctx.isUseBeanDefs();<a name="line.368"></a>
+<span class="sourceLineNo">369</span> }<a name="line.369"></a>
+<span class="sourceLineNo">370</span><a name="line.370"></a>
+<span class="sourceLineNo">371</span> /**<a name="line.371"></a>
+<span class="sourceLineNo">372</span> * Configuration property: Allow nested examples.<a name="line.372"></a>
+<span class="sourceLineNo">373</span> *<a name="line.373"></a>
+<span class="sourceLineNo">374</span> * @see JsonSchemaGenerator#JSONSCHEMA_allowNestedExamples<a name="line.374"></a>
+<span class="sourceLineNo">375</span> * @return<a name="line.375"></a>
+<span class="sourceLineNo">376</span> * <jk>true</jk> if nested examples are allowed in schema definitions.<a name="line.376"></a>
+<span class="sourceLineNo">377</span> */<a name="line.377"></a>
+<span class="sourceLineNo">378</span> protected final boolean isAllowNestedExamples() {<a name="line.378"></a>
+<span class="sourceLineNo">379</span> return ctx.isAllowNestedExamples();<a name="line.379"></a>
+<span class="sourceLineNo">380</span> }<a name="line.380"></a>
+<span class="sourceLineNo">381</span><a name="line.381"></a>
+<span class="sourceLineNo">382</span> /**<a name="line.382"></a>
+<span class="sourceLineNo">383</span> * Configuration property: Allow nested descriptions.<a name="line.383"></a>
+<span class="sourceLineNo">384</span> *<a name="line.384"></a>
+<span class="sourceLineNo">385</span> * @see JsonSchemaGenerator#JSONSCHEMA_allowNestedDescriptions<a name="line.385"></a>
+<span class="sourceLineNo">386</span> * @return<a name="line.386"></a>
+<span class="sourceLineNo">387</span> * <jk>true</jk> if nested descriptions are allowed in schema definitions.<a name="line.387"></a>
+<span class="sourceLineNo">388</span> */<a name="line.388"></a>
+<span class="sourceLineNo">389</span> protected final boolean isAllowNestedDescriptions() {<a name="line.389"></a>
+<span class="sourceLineNo">390</span> return ctx.isAllowNestedDescriptions();<a name="line.390"></a>
+<span class="sourceLineNo">391</span> }<a name="line.391"></a>
+<span class="sourceLineNo">392</span><a name="line.392"></a>
+<span class="sourceLineNo">393</span> /**<a name="line.393"></a>
+<span class="sourceLineNo">394</span> * Configuration property: Bean schema definition mapper.<a name="line.394"></a>
+<span class="sourceLineNo">395</span> *<a name="line.395"></a>
+<span class="sourceLineNo">396</span> * @see JsonSchemaGenerator#JSONSCHEMA_beanDefMapper<a name="line.396"></a>
+<span class="sourceLineNo">397</span> * @return<a name="line.397"></a>
+<span class="sourceLineNo">398</span> * Interface to use for converting Bean classes to definition IDs and URIs.<a name="line.398"></a>
+<span class="sourceLineNo">399</span> */<a name="line.399"></a>
+<span class="sourceLineNo">400</span> protected final BeanDefMapper getBeanDefMapper() {<a name="line.400"></a>
+<span class="sourceLineNo">401</span> return ctx.getBeanDefMapper();<a name="line.401"></a>
+<span class="sourceLineNo">402</span> }<a name="line.402"></a>
+<span class="sourceLineNo">403</span><a name="line.403"></a>
+<span class="sourceLineNo">404</span> /**<a name="line.404"></a>
+<span class="sourceLineNo">405</span> * Configuration property: Add examples.<a name="line.405"></a>
+<span class="sourceLineNo">406</span> *<a name="line.406"></a>
+<span class="sourceLineNo">407</span> * @see JsonSchemaGenerator#JSONSCHEMA_addExamplesTo<a name="line.407"></a>
+<span class="sourceLineNo">408</span> * @return<a name="line.408"></a>
+<span class="sourceLineNo">409</span> * Set of categories of types that examples should be automatically added to generated schemas.<a name="line.409"></a>
+<span class="sourceLineNo">410</span> */<a name="line.410"></a>
+<span class="sourceLineNo">411</span> protected final Set<TypeCategory> getAddExamplesTo() {<a name="line.411"></a>
+<span class="sourceLineNo">412</span> return ctx.getAddExamplesTo();<a name="line.412"></a>
+<span class="sourceLineNo">413</span> }<a name="line.413"></a>
+<span class="sourceLineNo">414</span><a name="line.414"></a>
+<span class="sourceLineNo">415</span> /**<a name="line.415"></a>
+<span class="sourceLineNo">416</span> * Configuration property: Add descriptions to types.<a name="line.416"></a>
+<span class="sourceLineNo">417</span> *<a name="line.417"></a>
+<span class="sourceLineNo">418</span> * @see JsonSchemaGenerator#JSONSCHEMA_addDescriptionsTo<a name="line.418"></a>
+<span class="sourceLineNo">419</span> * @return<a name="line.419"></a>
+<span class="sourceLineNo">420</span> * Set of categories of types that descriptions should be automatically added to generated schemas.<a name="line.420"></a>
+<span class="sourceLineNo">421</span> */<a name="line.421"></a>
+<span class="sourceLineNo">422</span> protected final Set<TypeCategory> getAddDescriptionsTo() {<a name="line.422"></a>
+<span class="sourceLineNo">423</span> return ctx.getAddDescriptionsTo();<a name="line.423"></a>
+<span class="sourceLineNo">424</span> }<a name="line.424"></a>
+<span class="sourceLineNo">425</span><a name="line.425"></a>
+<span class="sourceLineNo">426</span> /**<a name="line.426"></a>
+<span class="sourceLineNo">427</span> * Configuration property: Default schemas.<a name="line.427"></a>
+<span class="sourceLineNo">428</span> *<a name="line.428"></a>
+<span class="sourceLineNo">429</span> * @see JsonSchemaGenerator#JSONSCHEMA_defaultSchemas<a name="line.429"></a>
+<span class="sourceLineNo">430</span> * @return<a name="line.430"></a>
+<span class="sourceLineNo">431</span> * Custom schema information for particular class types.<a name="line.431"></a>
+<span class="sourceLineNo">432</span> */<a name="line.432"></a>
+<span class="sourceLineNo">433</span> protected final Map<String,ObjectMap> getDefaultSchemas() {<a name="line.433"></a>
+<span class="sourceLineNo">434</span> return ctx.getDefaultSchemas();<a name="line.434"></a>
+<span class="sourceLineNo">435</span> }<a name="line.435"></a>
+<span class="sourceLineNo">436</span><a name="line.436"></a>
+<span class="sourceLineNo">437</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.437"></a>
+<span class="sourceLineNo">438</span> // Utility methods<a name="line.438"></a>
+<span class="sourceLineNo">439</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.439"></a>
+<span class="sourceLineNo">440</span><a name="line.440"></a>
+<span class="sourceLineNo">441</span> private ClassMeta<?> toClassMeta(Object o) {<a name="line.441"></a>
+<span class="sourceLineNo">442</span> if (o instanceof Type)<a name="line.442"></a>
+<span class="sourceLineNo">443</span> return getClassMeta((Type)o);<a name="line.443"></a>
+<span class="sourceLineNo">444</span> return getClassMetaForObject(o);<a name="line.444"></a>
+<span class="sourceLineNo">445</span> }<a name="line.445"></a>
+<span class="sourceLineNo">446</span>}<a name="line.446"></a>
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestInfoProvider.html b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestInfoProvider.html
index bf4738c..f6cf621 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestInfoProvider.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestInfoProvider.html
@@ -26,448 +26,405 @@
<span class="sourceLineNo">018</span>import java.lang.reflect.Method;<a name="line.18"></a>
<span class="sourceLineNo">019</span>import java.util.*;<a name="line.19"></a>
<span class="sourceLineNo">020</span>import java.util.concurrent.*;<a name="line.20"></a>
-<span class="sourceLineNo">021</span>import java.util.regex.*;<a name="line.21"></a>
-<span class="sourceLineNo">022</span><a name="line.22"></a>
-<span class="sourceLineNo">023</span>import org.apache.juneau.*;<a name="line.23"></a>
-<span class="sourceLineNo">024</span>import org.apache.juneau.dto.swagger.*;<a name="line.24"></a>
-<span class="sourceLineNo">025</span>import org.apache.juneau.internal.*;<a name="line.25"></a>
-<span class="sourceLineNo">026</span>import org.apache.juneau.rest.annotation.*;<a name="line.26"></a>
-<span class="sourceLineNo">027</span>import org.apache.juneau.svl.*;<a name="line.27"></a>
-<span class="sourceLineNo">028</span><a name="line.28"></a>
-<span class="sourceLineNo">029</span>/**<a name="line.29"></a>
-<span class="sourceLineNo">030</span> * Default implementation of {@link RestInfoProvider}.<a name="line.30"></a>
-<span class="sourceLineNo">031</span> *<a name="line.31"></a>
-<span class="sourceLineNo">032</span> * <p><a name="line.32"></a>
-<span class="sourceLineNo">033</span> * Subclasses can override these methods to tailor how HTTP REST resources are documented.<a name="line.33"></a>
-<span class="sourceLineNo">034</span> *<a name="line.34"></a>
-<span class="sourceLineNo">035</span> * <h5 class='section'>See Also:</h5><a name="line.35"></a>
-<span class="sourceLineNo">036</span> * <ul><a name="line.36"></a>
-<span class="sourceLineNo">037</span> * <li class='jf'>{@link RestContext#REST_infoProvider}<a name="line.37"></a>
-<span class="sourceLineNo">038</span> * <li class='link'>{@doc juneau-rest-server.Swagger}<a name="line.38"></a>
-<span class="sourceLineNo">039</span> * </ul><a name="line.39"></a>
-<span class="sourceLineNo">040</span> */<a name="line.40"></a>
-<span class="sourceLineNo">041</span>public class BasicRestInfoProvider implements RestInfoProvider {<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> // Configurable properties<a name="line.44"></a>
-<span class="sourceLineNo">045</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.45"></a>
-<span class="sourceLineNo">046</span><a name="line.46"></a>
-<span class="sourceLineNo">047</span> private static final String PREFIX = "BasicRestInfoProvider.";<a name="line.47"></a>
-<span class="sourceLineNo">048</span><a name="line.48"></a>
-<span class="sourceLineNo">049</span> /**<a name="line.49"></a>
-<span class="sourceLineNo">050</span> * Configuration property: Ignore types from schema definitions.<a name="line.50"></a>
-<span class="sourceLineNo">051</span> *<a name="line.51"></a>
-<span class="sourceLineNo">052</span> * <h5 class='section'>Property:</h5><a name="line.52"></a>
-<span class="sourceLineNo">053</span> * <ul><a name="line.53"></a>
-<span class="sourceLineNo">054</span> * <li><b>Name:</b> <js>"BasicRestInfoProvider.ignoreTypes.s"</js><a name="line.54"></a>
-<span class="sourceLineNo">055</span> * <li><b>Data type:</b> <code>String</code> (comma-delimited)<a name="line.55"></a>
-<span class="sourceLineNo">056</span> * <li><b>Default:</b> <jk>null</jk>.<a name="line.56"></a>
-<span class="sourceLineNo">057</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.57"></a>
-<span class="sourceLineNo">058</span> * </ul><a name="line.58"></a>
-<span class="sourceLineNo">059</span> *<a name="line.59"></a>
-<span class="sourceLineNo">060</span> * <h5 class='section'>Description:</h5><a name="line.60"></a>
-<span class="sourceLineNo">061</span> * <p><a name="line.61"></a>
-<span class="sourceLineNo">062</span> * Defines class name patterns that should be ignored when generating schema definitions in the generated<a name="line.62"></a>
-<span class="sourceLineNo">063</span> * Swagger documentation.<a name="line.63"></a>
-<span class="sourceLineNo">064</span> *<a name="line.64"></a>
-<span class="sourceLineNo">065</span> * <h5 class='section'>Example:</h5><a name="line.65"></a>
-<span class="sourceLineNo">066</span> * <p class='bcode w800'><a name="line.66"></a>
-<span class="sourceLineNo">067</span> * <jc>// Don't generate schema for any prototype packages or the class named 'Swagger'.<a name="line.67"></a>
-<span class="sourceLineNo">068</span> * <ja>@RestResource</ja>(<a name="line.68"></a>
-<span class="sourceLineNo">069</span> * properties={<a name="line.69"></a>
-<span class="sourceLineNo">070</span> * <ja>@Property</ja>(name=<jsf>INFOPROVIDER_ignoreTypes</jsf>, value=<js>"Swagger,*.proto.*"</js>)<a name="line.70"></a>
-<span class="sourceLineNo">071</span> * }<a name="line.71"></a>
-<span class="sourceLineNo">072</span> * <jk>public class</jk> MyResource {...}<a name="line.72"></a>
-<span class="sourceLineNo">073</span> * </p><a name="line.73"></a>
-<span class="sourceLineNo">074</span> */<a name="line.74"></a>
-<span class="sourceLineNo">075</span> public static final String INFOPROVIDER_ignoreTypes = PREFIX + "ignoreTypes.s";<a name="line.75"></a>
-<span class="sourceLineNo">076</span><a name="line.76"></a>
-<span class="sourceLineNo">077</span><a name="line.77"></a>
-<span class="sourceLineNo">078</span> private final RestContext context;<a name="line.78"></a>
-<span class="sourceLineNo">079</span> private final String<a name="line.79"></a>
-<span class="sourceLineNo">080</span> siteName,<a name="line.80"></a>
-<span class="sourceLineNo">081</span> title,<a name="line.81"></a>
-<span class="sourceLineNo">082</span> description;<a name="line.82"></a>
-<span class="sourceLineNo">083</span> private final Set<Pattern> ignoreTypes;<a name="line.83"></a>
-<span class="sourceLineNo">084</span> private final ConcurrentHashMap<Locale,ConcurrentHashMap<Integer,Swagger>> swaggers = new ConcurrentHashMap<>();<a name="line.84"></a>
-<span class="sourceLineNo">085</span><a name="line.85"></a>
-<span class="sourceLineNo">086</span> /**<a name="line.86"></a>
-<span class="sourceLineNo">087</span> * Constructor.<a name="line.87"></a>
-<span class="sourceLineNo">088</span> *<a name="line.88"></a>
-<span class="sourceLineNo">089</span> * @param context The resource context.<a name="line.89"></a>
-<span class="sourceLineNo">090</span> */<a name="line.90"></a>
-<span class="sourceLineNo">091</span> public BasicRestInfoProvider(RestContext context) {<a name="line.91"></a>
-<span class="sourceLineNo">092</span> this.context = context;<a name="line.92"></a>
-<span class="sourceLineNo">093</span><a name="line.93"></a>
-<span class="sourceLineNo">094</span> PropertyStore ps = context.getPropertyStore();<a name="line.94"></a>
-<span class="sourceLineNo">095</span> this.ignoreTypes = new LinkedHashSet<>();<a name="line.95"></a>
-<span class="sourceLineNo">096</span> for (String s : split(ps.getProperty(INFOPROVIDER_ignoreTypes, String.class, "")))<a name="line.96"></a>
-<span class="sourceLineNo">097</span> ignoreTypes.add(Pattern.compile(s.replace(".", "\\.").replace("*", ".*")));<a name="line.97"></a>
-<span class="sourceLineNo">098</span><a name="line.98"></a>
-<span class="sourceLineNo">099</span> Builder b = new Builder(context);<a name="line.99"></a>
-<span class="sourceLineNo">100</span> this.siteName = b.siteName;<a name="line.100"></a>
-<span class="sourceLineNo">101</span> this.title = b.title;<a name="line.101"></a>
-<span class="sourceLineNo">102</span> this.description = b.description;<a name="line.102"></a>
-<span class="sourceLineNo">103</span> }<a name="line.103"></a>
+<span class="sourceLineNo">021</span><a name="line.21"></a>
+<span class="sourceLineNo">022</span>import org.apache.juneau.dto.swagger.*;<a name="line.22"></a>
+<span class="sourceLineNo">023</span>import org.apache.juneau.internal.*;<a name="line.23"></a>
+<span class="sourceLineNo">024</span>import org.apache.juneau.rest.annotation.*;<a name="line.24"></a>
+<span class="sourceLineNo">025</span>import org.apache.juneau.svl.*;<a name="line.25"></a>
+<span class="sourceLineNo">026</span><a name="line.26"></a>
+<span class="sourceLineNo">027</span>/**<a name="line.27"></a>
+<span class="sourceLineNo">028</span> * Default implementation of {@link RestInfoProvider}.<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> * Subclasses can override these methods to tailor how HTTP REST resources are documented.<a name="line.31"></a>
+<span class="sourceLineNo">032</span> *<a name="line.32"></a>
+<span class="sourceLineNo">033</span> * <h5 class='section'>See Also:</h5><a name="line.33"></a>
+<span class="sourceLineNo">034</span> * <ul><a name="line.34"></a>
+<span class="sourceLineNo">035</span> * <li class='jf'>{@link RestContext#REST_infoProvider}<a name="line.35"></a>
+<span class="sourceLineNo">036</span> * <li class='link'>{@doc juneau-rest-server.Swagger}<a name="line.36"></a>
+<span class="sourceLineNo">037</span> * </ul><a name="line.37"></a>
+<span class="sourceLineNo">038</span> */<a name="line.38"></a>
+<span class="sourceLineNo">039</span>public class BasicRestInfoProvider implements RestInfoProvider {<a name="line.39"></a>
+<span class="sourceLineNo">040</span><a name="line.40"></a>
+<span class="sourceLineNo">041</span> private final RestContext context;<a name="line.41"></a>
+<span class="sourceLineNo">042</span> private final String<a name="line.42"></a>
+<span class="sourceLineNo">043</span> siteName,<a name="line.43"></a>
+<span class="sourceLineNo">044</span> title,<a name="line.44"></a>
+<span class="sourceLineNo">045</span> description;<a name="line.45"></a>
+<span class="sourceLineNo">046</span> private final ConcurrentHashMap<Locale,ConcurrentHashMap<Integer,Swagger>> swaggers = new ConcurrentHashMap<>();<a name="line.46"></a>
+<span class="sourceLineNo">047</span><a name="line.47"></a>
+<span class="sourceLineNo">048</span> /**<a name="line.48"></a>
+<span class="sourceLineNo">049</span> * Constructor.<a name="line.49"></a>
+<span class="sourceLineNo">050</span> *<a name="line.50"></a>
+<span class="sourceLineNo">051</span> * @param context The resource context.<a name="line.51"></a>
+<span class="sourceLineNo">052</span> */<a name="line.52"></a>
+<span class="sourceLineNo">053</span> public BasicRestInfoProvider(RestContext context) {<a name="line.53"></a>
+<span class="sourceLineNo">054</span> this.context = context;<a name="line.54"></a>
+<span class="sourceLineNo">055</span><a name="line.55"></a>
+<span class="sourceLineNo">056</span> Builder b = new Builder(context);<a name="line.56"></a>
+<span class="sourceLineNo">057</span> this.siteName = b.siteName;<a name="line.57"></a>
+<span class="sourceLineNo">058</span> this.title = b.title;<a name="line.58"></a>
+<span class="sourceLineNo">059</span> this.description = b.description;<a name="line.59"></a>
+<span class="sourceLineNo">060</span> }<a name="line.60"></a>
+<span class="sourceLineNo">061</span><a name="line.61"></a>
+<span class="sourceLineNo">062</span> private static final class Builder {<a name="line.62"></a>
+<span class="sourceLineNo">063</span> String<a name="line.63"></a>
+<span class="sourceLineNo">064</span> siteName,<a name="line.64"></a>
+<span class="sourceLineNo">065</span> title,<a name="line.65"></a>
+<span class="sourceLineNo">066</span> description;<a name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span> Builder(RestContext context) {<a name="line.68"></a>
+<span class="sourceLineNo">069</span> for (RestResource r : getAnnotationsParentFirst(RestResource.class, context.getResource().getClass())) {<a name="line.69"></a>
+<span class="sourceLineNo">070</span> if (! r.siteName().isEmpty())<a name="line.70"></a>
+<span class="sourceLineNo">071</span> siteName = r.siteName();<a name="line.71"></a>
+<span class="sourceLineNo">072</span> if (r.title().length > 0)<a name="line.72"></a>
+<span class="sourceLineNo">073</span> title = joinnl(r.title());<a name="line.73"></a>
+<span class="sourceLineNo">074</span> if (r.description().length > 0)<a name="line.74"></a>
+<span class="sourceLineNo">075</span> description = joinnl(r.description());<a name="line.75"></a>
+<span class="sourceLineNo">076</span> }<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>
+<span class="sourceLineNo">079</span><a name="line.79"></a>
+<span class="sourceLineNo">080</span> /**<a name="line.80"></a>
+<span class="sourceLineNo">081</span> * Returns the localized swagger for this REST resource.<a name="line.81"></a>
+<span class="sourceLineNo">082</span> *<a name="line.82"></a>
+<span class="sourceLineNo">083</span> * <p><a name="line.83"></a>
+<span class="sourceLineNo">084</span> * Subclasses can override this method to customize the Swagger.<a name="line.84"></a>
+<span class="sourceLineNo">085</span> *<a name="line.85"></a>
+<span class="sourceLineNo">086</span> * @param req The incoming HTTP request.<a name="line.86"></a>
+<span class="sourceLineNo">087</span> * @return<a name="line.87"></a>
+<span class="sourceLineNo">088</span> * A new Swagger instance.<a name="line.88"></a>
+<span class="sourceLineNo">089</span> * <br>Never <jk>null</jk>.<a name="line.89"></a>
+<span class="sourceLineNo">090</span> * @throws Exception<a name="line.90"></a>
+<span class="sourceLineNo">091</span> */<a name="line.91"></a>
+<span class="sourceLineNo">092</span> @Override /* RestInfoProvider */<a name="line.92"></a>
+<span class="sourceLineNo">093</span> public Swagger getSwagger(RestRequest req) throws Exception {<a name="line.93"></a>
+<span class="sourceLineNo">094</span><a name="line.94"></a>
+<span class="sourceLineNo">095</span> Locale locale = req.getLocale();<a name="line.95"></a>
+<span class="sourceLineNo">096</span><a name="line.96"></a>
+<span class="sourceLineNo">097</span> // Find it in the cache.<a name="line.97"></a>
+<span class="sourceLineNo">098</span> // Swaggers are cached by user locale and an int hash of the @RestMethods they have access to.<a name="line.98"></a>
+<span class="sourceLineNo">099</span> HashCode userHash = HashCode.create();<a name="line.99"></a>
+<span class="sourceLineNo">100</span> for (RestJavaMethod sm : context.getCallMethods().values())<a name="line.100"></a>
+<span class="sourceLineNo">101</span> if (sm.isRequestAllowed(req))<a name="line.101"></a>
+<span class="sourceLineNo">102</span> userHash.add(sm.hashCode());<a name="line.102"></a>
+<span class="sourceLineNo">103</span> int hashCode = userHash.get();<a name="line.103"></a>
<span class="sourceLineNo">104</span><a name="line.104"></a>
-<span class="sourceLineNo">105</span> private static final class Builder {<a name="line.105"></a>
-<span class="sourceLineNo">106</span> String<a name="line.106"></a>
-<span class="sourceLineNo">107</span> siteName,<a name="line.107"></a>
-<span class="sourceLineNo">108</span> title,<a name="line.108"></a>
-<span class="sourceLineNo">109</span> description;<a name="line.109"></a>
-<span class="sourceLineNo">110</span><a name="line.110"></a>
-<span class="sourceLineNo">111</span> Builder(RestContext context) {<a name="line.111"></a>
-<span class="sourceLineNo">112</span> for (RestResource r : getAnnotationsParentFirst(RestResource.class, context.getResource().getClass())) {<a name="line.112"></a>
-<span class="sourceLineNo">113</span> if (! r.siteName().isEmpty())<a name="line.113"></a>
-<span class="sourceLineNo">114</span> siteName = r.siteName();<a name="line.114"></a>
-<span class="sourceLineNo">115</span> if (r.title().length > 0)<a name="line.115"></a>
-<span class="sourceLineNo">116</span> title = joinnl(r.title());<a name="line.116"></a>
-<span class="sourceLineNo">117</span> if (r.description().length > 0)<a name="line.117"></a>
-<span class="sourceLineNo">118</span> description = joinnl(r.description());<a name="line.118"></a>
-<span class="sourceLineNo">119</span> }<a name="line.119"></a>
-<span class="sourceLineNo">120</span> }<a name="line.120"></a>
-<span class="sourceLineNo">121</span> }<a name="line.121"></a>
-<span class="sourceLineNo">122</span><a name="line.122"></a>
-<span class="sourceLineNo">123</span> /**<a name="line.123"></a>
-<span class="sourceLineNo">124</span> * Returns the localized swagger for this REST resource.<a name="line.124"></a>
+<span class="sourceLineNo">105</span> if (! swaggers.containsKey(locale))<a name="line.105"></a>
+<span class="sourceLineNo">106</span> swaggers.putIfAbsent(locale, new ConcurrentHashMap<Integer,Swagger>());<a name="line.106"></a>
+<span class="sourceLineNo">107</span><a name="line.107"></a>
+<span class="sourceLineNo">108</span> Swagger swagger = swaggers.get(locale).get(hashCode);<a name="line.108"></a>
+<span class="sourceLineNo">109</span> if (swagger != null)<a name="line.109"></a>
+<span class="sourceLineNo">110</span> return swagger;<a name="line.110"></a>
+<span class="sourceLineNo">111</span><a name="line.111"></a>
+<span class="sourceLineNo">112</span> // Wasn't cached...need to create one.<a name="line.112"></a>
+<span class="sourceLineNo">113</span> swagger = new SwaggerGenerator(req).getSwagger();<a name="line.113"></a>
+<span class="sourceLineNo">114</span><a name="line.114"></a>
+<span class="sourceLineNo">115</span> swaggers.get(locale).put(hashCode, swagger);<a name="line.115"></a>
+<span class="sourceLineNo">116</span><a name="line.116"></a>
+<span class="sourceLineNo">117</span> return swagger;<a name="line.117"></a>
+<span class="sourceLineNo">118</span> }<a name="line.118"></a>
+<span class="sourceLineNo">119</span><a name="line.119"></a>
+<span class="sourceLineNo">120</span> /**<a name="line.120"></a>
+<span class="sourceLineNo">121</span> * Returns the localized summary of the specified java method on this servlet.<a name="line.121"></a>
+<span class="sourceLineNo">122</span> *<a name="line.122"></a>
+<span class="sourceLineNo">123</span> * <p><a name="line.123"></a>
+<span class="sourceLineNo">124</span> * Subclasses can override this method to provide their own summary.<a name="line.124"></a>
<span class="sourceLineNo">125</span> *<a name="line.125"></a>
<span class="sourceLineNo">126</span> * <p><a name="line.126"></a>
-<span class="sourceLineNo">127</span> * Subclasses can override this method to customize the Swagger.<a name="line.127"></a>
-<span class="sourceLineNo">128</span> *<a name="line.128"></a>
-<span class="sourceLineNo">129</span> * @param req The incoming HTTP request.<a name="line.129"></a>
-<span class="sourceLineNo">130</span> * @return<a name="line.130"></a>
-<span class="sourceLineNo">131</span> * A new Swagger instance.<a name="line.131"></a>
-<span class="sourceLineNo">132</span> * <br>Never <jk>null</jk>.<a name="line.132"></a>
-<span class="sourceLineNo">133</span> * @throws Exception<a name="line.133"></a>
-<span class="sourceLineNo">134</span> */<a name="line.134"></a>
-<span class="sourceLineNo">135</span> @Override /* RestInfoProvider */<a name="line.135"></a>
-<span class="sourceLineNo">136</span> public Swagger getSwagger(RestRequest req) throws Exception {<a name="line.136"></a>
-<span class="sourceLineNo">137</span><a name="line.137"></a>
-<span class="sourceLineNo">138</span> Locale locale = req.getLocale();<a name="line.138"></a>
-<span class="sourceLineNo">139</span><a name="line.139"></a>
-<span class="sourceLineNo">140</span> // Find it in the cache.<a name="line.140"></a>
-<span class="sourceLineNo">141</span> // Swaggers are cached by user locale and an int hash of the @RestMethods they have access to.<a name="line.141"></a>
-<span class="sourceLineNo">142</span> HashCode userHash = HashCode.create();<a name="line.142"></a>
-<span class="sourceLineNo">143</span> for (RestJavaMethod sm : context.getCallMethods().values())<a name="line.143"></a>
-<span class="sourceLineNo">144</span> if (sm.isRequestAllowed(req))<a name="line.144"></a>
-<span class="sourceLineNo">145</span> userHash.add(sm.hashCode());<a name="line.145"></a>
-<span class="sourceLineNo">146</span> int hashCode = userHash.get();<a name="line.146"></a>
-<span class="sourceLineNo">147</span><a name="line.147"></a>
-<span class="sourceLineNo">148</span> if (! swaggers.containsKey(locale))<a name="line.148"></a>
-<span class="sourceLineNo">149</span> swaggers.putIfAbsent(locale, new ConcurrentHashMap<Integer,Swagger>());<a name="line.149"></a>
-<span class="sourceLineNo">150</span><a name="line.150"></a>
-<span class="sourceLineNo">151</span> Swagger swagger = swaggers.get(locale).get(hashCode);<a name="line.151"></a>
-<span class="sourceLineNo">152</span> if (swagger != null)<a name="line.152"></a>
-<span class="sourceLineNo">153</span> return swagger;<a name="line.153"></a>
-<span class="sourceLineNo">154</span><a name="line.154"></a>
-<span class="sourceLineNo">155</span> // Wasn't cached...need to create one.<a name="line.155"></a>
-<span class="sourceLineNo">156</span> swagger = new SwaggerGenerator(req, ignoreTypes).getSwagger();<a name="line.156"></a>
-<span class="sourceLineNo">157</span><a name="line.157"></a>
-<span class="sourceLineNo">158</span> swaggers.get(locale).put(hashCode, swagger);<a name="line.158"></a>
-<span class="sourceLineNo">159</span><a name="line.159"></a>
-<span class="sourceLineNo">160</span> return swagger;<a name="line.160"></a>
-<span class="sourceLineNo">161</span> }<a name="line.161"></a>
-<span class="sourceLineNo">162</span><a name="line.162"></a>
-<span class="sourceLineNo">163</span> /**<a name="line.163"></a>
-<span class="sourceLineNo">164</span> * Returns the localized summary of the specified java method on this servlet.<a name="line.164"></a>
-<span class="sourceLineNo">165</span> *<a name="line.165"></a>
-<span class="sourceLineNo">166</span> * <p><a name="line.166"></a>
-<span class="sourceLineNo">167</span> * Subclasses can override this method to provide their own summary.<a name="line.167"></a>
-<span class="sourceLineNo">168</span> *<a name="line.168"></a>
-<span class="sourceLineNo">169</span> * <p><a name="line.169"></a>
-<span class="sourceLineNo">170</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.170"></a>
-<span class="sourceLineNo">171</span> * <ol class='spaced-list'><a name="line.171"></a>
-<span class="sourceLineNo">172</span> * <li>{@link RestMethod#summary() @RestMethod(summary)} annotation.<a name="line.172"></a>
-<span class="sourceLineNo">173</span> * <h5 class='figure'>Examples:</h5><a name="line.173"></a>
-<span class="sourceLineNo">174</span> * <p class='bcode w800'><a name="line.174"></a>
-<span class="sourceLineNo">175</span> * <cc>// Direct value</cc><a name="line.175"></a>
-<span class="sourceLineNo">176</span> * <ja>@RestMethod</ja>(summary=<js>"Summary of my method"</js>)<a name="line.176"></a>
-<span class="sourceLineNo">177</span> * <jk>public</jk> Object myMethod() {...}<a name="line.177"></a>
+<span class="sourceLineNo">127</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.127"></a>
+<span class="sourceLineNo">128</span> * <ol class='spaced-list'><a name="line.128"></a>
+<span class="sourceLineNo">129</span> * <li>{@link RestMethod#summary() @RestMethod(summary)} annotation.<a name="line.129"></a>
+<span class="sourceLineNo">130</span> * <h5 class='figure'>Examples:</h5><a name="line.130"></a>
+<span class="sourceLineNo">131</span> * <p class='bcode w800'><a name="line.131"></a>
+<span class="sourceLineNo">132</span> * <cc>// Direct value</cc><a name="line.132"></a>
+<span class="sourceLineNo">133</span> * <ja>@RestMethod</ja>(summary=<js>"Summary of my method"</js>)<a name="line.133"></a>
+<span class="sourceLineNo">134</span> * <jk>public</jk> Object myMethod() {...}<a name="line.134"></a>
+<span class="sourceLineNo">135</span> *<a name="line.135"></a>
+<span class="sourceLineNo">136</span> * <cc>// Pulled from some other location</cc><a name="line.136"></a>
+<span class="sourceLineNo">137</span> * <ja>@RestMethod</ja>(summary=<js>"$L{myLocalizedSummary}"</js>)<a name="line.137"></a>
+<span class="sourceLineNo">138</span> * <jk>public</jk> Object myMethod() {...}<a name="line.138"></a>
+<span class="sourceLineNo">139</span> * </p><a name="line.139"></a>
+<span class="sourceLineNo">140</span> * <li>Localized string from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.140"></a>
+<span class="sourceLineNo">141</span> * on the resource class, then any parent classes.<a name="line.141"></a>
+<span class="sourceLineNo">142</span> * <ol><a name="line.142"></a>
+<span class="sourceLineNo">143</span> * <li><ck>[ClassName].[javaMethodName].summary</ck><a name="line.143"></a>
+<span class="sourceLineNo">144</span> * <li><ck>[javaMethodName].summary</ck><a name="line.144"></a>
+<span class="sourceLineNo">145</span> * </ol><a name="line.145"></a>
+<span class="sourceLineNo">146</span> * <br>Value can contain any SVL variables defined on the {@link RestMethod#summary() @RestMethod(summary)} annotation.<a name="line.146"></a>
+<span class="sourceLineNo">147</span> * <h5 class='figure'>Examples:</h5><a name="line.147"></a>
+<span class="sourceLineNo">148</span> * <p class='bcode w800'><a name="line.148"></a>
+<span class="sourceLineNo">149</span> * <cc>// Direct value</cc><a name="line.149"></a>
+<span class="sourceLineNo">150</span> * <ck>MyClass.myMethod.summary</ck> = <cv>Summary of my method.</cv><a name="line.150"></a>
+<span class="sourceLineNo">151</span> *<a name="line.151"></a>
+<span class="sourceLineNo">152</span> * <cc>// Pulled from some other location</cc><a name="line.152"></a>
+<span class="sourceLineNo">153</span> * <ck>MyClass.myMethod.summary</ck> = <cv>$C{MyStrings/MyClass.myMethod.summary}</cv><a name="line.153"></a>
+<span class="sourceLineNo">154</span> * </p><a name="line.154"></a>
+<span class="sourceLineNo">155</span> * </ol><a name="line.155"></a>
+<span class="sourceLineNo">156</span> *<a name="line.156"></a>
+<span class="sourceLineNo">157</span> * @param method The Java method annotated with {@link RestMethod @RestMethod}.<a name="line.157"></a>
+<span class="sourceLineNo">158</span> * @param req The current request.<a name="line.158"></a>
+<span class="sourceLineNo">159</span> * @return The localized summary of the method, or <jk>null</jk> if none was found.<a name="line.159"></a>
+<span class="sourceLineNo">160</span> * @throws Exception<a name="line.160"></a>
+<span class="sourceLineNo">161</span> */<a name="line.161"></a>
+<span class="sourceLineNo">162</span> @Override /* RestInfoProvider */<a name="line.162"></a>
+<span class="sourceLineNo">163</span> public String getMethodSummary(Method method, RestRequest req) throws Exception {<a name="line.163"></a>
+<span class="sourceLineNo">164</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.164"></a>
+<span class="sourceLineNo">165</span><a name="line.165"></a>
+<span class="sourceLineNo">166</span> String s = method.getAnnotation(RestMethod.class).summary();<a name="line.166"></a>
+<span class="sourceLineNo">167</span> if (s.isEmpty()) {<a name="line.167"></a>
+<span class="sourceLineNo">168</span> Operation o = getSwaggerOperation(method, req);<a name="line.168"></a>
+<span class="sourceLineNo">169</span> if (o != null)<a name="line.169"></a>
+<span class="sourceLineNo">170</span> s = o.getSummary();<a name="line.170"></a>
+<span class="sourceLineNo">171</span> }<a name="line.171"></a>
+<span class="sourceLineNo">172</span><a name="line.172"></a>
+<span class="sourceLineNo">173</span> return isEmpty(s) ? null : vr.resolve(s);<a name="line.173"></a>
+<span class="sourceLineNo">174</span> }<a name="line.174"></a>
+<span class="sourceLineNo">175</span><a name="line.175"></a>
+<span class="sourceLineNo">176</span> /**<a name="line.176"></a>
+<span class="sourceLineNo">177</span> * Returns the localized description of the specified java method on this servlet.<a name="line.177"></a>
<span class="sourceLineNo">178</span> *<a name="line.178"></a>
-<span class="sourceLineNo">179</span> * <cc>// Pulled from some other location</cc><a name="line.179"></a>
-<span class="sourceLineNo">180</span> * <ja>@RestMethod</ja>(summary=<js>"$L{myLocalizedSummary}"</js>)<a name="line.180"></a>
-<span class="sourceLineNo">181</span> * <jk>public</jk> Object myMethod() {...}<a name="line.181"></a>
-<span class="sourceLineNo">182</span> * </p><a name="line.182"></a>
-<span class="sourceLineNo">183</span> * <li>Localized string from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.183"></a>
-<span class="sourceLineNo">184</span> * on the resource class, then any parent classes.<a name="line.184"></a>
-<span class="sourceLineNo">185</span> * <ol><a name="line.185"></a>
-<span class="sourceLineNo">186</span> * <li><ck>[ClassName].[javaMethodName].summary</ck><a name="line.186"></a>
-<span class="sourceLineNo">187</span> * <li><ck>[javaMethodName].summary</ck><a name="line.187"></a>
-<span class="sourceLineNo">188</span> * </ol><a name="line.188"></a>
-<span class="sourceLineNo">189</span> * <br>Value can contain any SVL variables defined on the {@link RestMethod#summary() @RestMethod(summary)} annotation.<a name="line.189"></a>
-<span class="sourceLineNo">190</span> * <h5 class='figure'>Examples:</h5><a name="line.190"></a>
-<span class="sourceLineNo">191</span> * <p class='bcode w800'><a name="line.191"></a>
-<span class="sourceLineNo">192</span> * <cc>// Direct value</cc><a name="line.192"></a>
-<span class="sourceLineNo">193</span> * <ck>MyClass.myMethod.summary</ck> = <cv>Summary of my method.</cv><a name="line.193"></a>
-<span class="sourceLineNo">194</span> *<a name="line.194"></a>
-<span class="sourceLineNo">195</span> * <cc>// Pulled from some other location</cc><a name="line.195"></a>
-<span class="sourceLineNo">196</span> * <ck>MyClass.myMethod.summary</ck> = <cv>$C{MyStrings/MyClass.myMethod.summary}</cv><a name="line.196"></a>
-<span class="sourceLineNo">197</span> * </p><a name="line.197"></a>
-<span class="sourceLineNo">198</span> * </ol><a name="line.198"></a>
-<span class="sourceLineNo">199</span> *<a name="line.199"></a>
-<span class="sourceLineNo">200</span> * @param method The Java method annotated with {@link RestMethod @RestMethod}.<a name="line.200"></a>
-<span class="sourceLineNo">201</span> * @param req The current request.<a name="line.201"></a>
-<span class="sourceLineNo">202</span> * @return The localized summary of the method, or <jk>null</jk> if none was found.<a name="line.202"></a>
-<span class="sourceLineNo">203</span> * @throws Exception<a name="line.203"></a>
-<span class="sourceLineNo">204</span> */<a name="line.204"></a>
-<span class="sourceLineNo">205</span> @Override /* RestInfoProvider */<a name="line.205"></a>
-<span class="sourceLineNo">206</span> public String getMethodSummary(Method method, RestRequest req) throws Exception {<a name="line.206"></a>
-<span class="sourceLineNo">207</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.207"></a>
-<span class="sourceLineNo">208</span><a name="line.208"></a>
-<span class="sourceLineNo">209</span> String s = method.getAnnotation(RestMethod.class).summary();<a name="line.209"></a>
-<span class="sourceLineNo">210</span> if (s.isEmpty()) {<a name="line.210"></a>
-<span class="sourceLineNo">211</span> Operation o = getSwaggerOperation(method, req);<a name="line.211"></a>
-<span class="sourceLineNo">212</span> if (o != null)<a name="line.212"></a>
-<span class="sourceLineNo">213</span> s = o.getSummary();<a name="line.213"></a>
-<span class="sourceLineNo">214</span> }<a name="line.214"></a>
-<span class="sourceLineNo">215</span><a name="line.215"></a>
-<span class="sourceLineNo">216</span> return isEmpty(s) ? null : vr.resolve(s);<a name="line.216"></a>
-<span class="sourceLineNo">217</span> }<a name="line.217"></a>
-<span class="sourceLineNo">218</span><a name="line.218"></a>
-<span class="sourceLineNo">219</span> /**<a name="line.219"></a>
-<span class="sourceLineNo">220</span> * Returns the localized description of the specified java method on this servlet.<a name="line.220"></a>
-<span class="sourceLineNo">221</span> *<a name="line.221"></a>
-<span class="sourceLineNo">222</span> * <p><a name="line.222"></a>
-<span class="sourceLineNo">223</span> * Subclasses can override this method to provide their own description.<a name="line.223"></a>
-<span class="sourceLineNo">224</span> *<a name="line.224"></a>
-<span class="sourceLineNo">225</span> * <p><a name="line.225"></a>
-<span class="sourceLineNo">226</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.226"></a>
-<span class="sourceLineNo">227</span> * <ol class='spaced-list'><a name="line.227"></a>
-<span class="sourceLineNo">228</span> * <li>{@link RestMethod#description() @RestMethod(description)} annotation.<a name="line.228"></a>
-<span class="sourceLineNo">229</span> * <h5 class='figure'>Examples:</h5><a name="line.229"></a>
-<span class="sourceLineNo">230</span> * <p class='bcode w800'><a name="line.230"></a>
-<span class="sourceLineNo">231</span> * <cc>// Direct value</cc><a name="line.231"></a>
-<span class="sourceLineNo">232</span> * <ja>@RestMethod</ja>(description=<js>"Description of my method"</js>)<a name="line.232"></a>
-<span class="sourceLineNo">233</span> * <jk>public</jk> Object myMethod() {...}<a name="line.233"></a>
+<span class="sourceLineNo">179</span> * <p><a name="line.179"></a>
+<span class="sourceLineNo">180</span> * Subclasses can override this method to provide their own description.<a name="line.180"></a>
+<span class="sourceLineNo">181</span> *<a name="line.181"></a>
+<span class="sourceLineNo">182</span> * <p><a name="line.182"></a>
+<span class="sourceLineNo">183</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.183"></a>
+<span class="sourceLineNo">184</span> * <ol class='spaced-list'><a name="line.184"></a>
+<span class="sourceLineNo">185</span> * <li>{@link RestMethod#description() @RestMethod(description)} annotation.<a name="line.185"></a>
+<span class="sourceLineNo">186</span> * <h5 class='figure'>Examples:</h5><a name="line.186"></a>
+<span class="sourceLineNo">187</span> * <p class='bcode w800'><a name="line.187"></a>
+<span class="sourceLineNo">188</span> * <cc>// Direct value</cc><a name="line.188"></a>
+<span class="sourceLineNo">189</span> * <ja>@RestMethod</ja>(description=<js>"Description of my method"</js>)<a name="line.189"></a>
+<span class="sourceLineNo">190</span> * <jk>public</jk> Object myMethod() {...}<a name="line.190"></a>
+<span class="sourceLineNo">191</span> *<a name="line.191"></a>
+<span class="sourceLineNo">192</span> * <cc>// Pulled from some other location</cc><a name="line.192"></a>
+<span class="sourceLineNo">193</span> * <ja>@RestMethod</ja>(description=<js>"$L{myLocalizedDescription}"</js>)<a name="line.193"></a>
+<span class="sourceLineNo">194</span> * <jk>public</jk> Object myMethod() {...}<a name="line.194"></a>
+<span class="sourceLineNo">195</span> * </p><a name="line.195"></a>
+<span class="sourceLineNo">196</span> * <li>Localized string from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.196"></a>
+<span class="sourceLineNo">197</span> * on the resource class, then any parent classes.<a name="line.197"></a>
+<span class="sourceLineNo">198</span> * <ol><a name="line.198"></a>
+<span class="sourceLineNo">199</span> * <li><ck>[ClassName].[javaMethodName].description</ck><a name="line.199"></a>
+<span class="sourceLineNo">200</span> * <li><ck>[javaMethodName].description</ck><a name="line.200"></a>
+<span class="sourceLineNo">201</span> * </ol><a name="line.201"></a>
+<span class="sourceLineNo">202</span> * <br>Value can contain any SVL variables defined on the {@link RestMethod#description() @RestMethod(description)} annotation.<a name="line.202"></a>
+<span class="sourceLineNo">203</span> * <h5 class='figure'>Examples:</h5><a name="line.203"></a>
+<span class="sourceLineNo">204</span> * <p class='bcode w800'><a name="line.204"></a>
+<span class="sourceLineNo">205</span> * <cc>// Direct value</cc><a name="line.205"></a>
+<span class="sourceLineNo">206</span> * <ck>MyClass.myMethod.description</ck> = <cv>Description of my method.</cv><a name="line.206"></a>
+<span class="sourceLineNo">207</span> *<a name="line.207"></a>
+<span class="sourceLineNo">208</span> * <cc>// Pulled from some other location</cc><a name="line.208"></a>
+<span class="sourceLineNo">209</span> * <ck>MyClass.myMethod.description</ck> = <cv>$C{MyStrings/MyClass.myMethod.description}</cv><a name="line.209"></a>
+<span class="sourceLineNo">210</span> * </p><a name="line.210"></a>
+<span class="sourceLineNo">211</span> * </ol><a name="line.211"></a>
+<span class="sourceLineNo">212</span> *<a name="line.212"></a>
+<span class="sourceLineNo">213</span> * @param method The Java method annotated with {@link RestMethod @RestMethod}.<a name="line.213"></a>
+<span class="sourceLineNo">214</span> * @param req The current request.<a name="line.214"></a>
+<span class="sourceLineNo">215</span> * @return The localized description of the method, or <jk>null</jk> if none was found.<a name="line.215"></a>
+<span class="sourceLineNo">216</span> * @throws Exception<a name="line.216"></a>
+<span class="sourceLineNo">217</span> */<a name="line.217"></a>
+<span class="sourceLineNo">218</span> @Override /* RestInfoProvider */<a name="line.218"></a>
+<span class="sourceLineNo">219</span> public String getMethodDescription(Method method, RestRequest req) throws Exception {<a name="line.219"></a>
+<span class="sourceLineNo">220</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.220"></a>
+<span class="sourceLineNo">221</span><a name="line.221"></a>
+<span class="sourceLineNo">222</span> String s = joinnl(method.getAnnotation(RestMethod.class).description());<a name="line.222"></a>
+<span class="sourceLineNo">223</span> if (s.isEmpty()) {<a name="line.223"></a>
+<span class="sourceLineNo">224</span> Operation o = getSwaggerOperation(method, req);<a name="line.224"></a>
+<span class="sourceLineNo">225</span> if (o != null)<a name="line.225"></a>
+<span class="sourceLineNo">226</span> s = o.getDescription();<a name="line.226"></a>
+<span class="sourceLineNo">227</span> }<a name="line.227"></a>
+<span class="sourceLineNo">228</span><a name="line.228"></a>
+<span class="sourceLineNo">229</span> return isEmpty(s) ? null : vr.resolve(s);<a name="line.229"></a>
+<span class="sourceLineNo">230</span> }<a name="line.230"></a>
+<span class="sourceLineNo">231</span><a name="line.231"></a>
+<span class="sourceLineNo">232</span> /**<a name="line.232"></a>
+<span class="sourceLineNo">233</span> * Returns the localized site name of this REST resource.<a name="line.233"></a>
<span class="sourceLineNo">234</span> *<a name="line.234"></a>
-<span class="sourceLineNo">235</span> * <cc>// Pulled from some other location</cc><a name="line.235"></a>
-<span class="sourceLineNo">236</span> * <ja>@RestMethod</ja>(description=<js>"$L{myLocalizedDescription}"</js>)<a name="line.236"></a>
-<span class="sourceLineNo">237</span> * <jk>public</jk> Object myMethod() {...}<a name="line.237"></a>
-<span class="sourceLineNo">238</span> * </p><a name="line.238"></a>
-<span class="sourceLineNo">239</span> * <li>Localized string from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.239"></a>
-<span class="sourceLineNo">240</span> * on the resource class, then any parent classes.<a name="line.240"></a>
-<span class="sourceLineNo">241</span> * <ol><a name="line.241"></a>
-<span class="sourceLineNo">242</span> * <li><ck>[ClassName].[javaMethodName].description</ck><a name="line.242"></a>
-<span class="sourceLineNo">243</span> * <li><ck>[javaMethodName].description</ck><a name="line.243"></a>
-<span class="sourceLineNo">244</span> * </ol><a name="line.244"></a>
-<span class="sourceLineNo">245</span> * <br>Value can contain any SVL variables defined on the {@link RestMethod#description() @RestMethod(description)} annotation.<a name="line.245"></a>
-<span class="sourceLineNo">246</span> * <h5 class='figure'>Examples:</h5><a name="line.246"></a>
-<span class="sourceLineNo">247</span> * <p class='bcode w800'><a name="line.247"></a>
-<span class="sourceLineNo">248</span> * <cc>// Direct value</cc><a name="line.248"></a>
-<span class="sourceLineNo">249</span> * <ck>MyClass.myMethod.description</ck> = <cv>Description of my method.</cv><a name="line.249"></a>
-<span class="sourceLineNo">250</span> *<a name="line.250"></a>
-<span class="sourceLineNo">251</span> * <cc>// Pulled from some other location</cc><a name="line.251"></a>
-<span class="sourceLineNo">252</span> * <ck>MyClass.myMethod.description</ck> = <cv>$C{MyStrings/MyClass.myMethod.description}</cv><a name="line.252"></a>
-<span class="sourceLineNo">253</span> * </p><a name="line.253"></a>
-<span class="sourceLineNo">254</span> * </ol><a name="line.254"></a>
-<span class="sourceLineNo">255</span> *<a name="line.255"></a>
-<span class="sourceLineNo">256</span> * @param method The Java method annotated with {@link RestMethod @RestMethod}.<a name="line.256"></a>
-<span class="sourceLineNo">257</span> * @param req The current request.<a name="line.257"></a>
-<span class="sourceLineNo">258</span> * @return The localized description of the method, or <jk>null</jk> if none was found.<a name="line.258"></a>
-<span class="sourceLineNo">259</span> * @throws Exception<a name="line.259"></a>
-<span class="sourceLineNo">260</span> */<a name="line.260"></a>
-<span class="sourceLineNo">261</span> @Override /* RestInfoProvider */<a name="line.261"></a>
-<span class="sourceLineNo">262</span> public String getMethodDescription(Method method, RestRequest req) throws Exception {<a name="line.262"></a>
-<span class="sourceLineNo">263</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.263"></a>
-<span class="sourceLineNo">264</span><a name="line.264"></a>
-<span class="sourceLineNo">265</span> String s = joinnl(method.getAnnotation(RestMethod.class).description());<a name="line.265"></a>
-<span class="sourceLineNo">266</span> if (s.isEmpty()) {<a name="line.266"></a>
-<span class="sourceLineNo">267</span> Operation o = getSwaggerOperation(method, req);<a name="line.267"></a>
-<span class="sourceLineNo">268</span> if (o != null)<a name="line.268"></a>
-<span class="sourceLineNo">269</span> s = o.getDescription();<a name="line.269"></a>
-<span class="sourceLineNo">270</span> }<a name="line.270"></a>
-<span class="sourceLineNo">271</span><a name="line.271"></a>
-<span class="sourceLineNo">272</span> return isEmpty(s) ? null : vr.resolve(s);<a name="line.272"></a>
-<span class="sourceLineNo">273</span> }<a name="line.273"></a>
-<span class="sourceLineNo">274</span><a name="line.274"></a>
-<span class="sourceLineNo">275</span> /**<a name="line.275"></a>
-<span class="sourceLineNo">276</span> * Returns the localized site name of this REST resource.<a name="line.276"></a>
-<span class="sourceLineNo">277</span> *<a name="line.277"></a>
-<span class="sourceLineNo">278</span> * <p><a name="line.278"></a>
-<span class="sourceLineNo">279</span> * Subclasses can override this method to provide their own site name.<a name="line.279"></a>
-<span class="sourceLineNo">280</span> *<a name="line.280"></a>
-<span class="sourceLineNo">281</span> * <p><a name="line.281"></a>
-<span class="sourceLineNo">282</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.282"></a>
-<span class="sourceLineNo">283</span> * <ol class='spaced-list'><a name="line.283"></a>
-<span class="sourceLineNo">284</span> * <li>{@link RestResource#siteName() @RestResource(siteName)} annotation on this class, and then any parent classes.<a name="line.284"></a>
-<span class="sourceLineNo">285</span> * <h5 class='figure'>Examples:</h5><a name="line.285"></a>
-<span class="sourceLineNo">286</span> * <p class='bcode w800'><a name="line.286"></a>
-<span class="sourceLineNo">287</span> * <jc>// Direct value</jc><a name="line.287"></a>
-<span class="sourceLineNo">288</span> * <ja>@RestResource</ja>(siteName=<js>"My Site"</js>)<a name="line.288"></a>
-<span class="sourceLineNo">289</span> * <jk>public class</jk> MyResource {...}<a name="line.289"></a>
-<span class="sourceLineNo">290</span> *<a name="line.290"></a>
-<span class="sourceLineNo">291</span> * <jc>// Pulled from some other location</jc><a name="line.291"></a>
-<span class="sourceLineNo">292</span> * <ja>@RestResource</ja>(siteName=<js>"$L{myLocalizedSiteName}"</js>)<a name="line.292"></a>
-<span class="sourceLineNo">293</span> * <jk>public class</jk> MyResource {...}<a name="line.293"></a>
-<span class="sourceLineNo">294</span> * </p><a name="line.294"></a>
-<span class="sourceLineNo">295</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.295"></a>
-<span class="sourceLineNo">296</span> * on the resource class, then any parent classes.<a name="line.296"></a>
-<span class="sourceLineNo">297</span> * <ol><a name="line.297"></a>
-<span class="sourceLineNo">298</span> * <li><ck>[ClassName].siteName</ck><a name="line.298"></a>
-<span class="sourceLineNo">299</span> * <li><ck>siteName</ck><a name="line.299"></a>
-<span class="sourceLineNo">300</span> * </ol><a name="line.300"></a>
-<span class="sourceLineNo">301</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#siteName() @RestResource(siteName)} annotation.<a name="line.301"></a>
-<span class="sourceLineNo">302</span> * <h5 class='figure'>Examples:</h5><a name="line.302"></a>
-<span class="sourceLineNo">303</span> * <p class='bcode w800'><a name="line.303"></a>
-<span class="sourceLineNo">304</span> * <cc>// Direct value</cc><a name="line.304"></a>
-<span class="sourceLineNo">305</span> * <ck>MyClass.siteName</ck> = <cv>My Site</cv><a name="line.305"></a>
-<span class="sourceLineNo">306</span> *<a name="line.306"></a>
-<span class="sourceLineNo">307</span> * <cc>// Pulled from some other location</cc><a name="line.307"></a>
-<span class="sourceLineNo">308</span> * <ck>MyClass.siteName</ck> = <cv>$C{MyStrings/MyClass.siteName}</cv><a name="line.308"></a>
-<span class="sourceLineNo">309</span> * </p><a name="line.309"></a>
-<span class="sourceLineNo">310</span> * </ol><a name="line.310"></a>
-<span class="sourceLineNo">311</span> *<a name="line.311"></a>
-<span class="sourceLineNo">312</span> * @param req The current request.<a name="line.312"></a>
-<span class="sourceLineNo">313</span> * @return The localized site name of this REST resource, or <jk>null</jk> if none was found.<a name="line.313"></a>
-<span class="sourceLineNo">314</span> * @throws Exception<a name="line.314"></a>
-<span class="sourceLineNo">315</span> */<a name="line.315"></a>
-<span class="sourceLineNo">316</span> @Override /* RestInfoProvider */<a name="line.316"></a>
-<span class="sourceLineNo">317</span> public String getSiteName(RestRequest req) throws Exception {<a name="line.317"></a>
-<span class="sourceLineNo">318</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.318"></a>
-<span class="sourceLineNo">319</span> if (siteName != null)<a name="line.319"></a>
-<span class="sourceLineNo">320</span> return vr.resolve(siteName);<a name="line.320"></a>
-<span class="sourceLineNo">321</span> String siteName = context.getMessages().findFirstString(req.getLocale(), "siteName");<a name="line.321"></a>
-<span class="sourceLineNo">322</span> if (siteName != null)<a name="line.322"></a>
-<span class="sourceLineNo">323</span> return vr.resolve(siteName);<a name="line.323"></a>
-<span class="sourceLineNo">324</span> return null;<a name="line.324"></a>
-<span class="sourceLineNo">325</span> }<a name="line.325"></a>
-<span class="sourceLineNo">326</span><a name="line.326"></a>
-<span class="sourceLineNo">327</span> /**<a name="line.327"></a>
-<span class="sourceLineNo">328</span> * Returns the localized title of this REST resource.<a name="line.328"></a>
-<span class="sourceLineNo">329</span> *<a name="line.329"></a>
-<span class="sourceLineNo">330</span> * <p><a name="line.330"></a>
-<span class="sourceLineNo">331</span> * Subclasses can override this method to provide their own title.<a name="line.331"></a>
-<span class="sourceLineNo">332</span> *<a name="line.332"></a>
-<span class="sourceLineNo">333</span> * <p><a name="line.333"></a>
-<span class="sourceLineNo">334</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.334"></a>
-<span class="sourceLineNo">335</span> * <ol class='spaced-list'><a name="line.335"></a>
-<span class="sourceLineNo">336</span> * <li>{@link RestResource#title() @RestResource(siteName)} annotation on this class, and then any parent classes.<a name="line.336"></a>
-<span class="sourceLineNo">337</span> * <h5 class='figure'>Examples:</h5><a name="line.337"></a>
-<span class="sourceLineNo">338</span> * <p class='bcode w800'><a name="line.338"></a>
-<span class="sourceLineNo">339</span> * <jc>// Direct value</jc><a name="line.339"></a>
-<span class="sourceLineNo">340</span> * <ja>@RestResource</ja>(title=<js>"My Resource"</js>)<a name="line.340"></a>
-<span class="sourceLineNo">341</span> * <jk>public class</jk> MyResource {...}<a name="line.341"></a>
+<span class="sourceLineNo">235</span> * <p><a name="line.235"></a>
+<span class="sourceLineNo">236</span> * Subclasses can override this method to provide their own site name.<a name="line.236"></a>
+<span class="sourceLineNo">237</span> *<a name="line.237"></a>
+<span class="sourceLineNo">238</span> * <p><a name="line.238"></a>
+<span class="sourceLineNo">239</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.239"></a>
+<span class="sourceLineNo">240</span> * <ol class='spaced-list'><a name="line.240"></a>
+<span class="sourceLineNo">241</span> * <li>{@link RestResource#siteName() @RestResource(siteName)} annotation on this class, and then any parent classes.<a name="line.241"></a>
+<span class="sourceLineNo">242</span> * <h5 class='figure'>Examples:</h5><a name="line.242"></a>
+<span class="sourceLineNo">243</span> * <p class='bcode w800'><a name="line.243"></a>
+<span class="sourceLineNo">244</span> * <jc>// Direct value</jc><a name="line.244"></a>
+<span class="sourceLineNo">245</span> * <ja>@RestResource</ja>(siteName=<js>"My Site"</js>)<a name="line.245"></a>
+<span class="sourceLineNo">246</span> * <jk>public class</jk> MyResource {...}<a name="line.246"></a>
+<span class="sourceLineNo">247</span> *<a name="line.247"></a>
+<span class="sourceLineNo">248</span> * <jc>// Pulled from some other location</jc><a name="line.248"></a>
+<span class="sourceLineNo">249</span> * <ja>@RestResource</ja>(siteName=<js>"$L{myLocalizedSiteName}"</js>)<a name="line.249"></a>
+<span class="sourceLineNo">250</span> * <jk>public class</jk> MyResource {...}<a name="line.250"></a>
+<span class="sourceLineNo">251</span> * </p><a name="line.251"></a>
+<span class="sourceLineNo">252</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.252"></a>
+<span class="sourceLineNo">253</span> * on the resource class, then any parent classes.<a name="line.253"></a>
+<span class="sourceLineNo">254</span> * <ol><a name="line.254"></a>
+<span class="sourceLineNo">255</span> * <li><ck>[ClassName].siteName</ck><a name="line.255"></a>
+<span class="sourceLineNo">256</span> * <li><ck>siteName</ck><a name="line.256"></a>
+<span class="sourceLineNo">257</span> * </ol><a name="line.257"></a>
+<span class="sourceLineNo">258</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#siteName() @RestResource(siteName)} annotation.<a name="line.258"></a>
+<span class="sourceLineNo">259</span> * <h5 class='figure'>Examples:</h5><a name="line.259"></a>
+<span class="sourceLineNo">260</span> * <p class='bcode w800'><a name="line.260"></a>
+<span class="sourceLineNo">261</span> * <cc>// Direct value</cc><a name="line.261"></a>
+<span class="sourceLineNo">262</span> * <ck>MyClass.siteName</ck> = <cv>My Site</cv><a name="line.262"></a>
+<span class="sourceLineNo">263</span> *<a name="line.263"></a>
+<span class="sourceLineNo">264</span> * <cc>// Pulled from some other location</cc><a name="line.264"></a>
+<span class="sourceLineNo">265</span> * <ck>MyClass.siteName</ck> = <cv>$C{MyStrings/MyClass.siteName}</cv><a name="line.265"></a>
+<span class="sourceLineNo">266</span> * </p><a name="line.266"></a>
+<span class="sourceLineNo">267</span> * </ol><a name="line.267"></a>
+<span class="sourceLineNo">268</span> *<a name="line.268"></a>
+<span class="sourceLineNo">269</span> * @param req The current request.<a name="line.269"></a>
+<span class="sourceLineNo">270</span> * @return The localized site name of this REST resource, or <jk>null</jk> if none was found.<a name="line.270"></a>
+<span class="sourceLineNo">271</span> * @throws Exception<a name="line.271"></a>
+<span class="sourceLineNo">272</span> */<a name="line.272"></a>
+<span class="sourceLineNo">273</span> @Override /* RestInfoProvider */<a name="line.273"></a>
+<span class="sourceLineNo">274</span> public String getSiteName(RestRequest req) throws Exception {<a name="line.274"></a>
+<span class="sourceLineNo">275</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.275"></a>
+<span class="sourceLineNo">276</span> if (siteName != null)<a name="line.276"></a>
+<span class="sourceLineNo">277</span> return vr.resolve(siteName);<a name="line.277"></a>
+<span class="sourceLineNo">278</span> String siteName = context.getMessages().findFirstString(req.getLocale(), "siteName");<a name="line.278"></a>
+<span class="sourceLineNo">279</span> if (siteName != null)<a name="line.279"></a>
+<span class="sourceLineNo">280</span> return vr.resolve(siteName);<a name="line.280"></a>
+<span class="sourceLineNo">281</span> return null;<a name="line.281"></a>
+<span class="sourceLineNo">282</span> }<a name="line.282"></a>
+<span class="sourceLineNo">283</span><a name="line.283"></a>
+<span class="sourceLineNo">284</span> /**<a name="line.284"></a>
+<span class="sourceLineNo">285</span> * Returns the localized title of this REST resource.<a name="line.285"></a>
+<span class="sourceLineNo">286</span> *<a name="line.286"></a>
+<span class="sourceLineNo">287</span> * <p><a name="line.287"></a>
+<span class="sourceLineNo">288</span> * Subclasses can override this method to provide their own title.<a name="line.288"></a>
+<span class="sourceLineNo">289</span> *<a name="line.289"></a>
+<span class="sourceLineNo">290</span> * <p><a name="line.290"></a>
+<span class="sourceLineNo">291</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.291"></a>
+<span class="sourceLineNo">292</span> * <ol class='spaced-list'><a name="line.292"></a>
+<span class="sourceLineNo">293</span> * <li>{@link RestResource#title() @RestResource(siteName)} annotation on this class, and then any parent classes.<a name="line.293"></a>
+<span class="sourceLineNo">294</span> * <h5 class='figure'>Examples:</h5><a name="line.294"></a>
+<span class="sourceLineNo">295</span> * <p class='bcode w800'><a name="line.295"></a>
+<span class="sourceLineNo">296</span> * <jc>// Direct value</jc><a name="line.296"></a>
+<span class="sourceLineNo">297</span> * <ja>@RestResource</ja>(title=<js>"My Resource"</js>)<a name="line.297"></a>
+<span class="sourceLineNo">298</span> * <jk>public class</jk> MyResource {...}<a name="line.298"></a>
+<span class="sourceLineNo">299</span> *<a name="line.299"></a>
+<span class="sourceLineNo">300</span> * <jc>// Pulled from some other location</jc><a name="line.300"></a>
+<span class="sourceLineNo">301</span> * <ja>@RestResource</ja>(title=<js>"$L{myLocalizedTitle}"</js>)<a name="line.301"></a>
+<span class="sourceLineNo">302</span> * <jk>public class</jk> MyResource {...}<a name="line.302"></a>
+<span class="sourceLineNo">303</span> * </p><a name="line.303"></a>
+<span class="sourceLineNo">304</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.304"></a>
+<span class="sourceLineNo">305</span> * on the resource class, then any parent classes.<a name="line.305"></a>
+<span class="sourceLineNo">306</span> * <ol><a name="line.306"></a>
+<span class="sourceLineNo">307</span> * <li><ck>[ClassName].title</ck><a name="line.307"></a>
+<span class="sourceLineNo">308</span> * <li><ck>title</ck><a name="line.308"></a>
+<span class="sourceLineNo">309</span> * </ol><a name="line.309"></a>
+<span class="sourceLineNo">310</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#title() @RestResource(title)} annotation.<a name="line.310"></a>
+<span class="sourceLineNo">311</span> * <h5 class='figure'>Examples:</h5><a name="line.311"></a>
+<span class="sourceLineNo">312</span> * <p class='bcode w800'><a name="line.312"></a>
+<span class="sourceLineNo">313</span> * <cc>// Direct value</cc><a name="line.313"></a>
+<span class="sourceLineNo">314</span> * <ck>MyClass.title</ck> = <cv>My Resource</cv><a name="line.314"></a>
+<span class="sourceLineNo">315</span> *<a name="line.315"></a>
+<span class="sourceLineNo">316</span> * <cc>// Pulled from some other location</cc><a name="line.316"></a>
+<span class="sourceLineNo">317</span> * <ck>MyClass.title</ck> = <cv>$C{MyStrings/MyClass.title}</cv><a name="line.317"></a>
+<span class="sourceLineNo">318</span> * </p><a name="line.318"></a>
+<span class="sourceLineNo">319</span> * <li><ck>/info/title</ck> entry in swagger file.<a name="line.319"></a>
+<span class="sourceLineNo">320</span> * </ol><a name="line.320"></a>
+<span class="sourceLineNo">321</span> *<a name="line.321"></a>
+<span class="sourceLineNo">322</span> * @param req The current request.<a name="line.322"></a>
+<span class="sourceLineNo">323</span> * @return The localized title of this REST resource, or <jk>null</jk> if none was found.<a name="line.323"></a>
+<span class="sourceLineNo">324</span> * @throws Exception<a name="line.324"></a>
+<span class="sourceLineNo">325</span> */<a name="line.325"></a>
+<span class="sourceLineNo">326</span> @Override /* RestInfoProvider */<a name="line.326"></a>
+<span class="sourceLineNo">327</span> public String getTitle(RestRequest req) throws Exception {<a name="line.327"></a>
+<span class="sourceLineNo">328</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.328"></a>
+<span class="sourceLineNo">329</span> if (title != null)<a name="line.329"></a>
+<span class="sourceLineNo">330</span> return vr.resolve(title);<a name="line.330"></a>
+<span class="sourceLineNo">331</span> String title = context.getMessages().findFirstString(req.getLocale(), "title");<a name="line.331"></a>
+<span class="sourceLineNo">332</span> if (title != null)<a name="line.332"></a>
+<span class="sourceLineNo">333</span> return vr.resolve(title);<a name="line.333"></a>
+<span class="sourceLineNo">334</span> Swagger s = getSwagger(req);<a name="line.334"></a>
+<span class="sourceLineNo">335</span> if (s != null && s.getInfo() != null && s.getInfo().hasTitle())<a name="line.335"></a>
+<span class="sourceLineNo">336</span> return s.getInfo().getTitle();<a name="line.336"></a>
+<span class="sourceLineNo">337</span> return null;<a name="line.337"></a>
+<span class="sourceLineNo">338</span> }<a name="line.338"></a>
+<span class="sourceLineNo">339</span><a name="line.339"></a>
+<span class="sourceLineNo">340</span> /**<a name="line.340"></a>
+<span class="sourceLineNo">341</span> * Returns the localized description of this REST resource.<a name="line.341"></a>
<span class="sourceLineNo">342</span> *<a name="line.342"></a>
-<span class="sourceLineNo">343</span> * <jc>// Pulled from some other location</jc><a name="line.343"></a>
-<span class="sourceLineNo">344</span> * <ja>@RestResource</ja>(title=<js>"$L{myLocalizedTitle}"</js>)<a name="line.344"></a>
-<span class="sourceLineNo">345</span> * <jk>public class</jk> MyResource {...}<a name="line.345"></a>
-<span class="sourceLineNo">346</span> * </p><a name="line.346"></a>
-<span class="sourceLineNo">347</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.347"></a>
-<span class="sourceLineNo">348</span> * on the resource class, then any parent classes.<a name="line.348"></a>
-<span class="sourceLineNo">349</span> * <ol><a name="line.349"></a>
-<span class="sourceLineNo">350</span> * <li><ck>[ClassName].title</ck><a name="line.350"></a>
-<span class="sourceLineNo">351</span> * <li><ck>title</ck><a name="line.351"></a>
-<span class="sourceLineNo">352</span> * </ol><a name="line.352"></a>
-<span class="sourceLineNo">353</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#title() @RestResource(title)} annotation.<a name="line.353"></a>
-<span class="sourceLineNo">354</span> * <h5 class='figure'>Examples:</h5><a name="line.354"></a>
-<span class="sourceLineNo">355</span> * <p class='bcode w800'><a name="line.355"></a>
-<span class="sourceLineNo">356</span> * <cc>// Direct value</cc><a name="line.356"></a>
-<span class="sourceLineNo">357</span> * <ck>MyClass.title</ck> = <cv>My Resource</cv><a name="line.357"></a>
-<span class="sourceLineNo">358</span> *<a name="line.358"></a>
-<span class="sourceLineNo">359</span> * <cc>// Pulled from some other location</cc><a name="line.359"></a>
-<span class="sourceLineNo">360</span> * <ck>MyClass.title</ck> = <cv>$C{MyStrings/MyClass.title}</cv><a name="line.360"></a>
-<span class="sourceLineNo">361</span> * </p><a name="line.361"></a>
-<span class="sourceLineNo">362</span> * <li><ck>/info/title</ck> entry in swagger file.<a name="line.362"></a>
-<span class="sourceLineNo">363</span> * </ol><a name="line.363"></a>
-<span class="sourceLineNo">364</span> *<a name="line.364"></a>
-<span class="sourceLineNo">365</span> * @param req The current request.<a name="line.365"></a>
-<span class="sourceLineNo">366</span> * @return The localized title of this REST resource, or <jk>null</jk> if none was found.<a name="line.366"></a>
-<span class="sourceLineNo">367</span> * @throws Exception<a name="line.367"></a>
-<span class="sourceLineNo">368</span> */<a name="line.368"></a>
-<span class="sourceLineNo">369</span> @Override /* RestInfoProvider */<a name="line.369"></a>
-<span class="sourceLineNo">370</span> public String getTitle(RestRequest req) throws Exception {<a name="line.370"></a>
-<span class="sourceLineNo">371</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.371"></a>
-<span class="sourceLineNo">372</span> if (title != null)<a name="line.372"></a>
-<span class="sourceLineNo">373</span> return vr.resolve(title);<a name="line.373"></a>
-<span class="sourceLineNo">374</span> String title = context.getMessages().findFirstString(req.getLocale(), "title");<a name="line.374"></a>
-<span class="sourceLineNo">375</span> if (title != null)<a name="line.375"></a>
-<span class="sourceLineNo">376</span> return vr.resolve(title);<a name="line.376"></a>
-<span class="sourceLineNo">377</span> Swagger s = getSwagger(req);<a name="line.377"></a>
-<span class="sourceLineNo">378</span> if (s != null && s.getInfo() != null && s.getInfo().hasTitle())<a name="line.378"></a>
-<span class="sourceLineNo">379</span> return s.getInfo().getTitle();<a name="line.379"></a>
-<span class="sourceLineNo">380</span> return null;<a name="line.380"></a>
-<span class="sourceLineNo">381</span> }<a name="line.381"></a>
-<span class="sourceLineNo">382</span><a name="line.382"></a>
-<span class="sourceLineNo">383</span> /**<a name="line.383"></a>
-<span class="sourceLineNo">384</span> * Returns the localized description of this REST resource.<a name="line.384"></a>
-<span class="sourceLineNo">385</span> *<a name="line.385"></a>
-<span class="sourceLineNo">386</span> * <p><a name="line.386"></a>
-<span class="sourceLineNo">387</span> * Subclasses can override this method to provide their own description.<a name="line.387"></a>
-<span class="sourceLineNo">388</span> *<a name="line.388"></a>
-<span class="sourceLineNo">389</span> * <p><a name="line.389"></a>
-<span class="sourceLineNo">390</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.390"></a>
-<span class="sourceLineNo">391</span> * <ol class='spaced-list'><a name="line.391"></a>
-<span class="sourceLineNo">392</span> * <li>{@link RestResource#description() @RestResource(description)} annotation on this class, and then any parent classes.<a name="line.392"></a>
-<span class="sourceLineNo">393</span> * <h5 class='figure'>Examples:</h5><a name="line.393"></a>
-<span class="sourceLineNo">394</span> * <p class='bcode w800'><a name="line.394"></a>
-<span class="sourceLineNo">395</span> * <jc>// Direct value</jc><a name="line.395"></a>
-<span class="sourceLineNo">396</span> * <ja>@RestResource</ja>(description=<js>"My Resource"</js>)<a name="line.396"></a>
-<span class="sourceLineNo">397</span> * <jk>public class</jk> MyResource {...}<a name="line.397"></a>
-<span class="sourceLineNo">398</span> *<a name="line.398"></a>
-<span class="sourceLineNo">399</span> * <jc>// Pulled from some other location</jc><a name="line.399"></a>
-<span class="sourceLineNo">400</span> * <ja>@RestResource</ja>(description=<js>"$L{myLocalizedDescription}"</js>)<a name="line.400"></a>
-<span class="sourceLineNo">401</span> * <jk>public class</jk> MyResource {...}<a name="line.401"></a>
-<span class="sourceLineNo">402</span> * </p><a name="line.402"></a>
-<span class="sourceLineNo">403</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.403"></a>
-<span class="sourceLineNo">404</span> * on the resource class, then any parent classes.<a name="line.404"></a>
-<span class="sourceLineNo">405</span> * <ol><a name="line.405"></a>
-<span class="sourceLineNo">406</span> * <li><ck>[ClassName].description</ck><a name="line.406"></a>
-<span class="sourceLineNo">407</span> * <li><ck>description</ck><a name="line.407"></a>
-<span class="sourceLineNo">408</span> * </ol><a name="line.408"></a>
-<span class="sourceLineNo">409</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#description() @RestResource(description)} annotation.<a name="line.409"></a>
-<span class="sourceLineNo">410</span> * <h5 class='figure'>Examples:</h5><a name="line.410"></a>
-<span class="sourceLineNo">411</span> * <p class='bcode w800'><a name="line.411"></a>
-<span class="sourceLineNo">412</span> * <cc>// Direct value</cc><a name="line.412"></a>
-<span class="sourceLineNo">413</span> * <ck>MyClass.description</ck> = <cv>My Resource</cv><a name="line.413"></a>
-<span class="sourceLineNo">414</span> *<a name="line.414"></a>
-<span class="sourceLineNo">415</span> * <cc>// Pulled from some other location</cc><a name="line.415"></a>
-<span class="sourceLineNo">416</span> * <ck>MyClass.description</ck> = <cv>$C{MyStrings/MyClass.description}</cv><a name="line.416"></a>
-<span class="sourceLineNo">417</span> * </p><a name="line.417"></a>
-<span class="sourceLineNo">418</span> * <li><ck>/info/description</ck> entry in swagger file.<a name="line.418"></a>
-<span class="sourceLineNo">419</span> * </ol><a name="line.419"></a>
-<span class="sourceLineNo">420</span> *<a name="line.420"></a>
-<span class="sourceLineNo">421</span> * @param req The current request.<a name="line.421"></a>
-<span class="sourceLineNo">422</span> * @return The localized description of this REST resource, or <jk>null</jk> if none was was found.<a name="line.422"></a>
-<span class="sourceLineNo">423</span> * @throws Exception<a name="line.423"></a>
-<span class="sourceLineNo">424</span> */<a name="line.424"></a>
-<span class="sourceLineNo">425</span> @Override /* RestInfoProvider */<a name="line.425"></a>
-<span class="sourceLineNo">426</span> public String getDescription(RestRequest req) throws Exception {<a name="line.426"></a>
-<span class="sourceLineNo">427</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.427"></a>
-<span class="sourceLineNo">428</span> if (description != null)<a name="line.428"></a>
-<span class="sourceLineNo">429</span> return vr.resolve(description);<a name="line.429"></a>
-<span class="sourceLineNo">430</span> String description = context.getMessages().findFirstString(req.getLocale(), "description");<a name="line.430"></a>
-<span class="sourceLineNo">431</span> if (description != null)<a name="line.431"></a>
-<span class="sourceLineNo">432</span> return vr.resolve(description);<a name="line.432"></a>
-<span class="sourceLineNo">433</span> Swagger s = getSwagger(req);<a name="line.433"></a>
-<span class="sourceLineNo">434</span> if (s != null && s.getInfo() != null && s.getInfo().hasDescription())<a name="line.434"></a>
-<span class="sourceLineNo">435</span> return s.getInfo().getDescription();<a name="line.435"></a>
-<span class="sourceLineNo">436</span> return null;<a name="line.436"></a>
-<span class="sourceLineNo">437</span> }<a name="line.437"></a>
-<span class="sourceLineNo">438</span><a name="line.438"></a>
-<span class="sourceLineNo">439</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.439"></a>
-<span class="sourceLineNo">440</span> // Utility methods<a name="line.440"></a>
-<span class="sourceLineNo">441</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.441"></a>
-<span class="sourceLineNo">442</span><a name="line.442"></a>
-<span class="sourceLineNo">443</span> private Operation getSwaggerOperation(Method method, RestRequest req) throws Exception {<a name="line.443"></a>
-<span class="sourceLineNo">444</span><a name="line.444"></a>
-<span class="sourceLineNo">445</span> Swagger s = getSwagger(req);<a name="line.445"></a>
-<span class="sourceLineNo">446</span> if (s != null) {<a name="line.446"></a>
-<span class="sourceLineNo">447</span> Map<String,OperationMap> sp = s.getPaths();<a name="line.447"></a>
-<span class="sourceLineNo">448</span> if (sp != null) {<a name="line.448"></a>
-<span class="sourceLineNo">449</span> Map<String,Operation> spp = sp.get(method.getAnnotation(RestMethod.class).path());<a name="line.449"></a>
-<span class="sourceLineNo">450</span> if (spp != null)<a name="line.450"></a>
-<span class="sourceLineNo">451</span> return spp.get(req.getMethod());<a name="line.451"></a>
-<span class="sourceLineNo">452</span> }<a name="line.452"></a>
-<span class="sourceLineNo">453</span> }<a name="line.453"></a>
-<span class="sourceLineNo">454</span> return null;<a name="line.454"></a>
-<span class="sourceLineNo">455</span> }<a name="line.455"></a>
-<span class="sourceLineNo">456</span><a name="line.456"></a>
-<span class="sourceLineNo">457</span> static String joinnl(String[] ss) {<a name="line.457"></a>
-<span class="sourceLineNo">458</span> if (ss.length == 0)<a name="line.458"></a>
-<span class="sourceLineNo">459</span> return "";<a name="line.459"></a>
-<span class="sourceLineNo">460</span> return StringUtils.joinnl(ss).trim();<a name="line.460"></a>
-<span class="sourceLineNo">461</span> }<a name="line.461"></a>
-<span class="sourceLineNo">462</span>}<a name="line.462"></a>
+<span class="sourceLineNo">343</span> * <p><a name="line.343"></a>
+<span class="sourceLineNo">344</span> * Subclasses can override this method to provide their own description.<a name="line.344"></a>
+<span class="sourceLineNo">345</span> *<a name="line.345"></a>
+<span class="sourceLineNo">346</span> * <p><a name="line.346"></a>
+<span class="sourceLineNo">347</span> * The default implementation returns the value from the following locations (whichever matches first):<a name="line.347"></a>
+<span class="sourceLineNo">348</span> * <ol class='spaced-list'><a name="line.348"></a>
+<span class="sourceLineNo">349</span> * <li>{@link RestResource#description() @RestResource(description)} annotation on this class, and then any parent classes.<a name="line.349"></a>
+<span class="sourceLineNo">350</span> * <h5 class='figure'>Examples:</h5><a name="line.350"></a>
+<span class="sourceLineNo">351</span> * <p class='bcode w800'><a name="line.351"></a>
+<span class="sourceLineNo">352</span> * <jc>// Direct value</jc><a name="line.352"></a>
+<span class="sourceLineNo">353</span> * <ja>@RestResource</ja>(description=<js>"My Resource"</js>)<a name="line.353"></a>
+<span class="sourceLineNo">354</span> * <jk>public class</jk> MyResource {...}<a name="line.354"></a>
+<span class="sourceLineNo">355</span> *<a name="line.355"></a>
+<span class="sourceLineNo">356</span> * <jc>// Pulled from some other location</jc><a name="line.356"></a>
+<span class="sourceLineNo">357</span> * <ja>@RestResource</ja>(description=<js>"$L{myLocalizedDescription}"</js>)<a name="line.357"></a>
+<span class="sourceLineNo">358</span> * <jk>public class</jk> MyResource {...}<a name="line.358"></a>
+<span class="sourceLineNo">359</span> * </p><a name="line.359"></a>
+<span class="sourceLineNo">360</span> * <li>Localized strings from resource bundle identified by {@link RestResource#messages() @RestResource(messages)}<a name="line.360"></a>
+<span class="sourceLineNo">361</span> * on the resource class, then any parent classes.<a name="line.361"></a>
+<span class="sourceLineNo">362</span> * <ol><a name="line.362"></a>
+<span class="sourceLineNo">363</span> * <li><ck>[ClassName].description</ck><a name="line.363"></a>
+<span class="sourceLineNo">364</span> * <li><ck>description</ck><a name="line.364"></a>
+<span class="sourceLineNo">365</span> * </ol><a name="line.365"></a>
+<span class="sourceLineNo">366</span> * <br>Value can contain any SVL variables defined on the {@link RestResource#description() @RestResource(description)} annotation.<a name="line.366"></a>
+<span class="sourceLineNo">367</span> * <h5 class='figure'>Examples:</h5><a name="line.367"></a>
+<span class="sourceLineNo">368</span> * <p class='bcode w800'><a name="line.368"></a>
+<span class="sourceLineNo">369</span> * <cc>// Direct value</cc><a name="line.369"></a>
+<span class="sourceLineNo">370</span> * <ck>MyClass.description</ck> = <cv>My Resource</cv><a name="line.370"></a>
+<span class="sourceLineNo">371</span> *<a name="line.371"></a>
+<span class="sourceLineNo">372</span> * <cc>// Pulled from some other location</cc><a name="line.372"></a>
+<span class="sourceLineNo">373</span> * <ck>MyClass.description</ck> = <cv>$C{MyStrings/MyClass.description}</cv><a name="line.373"></a>
+<span class="sourceLineNo">374</span> * </p><a name="line.374"></a>
+<span class="sourceLineNo">375</span> * <li><ck>/info/description</ck> entry in swagger file.<a name="line.375"></a>
+<span class="sourceLineNo">376</span> * </ol><a name="line.376"></a>
+<span class="sourceLineNo">377</span> *<a name="line.377"></a>
+<span class="sourceLineNo">378</span> * @param req The current request.<a name="line.378"></a>
+<span class="sourceLineNo">379</span> * @return The localized description of this REST resource, or <jk>null</jk> if none was was found.<a name="line.379"></a>
+<span class="sourceLineNo">380</span> * @throws Exception<a name="line.380"></a>
+<span class="sourceLineNo">381</span> */<a name="line.381"></a>
+<span class="sourceLineNo">382</span> @Override /* RestInfoProvider */<a name="line.382"></a>
+<span class="sourceLineNo">383</span> public String getDescription(RestRequest req) throws Exception {<a name="line.383"></a>
+<span class="sourceLineNo">384</span> VarResolverSession vr = req.getVarResolverSession();<a name="line.384"></a>
+<span class="sourceLineNo">385</span> if (description != null)<a name="line.385"></a>
+<span class="sourceLineNo">386</span> return vr.resolve(description);<a name="line.386"></a>
+<span class="sourceLineNo">387</span> String description = context.getMessages().findFirstString(req.getLocale(), "description");<a name="line.387"></a>
+<span class="sourceLineNo">388</span> if (description != null)<a name="line.388"></a>
+<span class="sourceLineNo">389</span> return vr.resolve(description);<a name="line.389"></a>
+<span class="sourceLineNo">390</span> Swagger s = getSwagger(req);<a name="line.390"></a>
+<span class="sourceLineNo">391</span> if (s != null && s.getInfo() != null && s.getInfo().hasDescription())<a name="line.391"></a>
+<span class="sourceLineNo">392</span> return s.getInfo().getDescription();<a name="line.392"></a>
+<span class="sourceLineNo">393</span> return null;<a name="line.393"></a>
+<span class="sourceLineNo">394</span> }<a name="line.394"></a>
+<span class="sourceLineNo">395</span><a name="line.395"></a>
+<span class="sourceLineNo">396</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.396"></a>
+<span class="sourceLineNo">397</span> // Utility methods<a name="line.397"></a>
+<span class="sourceLineNo">398</span> //-----------------------------------------------------------------------------------------------------------------<a name="line.398"></a>
+<span class="sourceLineNo">399</span><a name="line.399"></a>
+<span class="sourceLineNo">400</span> private Operation getSwaggerOperation(Method method, RestRequest req) throws Exception {<a name="line.400"></a>
+<span class="sourceLineNo">401</span><a name="line.401"></a>
+<span class="sourceLineNo">402</span> Swagger s = getSwagger(req);<a name="line.402"></a>
+<span class="sourceLineNo">403</span> if (s != null) {<a name="line.403"></a>
+<span class="sourceLineNo">404</span> Map<String,OperationMap> sp = s.getPaths();<a name="line.404"></a>
+<span class="sourceLineNo">405</span> if (sp != null) {<a name="line.405"></a>
+<span class="sourceLineNo">406</span> Map<String,Operation> spp = sp.get(method.getAnnotation(RestMethod.class).path());<a name="line.406"></a>
+<span class="sourceLineNo">407</span> if (spp != null)<a name="line.407"></a>
+<span class="sourceLineNo">408</span> return spp.get(req.getMethod());<a name="line.408"></a>
+<span class="sourceLineNo">409</span> }<a name="line.409"></a>
+<span class="sourceLineNo">410</span> }<a name="line.410"></a>
+<span class="sourceLineNo">411</span> return null;<a name="line.411"></a>
+<span class="sourceLineNo">412</span> }<a name="line.412"></a>
+<span class="sourceLineNo">413</span><a name="line.413"></a>
+<span class="sourceLineNo">414</span> static String joinnl(String[] ss) {<a name="line.414"></a>
+<span class="sourceLineNo">415</span> if (ss.length == 0)<a name="line.415"></a>
+<span class="sourceLineNo">416</span> return "";<a name="line.416"></a>
+<span class="sourceLineNo">417</span> return StringUtils.joinnl(ss).trim();<a name="line.417"></a>
+<span class="sourceLineNo">418</span> }<a name="line.418"></a>
+<span class="sourceLineNo">419</span>}<a name="line.419"></a>
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestServlet.html b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestServlet.html
index 4261752..b1e2b8b 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestServlet.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/BasicRestServlet.html
@@ -22,222 +22,224 @@
<span class="sourceLineNo">014</span><a name="line.14"></a>
<span class="sourceLineNo">015</span>import static org.apache.juneau.http.HttpMethodName.*;<a name="line.15"></a>
<span class="sourceLineNo">016</span>import static org.apache.juneau.jsonschema.JsonSchemaGenerator.*;<a name="line.16"></a>
-<span class="sourceLineNo">017</span>import static org.apache.juneau.rest.BasicRestInfoProvider.*;<a name="line.17"></a>
-<span class="sourceLineNo">018</span><a name="line.18"></a>
-<span class="sourceLineNo">019</span>import org.apache.juneau.dto.swagger.*;<a name="line.19"></a>
-<span class="sourceLineNo">020</span>import org.apache.juneau.dto.swagger.ui.*;<a name="line.20"></a>
-<span class="sourceLineNo">021</span>import org.apache.juneau.html.*;<a name="line.21"></a>
-<span class="sourceLineNo">022</span>import org.apache.juneau.jso.*;<a name="line.22"></a>
-<span class="sourceLineNo">023</span>import org.apache.juneau.json.*;<a name="line.23"></a>
-<span class="sourceLineNo">024</span>import org.apache.juneau.plaintext.*;<a name="line.24"></a>
-<span class="sourceLineNo">025</span>import org.apache.juneau.rest.annotation.*;<a name="line.25"></a>
-<span class="sourceLineNo">026</span>import org.apache.juneau.soap.*;<a name="line.26"></a>
-<span class="sourceLineNo">027</span>import org.apache.juneau.uon.*;<a name="line.27"></a>
-<span class="sourceLineNo">028</span>import org.apache.juneau.urlencoding.*;<a name="line.28"></a>
-<span class="sourceLineNo">029</span>import org.apache.juneau.xml.*;<a name="line.29"></a>
-<span class="sourceLineNo">030</span>import org.apache.juneau.xmlschema.*;<a name="line.30"></a>
-<span class="sourceLineNo">031</span><a name="line.31"></a>
-<span class="sourceLineNo">032</span>/**<a name="line.32"></a>
-<span class="sourceLineNo">033</span> * Subclass of {@link RestServlet} with default serializers and parsers defined.<a name="line.33"></a>
-<span class="sourceLineNo">034</span> *<a name="line.34"></a>
-<span class="sourceLineNo">035</span> * <p><a name="line.35"></a>
-<span class="sourceLineNo">036</span> * Supports the following request <code>Accept</code> header values with the resulting response <code>Content-Type</code>:<a name="line.36"></a>
-<span class="sourceLineNo">037</span> * <table class='styled'><a name="line.37"></a>
-<span class="sourceLineNo">038</span> * <tr><a name="line.38"></a>
-<span class="sourceLineNo">039</span> * <th>Accept</th><a name="line.39"></a>
-<span class="sourceLineNo">040</span> * <th>Content-Type</th><a name="line.40"></a>
-<span class="sourceLineNo">041</span> * <th>Serializer</th><a name="line.41"></a>
-<span class="sourceLineNo">042</span> * </tr><a name="line.42"></a>
-<span class="sourceLineNo">043</span> * <tr><a name="line.43"></a>
-<span class="sourceLineNo">044</span> * <td class='code'>application/json<br>text/json</td><a name="line.44"></a>
-<span class="sourceLineNo">045</span> * <td class='code'>application/json</td><a name="line.45"></a>
-<span class="sourceLineNo">046</span> * <td>{@link JsonSerializer}</td><a name="line.46"></a>
-<span class="sourceLineNo">047</span> * </tr><a name="line.47"></a>
-<span class="sourceLineNo">048</span> * <tr><a name="line.48"></a>
-<span class="sourceLineNo">049</span> * <td class='code'>application/json+simple<br>text/json+simple</td><a name="line.49"></a>
-<span class="sourceLineNo">050</span> * <td class='code'>application/json</td><a name="line.50"></a>
-<span class="sourceLineNo">051</span> * <td>{@link org.apache.juneau.json.SimpleJsonSerializer}</td><a name="line.51"></a>
-<span class="sourceLineNo">052</span> * </tr><a name="line.52"></a>
-<span class="sourceLineNo">053</span> * <tr><a name="line.53"></a>
-<span class="sourceLineNo">054</span> * <td class='code'>application/json+schema<br>text/json+schema</td><a name="line.54"></a>
-<span class="sourceLineNo">055</span> * <td class='code'>application/json</td><a name="line.55"></a>
-<span class="sourceLineNo">056</span> * <td>{@link JsonSchemaSerializer}</td><a name="line.56"></a>
-<span class="sourceLineNo">057</span> * </tr><a name="line.57"></a>
-<span class="sourceLineNo">058</span> * <tr><a name="line.58"></a>
+<span class="sourceLineNo">017</span><a name="line.17"></a>
+<span class="sourceLineNo">018</span>import org.apache.juneau.dto.swagger.*;<a name="line.18"></a>
+<span class="sourceLineNo">019</span>import org.apache.juneau.dto.swagger.ui.*;<a name="line.19"></a>
+<span class="sourceLineNo">020</span>import org.apache.juneau.html.*;<a name="line.20"></a>
+<span class="sourceLineNo">021</span>import org.apache.juneau.jso.*;<a name="line.21"></a>
+<span class="sourceLineNo">022</span>import org.apache.juneau.json.*;<a name="line.22"></a>
+<span class="sourceLineNo">023</span>import org.apache.juneau.plaintext.*;<a name="line.23"></a>
+<span class="sourceLineNo">024</span>import org.apache.juneau.rest.annotation.*;<a name="line.24"></a>
+<span class="sourceLineNo">025</span>import org.apache.juneau.soap.*;<a name="line.25"></a>
+<span class="sourceLineNo">026</span>import org.apache.juneau.uon.*;<a name="line.26"></a>
+<span class="sourceLineNo">027</span>import org.apache.juneau.urlencoding.*;<a name="line.27"></a>
+<span class="sourceLineNo">028</span>import org.apache.juneau.xml.*;<a name="line.28"></a>
+<span class="sourceLineNo">029</span>import org.apache.juneau.xmlschema.*;<a name="line.29"></a>
+<span class="sourceLineNo">030</span><a name="line.30"></a>
+<span class="sourceLineNo">031</span>/**<a name="line.31"></a>
+<span class="sourceLineNo">032</span> * Subclass of {@link RestServlet} with default serializers and parsers defined.<a name="line.32"></a>
+<span class="sourceLineNo">033</span> *<a name="line.33"></a>
+<span class="sourceLineNo">034</span> * <p><a name="line.34"></a>
+<span class="sourceLineNo">035</span> * Supports the following request <code>Accept</code> header values with the resulting response <code>Content-Type</code>:<a name="line.35"></a>
+<span class="sourceLineNo">036</span> * <table class='styled'><a name="line.36"></a>
+<span class="sourceLineNo">037</span> * <tr><a name="line.37"></a>
+<span class="sourceLineNo">038</span> * <th>Accept</th><a name="line.38"></a>
+<span class="sourceLineNo">039</span> * <th>Content-Type</th><a name="line.39"></a>
+<span class="sourceLineNo">040</span> * <th>Serializer</th><a name="line.40"></a>
+<span class="sourceLineNo">041</span> * </tr><a name="line.41"></a>
+<span class="sourceLineNo">042</span> * <tr><a name="line.42"></a>
+<span class="sourceLineNo">043</span> * <td class='code'>application/json<br>text/json</td><a name="line.43"></a>
+<span class="sourceLineNo">044</span> * <td class='code'>application/json</td><a name="line.44"></a>
+<span class="sourceLineNo">045</span> * <td>{@link JsonSerializer}</td><a name="line.45"></a>
+<span class="sourceLineNo">046</span> * </tr><a name="line.46"></a>
+<span class="sourceLineNo">047</span> * <tr><a name="line.47"></a>
+<span class="sourceLineNo">048</span> * <td class='code'>application/json+simple<br>text/json+simple</td><a name="line.48"></a>
+<span class="sourceLineNo">049</span> * <td class='code'>application/json</td><a name="line.49"></a>
+<span class="sourceLineNo">050</span> * <td>{@link org.apache.juneau.json.SimpleJsonSerializer}</td><a name="line.50"></a>
+<span class="sourceLineNo">051</span> * </tr><a name="line.51"></a>
+<span class="sourceLineNo">052</span> * <tr><a name="line.52"></a>
+<span class="sourceLineNo">053</span> * <td class='code'>application/json+schema<br>text/json+schema</td><a name="line.53"></a>
+<span class="sourceLineNo">054</span> * <td class='code'>application/json</td><a name="line.54"></a>
+<span class="sourceLineNo">055</span> * <td>{@link JsonSchemaSerializer}</td><a name="line.55"></a>
+<span class="sourceLineNo">056</span> * </tr><a name="line.56"></a>
+<span class="sourceLineNo">057</span> * <tr><a name="line.57"></a>
+<span class="sourceLineNo">058</span> * <td class='code'>text/xml</td><a name="line.58"></a>
<span class="sourceLineNo">059</span> * <td class='code'>text/xml</td><a name="line.59"></a>
-<span class="sourceLineNo">060</span> * <td class='code'>text/xml</td><a name="line.60"></a>
-<span class="sourceLineNo">061</span> * <td>{@link XmlDocSerializer}</td><a name="line.61"></a>
-<span class="sourceLineNo">062</span> * </tr><a name="line.62"></a>
-<span class="sourceLineNo">063</span> * <tr><a name="line.63"></a>
-<span class="sourceLineNo">064</span> * <td class='code'>text/xml+schema</td><a name="line.64"></a>
-<span class="sourceLineNo">065</span> * <td class='code'>text/xml</td><a name="line.65"></a>
-<span class="sourceLineNo">066</span> * <td>{@link XmlSchemaDocSerializer}</td><a name="line.66"></a>
-<span class="sourceLineNo">067</span> * </tr><a name="line.67"></a>
-<span class="sourceLineNo">068</span> * <tr><a name="line.68"></a>
+<span class="sourceLineNo">060</span> * <td>{@link XmlDocSerializer}</td><a name="line.60"></a>
+<span class="sourceLineNo">061</span> * </tr><a name="line.61"></a>
+<span class="sourceLineNo">062</span> * <tr><a name="line.62"></a>
+<span class="sourceLineNo">063</span> * <td class='code'>text/xml+schema</td><a name="line.63"></a>
+<span class="sourceLineNo">064</span> * <td class='code'>text/xml</td><a name="line.64"></a>
+<span class="sourceLineNo">065</span> * <td>{@link XmlSchemaDocSerializer}</td><a name="line.65"></a>
+<span class="sourceLineNo">066</span> * </tr><a name="line.66"></a>
+<span class="sourceLineNo">067</span> * <tr><a name="line.67"></a>
+<span class="sourceLineNo">068</span> * <td class='code'>text/html</td><a name="line.68"></a>
<span class="sourceLineNo">069</span> * <td class='code'>text/html</td><a name="line.69"></a>
-<span class="sourceLineNo">070</span> * <td class='code'>text/html</td><a name="line.70"></a>
-<span class="sourceLineNo">071</span> * <td>{@link HtmlDocSerializer}</td><a name="line.71"></a>
-<span class="sourceLineNo">072</span> * </tr><a name="line.72"></a>
-<span class="sourceLineNo">073</span> * <tr><a name="line.73"></a>
-<span class="sourceLineNo">074</span> * <td class='code'>text/html+stripped</td><a name="line.74"></a>
-<span class="sourceLineNo">075</span> * <td class='code'>text/html</td><a name="line.75"></a>
-<span class="sourceLineNo">076</span> * <td>{@link HtmlStrippedDocSerializer}</td><a name="line.76"></a>
-<span class="sourceLineNo">077</span> * </tr><a name="line.77"></a>
-<span class="sourceLineNo">078</span> * <tr><a name="line.78"></a>
+<span class="sourceLineNo">070</span> * <td>{@link HtmlDocSerializer}</td><a name="line.70"></a>
+<span class="sourceLineNo">071</span> * </tr><a name="line.71"></a>
+<span class="sourceLineNo">072</span> * <tr><a name="line.72"></a>
+<span class="sourceLineNo">073</span> * <td class='code'>text/html+stripped</td><a name="line.73"></a>
+<span class="sourceLineNo">074</span> * <td class='code'>text/html</td><a name="line.74"></a>
+<span class="sourceLineNo">075</span> * <td>{@link HtmlStrippedDocSerializer}</td><a name="line.75"></a>
+<span class="sourceLineNo">076</span> * </tr><a name="line.76"></a>
+<span class="sourceLineNo">077</span> * <tr><a name="line.77"></a>
+<span class="sourceLineNo">078</span> * <td class='code'>text/uon</td><a name="line.78"></a>
<span class="sourceLineNo">079</span> * <td class='code'>text/uon</td><a name="line.79"></a>
-<span class="sourceLineNo">080</span> * <td class='code'>text/uon</td><a name="line.80"></a>
-<span class="sourceLineNo">081</span> * <td>{@link UonSerializer}</td><a name="line.81"></a>
-<span class="sourceLineNo">082</span> * </tr><a name="line.82"></a>
-<span class="sourceLineNo">083</span> * <tr><a name="line.83"></a>
+<span class="sourceLineNo">080</span> * <td>{@link UonSerializer}</td><a name="line.80"></a>
+<span class="sourceLineNo">081</span> * </tr><a name="line.81"></a>
+<span class="sourceLineNo">082</span> * <tr><a name="line.82"></a>
+<span class="sourceLineNo">083</span> * <td class='code'>application/x-www-form-urlencoded</td><a name="line.83"></a>
<span class="sourceLineNo">084</span> * <td class='code'>application/x-www-form-urlencoded</td><a name="line.84"></a>
-<span class="sourceLineNo">085</span> * <td class='code'>application/x-www-form-urlencoded</td><a name="line.85"></a>
-<span class="sourceLineNo">086</span> * <td>{@link UrlEncodingSerializer}</td><a name="line.86"></a>
-<span class="sourceLineNo">087</span> * </tr><a name="line.87"></a>
-<span class="sourceLineNo">088</span> * <tr><a name="line.88"></a>
-<span class="sourceLineNo">089</span> * <td class='code'>text/xml+soap</td><a name="line.89"></a>
-<span class="sourceLineNo">090</span> * <td class='code'>text/xml</td><a name="line.90"></a>
-<span class="sourceLineNo">091</span> * <td>{@link SoapXmlSerializer}</td><a name="line.91"></a>
-<span class="sourceLineNo">092</span> * </tr><a name="line.92"></a>
-<span class="sourceLineNo">093</span> * <tr><a name="line.93"></a>
+<span class="sourceLineNo">085</span> * <td>{@link UrlEncodingSerializer}</td><a name="line.85"></a>
+<span class="sourceLineNo">086</span> * </tr><a name="line.86"></a>
+<span class="sourceLineNo">087</span> * <tr><a name="line.87"></a>
+<span class="sourceLineNo">088</span> * <td class='code'>text/xml+soap</td><a name="line.88"></a>
+<span class="sourceLineNo">089</span> * <td class='code'>text/xml</td><a name="line.89"></a>
+<span class="sourceLineNo">090</span> * <td>{@link SoapXmlSerializer}</td><a name="line.90"></a>
+<span class="sourceLineNo">091</span> * </tr><a name="line.91"></a>
+<span class="sourceLineNo">092</span> * <tr><a name="line.92"></a>
+<span class="sourceLineNo">093</span> * <td class='code'>text/plain</td><a name="line.93"></a>
<span class="sourceLineNo">094</span> * <td class='code'>text/plain</td><a name="line.94"></a>
-<span class="sourceLineNo">095</span> * <td class='code'>text/plain</td><a name="line.95"></a>
-<span class="sourceLineNo">096</span> * <td>{@link PlainTextSerializer}</td><a name="line.96"></a>
-<span class="sourceLineNo">097</span> * </tr><a name="line.97"></a>
-<span class="sourceLineNo">098</span> * </table><a name="line.98"></a>
-<span class="sourceLineNo">099</span> * <p><a name="line.99"></a>
-<span class="sourceLineNo">100</span> * Supports the following request <code>Content-Type</code> header values:<a name="line.100"></a>
-<span class="sourceLineNo">101</span> * </p><a name="line.101"></a>
-<span class="sourceLineNo">102</span> * <table class='styled'><a name="line.102"></a>
-<span class="sourceLineNo">103</span> * <tr><a name="line.103"></a>
-<span class="sourceLineNo">104</span> * <th>Content-Type</th><a name="line.104"></a>
-<span class="sourceLineNo">105</span> * <th>Parser</th><a name="line.105"></a>
-<span class="sourceLineNo">106</span> * </tr><a name="line.106"></a>
-<span class="sourceLineNo">107</span> * <tr><a name="line.107"></a>
-<span class="sourceLineNo">108</span> * <td class='code'>application/json<br>text/json</td><a name="line.108"></a>
-<span class="sourceLineNo">109</span> * <td>{@link JsonParser}</td><a name="line.109"></a>
-<span class="sourceLineNo">110</span> * </tr><a name="line.110"></a>
-<span class="sourceLineNo">111</span> * <tr><a name="line.111"></a>
-<span class="sourceLineNo">112</span> * <td class='code'>text/xml<br>application/xml</td><a name="line.112"></a>
-<span class="sourceLineNo">113</span> * <td>{@link XmlParser}</td><a name="line.113"></a>
-<span class="sourceLineNo">114</span> * </tr><a name="line.114"></a>
-<span class="sourceLineNo">115</span> * <tr><a name="line.115"></a>
-<span class="sourceLineNo">116</span> * <td class='code'>text/html<br>text/html+stripped</td><a name="line.116"></a>
-<span class="sourceLineNo">117</span> * <td>{@link HtmlParser}</td><a name="line.117"></a>
-<span class="sourceLineNo">118</span> * </tr><a name="line.118"></a>
-<span class="sourceLineNo">119</span> * <tr><a name="line.119"></a>
-<span class="sourceLineNo">120</span> * <td class='code'>text/uon</td><a name="line.120"></a>
-<span class="sourceLineNo">121</span> * <td>{@link UonParser}</td><a name="line.121"></a>
-<span class="sourceLineNo">122</span> * </tr><a name="line.122"></a>
-<span class="sourceLineNo">123</span> * <tr><a name="line.123"></a>
-<span class="sourceLineNo">124</span> * <td class='code'>application/x-www-form-urlencoded</td><a name="line.124"></a>
-<span class="sourceLineNo">125</span> * <td>{@link UrlEncodingParser}</td><a name="line.125"></a>
-<span class="sourceLineNo">126</span> * </tr><a name="line.126"></a>
-<span class="sourceLineNo">127</span> * <tr><a name="line.127"></a>
-<span class="sourceLineNo">128</span> * <td class='code'>text/plain</td><a name="line.128"></a>
-<span class="sourceLineNo">129</span> * <td>{@link PlainTextParser}</td><a name="line.129"></a>
-<span class="sourceLineNo">130</span> * </tr><a name="line.130"></a>
-<span class="sourceLineNo">131</span> * </table><a name="line.131"></a>
-<span class="sourceLineNo">132</span> *<a name="line.132"></a>
-<span class="sourceLineNo">133</span> * <p><a name="line.133"></a>
-<span class="sourceLineNo">134</span> * It should be noted that we do NOT add {@link JsoParser} to the list of parsers since this could cause security<a name="line.134"></a>
-<span class="sourceLineNo">135</span> * issues.<a name="line.135"></a>
-<span class="sourceLineNo">136</span> * Use caution when using this particular parser as it could inadvertently cause code execution security holes.<a name="line.136"></a>
-<span class="sourceLineNo">137</span> *<a name="line.137"></a>
-<span class="sourceLineNo">138</span> * <p><a name="line.138"></a>
-<span class="sourceLineNo">139</span> * The list of serializers and parsers can be appended to using the<a name="line.139"></a>
-<span class="sourceLineNo">140</span> * {@link RestResource#serializers() @RestResource(serializers)} and<a name="line.140"></a>
-<span class="sourceLineNo">141</span> * {@link RestResource#parsers() @RestResource(parsers)} annotations on subclasses.<a name="line.141"></a>
-<span class="sourceLineNo">142</span> *<a name="line.142"></a>
-<span class="sourceLineNo">143</span> * <p><a name="line.143"></a>
-<span class="sourceLineNo">144</span> * This subclass also provides a default OPTIONS page by implementing a {@link #getOptions(RestRequest)} that returns a<a name="line.144"></a>
-<span class="sourceLineNo">145</span> * POJO consisting of beans describing the class.<a name="line.145"></a>
-<span class="sourceLineNo">146</span> * <img class='bordered' src='doc-files/OptionsPage.png'><a name="line.146"></a>
-<span class="sourceLineNo">147</span> *<a name="line.147"></a>
-<span class="sourceLineNo">148</span> * <p><a name="line.148"></a>
-<span class="sourceLineNo">149</span> * The OPTIONS page can be modified or augmented by overriding this method and providing your own data.<a name="line.149"></a>
-<span class="sourceLineNo">150</span> *<a name="line.150"></a>
-<span class="sourceLineNo">151</span> * <h5 class='section'>Notes:</h5><a name="line.151"></a>
-<span class="sourceLineNo">152</span> * <ul class='spaced-list'><a name="line.152"></a>
-<span class="sourceLineNo">153</span> * <li><a name="line.153"></a>
-<span class="sourceLineNo">154</span> * Provides a default HTML stylesheet by setting {@link HtmlDoc#stylesheet() @HtmlDoc(stylesheet)}<a name="line.154"></a>
-<span class="sourceLineNo">155</span> * to <js>"styles/juneau.css"</js>.<a name="line.155"></a>
-<span class="sourceLineNo">156</span> * <li><a name="line.156"></a>
-<span class="sourceLineNo">157</span> * Provides a default classpath entry "htdocs" by setting<a name="line.157"></a>
-<span class="sourceLineNo">158</span> * {@link RestResource#staticFiles() @RestResource(staticFiles)} to <code>{<js>"htdocs:htdocs"</js>,<js>"styles:styles"</js>}</code>.<a name="line.158"></a>
-<span class="sourceLineNo">159</span> * This allows files inside the <code>[servletPackage].htdocs</code> package to be served up under the URL<a name="line.159"></a>
-<span class="sourceLineNo">160</span> * <code>/servletPath/htdocs</code>.<a name="line.160"></a>
-<span class="sourceLineNo">161</span> * </ul><a name="line.161"></a>
-<span class="sourceLineNo">162</span> *<a name="line.162"></a>
-<span class="sourceLineNo">163</span> * <h5 class='section'>See Also:</h5><a name="line.163"></a>
-<span class="sourceLineNo">164</span> * <ul><a name="line.164"></a>
-<span class="sourceLineNo">165</span> * <li class='link'>{@doc juneau-rest-server.Instantiation.BasicRestServlet}<a name="line.165"></a>
-<span class="sourceLineNo">166</span> * </ul><a name="line.166"></a>
-<span class="sourceLineNo">167</span> */<a name="line.167"></a>
-<span class="sourceLineNo">168</span>@RestResource(<a name="line.168"></a>
-<span class="sourceLineNo">169</span><a name="line.169"></a>
-<span class="sourceLineNo">170</span> // Allow OPTIONS requests to be simulated using ?method=OPTIONS query parameter.<a name="line.170"></a>
-<span class="sourceLineNo">171</span> allowedMethodParams="OPTIONS",<a name="line.171"></a>
-<span class="sourceLineNo">172</span><a name="line.172"></a>
-<span class="sourceLineNo">173</span> // HTML-page specific settings.<a name="line.173"></a>
-<span class="sourceLineNo">174</span> htmldoc=@HtmlDoc(<a name="line.174"></a>
-<span class="sourceLineNo">175</span> // Basic page navigation links.<a name="line.175"></a>
-<span class="sourceLineNo">176</span> navlinks={<a name="line.176"></a>
-<span class="sourceLineNo">177</span> "up: request:/..",<a name="line.177"></a>
-<span class="sourceLineNo">178</span> "options: servlet:/?method=OPTIONS"<a name="line.178"></a>
-<span class="sourceLineNo">179</span> }<a name="line.179"></a>
-<span class="sourceLineNo">180</span> ),<a name="line.180"></a>
-<span class="sourceLineNo">181</span><a name="line.181"></a>
-<span class="sourceLineNo">182</span> // POJO swaps to apply to all serializers/parsers.<a name="line.182"></a>
-<span class="sourceLineNo">183</span> pojoSwaps={<a name="line.183"></a>
-<span class="sourceLineNo">184</span> // Use the SwaggerUI swap when rendering Swagger beans.<a name="line.184"></a>
-<span class="sourceLineNo">185</span> SwaggerUI.class<a name="line.185"></a>
-<span class="sourceLineNo">186</span> },<a name="line.186"></a>
-<span class="sourceLineNo">187</span><a name="line.187"></a>
-<span class="sourceLineNo">188</span> // Properties to apply to all serializers/parsers and REST-specific API objects.<a name="line.188"></a>
-<span class="sourceLineNo">189</span> properties={<a name="line.189"></a>
-<span class="sourceLineNo">190</span> // Add descriptions to the following types when not specified:<a name="line.190"></a>
-<span class="sourceLineNo">191</span> @Property(name=JSONSCHEMA_addDescriptionsTo, value="bean,collection,array,map,enum"),<a name="line.191"></a>
-<span class="sourceLineNo">192</span><a name="line.192"></a>
-<span class="sourceLineNo">193</span> // Add x-example to the following types:<a name="line.193"></a>
-<span class="sourceLineNo">194</span> @Property(name=JSONSCHEMA_addExamplesTo, value="bean,collection,array,map"),<a name="line.194"></a>
-<span class="sourceLineNo">195</span><a name="line.195"></a>
-<span class="sourceLineNo">196</span> // Don't generate schema information on the Swagger bean itself or HTML beans.<a name="line.196"></a>
-<span class="sourceLineNo">197</span> @Property(name=INFOPROVIDER_ignoreTypes, value="Swagger,org.apache.juneau.dto.html5.*")<a name="line.197"></a>
-<span class="sourceLineNo">198</span> },<a name="line.198"></a>
-<span class="sourceLineNo">199</span><a name="line.199"></a>
-<span class="sourceLineNo">200</span> // Shortcut for boolean properties.<a name="line.200"></a>
-<span class="sourceLineNo">201</span> flags={<a name="line.201"></a>
-<span class="sourceLineNo">202</span> // Use $ref references for bean definitions to reduce duplication in Swagger.<a name="line.202"></a>
-<span class="sourceLineNo">203</span> JSONSCHEMA_useBeanDefs<a name="line.203"></a>
-<span class="sourceLineNo">204</span> }<a name="line.204"></a>
-<span class="sourceLineNo">205</span>)<a name="line.205"></a>
-<span class="sourceLineNo">206</span>public abstract class BasicRestServlet extends RestServlet implements BasicRestConfig {<a name="line.206"></a>
-<span class="sourceLineNo">207</span> private static final long serialVersionUID = 1L;<a name="line.207"></a>
-<span class="sourceLineNo">208</span><a name="line.208"></a>
-<span class="sourceLineNo">209</span> /**<a name="line.209"></a>
-<span class="sourceLineNo">210</span> * [OPTIONS /*] - Show resource options.<a name="line.210"></a>
-<span class="sourceLineNo">211</span> *<a name="line.211"></a>
-<span class="sourceLineNo">212</span> * @param req The HTTP request.<a name="line.212"></a>
-<span class="sourceLineNo">213</span> * @return A bean containing the contents for the OPTIONS page.<a name="line.213"></a>
-<span class="sourceLineNo">214</span> */<a name="line.214"></a>
-<span class="sourceLineNo">215</span> @RestMethod(name=OPTIONS, path="/*",<a name="line.215"></a>
-<span class="sourceLineNo">216</span> summary="Swagger documentation",<a name="line.216"></a>
-<span class="sourceLineNo">217</span> description="Swagger documentation for this resource.",<a name="line.217"></a>
-<span class="sourceLineNo">218</span> htmldoc=@HtmlDoc(<a name="line.218"></a>
-<span class="sourceLineNo">219</span> // Override the nav links for the swagger page.<a name="line.219"></a>
-<span class="sourceLineNo">220</span> navlinks={<a name="line.220"></a>
-<span class="sourceLineNo">221</span> "back: servlet:/",<a name="line.221"></a>
-<span class="sourceLineNo">222</span> "json: servlet:/?method=OPTIONS&Accept=text/json&plainText=true"<a name="line.222"></a>
-<span class="sourceLineNo">223</span> },<a name="line.223"></a>
-<span class="sourceLineNo">224</span> // Never show aside contents of page inherited from class.<a name="line.224"></a>
-<span class="sourceLineNo">225</span> aside="NONE"<a name="line.225"></a>
-<span class="sourceLineNo">226</span> )<a name="line.226"></a>
-<span class="sourceLineNo">227</span> )<a name="line.227"></a>
-<span class="sourceLineNo">228</span> public Swagger getOptions(RestRequest req) {<a name="line.228"></a>
-<span class="sourceLineNo">229</span> // Localized Swagger for this resource is available through the RestRequest object.<a name="line.229"></a>
-<span class="sourceLineNo">230</span> return req.getSwagger();<a name="line.230"></a>
-<span class="sourceLineNo">231</span> }<a name="line.231"></a>
-<span class="sourceLineNo">232</span>}<a name="line.232"></a>
+<span class="sourceLineNo">095</span> * <td>{@link PlainTextSerializer}</td><a name="line.95"></a>
+<span class="sourceLineNo">096</span> * </tr><a name="line.96"></a>
+<span class="sourceLineNo">097</span> * </table><a name="line.97"></a>
+<span class="sourceLineNo">098</span> * <p><a name="line.98"></a>
+<span class="sourceLineNo">099</span> * Supports the following request <code>Content-Type</code> header values:<a name="line.99"></a>
+<span class="sourceLineNo">100</span> * </p><a name="line.100"></a>
+<span class="sourceLineNo">101</span> * <table class='styled'><a name="line.101"></a>
+<span class="sourceLineNo">102</span> * <tr><a name="line.102"></a>
+<span class="sourceLineNo">103</span> * <th>Content-Type</th><a name="line.103"></a>
+<span class="sourceLineNo">104</span> * <th>Parser</th><a name="line.104"></a>
+<span class="sourceLineNo">105</span> * </tr><a name="line.105"></a>
+<span class="sourceLineNo">106</span> * <tr><a name="line.106"></a>
+<span class="sourceLineNo">107</span> * <td class='code'>application/json<br>text/json</td><a name="line.107"></a>
+<span class="sourceLineNo">108</span> * <td>{@link JsonParser}</td><a name="line.108"></a>
+<span class="sourceLineNo">109</span> * </tr><a name="line.109"></a>
+<span class="sourceLineNo">110</span> * <tr><a name="line.110"></a>
+<span class="sourceLineNo">111</span> * <td class='code'>text/xml<br>application/xml</td><a name="line.111"></a>
+<span class="sourceLineNo">112</span> * <td>{@link XmlParser}</td><a name="line.112"></a>
+<span class="sourceLineNo">113</span> * </tr><a name="line.113"></a>
+<span class="sourceLineNo">114</span> * <tr><a name="line.114"></a>
+<span class="sourceLineNo">115</span> * <td class='code'>text/html<br>text/html+stripped</td><a name="line.115"></a>
+<span class="sourceLineNo">116</span> * <td>{@link HtmlParser}</td><a name="line.116"></a>
+<span class="sourceLineNo">117</span> * </tr><a name="line.117"></a>
+<span class="sourceLineNo">118</span> * <tr><a name="line.118"></a>
+<span class="sourceLineNo">119</span> * <td class='code'>text/uon</td><a name="line.119"></a>
+<span class="sourceLineNo">120</span> * <td>{@link UonParser}</td><a name="line.120"></a>
+<span class="sourceLineNo">121</span> * </tr><a name="line.121"></a>
+<span class="sourceLineNo">122</span> * <tr><a name="line.122"></a>
+<span class="sourceLineNo">123</span> * <td class='code'>application/x-www-form-urlencoded</td><a name="line.123"></a>
+<span class="sourceLineNo">124</span> * <td>{@link UrlEncodingParser}</td><a name="line.124"></a>
+<span class="sourceLineNo">125</span> * </tr><a name="line.125"></a>
+<span class="sourceLineNo">126</span> * <tr><a name="line.126"></a>
+<span class="sourceLineNo">127</span> * <td class='code'>text/plain</td><a name="line.127"></a>
+<span class="sourceLineNo">128</span> * <td>{@link PlainTextParser}</td><a name="line.128"></a>
+<span class="sourceLineNo">129</span> * </tr><a name="line.129"></a>
+<span class="sourceLineNo">130</span> * </table><a name="line.130"></a>
+<span class="sourceLineNo">131</span> *<a name="line.131"></a>
+<span class="sourceLineNo">132</span> * <p><a name="line.132"></a>
+<span class="sourceLineNo">133</span> * It should be noted that we do NOT add {@link JsoParser} to the list of parsers since this could cause security<a name="line.133"></a>
+<span class="sourceLineNo">134</span> * issues.<a name="line.134"></a>
+<span class="sourceLineNo">135</span> * Use caution when using this particular parser as it could inadvertently cause code execution security holes.<a name="line.135"></a>
+<span class="sourceLineNo">136</span> *<a name="line.136"></a>
+<span class="sourceLineNo">137</span> * <p><a name="line.137"></a>
+<span class="sourceLineNo">138</span> * The list of serializers and parsers can be appended to using the<a name="line.138"></a>
+<span class="sourceLineNo">139</span> * {@link RestResource#serializers() @RestResource(serializers)} and<a name="line.139"></a>
+<span class="sourceLineNo">140</span> * {@link RestResource#parsers() @RestResource(parsers)} annotations on subclasses.<a name="line.140"></a>
+<span class="sourceLineNo">141</span> *<a name="line.141"></a>
+<span class="sourceLineNo">142</span> * <p><a name="line.142"></a>
+<span class="sourceLineNo">143</span> * This subclass also provides a default OPTIONS page by implementing a {@link #getOptions(RestRequest)} that returns a<a name="line.143"></a>
+<span class="sourceLineNo">144</span> * POJO consisting of beans describing the class.<a name="line.144"></a>
+<span class="sourceLineNo">145</span> * <img class='bordered' src='doc-files/OptionsPage.png'><a name="line.145"></a>
+<span class="sourceLineNo">146</span> *<a name="line.146"></a>
+<span class="sourceLineNo">147</span> * <p><a name="line.147"></a>
+<span class="sourceLineNo">148</span> * The OPTIONS page can be modified or augmented by overriding this method and providing your own data.<a name="line.148"></a>
+<span class="sourceLineNo">149</span> *<a name="line.149"></a>
+<span class="sourceLineNo">150</span> * <h5 class='section'>Notes:</h5><a name="line.150"></a>
+<span class="sourceLineNo">151</span> * <ul class='spaced-list'><a name="line.151"></a>
+<span class="sourceLineNo">152</span> * <li><a name="line.152"></a>
+<span class="sourceLineNo">153</span> * Provides a default HTML stylesheet by setting {@link HtmlDoc#stylesheet() @HtmlDoc(stylesheet)}<a name="line.153"></a>
+<span class="sourceLineNo">154</span> * to <js>"styles/juneau.css"</js>.<a name="line.154"></a>
+<span class="sourceLineNo">155</span> * <li><a name="line.155"></a>
+<span class="sourceLineNo">156</span> * Provides a default classpath entry "htdocs" by setting<a name="line.156"></a>
+<span class="sourceLineNo">157</span> * {@link RestResource#staticFiles() @RestResource(staticFiles)} to <code>{<js>"htdocs:htdocs"</js>,<js>"styles:styles"</js>}</code>.<a name="line.157"></a>
+<span class="sourceLineNo">158</span> * This allows files inside the <code>[servletPackage].htdocs</code> package to be served up under the URL<a name="line.158"></a>
+<span class="sourceLineNo">159</span> * <code>/servletPath/htdocs</code>.<a name="line.159"></a>
+<span class="sourceLineNo">160</span> * </ul><a name="line.160"></a>
+<span class="sourceLineNo">161</span> *<a name="line.161"></a>
+<span class="sourceLineNo">162</span> * <h5 class='section'>See Also:</h5><a name="line.162"></a>
+<span class="sourceLineNo">163</span> * <ul><a name="line.163"></a>
+<span class="sourceLineNo">164</span> * <li class='link'>{@doc juneau-rest-server.Instantiation.BasicRestServlet}<a name="line.164"></a>
+<span class="sourceLineNo">165</span> * </ul><a name="line.165"></a>
+<span class="sourceLineNo">166</span> */<a name="line.166"></a>
+<span class="sourceLineNo">167</span>@RestResource(<a name="line.167"></a>
+<span class="sourceLineNo">168</span><a name="line.168"></a>
+<span class="sourceLineNo">169</span> // Allow OPTIONS requests to be simulated using ?method=OPTIONS query parameter.<a name="line.169"></a>
+<span class="sourceLineNo">170</span> allowedMethodParams="OPTIONS",<a name="line.170"></a>
+<span class="sourceLineNo">171</span><a name="line.171"></a>
+<span class="sourceLineNo">172</span> // HTML-page specific settings.<a name="line.172"></a>
+<span class="sourceLineNo">173</span> htmldoc=@HtmlDoc(<a name="line.173"></a>
+<span class="sourceLineNo">174</span> // Basic page navigation links.<a name="line.174"></a>
+<span class="sourceLineNo">175</span> navlinks={<a name="line.175"></a>
+<span class="sourceLineNo">176</span> "up: request:/..",<a name="line.176"></a>
+<span class="sourceLineNo">177</span> "options: servlet:/?method=OPTIONS"<a name="line.177"></a>
+<span class="sourceLineNo">178</span> }<a name="line.178"></a>
+<span class="sourceLineNo">179</span> )<a name="line.179"></a>
+<span class="sourceLineNo">180</span>)<a name="line.180"></a>
+<span class="sourceLineNo">181</span>public abstract class BasicRestServlet extends RestServlet implements BasicRestConfig {<a name="line.181"></a>
+<span class="sourceLineNo">182</span> private static final long serialVersionUID = 1L;<a name="line.182"></a>
+<span class="sourceLineNo">183</span><a name="line.183"></a>
+<span class="sourceLineNo">184</span> /**<a name="line.184"></a>
+<span class="sourceLineNo">185</span> * [OPTIONS /*] - Show resource options.<a name="line.185"></a>
+<span class="sourceLineNo">186</span> *<a name="line.186"></a>
+<span class="sourceLineNo">187</span> * @param req The HTTP request.<a name="line.187"></a>
+<span class="sourceLineNo">188</span> * @return A bean containing the contents for the OPTIONS page.<a name="line.188"></a>
+<span class="sourceLineNo">189</span> */<a name="line.189"></a>
+<span class="sourceLineNo">190</span> @RestMethod(name=OPTIONS, path="/*",<a name="line.190"></a>
+<span class="sourceLineNo">191</span><a name="line.191"></a>
+<span class="sourceLineNo">192</span> summary="Swagger documentation",<a name="line.192"></a>
+<span class="sourceLineNo">193</span> description="Swagger documentation for this resource.",<a name="line.193"></a>
+<span class="sourceLineNo">194</span><a name="line.194"></a>
+<span class="sourceLineNo">195</span> htmldoc=@HtmlDoc(<a name="line.195"></a>
+<span class="sourceLineNo">196</span> // Override the nav links for the swagger page.<a name="line.196"></a>
+<span class="sourceLineNo">197</span> navlinks={<a name="line.197"></a>
+<span class="sourceLineNo">198</span> "back: servlet:/",<a name="line.198"></a>
+<span class="sourceLineNo">199</span> "json: servlet:/?method=OPTIONS&Accept=text/json&plainText=true"<a name="line.199"></a>
+<span class="sourceLineNo">200</span> },<a name="line.200"></a>
+<span class="sourceLineNo">201</span> // Never show aside contents of page inherited from class.<a name="line.201"></a>
+<span class="sourceLineNo">202</span> aside="NONE"<a name="line.202"></a>
+<span class="sourceLineNo">203</span> ),<a name="line.203"></a>
+<span class="sourceLineNo">204</span><a name="line.204"></a>
+<span class="sourceLineNo">205</span> // POJO swaps to apply to all serializers/parsers on this method.<a name="line.205"></a>
+<span class="sourceLineNo">206</span> pojoSwaps={<a name="line.206"></a>
+<span class="sourceLineNo">207</span> // Use the SwaggerUI swap when rendering Swagger beans.<a name="line.207"></a>
+<span class="sourceLineNo">208</span> // This is a per-media-type swap that only applies to text/html requests.<a name="line.208"></a>
+<span class="sourceLineNo">209</span> SwaggerUI.class<a name="line.209"></a>
+<span class="sourceLineNo">210</span> },<a name="line.210"></a>
+<span class="sourceLineNo">211</span><a name="line.211"></a>
+<span class="sourceLineNo">212</span> // Properties to apply to all serializers/parsers and REST-specific API objects on this method.<a name="line.212"></a>
+<span class="sourceLineNo">213</span> properties={<a name="line.213"></a>
+<span class="sourceLineNo">214</span> // Add descriptions to the following types when not specified:<a name="line.214"></a>
+<span class="sourceLineNo">215</span> @Property(name=JSONSCHEMA_addDescriptionsTo, value="bean,collection,array,map,enum"),<a name="line.215"></a>
+<span class="sourceLineNo">216</span><a name="line.216"></a>
+<span class="sourceLineNo">217</span> // Add x-example to the following types:<a name="line.217"></a>
+<span class="sourceLineNo">218</span> @Property(name=JSONSCHEMA_addExamplesTo, value="bean,collection,array,map"),<a name="line.218"></a>
+<span class="sourceLineNo">219</span><a name="line.219"></a>
+<span class="sourceLineNo">220</span> // Don't generate schema information on the Swagger bean itself or HTML beans.<a name="line.220"></a>
+<span class="sourceLineNo">221</span> @Property(name=JSONSCHEMA_ignoreTypes, value="Swagger,org.apache.juneau.dto.html5.*")<a name="line.221"></a>
+<span class="sourceLineNo">222</span> },<a name="line.222"></a>
+<span class="sourceLineNo">223</span><a name="line.223"></a>
+<span class="sourceLineNo">224</span> // Shortcut for boolean properties.<a name="line.224"></a>
+<span class="sourceLineNo">225</span> flags={<a name="line.225"></a>
+<span class="sourceLineNo">226</span> // Use $ref references for bean definitions to reduce duplication in Swagger.<a name="line.226"></a>
+<span class="sourceLineNo">227</span> JSONSCHEMA_useBeanDefs<a name="line.227"></a>
+<span class="sourceLineNo">228</span> }<a name="line.228"></a>
+<span class="sourceLineNo">229</span> )<a name="line.229"></a>
+<span class="sourceLineNo">230</span> public Swagger getOptions(RestRequest req) {<a name="line.230"></a>
+<span class="sourceLineNo">231</span> // Localized Swagger for this resource is available through the RestRequest object.<a name="line.231"></a>
+<span class="sourceLineNo">232</span> return req.getSwagger();<a name="line.232"></a>
+<span class="sourceLineNo">233</span> }<a name="line.233"></a>
+<span class="sourceLineNo">234</span>}<a name="line.234"></a>
diff --git a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/RestContext.StaticFile.html b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/RestContext.StaticFile.html
index 6d3c91b..03751f1 100644
--- a/content/site/apidocs_preview/src-html/org/apache/juneau/rest/RestContext.StaticFile.html
+++ b/content/site/apidocs_preview/src-html/org/apache/juneau/rest/RestContext.StaticFile.html
@@ -49,4743 +49,4729 @@
<span class="sourceLineNo">041</span>import org.apache.juneau.httppart.bean.*;<a name="line.41"></a>
<span class="sourceLineNo">042</span>import org.apache.juneau.internal.*;<a name="line.42"></a>
<span class="sourceLineNo">043</span>import org.apache.juneau.json.*;<a name="line.43"></a>
-<span class="sourceLineNo">044</span>import org.apache.juneau.jsonschema.*;<a name="line.44"></a>
-<span class="sourceLineNo">045</span>import org.apache.juneau.msgpack.*;<a name="line.45"></a>
-<span class="sourceLineNo">046</span>import org.apache.juneau.oapi.*;<a name="line.46"></a>
-<span class="sourceLineNo">047</span>import org.apache.juneau.parser.*;<a name="line.47"></a>
-<span class="sourceLineNo">048</span>import org.apache.juneau.plaintext.*;<a name="line.48"></a>
-<span class="sourceLineNo">049</span>import org.apache.juneau.remote.*;<a name="line.49"></a>
-<span class="sourceLineNo">050</span>import org.apache.juneau.rest.annotation.*;<a name="line.50"></a>
-<span class="sourceLineNo">051</span>import org.apache.juneau.rest.converters.*;<a name="line.51"></a>
-<span class="sourceLineNo">052</span>import org.apache.juneau.rest.exception.*;<a name="line.52"></a>
-<span class="sourceLineNo">053</span>import org.apache.juneau.rest.helper.*;<a name="line.53"></a>
-<span class="sourceLineNo">054</span>import org.apache.juneau.rest.reshandlers.*;<a name="line.54"></a>
-<span class="sourceLineNo">055</span>import org.apache.juneau.rest.util.*;<a name="line.55"></a>
-<span class="sourceLineNo">056</span>import org.apache.juneau.rest.vars.*;<a name="line.56"></a>
-<span class="sourceLineNo">057</span>import org.apache.juneau.rest.widget.*;<a name="line.57"></a>
-<span class="sourceLineNo">058</span>import org.apache.juneau.serializer.*;<a name="line.58"></a>
-<span class="sourceLineNo">059</span>import org.apache.juneau.soap.*;<a name="line.59"></a>
-<span class="sourceLineNo">060</span>import org.apache.juneau.svl.*;<a name="line.60"></a>
-<span class="sourceLineNo">061</span>import org.apache.juneau.uon.*;<a name="line.61"></a>
-<span class="sourceLineNo">062</span>import org.apache.juneau.urlencoding.*;<a name="line.62"></a>
-<span class="sourceLineNo">063</span>import org.apache.juneau.utils.*;<a name="line.63"></a>
-<span class="sourceLineNo">064</span>import org.apache.juneau.xml.*;<a name="line.64"></a>
-<span class="sourceLineNo">065</span>import org.apache.juneau.xmlschema.*;<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> * Contains all the configuration on a REST resource and the entry points for handling REST calls.<a name="line.68"></a>
-<span class="sourceLineNo">069</span> *<a name="line.69"></a>
-<span class="sourceLineNo">070</span> * <h5 class='section'>See Also:</h5><a name="line.70"></a>
-<span class="sourceLineNo">071</span> * <ul><a name="line.71"></a>
-<span class="sourceLineNo">072</span> * <li class='link'>{@doc juneau-rest-server.RestContext}<a name="line.72"></a>
-<span class="sourceLineNo">073</span> * </ul><a name="line.73"></a>
-<span class="sourceLineNo">074</span> */<a name="line.74"></a>
-<span class="sourceLineNo">075</span>public final class RestContext extends BeanContext {<a name="line.75"></a>
-<span class="sourceLineNo">076</span><a name="line.76"></a>
-<span class="sourceLineNo">077</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.77"></a>
-<span class="sourceLineNo">078</span> // Configurable properties<a name="line.78"></a>
-<span class="sourceLineNo">079</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.79"></a>
-<span class="sourceLineNo">080</span><a name="line.80"></a>
-<span class="sourceLineNo">081</span> private static final String PREFIX = "RestContext.";<a name="line.81"></a>
-<span class="sourceLineNo">082</span><a name="line.82"></a>
-<span class="sourceLineNo">083</span> /**<a name="line.83"></a>
-<span class="sourceLineNo">084</span> * Configuration property: Allow body URL parameter.<a name="line.84"></a>
-<span class="sourceLineNo">085</span> *<a name="line.85"></a>
-<span class="sourceLineNo">086</span> * <h5 class='section'>Property:</h5><a name="line.86"></a>
-<span class="sourceLineNo">087</span> * <ul><a name="line.87"></a>
-<span class="sourceLineNo">088</span> * <li><b>Name:</b> <js>"RestContext.allowBodyParam.b"</js><a name="line.88"></a>
-<span class="sourceLineNo">089</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.89"></a>
-<span class="sourceLineNo">090</span> * <li><b>Default:</b> <jk>true</jk><a name="line.90"></a>
-<span class="sourceLineNo">091</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.91"></a>
-<span class="sourceLineNo">092</span> * <li><b>Annotations:</b><a name="line.92"></a>
-<span class="sourceLineNo">093</span> * <ul><a name="line.93"></a>
-<span class="sourceLineNo">094</span> * <li class='ja'>{@link RestResource#allowBodyParam()}<a name="line.94"></a>
-<span class="sourceLineNo">095</span> * </ul><a name="line.95"></a>
-<span class="sourceLineNo">096</span> * <li><b>Methods:</b><a name="line.96"></a>
-<span class="sourceLineNo">097</span> * <ul><a name="line.97"></a>
-<span class="sourceLineNo">098</span> * <li class='jm'>{@link RestContextBuilder#allowBodyParam(boolean)}<a name="line.98"></a>
-<span class="sourceLineNo">099</span> * </ul><a name="line.99"></a>
-<span class="sourceLineNo">100</span> * </ul><a name="line.100"></a>
-<span class="sourceLineNo">101</span> *<a name="line.101"></a>
-<span class="sourceLineNo">102</span> * <h5 class='section'>Description:</h5><a name="line.102"></a>
-<span class="sourceLineNo">103</span> * <p><a name="line.103"></a>
-<span class="sourceLineNo">104</span> * When enabled, the HTTP body content on PUT and POST requests can be passed in as text using the <js>"body"</js><a name="line.104"></a>
-<span class="sourceLineNo">105</span> * URL parameter.<a name="line.105"></a>
-<span class="sourceLineNo">106</span> * <br><a name="line.106"></a>
-<span class="sourceLineNo">107</span> * For example:<a name="line.107"></a>
-<span class="sourceLineNo">108</span> * <p class='bcode w800'><a name="line.108"></a>
-<span class="sourceLineNo">109</span> * ?body=(name='John%20Smith',age=45)<a name="line.109"></a>
-<span class="sourceLineNo">110</span> * </p><a name="line.110"></a>
-<span class="sourceLineNo">111</span> *<a name="line.111"></a>
-<span class="sourceLineNo">112</span> * <h5 class='section'>Example:</h5><a name="line.112"></a>
-<span class="sourceLineNo">113</span> * <p class='bcode w800'><a name="line.113"></a>
-<span class="sourceLineNo">114</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.114"></a>
-<span class="sourceLineNo">115</span> * <ja>@RestResource</ja>(allowBodyParam=<js>"$C{REST/allowBodyParam,false}"</js>)<a name="line.115"></a>
-<span class="sourceLineNo">116</span> * <jk>public class</jk> MyResource {<a name="line.116"></a>
-<span class="sourceLineNo">117</span> *<a name="line.117"></a>
-<span class="sourceLineNo">118</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.118"></a>
-<span class="sourceLineNo">119</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.119"></a>
-<span class="sourceLineNo">120</span> *<a name="line.120"></a>
-<span class="sourceLineNo">121</span> * <jc>// Using method on builder.</jc><a name="line.121"></a>
-<span class="sourceLineNo">122</span> * builder.allowBodyParam(<jk>false</jk>);<a name="line.122"></a>
-<span class="sourceLineNo">123</span> *<a name="line.123"></a>
-<span class="sourceLineNo">124</span> * <jc>// Same, but using property.</jc><a name="line.124"></a>
-<span class="sourceLineNo">125</span> * builder.set(<jsf>REST_allowBodyParam</jsf>, <jk>false</jk>);<a name="line.125"></a>
-<span class="sourceLineNo">126</span> * }<a name="line.126"></a>
-<span class="sourceLineNo">127</span> *<a name="line.127"></a>
-<span class="sourceLineNo">128</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.128"></a>
-<span class="sourceLineNo">129</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.129"></a>
-<span class="sourceLineNo">130</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.130"></a>
-<span class="sourceLineNo">131</span> * builder.allowBodyParam(<jk>false</jk>);<a name="line.131"></a>
-<span class="sourceLineNo">132</span> * }<a name="line.132"></a>
-<span class="sourceLineNo">133</span> * }<a name="line.133"></a>
-<span class="sourceLineNo">134</span> * </p><a name="line.134"></a>
-<span class="sourceLineNo">135</span> *<a name="line.135"></a>
-<span class="sourceLineNo">136</span> * <h5 class='section'>Notes:</h5><a name="line.136"></a>
-<span class="sourceLineNo">137</span> * <ul class='spaced-list'><a name="line.137"></a>
-<span class="sourceLineNo">138</span> * <li><a name="line.138"></a>
-<span class="sourceLineNo">139</span> * <js>'body'</js> parameter name is case-insensitive.<a name="line.139"></a>
-<span class="sourceLineNo">140</span> * <li><a name="line.140"></a>
-<span class="sourceLineNo">141</span> * Useful for debugging PUT and POST methods using only a browser.<a name="line.141"></a>
-<span class="sourceLineNo">142</span> * </ul><a name="line.142"></a>
-<span class="sourceLineNo">143</span> */<a name="line.143"></a>
-<span class="sourceLineNo">144</span> public static final String REST_allowBodyParam = PREFIX + "allowBodyParam.b";<a name="line.144"></a>
-<span class="sourceLineNo">145</span><a name="line.145"></a>
-<span class="sourceLineNo">146</span> /**<a name="line.146"></a>
-<span class="sourceLineNo">147</span> * Configuration property: Allowed method parameters.<a name="line.147"></a>
-<span class="sourceLineNo">148</span> *<a name="line.148"></a>
-<span class="sourceLineNo">149</span> * <h5 class='section'>Property:</h5><a name="line.149"></a>
-<span class="sourceLineNo">150</span> * <ul><a name="line.150"></a>
-<span class="sourceLineNo">151</span> * <li><b>Name:</b> <js>"RestContext.allowedMethodParams.s"</js><a name="line.151"></a>
-<span class="sourceLineNo">152</span> * <li><b>Data type:</b> <code>String</code><a name="line.152"></a>
-<span class="sourceLineNo">153</span> * <li><b>Default:</b> <js>"HEAD,OPTIONS"</js><a name="line.153"></a>
-<span class="sourceLineNo">154</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.154"></a>
-<span class="sourceLineNo">155</span> * <li><b>Annotations:</b><a name="line.155"></a>
-<span class="sourceLineNo">156</span> * <ul><a name="line.156"></a>
-<span class="sourceLineNo">157</span> * <li class='ja'>{@link RestResource#allowedMethodParams()}<a name="line.157"></a>
-<span class="sourceLineNo">158</span> * </ul><a name="line.158"></a>
-<span class="sourceLineNo">159</span> * <li><b>Methods:</b><a name="line.159"></a>
-<span class="sourceLineNo">160</span> * <ul><a name="line.160"></a>
-<span class="sourceLineNo">161</span> * <li class='jm'>{@link RestContextBuilder#allowedMethodParams(String...)}<a name="line.161"></a>
-<span class="sourceLineNo">162</span> * </ul><a name="line.162"></a>
-<span class="sourceLineNo">163</span> * </ul><a name="line.163"></a>
-<span class="sourceLineNo">164</span> *<a name="line.164"></a>
-<span class="sourceLineNo">165</span> * <h5 class='section'>Description:</h5><a name="line.165"></a>
-<span class="sourceLineNo">166</span> * <p><a name="line.166"></a>
-<span class="sourceLineNo">167</span> * When specified, the HTTP method can be overridden by passing in a <js>"method"</js> URL parameter on a regular<a name="line.167"></a>
-<span class="sourceLineNo">168</span> * GET request.<a name="line.168"></a>
-<span class="sourceLineNo">169</span> * <br><a name="line.169"></a>
-<span class="sourceLineNo">170</span> * For example:<a name="line.170"></a>
-<span class="sourceLineNo">171</span> * <p class='bcode w800'><a name="line.171"></a>
-<span class="sourceLineNo">172</span> * ?method=OPTIONS<a name="line.172"></a>
-<span class="sourceLineNo">173</span> * </p><a name="line.173"></a>
-<span class="sourceLineNo">174</span> *<a name="line.174"></a>
-<span class="sourceLineNo">175</span> * <h5 class='section'>Example:</h5><a name="line.175"></a>
-<span class="sourceLineNo">176</span> * <p class='bcode w800'><a name="line.176"></a>
-<span class="sourceLineNo">177</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.177"></a>
-<span class="sourceLineNo">178</span> * <ja>@RestResource</ja>(allowMethodParams=<js>"$C{REST/allowMethodParams,HEAD\,OPTIONS\,PUT}"</js>)<a name="line.178"></a>
-<span class="sourceLineNo">179</span> * <jk>public class</jk> MyResource {<a name="line.179"></a>
-<span class="sourceLineNo">180</span> *<a name="line.180"></a>
-<span class="sourceLineNo">181</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.181"></a>
-<span class="sourceLineNo">182</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.182"></a>
-<span class="sourceLineNo">183</span> *<a name="line.183"></a>
-<span class="sourceLineNo">184</span> * <jc>// Using method on builder.</jc><a name="line.184"></a>
-<span class="sourceLineNo">185</span> * builder.allowMethodParams(<js>"HEAD,OPTIONS,PUT"</js>);<a name="line.185"></a>
-<span class="sourceLineNo">186</span> *<a name="line.186"></a>
-<span class="sourceLineNo">187</span> * <jc>// Same, but using property.</jc><a name="line.187"></a>
-<span class="sourceLineNo">188</span> * builder.set(<jsf>REST_allowMethodParams</jsf>, <js>"HEAD,OPTIONS,PUT"</js>);<a name="line.188"></a>
-<span class="sourceLineNo">189</span> * }<a name="line.189"></a>
-<span class="sourceLineNo">190</span> *<a name="line.190"></a>
-<span class="sourceLineNo">191</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.191"></a>
-<span class="sourceLineNo">192</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.192"></a>
-<span class="sourceLineNo">193</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.193"></a>
-<span class="sourceLineNo">194</span> * builder.allowMethodParams(<js>"HEAD"</js>, <js>"OPTIONS"</js>, <js>"PUT"</js>);<a name="line.194"></a>
-<span class="sourceLineNo">195</span> * }<a name="line.195"></a>
-<span class="sourceLineNo">196</span> * }<a name="line.196"></a>
-<span class="sourceLineNo">197</span> * </p><a name="line.197"></a>
-<span class="sourceLineNo">198</span> *<a name="line.198"></a>
-<span class="sourceLineNo">199</span> * <h5 class='section'>Notes:</h5><a name="line.199"></a>
-<span class="sourceLineNo">200</span> * <ul class='spaced-list'><a name="line.200"></a>
-<span class="sourceLineNo">201</span> * <li><a name="line.201"></a>
-<span class="sourceLineNo">202</span> * Format is a comma-delimited list of HTTP method names that can be passed in as a method parameter.<a name="line.202"></a>
-<span class="sourceLineNo">203</span> * <li><a name="line.203"></a>
-<span class="sourceLineNo">204</span> * <js>'method'</js> parameter name is case-insensitive.<a name="line.204"></a>
-<span class="sourceLineNo">205</span> * <li><a name="line.205"></a>
-<span class="sourceLineNo">206</span> * Use <js>"*"</js> to represent all methods.<a name="line.206"></a>
-<span class="sourceLineNo">207</span> * </ul><a name="line.207"></a>
-<span class="sourceLineNo">208</span> *<a name="line.208"></a>
-<span class="sourceLineNo">209</span> * <p><a name="line.209"></a>
-<span class="sourceLineNo">210</span> * Note that per the {@doc RFC2616.section9 HTTP specification}, special care should<a name="line.210"></a>
-<span class="sourceLineNo">211</span> * be taken when allowing non-safe (POST, PUT, DELETE) methods to be invoked through GET requests.<a name="line.211"></a>
-<span class="sourceLineNo">212</span> */<a name="line.212"></a>
-<span class="sourceLineNo">213</span> public static final String REST_allowedMethodParams = PREFIX + "allowedMethodParams.s";<a name="line.213"></a>
-<span class="sourceLineNo">214</span><a name="line.214"></a>
-<span class="sourceLineNo">215</span> /**<a name="line.215"></a>
-<span class="sourceLineNo">216</span> * Configuration property: Allow header URL parameters.<a name="line.216"></a>
-<span class="sourceLineNo">217</span> *<a name="line.217"></a>
-<span class="sourceLineNo">218</span> * <h5 class='section'>Property:</h5><a name="line.218"></a>
-<span class="sourceLineNo">219</span> * <ul><a name="line.219"></a>
-<span class="sourceLineNo">220</span> * <li><b>Name:</b> <js>"RestContext.allowHeaderParams.b"</js><a name="line.220"></a>
-<span class="sourceLineNo">221</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.221"></a>
-<span class="sourceLineNo">222</span> * <li><b>Default:</b> <jk>true</jk><a name="line.222"></a>
-<span class="sourceLineNo">223</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.223"></a>
-<span class="sourceLineNo">224</span> * <li><b>Annotations:</b><a name="line.224"></a>
-<span class="sourceLineNo">225</span> * <ul><a name="line.225"></a>
-<span class="sourceLineNo">226</span> * <li class='ja'>{@link RestResource#allowHeaderParams()}<a name="line.226"></a>
-<span class="sourceLineNo">227</span> * </ul><a name="line.227"></a>
-<span class="sourceLineNo">228</span> * <li><b>Methods:</b><a name="line.228"></a>
-<span class="sourceLineNo">229</span> * <ul><a name="line.229"></a>
-<span class="sourceLineNo">230</span> * <li class='jm'>{@link RestContextBuilder#allowHeaderParams(boolean)}<a name="line.230"></a>
-<span class="sourceLineNo">231</span> * </ul><a name="line.231"></a>
-<span class="sourceLineNo">232</span> * </ul><a name="line.232"></a>
-<span class="sourceLineNo">233</span> *<a name="line.233"></a>
-<span class="sourceLineNo">234</span> * <h5 class='section'>Description:</h5><a name="line.234"></a>
-<span class="sourceLineNo">235</span> * <p><a name="line.235"></a>
-<span class="sourceLineNo">236</span> * When enabled, headers such as <js>"Accept"</js> and <js>"Content-Type"</js> to be passed in as URL query<a name="line.236"></a>
-<span class="sourceLineNo">237</span> * parameters.<a name="line.237"></a>
-<span class="sourceLineNo">238</span> * <br><a name="line.238"></a>
-<span class="sourceLineNo">239</span> * For example:<a name="line.239"></a>
-<span class="sourceLineNo">240</span> * <p class='bcode w800'><a name="line.240"></a>
-<span class="sourceLineNo">241</span> * ?Accept=text/json&amp;Content-Type=text/json<a name="line.241"></a>
-<span class="sourceLineNo">242</span> * </p><a name="line.242"></a>
-<span class="sourceLineNo">243</span> *<a name="line.243"></a>
-<span class="sourceLineNo">244</span> * <h5 class='section'>Example:</h5><a name="line.244"></a>
-<span class="sourceLineNo">245</span> * <p class='bcode w800'><a name="line.245"></a>
-<span class="sourceLineNo">246</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.246"></a>
-<span class="sourceLineNo">247</span> * <ja>@RestResource</ja>(allowMethodParams=<js>"$C{REST/allowHeaderParams,false}"</js>)<a name="line.247"></a>
-<span class="sourceLineNo">248</span> * <jk>public class</jk> MyResource {<a name="line.248"></a>
-<span class="sourceLineNo">249</span> *<a name="line.249"></a>
-<span class="sourceLineNo">250</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.250"></a>
-<span class="sourceLineNo">251</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.251"></a>
-<span class="sourceLineNo">252</span> *<a name="line.252"></a>
-<span class="sourceLineNo">253</span> * <jc>// Using method on builder.</jc><a name="line.253"></a>
-<span class="sourceLineNo">254</span> * builder.allowHeaderParams(<jk>false</jk>);<a name="line.254"></a>
-<span class="sourceLineNo">255</span> *<a name="line.255"></a>
-<span class="sourceLineNo">256</span> * <jc>// Same, but using property.</jc><a name="line.256"></a>
-<span class="sourceLineNo">257</span> * builder.set(<jsf>REST_allowHeaderParams</jsf>, <jk>false</jk>);<a name="line.257"></a>
-<span class="sourceLineNo">258</span> * }<a name="line.258"></a>
-<span class="sourceLineNo">259</span> *<a name="line.259"></a>
-<span class="sourceLineNo">260</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.260"></a>
-<span class="sourceLineNo">261</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.261"></a>
-<span class="sourceLineNo">262</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.262"></a>
-<span class="sourceLineNo">263</span> * builder.allowHeaderParams(<jk>false</jk>);<a name="line.263"></a>
-<span class="sourceLineNo">264</span> * }<a name="line.264"></a>
-<span class="sourceLineNo">265</span> * }<a name="line.265"></a>
-<span class="sourceLineNo">266</span> * </p><a name="line.266"></a>
-<span class="sourceLineNo">267</span> *<a name="line.267"></a>
-<span class="sourceLineNo">268</span> * <h5 class='section'>Notes:</h5><a name="line.268"></a>
-<span class="sourceLineNo">269</span> * <ul class='spaced-list'><a name="line.269"></a>
-<span class="sourceLineNo">270</span> * <li><a name="line.270"></a>
-<span class="sourceLineNo">271</span> * Header names are case-insensitive.<a name="line.271"></a>
-<span class="sourceLineNo">272</span> * <li><a name="line.272"></a>
-<span class="sourceLineNo">273</span> * Useful for debugging REST interface using only a browser.<a name="line.273"></a>
-<span class="sourceLineNo">274</span> * </ul><a name="line.274"></a>
-<span class="sourceLineNo">275</span> */<a name="line.275"></a>
-<span class="sourceLineNo">276</span> public static final String REST_allowHeaderParams = PREFIX + "allowHeaderParams.b";<a name="line.276"></a>
-<span class="sourceLineNo">277</span><a name="line.277"></a>
-<span class="sourceLineNo">278</span> /**<a name="line.278"></a>
-<span class="sourceLineNo">279</span> * Configuration property: REST call handler.<a name="line.279"></a>
-<span class="sourceLineNo">280</span> *<a name="line.280"></a>
-<span class="sourceLineNo">281</span> * <h5 class='section'>Property:</h5><a name="line.281"></a>
-<span class="sourceLineNo">282</span> * <ul><a name="line.282"></a>
-<span class="sourceLineNo">283</span> * <li><b>Name:</b> <js>"RestContext.callHandler.o"</js><a name="line.283"></a>
-<span class="sourceLineNo">284</span> * <li><b>Data type:</b> {@link RestCallHandler} | <code>Class&lt;? <jk>extends</jk> {@link RestCallHandler}&gt;</code><a name="line.284"></a>
-<span class="sourceLineNo">285</span> * <li><b>Default:</b> {@link BasicRestCallHandler}<a name="line.285"></a>
-<span class="sourceLineNo">286</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.286"></a>
-<span class="sourceLineNo">287</span> * <li><b>Annotations:</b><a name="line.287"></a>
-<span class="sourceLineNo">288</span> * <ul><a name="line.288"></a>
-<span class="sourceLineNo">289</span> * <li class='ja'>{@link RestResource#callHandler()}<a name="line.289"></a>
-<span class="sourceLineNo">290</span> * </ul><a name="line.290"></a>
-<span class="sourceLineNo">291</span> * <li><b>Methods:</b><a name="line.291"></a>
-<span class="sourceLineNo">292</span> * <ul><a name="line.292"></a>
-<span class="sourceLineNo">293</span> * <li class='jm'>{@link RestContextBuilder#callHandler(Class)}<a name="line.293"></a>
-<span class="sourceLineNo">294</span> * <li class='jm'>{@link RestContextBuilder#callHandler(RestCallHandler)}<a name="line.294"></a>
-<span class="sourceLineNo">295</span> * </ul><a name="line.295"></a>
-<span class="sourceLineNo">296</span> * </ul><a name="line.296"></a>
-<span class="sourceLineNo">297</span> *<a name="line.297"></a>
-<span class="sourceLineNo">298</span> * <h5 class='section'>Description:</h5><a name="line.298"></a>
-<span class="sourceLineNo">299</span> * <p><a name="line.299"></a>
-<span class="sourceLineNo">300</span> * This class handles the basic lifecycle of an HTTP REST call.<a name="line.300"></a>
-<span class="sourceLineNo">301</span> * <br>Subclasses can be used to customize how these HTTP calls are handled.<a name="line.301"></a>
-<span class="sourceLineNo">302</span> *<a name="line.302"></a>
-<span class="sourceLineNo">303</span> * <h5 class='section'>Example:</h5><a name="line.303"></a>
-<span class="sourceLineNo">304</span> * <p class='bcode w800'><a name="line.304"></a>
-<span class="sourceLineNo">305</span> * <jc>// Our customized call handler.</jc><a name="line.305"></a>
-<span class="sourceLineNo">306</span> * <jk>public class</jk> MyRestCallHandler <jk>extends</jk> BasicRestCallHandler {<a name="line.306"></a>
-<span class="sourceLineNo">307</span> *<a name="line.307"></a>
-<span class="sourceLineNo">308</span> * <jc>// Must provide this constructor!</jc><a name="line.308"></a>
-<span class="sourceLineNo">309</span> * <jk>public</jk> MyRestCallHandler(RestContext context) {<a name="line.309"></a>
-<span class="sourceLineNo">310</span> * <jk>super</jk>(context);<a name="line.310"></a>
-<span class="sourceLineNo">311</span> * }<a name="line.311"></a>
-<span class="sourceLineNo">312</span> *<a name="line.312"></a>
-<span class="sourceLineNo">313</span> * <ja>@Override</ja><a name="line.313"></a>
-<span class="sourceLineNo">314</span> * <jk>public</jk> RestRequest createRequest(HttpServletRequest req) <jk>throws</jk> ServletException {<a name="line.314"></a>
-<span class="sourceLineNo">315</span> * <jc>// Low-level handling of requests.</jc><a name="line.315"></a>
-<span class="sourceLineNo">316</span> * ...<a name="line.316"></a>
-<span class="sourceLineNo">317</span> * }<a name="line.317"></a>
-<span class="sourceLineNo">318</span> *<a name="line.318"></a>
-<span class="sourceLineNo">319</span> * <ja>@Override</ja><a name="line.319"></a>
-<span class="sourceLineNo">320</span> * <jk>public void</jk> handleResponse(RestRequest req, RestResponse res, Object output) <jk>throws</jk> IOException, RestException {<a name="line.320"></a>
-<span class="sourceLineNo">321</span> * <jc>// Low-level handling of responses.</jc><a name="line.321"></a>
-<span class="sourceLineNo">322</span> * ...<a name="line.322"></a>
-<span class="sourceLineNo">323</span> * }<a name="line.323"></a>
-<span class="sourceLineNo">324</span> *<a name="line.324"></a>
-<span class="sourceLineNo">325</span> * <ja>@Override</ja><a name="line.325"></a>
-<span class="sourceLineNo">326</span> * <jk>public void</jk> handleNotFound(int rc, RestRequest req, RestResponse res) <jk>throws</jk> Exception {<a name="line.326"></a>
-<span class="sourceLineNo">327</span> * <jc>// Low-level handling of various error conditions.</jc><a name="line.327"></a>
-<span class="sourceLineNo">328</span> * ...<a name="line.328"></a>
-<span class="sourceLineNo">329</span> * }<a name="line.329"></a>
-<span class="sourceLineNo">330</span> * }<a name="line.330"></a>
-<span class="sourceLineNo">331</span> *<a name="line.331"></a>
-<span class="sourceLineNo">332</span> * <jc>// Option #1 - Registered via annotation resolving to a config file setting with default value.</jc><a name="line.332"></a>
-<span class="sourceLineNo">333</span> * <ja>@RestResource</ja>(callHandler=MyRestCallHandler.<jk>class</jk>)<a name="line.333"></a>
-<span class="sourceLineNo">334</span> * <jk>public class</jk> MyResource {<a name="line.334"></a>
-<span class="sourceLineNo">335</span> *<a name="line.335"></a>
-<span class="sourceLineNo">336</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.336"></a>
-<span class="sourceLineNo">337</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.337"></a>
-<span class="sourceLineNo">338</span> *<a name="line.338"></a>
-<span class="sourceLineNo">339</span> * <jc>// Using method on builder.</jc><a name="line.339"></a>
-<span class="sourceLineNo">340</span> * builder.callHandler(MyRestCallHandler.<jk>class</jk>);<a name="line.340"></a>
-<span class="sourceLineNo">341</span> *<a name="line.341"></a>
-<span class="sourceLineNo">342</span> * <jc>// Same, but using property.</jc><a name="line.342"></a>
-<span class="sourceLineNo">343</span> * builder.set(<jsf>REST_callHandler</jsf>, MyRestCallHandler.<jk>class</jk>);<a name="line.343"></a>
-<span class="sourceLineNo">344</span> * }<a name="line.344"></a>
-<span class="sourceLineNo">345</span> *<a name="line.345"></a>
-<span class="sourceLineNo">346</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.346"></a>
-<span class="sourceLineNo">347</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.347"></a>
-<span class="sourceLineNo">348</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.348"></a>
-<span class="sourceLineNo">349</span> * builder.callHandler(MyRestCallHandler.<jk>class</jk>);<a name="line.349"></a>
-<span class="sourceLineNo">350</span> * }<a name="line.350"></a>
-<span class="sourceLineNo">351</span> * }<a name="line.351"></a>
-<span class="sourceLineNo">352</span> * </p><a name="line.352"></a>
-<span class="sourceLineNo">353</span> *<a name="line.353"></a>
-<span class="sourceLineNo">354</span> * <h5 class='section'>Notes:</h5><a name="line.354"></a>
-<span class="sourceLineNo">355</span> * <ul class='spaced-list'><a name="line.355"></a>
-<span class="sourceLineNo">356</span> * <li><a name="line.356"></a>
-<span class="sourceLineNo">357</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.357"></a>
-<span class="sourceLineNo">358</span> * <ul><a name="line.358"></a>
-<span class="sourceLineNo">359</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.359"></a>
-<span class="sourceLineNo">360</span> * <li><code><jk>public</jk> T()</code><a name="line.360"></a>
-<span class="sourceLineNo">361</span> * </ul><a name="line.361"></a>
-<span class="sourceLineNo">362</span> * <li><a name="line.362"></a>
-<span class="sourceLineNo">363</span> * Inner classes of the REST resource class are allowed.<a name="line.363"></a>
-<span class="sourceLineNo">364</span> * </ul><a name="line.364"></a>
-<span class="sourceLineNo">365</span> */<a name="line.365"></a>
-<span class="sourceLineNo">366</span> public static final String REST_callHandler = PREFIX + "callHandler.o";<a name="line.366"></a>
-<span class="sourceLineNo">367</span><a name="line.367"></a>
-<span class="sourceLineNo">368</span> /**<a name="line.368"></a>
-<span class="sourceLineNo">369</span> * Configuration property: Children.<a name="line.369"></a>
-<span class="sourceLineNo">370</span> *<a name="line.370"></a>
-<span class="sourceLineNo">371</span> * <h5 class='section'>Property:</h5><a name="line.371"></a>
-<span class="sourceLineNo">372</span> * <ul><a name="line.372"></a>
-<span class="sourceLineNo">373</span> * <li><b>Name:</b> <js>"RestContext.children.lo"</js><a name="line.373"></a>
-<span class="sourceLineNo">374</span> * <li><b>Data type:</b> <code>List&lt;Class | Object | {@link RestChild}&gt;</code><a name="line.374"></a>
-<span class="sourceLineNo">375</span> * <li><b>Default:</b> empty list<a name="line.375"></a>
-<span class="sourceLineNo">376</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.376"></a>
-<span class="sourceLineNo">377</span> * <li><b>Annotations:</b><a name="line.377"></a>
-<span class="sourceLineNo">378</span> * <ul><a name="line.378"></a>
-<span class="sourceLineNo">379</span> * <li class='ja'>{@link RestResource#children()}<a name="line.379"></a>
-<span class="sourceLineNo">380</span> * </ul><a name="line.380"></a>
-<span class="sourceLineNo">381</span> * <li><b>Methods:</b><a name="line.381"></a>
-<span class="sourceLineNo">382</span> * <ul><a name="line.382"></a>
-<span class="sourceLineNo">383</span> * <li class='jm'>{@link RestContextBuilder#child(String,Object)}<a name="line.383"></a>
-<span class="sourceLineNo">384</span> * <li class='jm'>{@link RestContextBuilder#children(Class...)}<a name="line.384"></a>
-<span class="sourceLineNo">385</span> * <li class='jm'>{@link RestContextBuilder#children(Object...)}<a name="line.385"></a>
-<span class="sourceLineNo">386</span> * </ul><a name="line.386"></a>
-<span class="sourceLineNo">387</span> * </ul><a name="line.387"></a>
-<span class="sourceLineNo">388</span> *<a name="line.388"></a>
-<span class="sourceLineNo">389</span> * <h5 class='section'>Description:</h5><a name="line.389"></a>
-<span class="sourceLineNo">390</span> * <p><a name="line.390"></a>
-<span class="sourceLineNo">391</span> * Defines children of this resource.<a name="line.391"></a>
-<span class="sourceLineNo">392</span> *<a name="line.392"></a>
-<span class="sourceLineNo">393</span> * <p><a name="line.393"></a>
-<span class="sourceLineNo">394</span> * A REST child resource is simply another servlet or object that is initialized as part of the ascendant resource and has a<a name="line.394"></a>
-<span class="sourceLineNo">395</span> * servlet path directly under the ascendant resource object path.<a name="line.395"></a>
-<span class="sourceLineNo">396</span> * <br>The main advantage to defining servlets as REST children is that you do not need to define them in the<a name="line.396"></a>
-<span class="sourceLineNo">397</span> * <code>web.xml</code> file of the web application.<a name="line.397"></a>
-<span class="sourceLineNo">398</span> * <br>This can cut down on the number of entries that show up in the <code>web.xml</code> file if you are defining<a name="line.398"></a>
-<span class="sourceLineNo">399</span> * large numbers of servlets.<a name="line.399"></a>
-<span class="sourceLineNo">400</span> *<a name="line.400"></a>
-<span class="sourceLineNo">401</span> * <p><a name="line.401"></a>
-<span class="sourceLineNo">402</span> * Child resources must specify a value for {@link RestResource#path() @RestResource(path)} that identifies the subpath of the child resource<a name="line.402"></a>
-<span class="sourceLineNo">403</span> * relative to the ascendant path UNLESS you use the {@link RestContextBuilder#child(String, Object)} method to register it.<a name="line.403"></a>
-<span class="sourceLineNo">404</span> *<a name="line.404"></a>
-<span class="sourceLineNo">405</span> * <p><a name="line.405"></a>
-<span class="sourceLineNo">406</span> * Child resources can be nested arbitrarily deep using this technique (i.e. children can also have children).<a name="line.406"></a>
-<span class="sourceLineNo">407</span> *<a name="line.407"></a>
-<span class="sourceLineNo">408</span> * <dl><a name="line.408"></a>
-<span class="sourceLineNo">409</span> * <dt>Servlet initialization:</dt><a name="line.409"></a>
-<span class="sourceLineNo">410</span> * <dd><a name="line.410"></a>
-<span class="sourceLineNo">411</span> * <p><a name="line.411"></a>
-<span class="sourceLineNo">412</span> * A child resource will be initialized immediately after the ascendant servlet/resource is initialized.<a name="line.412"></a>
-<span class="sourceLineNo">413</span> * <br>The child resource receives the same servlet config as the ascendant servlet/resource.<a name="line.413"></a>
-<span class="sourceLineNo">414</span> * <br>This allows configuration information such as servlet initialization parameters to filter to child<a name="line.414"></a>
-<span class="sourceLineNo">415</span> * resources.<a name="line.415"></a>
-<span class="sourceLineNo">416</span> * </p><a name="line.416"></a>
-<span class="sourceLineNo">417</span> * </dd><a name="line.417"></a>
-<span class="sourceLineNo">418</span> * <dt>Runtime behavior:</dt><a name="line.418"></a>
-<span class="sourceLineNo">419</span> * <dd><a name="line.419"></a>
-<span class="sourceLineNo">420</span> * <p><a name="line.420"></a>
-<span class="sourceLineNo">421</span> * As a rule, methods defined on the <code>HttpServletRequest</code> object will behave as if the child<a name="line.421"></a>
-<span class="sourceLineNo">422</span> * servlet were deployed as a top-level resource under the child's servlet path.<a name="line.422"></a>
-<span class="sourceLineNo">423</span> * <br>For example, the <code>getServletPath()</code> and <code>getPathInfo()</code> methods on the<a name="line.423"></a>
-<span class="sourceLineNo">424</span> * <code>HttpServletRequest</code> object will behave as if the child resource were deployed using the<a name="line.424"></a>
-<span class="sourceLineNo">425</span> * child's servlet path.<a name="line.425"></a>
-<span class="sourceLineNo">426</span> * <br>Therefore, the runtime behavior should be equivalent to deploying the child servlet in the<a name="line.426"></a>
-<span class="sourceLineNo">427</span> * <code>web.xml</code> file of the web application.<a name="line.427"></a>
-<span class="sourceLineNo">428</span> * </p><a name="line.428"></a>
-<span class="sourceLineNo">429</span> * </dd><a name="line.429"></a>
-<span class="sourceLineNo">430</span> * </dl><a name="line.430"></a>
-<span class="sourceLineNo">431</span> *<a name="line.431"></a>
-<span class="sourceLineNo">432</span> * <h5 class='section'>Example:</h5><a name="line.432"></a>
-<span class="sourceLineNo">433</span> * <p class='bcode w800'><a name="line.433"></a>
-<span class="sourceLineNo">434</span> * <jc>// Our child resource.</jc><a name="line.434"></a>
-<span class="sourceLineNo">435</span> * <ja>@RestResource</ja>(path=<js>"/child"</js>)<a name="line.435"></a>
-<span class="sourceLineNo">436</span> * <jk>public class</jk> MyChildResource {...}<a name="line.436"></a>
-<span class="sourceLineNo">437</span> *<a name="line.437"></a>
-<span class="sourceLineNo">438</span> * <jc>// Option #1 - Registered via annotation.</jc><a name="line.438"></a>
-<span class="sourceLineNo">439</span> * <ja>@RestResource</ja>(children={MyChildResource.<jk>class</jk>})<a name="line.439"></a>
-<span class="sourceLineNo">440</span> * <jk>public class</jk> MyResource {<a name="line.440"></a>
-<span class="sourceLineNo">441</span> *<a name="line.441"></a>
-<span class="sourceLineNo">442</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.442"></a>
-<span class="sourceLineNo">443</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.443"></a>
-<span class="sourceLineNo">444</span> *<a name="line.444"></a>
-<span class="sourceLineNo">445</span> * <jc>// Using method on builder.</jc><a name="line.445"></a>
-<span class="sourceLineNo">446</span> * builder.children(MyChildResource.<jk>class</jk>);<a name="line.446"></a>
-<span class="sourceLineNo">447</span> *<a name="line.447"></a>
-<span class="sourceLineNo">448</span> * <jc>// Same, but using property.</jc><a name="line.448"></a>
-<span class="sourceLineNo">449</span> * builder.addTo(<jsf>REST_children</jsf>, MyChildResource.<jk>class</jk>));<a name="line.449"></a>
-<span class="sourceLineNo">450</span> *<a name="line.450"></a>
-<span class="sourceLineNo">451</span> * <jc>// Use a pre-instantiated object instead.</jc><a name="line.451"></a>
-<span class="sourceLineNo">452</span> * builder.child(<js>"/child"</js>, <jk>new</jk> MyChildResource());<a name="line.452"></a>
-<span class="sourceLineNo">453</span> * }<a name="line.453"></a>
-<span class="sourceLineNo">454</span> *<a name="line.454"></a>
-<span class="sourceLineNo">455</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.455"></a>
-<span class="sourceLineNo">456</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.456"></a>
-<span class="sourceLineNo">457</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.457"></a>
-<span class="sourceLineNo">458</span> * builder.children(MyChildResource.<jk>class</jk>);<a name="line.458"></a>
-<span class="sourceLineNo">459</span> * }<a name="line.459"></a>
-<span class="sourceLineNo">460</span> * }<a name="line.460"></a>
-<span class="sourceLineNo">461</span> *<a name="line.461"></a>
-<span class="sourceLineNo">462</span> * <h5 class='section'>Notes:</h5><a name="line.462"></a>
-<span class="sourceLineNo">463</span> * <ul class='spaced-list'><a name="line.463"></a>
-<span class="sourceLineNo">464</span> * <li><a name="line.464"></a>
-<span class="sourceLineNo">465</span> * When defined as classes, instances are resolved using the registered {@link #REST_resourceResolver} which<a name="line.465"></a>
-<span class="sourceLineNo">466</span> * by default is {@link BasicRestResourceResolver} which requires the class have one of the following<a name="line.466"></a>
-<span class="sourceLineNo">467</span> * constructors:<a name="line.467"></a>
-<span class="sourceLineNo">468</span> * <ul><a name="line.468"></a>
-<span class="sourceLineNo">469</span> * <li><code><jk>public</jk> T(RestContextBuilder)</code><a name="line.469"></a>
-<span class="sourceLineNo">470</span> * <li><code><jk>public</jk> T()</code><a name="line.470"></a>
-<span class="sourceLineNo">471</span> * </ul><a name="line.471"></a>
-<span class="sourceLineNo">472</span> * </ul><a name="line.472"></a>
-<span class="sourceLineNo">473</span> *<a name="line.473"></a>
-<span class="sourceLineNo">474</span> * <h5 class='section'>See Also:</h5><a name="line.474"></a>
-<span class="sourceLineNo">475</span> * <ul><a name="line.475"></a>
-<span class="sourceLineNo">476</span> * <li class='link'>{@doc juneau-rest-server.Instantiation.Children}<a name="line.476"></a>
-<span class="sourceLineNo">477</span> * </ul><a name="line.477"></a>
-<span class="sourceLineNo">478</span> */<a name="line.478"></a>
-<span class="sourceLineNo">479</span> public static final String REST_children = PREFIX + "children.lo";<a name="line.479"></a>
-<span class="sourceLineNo">480</span><a name="line.480"></a>
-<span class="sourceLineNo">481</span> /**<a name="line.481"></a>
-<span class="sourceLineNo">482</span> * Configuration property: Classpath resource finder.<a name="line.482"></a>
-<span class="sourceLineNo">483</span> *<a name="line.483"></a>
-<span class="sourceLineNo">484</span> * <h5 class='section'>Property:</h5><a name="line.484"></a>
-<span class="sourceLineNo">485</span> * <ul><a name="line.485"></a>
-<span class="sourceLineNo">486</span> * <li><b>Name:</b> <js>"RestContext.classpathResourceFinder.o"</js><a name="line.486"></a>
-<span class="sourceLineNo">487</span> * <li><b>Data type:</b> {@link ClasspathResourceFinder}<a name="line.487"></a>
-<span class="sourceLineNo">488</span> * <li><b>Default:</b> {@link ClasspathResourceFinderBasic}<a name="line.488"></a>
-<span class="sourceLineNo">489</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.489"></a>
-<span class="sourceLineNo">490</span> * <li><b>Annotations:</b><a name="line.490"></a>
-<span class="sourceLineNo">491</span> * <ul><a name="line.491"></a>
-<span class="sourceLineNo">492</span> * <li class='ja'>{@link RestResource#classpathResourceFinder()}<a name="line.492"></a>
-<span class="sourceLineNo">493</span> * </ul><a name="line.493"></a>
-<span class="sourceLineNo">494</span> * <li><b>Methods:</b><a name="line.494"></a>
-<span class="sourceLineNo">495</span> * <ul><a name="line.495"></a>
-<span class="sourceLineNo">496</span> * <li class='jm'>{@link RestContextBuilder#classpathResourceFinder(Class)}<a name="line.496"></a>
-<span class="sourceLineNo">497</span> * <li class='jm'>{@link RestContextBuilder#classpathResourceFinder(ClasspathResourceFinder)}<a name="line.497"></a>
-<span class="sourceLineNo">498</span> * </ul><a name="line.498"></a>
-<span class="sourceLineNo">499</span> * </ul><a name="line.499"></a>
-<span class="sourceLineNo">500</span> *<a name="line.500"></a>
-<span class="sourceLineNo">501</span> * <h5 class='section'>Description:</h5><a name="line.501"></a>
-<span class="sourceLineNo">502</span> * <p><a name="line.502"></a>
-<span class="sourceLineNo">503</span> * Used to retrieve localized files from the classpath.<a name="line.503"></a>
-<span class="sourceLineNo">504</span> *<a name="line.504"></a>
-<span class="sourceLineNo">505</span> * <p><a name="line.505"></a>
-<span class="sourceLineNo">506</span> * Used by the following methods:<a name="line.506"></a>
-<span class="sourceLineNo">507</span> * <ul><a name="line.507"></a>
-<span class="sourceLineNo">508</span> * <li class='jc'>{@link RestContext}<a name="line.508"></a>
-<span class="sourceLineNo">509</span> * <ul><a name="line.509"></a>
-<span class="sourceLineNo">510</span> * <li class='jm'>{@link #getClasspathResource(String,Locale) getClasspathResource(String,Locale)}<a name="line.510"></a>
-<span class="sourceLineNo">511</span> * <li class='jm'>{@link #getClasspathResource(Class,String,Locale) getClasspathResource(Class,String,Locale)}<a name="line.511"></a>
-<span class="sourceLineNo">512</span> * <li class='jm'>{@link #getClasspathResource(Class,MediaType,String,Locale) getClasspathResource(Class,MediaType,String,Locale)}<a name="line.512"></a>
-<span class="sourceLineNo">513</span> * <li class='jm'>{@link #getClasspathResource(Class,Class,MediaType,String,Locale) getClasspathResource(Class,Class,MediaType,String,Locale)}<a name="line.513"></a>
-<span class="sourceLineNo">514</span> * <li class='jm'>{@link #getClasspathResourceAsString(String,Locale) getClasspathResourceAsString(String,Locale)}<a name="line.514"></a>
-<span class="sourceLineNo">515</span> * <li class='jm'>{@link #getClasspathResourceAsString(Class,String,Locale) getClasspathResourceAsString(Class,String,Locale)}<a name="line.515"></a>
-<span class="sourceLineNo">516</span> * <li class='jm'>{@link #resolveStaticFile(String) resolveStaticFile(String)}<a name="line.516"></a>
-<span class="sourceLineNo">517</span> * </ul><a name="line.517"></a>
-<span class="sourceLineNo">518</span> * <li class='jc'>{@link RestRequest}<a name="line.518"></a>
-<span class="sourceLineNo">519</span> * <ul><a name="line.519"></a>
-<span class="sourceLineNo">520</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String) getClasspathReaderResource(String)}<a name="line.520"></a>
-<span class="sourceLineNo">521</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String,boolean) getClasspathReaderResource(String,boolean)}<a name="line.521"></a>
-<span class="sourceLineNo">522</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String,boolean,MediaType) getClasspathReaderResource(String,boolean,MediaType)}<a name="line.522"></a>
-<span class="sourceLineNo">523</span> * </ul><a name="line.523"></a>
-<span class="sourceLineNo">524</span> * </ul><a name="line.524"></a>
-<span class="sourceLineNo">525</span> *<a name="line.525"></a>
-<span class="sourceLineNo">526</span> * <p><a name="line.526"></a>
-<span class="sourceLineNo">527</span> * It also affects the behavior of the {@link #REST_staticFiles} property.<a name="line.527"></a>
-<span class="sourceLineNo">528</span> *<a name="line.528"></a>
-<span class="sourceLineNo">529</span> * <h5 class='section'>Example:</h5><a name="line.529"></a>
-<span class="sourceLineNo">530</span> * <p class='bcode w800'><a name="line.530"></a>
-<span class="sourceLineNo">531</span> * <jc>// Our customized classpath resource finder.</jc><a name="line.531"></a>
-<span class="sourceLineNo">532</span> * <jk>public class</jk> MyClasspathResourceFinder <jk>extends</jk> ClasspathResourceFinderBasic {<a name="line.532"></a>
-<span class="sourceLineNo">533</span> * <ja>@Override</ja><a name="line.533"></a>
-<span class="sourceLineNo">534</span> * <jk>public</jk> InputStream findResource(Class&lt;?&gt; baseClass, String name, Locale locale) <jk>throws</jk> IOException {<a name="line.534"></a>
-<span class="sourceLineNo">535</span> * <jc>// Do your own resolution.</jc><a name="line.535"></a>
-<span class="sourceLineNo">536</span> * }<a name="line.536"></a>
-<span class="sourceLineNo">537</span> * }<a name="line.537"></a>
-<span class="sourceLineNo">538</span> *<a name="line.538"></a>
-<span class="sourceLineNo">539</span> * <jc>// Option #1 - Registered via annotation.</jc><a name="line.539"></a>
-<span class="sourceLineNo">540</span> * <ja>@RestResource</ja>(classpathResourceFinder=MyClasspathResourceFinder.<jk>class</jk>)<a name="line.540"></a>
-<span class="sourceLineNo">541</span> * <jk>public class</jk> MyResource {<a name="line.541"></a>
-<span class="sourceLineNo">542</span> *<a name="line.542"></a>
-<span class="sourceLineNo">543</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.543"></a>
-<span class="sourceLineNo">544</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.544"></a>
-<span class="sourceLineNo">545</span> *<a name="line.545"></a>
-<span class="sourceLineNo">546</span> * <jc>// Using method on builder.</jc><a name="line.546"></a>
-<span class="sourceLineNo">547</span> * builder.classpathResourceFinder(MyClasspathResourceFinder.<jk>class</jk>);<a name="line.547"></a>
-<span class="sourceLineNo">548</span> *<a name="line.548"></a>
-<span class="sourceLineNo">549</span> * <jc>// Same, but using property.</jc><a name="line.549"></a>
-<span class="sourceLineNo">550</span> * builder.set(<jsf>REST_classpathResourceFinder</jsf>, MyClasspathResourceFinder.<jk>class</jk>));<a name="line.550"></a>
-<span class="sourceLineNo">551</span> *<a name="line.551"></a>
-<span class="sourceLineNo">552</span> * <jc>// Use a pre-instantiated object instead.</jc><a name="line.552"></a>
-<span class="sourceLineNo">553</span> * builder.classpathResourceFinder(<jk>new</jk> MyClasspathResourceFinder());<a name="line.553"></a>
-<span class="sourceLineNo">554</span> * }<a name="line.554"></a>
-<span class="sourceLineNo">555</span> *<a name="line.555"></a>
-<span class="sourceLineNo">556</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.556"></a>
-<span class="sourceLineNo">557</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.557"></a>
-<span class="sourceLineNo">558</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.558"></a>
-<span class="sourceLineNo">559</span> * builder.classpathResourceFinder(MyClasspathResourceFinder.<jk>class</jk>);<a name="line.559"></a>
-<span class="sourceLineNo">560</span> * }<a name="line.560"></a>
-<span class="sourceLineNo">561</span> * }<a name="line.561"></a>
-<span class="sourceLineNo">562</span> *<a name="line.562"></a>
-<span class="sourceLineNo">563</span> * <h5 class='section'>Notes:</h5><a name="line.563"></a>
-<span class="sourceLineNo">564</span> * <ul class='spaced-list'><a name="line.564"></a>
-<span class="sourceLineNo">565</span> * <li><a name="line.565"></a>
-<span class="sourceLineNo">566</span> * The default value is {@link ClasspathResourceFinderBasic} which provides basic support for finding localized<a name="line.566"></a>
-<span class="sourceLineNo">567</span> * resources on the classpath and JVM working directory.<a name="line.567"></a>
-<span class="sourceLineNo">568</span> * <br>The {@link ClasspathResourceFinderRecursive} is another option that also recursively searches for resources<a name="line.568"></a>
-<span class="sourceLineNo">569</span> * up the class-hierarchy.<a name="line.569"></a>
-<span class="sourceLineNo">570</span> * <br>Each of these classes can be extended to provide customized handling of resource retrieval.<a name="line.570"></a>
-<span class="sourceLineNo">571</span> * <li><a name="line.571"></a>
-<span class="sourceLineNo">572</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.572"></a>
-<span class="sourceLineNo">573</span> * <ul><a name="line.573"></a>
-<span class="sourceLineNo">574</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.574"></a>
-<span class="sourceLineNo">575</span> * <li><code><jk>public</jk> T()</code><a name="line.575"></a>
-<span class="sourceLineNo">576</span> * </ul><a name="line.576"></a>
-<span class="sourceLineNo">577</span> * <li><a name="line.577"></a>
-<span class="sourceLineNo">578</span> * Inner classes of the REST resource class are allowed.<a name="line.578"></a>
-<span class="sourceLineNo">579</span> * </ul><a name="line.579"></a>
-<span class="sourceLineNo">580</span> */<a name="line.580"></a>
-<span class="sourceLineNo">581</span> public static final String REST_classpathResourceFinder = PREFIX + "classpathResourceFinder.o";<a name="line.581"></a>
-<span class="sourceLineNo">582</span><a name="line.582"></a>
-<span class="sourceLineNo">583</span> /**<a name="line.583"></a>
-<span class="sourceLineNo">584</span> * Configuration property: Client version header.<a name="line.584"></a>
-<span class="sourceLineNo">585</span> *<a name="line.585"></a>
-<span class="sourceLineNo">586</span> * <h5 class='section'>Property:</h5><a name="line.586"></a>
-<span class="sourceLineNo">587</span> * <ul><a name="line.587"></a>
-<span class="sourceLineNo">588</span> * <li><b>Name:</b> <js>"RestContext.clientVersionHeader.s"</js><a name="line.588"></a>
-<span class="sourceLineNo">589</span> * <li><b>Data type:</b> <code>String</code><a name="line.589"></a>
-<span class="sourceLineNo">590</span> * <li><b>Default:</b> <js>"X-Client-Version"</js><a name="line.590"></a>
-<span class="sourceLineNo">591</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.591"></a>
-<span class="sourceLineNo">592</span> * <li><b>Annotations:</b><a name="line.592"></a>
-<span class="sourceLineNo">593</span> * <ul><a name="line.593"></a>
-<span class="sourceLineNo">594</span> * <li class='ja'>{@link RestResource#clientVersionHeader()}<a name="line.594"></a>
-<span class="sourceLineNo">595</span> * </ul><a name="line.595"></a>
-<span class="sourceLineNo">596</span> * <li><b>Methods:</b><a name="line.596"></a>
-<span class="sourceLineNo">597</span> * <ul><a name="line.597"></a>
-<span class="sourceLineNo">598</span> * <li class='jm'>{@link RestContextBuilder#clientVersionHeader(String)}<a name="line.598"></a>
-<span class="sourceLineNo">599</span> * </ul><a name="line.599"></a>
-<span class="sourceLineNo">600</span> * </ul><a name="line.600"></a>
-<span class="sourceLineNo">601</span> *<a name="line.601"></a>
-<span class="sourceLineNo">602</span> * <h5 class='section'>Description:</h5><a name="line.602"></a>
-<span class="sourceLineNo">603</span> * <p><a name="line.603"></a>
-<span class="sourceLineNo">604</span> * Specifies the name of the header used to denote the client version on HTTP requests.<a name="line.604"></a>
-<span class="sourceLineNo">605</span> *<a name="line.605"></a>
-<span class="sourceLineNo">606</span> * <p><a name="line.606"></a>
-<span class="sourceLineNo">607</span> * The client version is used to support backwards compatibility for breaking REST interface changes.<a name="line.607"></a>
-<span class="sourceLineNo">608</span> * <br>Used in conjunction with {@link RestMethod#clientVersion() @RestMethod(clientVersion)} annotation.<a name="line.608"></a>
-<span class="sourceLineNo">609</span> *<a name="line.609"></a>
-<span class="sourceLineNo">610</span> * <h5 class='section'>Example:</h5><a name="line.610"></a>
-<span class="sourceLineNo">611</span> * <p class='bcode w800'><a name="line.611"></a>
-<span class="sourceLineNo">612</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.612"></a>
-<span class="sourceLineNo">613</span> * <ja>@RestResource</ja>(clientVersionHeader=<js>"$C{REST/clientVersionHeader,Client-Version}"</js>)<a name="line.613"></a>
-<span class="sourceLineNo">614</span> * <jk>public class</jk> MyResource {<a name="line.614"></a>
-<span class="sourceLineNo">615</span> *<a name="line.615"></a>
-<span class="sourceLineNo">616</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.616"></a>
-<span class="sourceLineNo">617</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.617"></a>
-<span class="sourceLineNo">618</span> *<a name="line.618"></a>
-<span class="sourceLineNo">619</span> * <jc>// Using method on builder.</jc><a name="line.619"></a>
-<span class="sourceLineNo">620</span> * builder.clientVersionHeader(<js>"Client-Version"</js>);<a name="line.620"></a>
-<span class="sourceLineNo">621</span> *<a name="line.621"></a>
-<span class="sourceLineNo">622</span> * <jc>// Same, but using property.</jc><a name="line.622"></a>
-<span class="sourceLineNo">623</span> * builder.set(<jsf>REST_clientVersionHeader</jsf>, <js>"Client-Version"</js>);<a name="line.623"></a>
-<span class="sourceLineNo">624</span> * }<a name="line.624"></a>
-<span class="sourceLineNo">625</span> *<a name="line.625"></a>
-<span class="sourceLineNo">626</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.626"></a>
-<span class="sourceLineNo">627</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.627"></a>
-<span class="sourceLineNo">628</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.628"></a>
-<span class="sourceLineNo">629</span> * builder.clientVersionHeader(<js>"Client-Version"</js>);<a name="line.629"></a>
-<span class="sourceLineNo">630</span> * }<a name="line.630"></a>
-<span class="sourceLineNo">631</span> * }<a name="line.631"></a>
-<span class="sourceLineNo">632</span> * </p><a name="line.632"></a>
-<span class="sourceLineNo">633</span> * <p class='bcode w800'><a name="line.633"></a>
-<span class="sourceLineNo">634</span> * <jc>// Call this method if Client-Version is at least 2.0.<a name="line.634"></a>
-<span class="sourceLineNo">635</span> * // Note that this also matches 2.0.1.</jc><a name="line.635"></a>
-<span class="sourceLineNo">636</span> * <ja>@RestMethod</ja>(name=<jsf>GET</jsf>, path=<js>"/foobar"</js>, clientVersion=<js>"2.0"</js>)<a name="line.636"></a>
-<span class="sourceLineNo">637</span> * <jk>public</jk> Object method1() {<a name="line.637"></a>
-<span class="sourceLineNo">638</span> * ...<a name="line.638"></a>
-<span class="sourceLineNo">639</span> * }<a name="line.639"></a>
-<span class="sourceLineNo">640</span> *<a name="line.640"></a>
-<span class="sourceLineNo">641</span> * <jc>// Call this method if Client-Version is at least 1.1, but less than 2.0.</jc><a name="line.641"></a>
-<span class="sourceLineNo">642</span> * <ja>@RestMethod</ja>(name=<jsf>GET</jsf>, path=<js>"/foobar"</js>, clientVersion=<js>"[1.1,2.0)"</js>)<a name="line.642"></a>
-<span class="sourceLineNo">643</span> * <jk>public</jk> Object method2() {<a name="line.643"></a>
-<span class="sourceLineNo">644</span> * ...<a name="line.644"></a>
-<span class="sourceLineNo">645</span> * }<a name="line.645"></a>
-<span class="sourceLineNo">646</span> *<a name="line.646"></a>
-<span class="sourceLineNo">647</span> * <jc>// Call this method if Client-Version is less than 1.1.</jc><a name="line.647"></a>
-<span class="sourceLineNo">648</span> * <ja>@RestMethod</ja>(name=<jsf>GET</jsf>, path=<js>"/foobar"</js>, clientVersion=<js>"[0,1.1)"</js>)<a name="line.648"></a>
-<span class="sourceLineNo">649</span> * <jk>public</jk> Object method3() {<a name="line.649"></a>
-<span class="sourceLineNo">650</span> * ...<a name="line.650"></a>
-<span class="sourceLineNo">651</span> * }<a name="line.651"></a>
-<span class="sourceLineNo">652</span> * </p><a name="line.652"></a>
-<span class="sourceLineNo">653</span> */<a name="line.653"></a>
-<span class="sourceLineNo">654</span> public static final String REST_clientVersionHeader = PREFIX + "clientVersionHeader.s";<a name="line.654"></a>
-<span class="sourceLineNo">655</span><a name="line.655"></a>
-<span class="sourceLineNo">656</span> /**<a name="line.656"></a>
-<span class="sourceLineNo">657</span> * Configuration property: Class-level response converters.<a name="line.657"></a>
-<span class="sourceLineNo">658</span> *<a name="line.658"></a>
-<span class="sourceLineNo">659</span> * <h5 class='section'>Property:</h5><a name="line.659"></a>
-<span class="sourceLineNo">660</span> * <ul><a name="line.660"></a>
-<span class="sourceLineNo">661</span> * <li><b>Name:</b> <js>"RestContext.converters.lo"</js><a name="line.661"></a>
-<span class="sourceLineNo">662</span> * <li><b>Data type:</b> <code>List&lt;{@link RestConverter} | Class&lt;? <jk>extends</jk> {@link RestConverter}&gt;&gt;</code><a name="line.662"></a>
-<span class="sourceLineNo">663</span> * <li><b>Default:</b> empty list<a name="line.663"></a>
-<span class="sourceLineNo">664</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.664"></a>
-<span class="sourceLineNo">665</span> * <li><b>Annotations:</b><a name="line.665"></a>
-<span class="sourceLineNo">666</span> * <ul><a name="line.666"></a>
-<span class="sourceLineNo">667</span> * <li class='ja'>{@link RestResource#converters()}<a name="line.667"></a>
-<span class="sourceLineNo">668</span> * <li class='ja'>{@link RestMethod#converters()}<a name="line.668"></a>
-<span class="sourceLineNo">669</span> * </ul><a name="line.669"></a>
-<span class="sourceLineNo">670</span> * <li><b>Methods:</b><a name="line.670"></a>
-<span class="sourceLineNo">671</span> * <ul><a name="line.671"></a>
-<span class="sourceLineNo">672</span> * <li class='jm'>{@link RestContextBuilder#converters(Class...)}<a name="line.672"></a>
-<span class="sourceLineNo">673</span> * <li class='jm'>{@link RestContextBuilder#converters(RestConverter...)}<a name="line.673"></a>
-<span class="sourceLineNo">674</span> * </ul><a name="line.674"></a>
-<span class="sourceLineNo">675</span> * </ul><a name="line.675"></a>
-<span class="sourceLineNo">676</span> *<a name="line.676"></a>
-<span class="sourceLineNo">677</span> * <h5 class='section'>Description:</h5><a name="line.677"></a>
-<span class="sourceLineNo">678</span> * <p><a name="line.678"></a>
-<span class="sourceLineNo">679</span> * Associates one or more {@link RestConverter converters} with a resource class.<a name="line.679"></a>
-<span class="sourceLineNo">680</span> * <br>These converters get called immediately after execution of the REST method in the same order specified in the<a name="line.680"></a>
-<span class="sourceLineNo">681</span> * annotation.<a name="line.681"></a>
-<span class="sourceLineNo">682</span> * <br>The object passed into this converter is the object returned from the Java method or passed into<a name="line.682"></a>
-<span class="sourceLineNo">683</span> * the {@link RestResponse#setOutput(Object)} method.<a name="line.683"></a>
-<span class="sourceLineNo">684</span> *<a name="line.684"></a>
-<span class="sourceLineNo">685</span> * <p><a name="line.685"></a>
-<span class="sourceLineNo">686</span> * Can be used for performing post-processing on the response object before serialization.<a name="line.686"></a>
-<span class="sourceLineNo">687</span> *<a name="line.687"></a>
-<span class="sourceLineNo">688</span> * <p><a name="line.688"></a>
-<span class="sourceLineNo">689</span> * When multiple converters are specified, they're executed in the order they're specified in the annotation<a name="line.689"></a>
-<span class="sourceLineNo">690</span> * (e.g. first the results will be traversed, then the resulting node will be searched/sorted).<a name="line.690"></a>
-<span class="sourceLineNo">691</span> *<a name="line.691"></a>
-<span class="sourceLineNo">692</span> * <h5 class='section'>Example:</h5><a name="line.692"></a>
-<span class="sourceLineNo">693</span> * <p class='bcode w800'><a name="line.693"></a>
-<span class="sourceLineNo">694</span> * <jc>// Our converter.</jc><a name="line.694"></a>
-<span class="sourceLineNo">695</span> * <jk>public class</jk> MyConverter <jk>implements</jk> RestConverter {<a name="line.695"></a>
-<span class="sourceLineNo">696</span> * <ja>@Override</ja><a name="line.696"></a>
-<span class="sourceLineNo">697</span> * <jk>public</jk> Object convert(RestRequest req, Object o) {<a name="line.697"></a>
-<span class="sourceLineNo">698</span> * <jc>// Do something with object and return another object.</jc><a name="line.698"></a>
-<span class="sourceLineNo">699</span> * <jc>// Or just return the same object for a no-op.</jc><a name="line.699"></a>
-<span class="sourceLineNo">700</span> * }<a name="line.700"></a>
-<span class="sourceLineNo">701</span> * }<a name="line.701"></a>
-<span class="sourceLineNo">702</span> *<a name="line.702"></a>
-<span class="sourceLineNo">703</span> * <jc>// Option #1 - Registered via annotation resolving to a config file setting with default value.</jc><a name="line.703"></a>
-<span class="sourceLineNo">704</span> * <ja>@RestResource</ja>(converters={MyConverter.<jk>class</jk>})<a name="line.704"></a>
-<span class="sourceLineNo">705</span> * <jk>public class</jk> MyResource {<a name="line.705"></a>
-<span class="sourceLineNo">706</span> *<a name="line.706"></a>
-<span class="sourceLineNo">707</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.707"></a>
-<span class="sourceLineNo">708</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.708"></a>
-<span class="sourceLineNo">709</span> *<a name="line.709"></a>
-<span class="sourceLineNo">710</span> * <jc>// Using method on builder.</jc><a name="line.710"></a>
-<span class="sourceLineNo">711</span> * builder.converters(MyConverter.<jk>class</jk>);<a name="line.711"></a>
-<span class="sourceLineNo">712</span> *<a name="line.712"></a>
-<span class="sourceLineNo">713</span> * <jc>// Same, but using property.</jc><a name="line.713"></a>
-<span class="sourceLineNo">714</span> * builder.set(<jsf>REST_converters</jsf>, MyConverter.<jk>class</jk>);<a name="line.714"></a>
-<span class="sourceLineNo">715</span> *<a name="line.715"></a>
-<span class="sourceLineNo">716</span> * <jc>// Pass in an instance instead.</jc><a name="line.716"></a>
-<span class="sourceLineNo">717</span> * builder.converters(<jk>new</jk> MyConverter());<a name="line.717"></a>
-<span class="sourceLineNo">718</span> * }<a name="line.718"></a>
-<span class="sourceLineNo">719</span> *<a name="line.719"></a>
-<span class="sourceLineNo">720</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.720"></a>
-<span class="sourceLineNo">721</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.721"></a>
-<span class="sourceLineNo">722</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.722"></a>
-<span class="sourceLineNo">723</span> * builder.converters(MyConverter.<jk>class</jk>);<a name="line.723"></a>
-<span class="sourceLineNo">724</span> * }<a name="line.724"></a>
-<span class="sourceLineNo">725</span> * }<a name="line.725"></a>
-<span class="sourceLineNo">726</span> * </p><a name="line.726"></a>
-<span class="sourceLineNo">727</span> *<a name="line.727"></a>
-<span class="sourceLineNo">728</span> * <h5 class='section'>See Also:</h5><a name="line.728"></a>
-<span class="sourceLineNo">729</span> * <ul><a name="line.729"></a>
-<span class="sourceLineNo">730</span> * <li class='jc'>{@link Traversable} - Allows URL additional path info to address individual elements in a POJO tree.<a name="line.730"></a>
-<span class="sourceLineNo">731</span> * <li class='jc'>{@link Queryable} - Allows query/view/sort functions to be performed on POJOs.<a name="line.731"></a>
-<span class="sourceLineNo">732</span> * <li class='jc'>{@link Introspectable} - Allows Java public methods to be invoked on the returned POJOs.<a name="line.732"></a>
-<span class="sourceLineNo">733</span> * </ul><a name="line.733"></a>
-<span class="sourceLineNo">734</span> *<a name="line.734"></a>
-<span class="sourceLineNo">735</span> * <h5 class='section'>See Also:</h5><a name="line.735"></a>
-<span class="sourceLineNo">736</span> * <ul><a name="line.736"></a>
-<span class="sourceLineNo">737</span> * <li class='link'>{@doc juneau-rest-server.Converters}<a name="line.737"></a>
-<span class="sourceLineNo">738</span> * </ul><a name="line.738"></a>
-<span class="sourceLineNo">739</span> *<a name="line.739"></a>
-<span class="sourceLineNo">740</span> * <h5 class='section'>Notes:</h5><a name="line.740"></a>
-<span class="sourceLineNo">741</span> * <ul class='spaced-list'><a name="line.741"></a>
-<span class="sourceLineNo">742</span> * <li><a name="line.742"></a>
-<span class="sourceLineNo">743</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.743"></a>
-<span class="sourceLineNo">744</span> * <ul><a name="line.744"></a>
-<span class="sourceLineNo">745</span> * <li><code><jk>public</jk> T(BeanContext)</code><a name="line.745"></a>
-<span class="sourceLineNo">746</span> * <li><code><jk>public</jk> T()</code><a name="line.746"></a>
-<span class="sourceLineNo">747</span> * </ul><a name="line.747"></a>
-<span class="sourceLineNo">748</span> * <li><a name="line.748"></a>
-<span class="sourceLineNo">749</span> * Inner classes of the REST resource class are allowed.<a name="line.749"></a>
-<span class="sourceLineNo">750</span> * </ul><a name="line.750"></a>
-<span class="sourceLineNo">751</span> */<a name="line.751"></a>
-<span class="sourceLineNo">752</span> public static final String REST_converters = PREFIX + "converters.lo";<a name="line.752"></a>
-<span class="sourceLineNo">753</span><a name="line.753"></a>
-<span class="sourceLineNo">754</span> /**<a name="line.754"></a>
-<span class="sourceLineNo">755</span> * Configuration property: Debug mode.<a name="line.755"></a>
-<span class="sourceLineNo">756</span> *<a name="line.756"></a>
-<span class="sourceLineNo">757</span> * <h5 class='section'>Property:</h5><a name="line.757"></a>
-<span class="sourceLineNo">758</span> * <ul><a name="line.758"></a>
-<span class="sourceLineNo">759</span> * <li><b>Name:</b> <js>"RestContext.debug.b"</js><a name="line.759"></a>
-<span class="sourceLineNo">760</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.760"></a>
-<span class="sourceLineNo">761</span> * <li><b>Default:</b> <jk>false</jk><a name="line.761"></a>
-<span class="sourceLineNo">762</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.762"></a>
-<span class="sourceLineNo">763</span> * <li><b>Annotations:</b><a name="line.763"></a>
-<span class="sourceLineNo">764</span> * <ul><a name="line.764"></a>
-<span class="sourceLineNo">765</span> * <li class='ja'>{@link RestResource#debug()}<a name="line.765"></a>
-<span class="sourceLineNo">766</span> * </ul><a name="line.766"></a>
-<span class="sourceLineNo">767</span> * <li><b>Methods:</b><a name="line.767"></a>
-<span class="sourceLineNo">768</span> * <ul><a name="line.768"></a>
-<span class="sourceLineNo">769</span> * <li class='jm'>{@link RestContextBuilder#debug(boolean)}<a name="line.769"></a>
-<span class="sourceLineNo">770</span> * </ul><a name="line.770"></a>
-<span class="sourceLineNo">771</span> * </ul><a name="line.771"></a>
-<span class="sourceLineNo">772</span> *<a name="line.772"></a>
-<span class="sourceLineNo">773</span> * <h5 class='section'>Description:</h5><a name="line.773"></a>
-<span class="sourceLineNo">774</span> * <p><a name="line.774"></a>
-<span class="sourceLineNo">775</span> * Enables the following:<a name="line.775"></a>
-<span class="sourceLineNo">776</span> * <ul><a name="line.776"></a>
-<span class="sourceLineNo">777</span> * <li>A message and stack trace is printed to STDERR when {@link BasicRestCallHandler#handleError(HttpServletRequest, HttpServletResponse, Throwable)} is called.<a name="line.777"></a>
-<span class="sourceLineNo">778</span> * </ul><a name="line.778"></a>
-<span class="sourceLineNo">779</span> */<a name="line.779"></a>
-<span class="sourceLineNo">780</span> public static final String REST_debug = PREFIX + "debug.b";<a name="line.780"></a>
-<span class="sourceLineNo">781</span><a name="line.781"></a>
-<span class="sourceLineNo">782</span> /**<a name="line.782"></a>
-<span class="sourceLineNo">783</span> * Configuration property: Default character encoding.<a name="line.783"></a>
-<span class="sourceLineNo">784</span> *<a name="line.784"></a>
-<span class="sourceLineNo">785</span> * <h5 class='section'>Property:</h5><a name="line.785"></a>
-<span class="sourceLineNo">786</span> * <ul><a name="line.786"></a>
-<span class="sourceLineNo">787</span> * <li><b>Name:</b> <js>"RestContext.defaultCharset.s"</js><a name="line.787"></a>
-<span class="sourceLineNo">788</span> * <li><b>Data type:</b> <code>String</code><a name="line.788"></a>
-<span class="sourceLineNo">789</span> * <li><b>Default:</b> <js>"utf-8"</js><a name="line.789"></a>
-<span class="sourceLineNo">790</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.790"></a>
-<span class="sourceLineNo">791</span> * <li><b>Annotations:</b><a name="line.791"></a>
-<span class="sourceLineNo">792</span> * <ul><a name="line.792"></a>
-<span class="sourceLineNo">793</span> * <li class='ja'>{@link RestResource#defaultCharset()}<a name="line.793"></a>
-<span class="sourceLineNo">794</span> * <li class='ja'>{@link RestMethod#defaultCharset()}<a name="line.794"></a>
-<span class="sourceLineNo">795</span> * </ul><a name="line.795"></a>
-<span class="sourceLineNo">796</span> * <li><b>Methods:</b><a name="line.796"></a>
-<span class="sourceLineNo">797</span> * <ul><a name="line.797"></a>
-<span class="sourceLineNo">798</span> * <li class='jm'>{@link RestContextBuilder#defaultCharset(String)}<a name="line.798"></a>
-<span class="sourceLineNo">799</span> * <li class='jm'>{@link RestContextBuilder#defaultCharset(Charset)}<a name="line.799"></a>
-<span class="sourceLineNo">800</span> * </ul><a name="line.800"></a>
-<span class="sourceLineNo">801</span> * </ul><a name="line.801"></a>
-<span class="sourceLineNo">802</span> *<a name="line.802"></a>
-<span class="sourceLineNo">803</span> * <h5 class='section'>Description:</h5><a name="line.803"></a>
-<span class="sourceLineNo">804</span> * <p><a name="line.804"></a>
-<span class="sourceLineNo">805</span> * The default character encoding for the request and response if not specified on the request.<a name="line.805"></a>
-<span class="sourceLineNo">806</span> *<a name="line.806"></a>
-<span class="sourceLineNo">807</span> * <h5 class='section'>Example:</h5><a name="line.807"></a>
-<span class="sourceLineNo">808</span> * <p class='bcode w800'><a name="line.808"></a>
-<span class="sourceLineNo">809</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.809"></a>
-<span class="sourceLineNo">810</span> * <ja>@RestResource</ja>(defaultCharset=<js>"$C{REST/defaultCharset,US-ASCII}"</js>)<a name="line.810"></a>
-<span class="sourceLineNo">811</span> * <jk>public class</jk> MyResource {<a name="line.811"></a>
-<span class="sourceLineNo">812</span> *<a name="line.812"></a>
-<span class="sourceLineNo">813</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.813"></a>
-<span class="sourceLineNo">814</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.814"></a>
-<span class="sourceLineNo">815</span> *<a name="line.815"></a>
-<span class="sourceLineNo">816</span> * <jc>// Using method on builder.</jc><a name="line.816"></a>
-<span class="sourceLineNo">817</span> * builder.defaultCharset(<js>"US-ASCII"</js>);<a name="line.817"></a>
-<span class="sourceLineNo">818</span> *<a name="line.818"></a>
-<span class="sourceLineNo">819</span> * <jc>// Same, but using property.</jc><a name="line.819"></a>
-<span class="sourceLineNo">820</span> * builder.set(<jsf>REST_defaultCharset</jsf>, <js>"US-ASCII"</js>);<a name="line.820"></a>
-<span class="sourceLineNo">821</span> * }<a name="line.821"></a>
-<span class="sourceLineNo">822</span> *<a name="line.822"></a>
-<span class="sourceLineNo">823</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.823"></a>
-<span class="sourceLineNo">824</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.824"></a>
-<span class="sourceLineNo">825</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.825"></a>
-<span class="sourceLineNo">826</span> * builder.defaultCharset(<js>"US-ASCII"</js>);<a name="line.826"></a>
-<span class="sourceLineNo">827</span> * }<a name="line.827"></a>
-<span class="sourceLineNo">828</span> *<a name="line.828"></a>
-<span class="sourceLineNo">829</span> * <jc>// Override at the method level.</jc><a name="line.829"></a>
-<span class="sourceLineNo">830</span> * <ja>@RestMethod</ja>(defaultCharset=<js>"UTF-16"</js>)<a name="line.830"></a>
-<span class="sourceLineNo">831</span> * public Object myMethod() {...}<a name="line.831"></a>
-<span class="sourceLineNo">832</span> * }<a name="line.832"></a>
-<span class="sourceLineNo">833</span> * </p><a name="line.833"></a>
-<span class="sourceLineNo">834</span> */<a name="line.834"></a>
-<span class="sourceLineNo">835</span> public static final String REST_defaultCharset = PREFIX + "defaultCharset.s";<a name="line.835"></a>
-<span class="sourceLineNo">836</span><a name="line.836"></a>
-<span class="sourceLineNo">837</span> /**<a name="line.837"></a>
-<span class="sourceLineNo">838</span> * Configuration property: Default request headers.<a name="line.838"></a>
-<span class="sourceLineNo">839</span> *<a name="line.839"></a>
-<span class="sourceLineNo">840</span> * <h5 class='section'>Property:</h5><a name="line.840"></a>
-<span class="sourceLineNo">841</span> * <ul><a name="line.841"></a>
-<span class="sourceLineNo">842</span> * <li><b>Name:</b> <js>"RestContext.defaultRequestHeaders.smo"</js><a name="line.842"></a>
-<span class="sourceLineNo">843</span> * <li><b>Data type:</b> <code>Map&lt;String,String&gt;</code><a name="line.843"></a>
-<span class="sourceLineNo">844</span> * <li><b>Default:</b> empty map<a name="line.844"></a>
-<span class="sourceLineNo">845</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.845"></a>
-<span class="sourceLineNo">846</span> * <li><b>Annotations:</b><a name="line.846"></a>
-<span class="sourceLineNo">847</span> * <ul><a name="line.847"></a>
-<span class="sourceLineNo">848</span> * <li class='ja'>{@link RestResource#defaultRequestHeaders()}<a name="line.848"></a>
-<span class="sourceLineNo">849</span> * <li class='ja'>{@link RestMethod#defaultRequestHeaders()}<a name="line.849"></a>
-<span class="sourceLineNo">850</span> * </ul><a name="line.850"></a>
-<span class="sourceLineNo">851</span> * <li><b>Methods:</b><a name="line.851"></a>
-<span class="sourceLineNo">852</span> * <ul><a name="line.852"></a>
-<span class="sourceLineNo">853</span> * <li class='jm'>{@link RestContextBuilder#defaultRequestHeader(String,Object)}<a name="line.853"></a>
-<span class="sourceLineNo">854</span> * <li class='jm'>{@link RestContextBuilder#defaultRequestHeaders(String...)}<a name="line.854"></a>
-<span class="sourceLineNo">855</span> * </ul><a name="line.855"></a>
-<span class="sourceLineNo">856</span> * </ul><a name="line.856"></a>
-<span class="sourceLineNo">857</span> *<a name="line.857"></a>
-<span class="sourceLineNo">858</span> * <h5 class='section'>Description:</h5><a name="line.858"></a>
-<span class="sourceLineNo">859</span> * <p><a name="line.859"></a>
-<span class="sourceLineNo">860</span> * Specifies default values for request headers if they're not passed in through the request.<a name="line.860"></a>
-<span class="sourceLineNo">861</span> *<a name="line.861"></a>
-<span class="sourceLineNo">862</span> * <h5 class='section'>Notes:</h5><a name="line.862"></a>
-<span class="sourceLineNo">863</span> * <ul class='spaced-list'><a name="line.863"></a>
-<span class="sourceLineNo">864</span> * <li><a name="line.864"></a>
-<span class="sourceLineNo">865</span> * Strings are in the format <js>"Header-Name: header-value"</js>.<a name="line.865"></a>
-<span class="sourceLineNo">866</span> * <li><a name="line.866"></a>
-<span class="sourceLineNo">867</span> * Affects values returned by {@link RestRequest#getHeader(String)} when the header is not present on the request.<a name="line.867"></a>
-<span class="sourceLineNo">868</span> * <li><a name="line.868"></a>
-<span class="sourceLineNo">869</span> * The most useful reason for this annotation is to provide a default <code>Accept</code> header when one is not<a name="line.869"></a>
-<span class="sourceLineNo">870</span> * specified so that a particular default {@link Serializer} is picked.<a name="line.870"></a>
-<span class="sourceLineNo">871</span> * </ul><a name="line.871"></a>
-<span class="sourceLineNo">872</span> *<a name="line.872"></a>
-<span class="sourceLineNo">873</span> * <h5 class='section'>Example:</h5><a name="line.873"></a>
-<span class="sourceLineNo">874</span> * <p class='bcode w800'><a name="line.874"></a>
-<span class="sourceLineNo">875</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.875"></a>
-<span class="sourceLineNo">876</span> * <ja>@RestResource</ja>(defaultRequestHeaders={<js>"Accept: application/json"</js>, <js>"My-Header: $C{REST/myHeaderValue}"</js>})<a name="line.876"></a>
-<span class="sourceLineNo">877</span> * <jk>public class</jk> MyResource {<a name="line.877"></a>
-<span class="sourceLineNo">878</span> *<a name="line.878"></a>
-<span class="sourceLineNo">879</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.879"></a>
-<span class="sourceLineNo">880</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.880"></a>
-<span class="sourceLineNo">881</span> *<a name="line.881"></a>
-<span class="sourceLineNo">882</span> * <jc>// Using method on builder.</jc><a name="line.882"></a>
-<span class="sourceLineNo">883</span> * builder<a name="line.883"></a>
-<span class="sourceLineNo">884</span> * .defaultRequestHeader(<js>"Accept"</js>, <js>"application/json"</js>);<a name="line.884"></a>
-<span class="sourceLineNo">885</span> * .defaultRequestHeaders(<js>"My-Header: foo"</js>);<a name="line.885"></a>
-<span class="sourceLineNo">886</span> *<a name="line.886"></a>
-<span class="sourceLineNo">887</span> * <jc>// Same, but using property.</jc><a name="line.887"></a>
-<span class="sourceLineNo">888</span> * builder.addTo(<jsf>REST_defaultRequestHeaders</jsf>, <js>"Accept"</js>, <js>"application/json"</js>);<a name="line.888"></a>
-<span class="sourceLineNo">889</span> * }<a name="line.889"></a>
-<span class="sourceLineNo">890</span> *<a name="line.890"></a>
-<span class="sourceLineNo">891</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.891"></a>
-<span class="sourceLineNo">892</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.892"></a>
-<span class="sourceLineNo">893</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.893"></a>
-<span class="sourceLineNo">894</span> * builder.defaultRequestHeader(<js>"Accept"</js>, <js>"application/json"</js>);<a name="line.894"></a>
-<span class="sourceLineNo">895</span> * }<a name="line.895"></a>
-<span class="sourceLineNo">896</span> *<a name="line.896"></a>
-<span class="sourceLineNo">897</span> * <jc>// Override at the method level.</jc><a name="line.897"></a>
-<span class="sourceLineNo">898</span> * <ja>@RestMethod</ja>(defaultRequestHeaders={<js>"Accept: text/xml"</js>})<a name="line.898"></a>
-<span class="sourceLineNo">899</span> * public Object myMethod() {...}<a name="line.899"></a>
-<span class="sourceLineNo">900</span> * }<a name="line.900"></a>
-<span class="sourceLineNo">901</span> * </p><a name="line.901"></a>
-<span class="sourceLineNo">902</span> */<a name="line.902"></a>
-<span class="sourceLineNo">903</span> public static final String REST_defaultRequestHeaders = PREFIX + "defaultRequestHeaders.smo";<a name="line.903"></a>
-<span class="sourceLineNo">904</span><a name="line.904"></a>
-<span class="sourceLineNo">905</span> /**<a name="line.905"></a>
-<span class="sourceLineNo">906</span> * Configuration property: Default response headers.<a name="line.906"></a>
-<span class="sourceLineNo">907</span> *<a name="line.907"></a>
-<span class="sourceLineNo">908</span> * <h5 class='section'>Property:</h5><a name="line.908"></a>
-<span class="sourceLineNo">909</span> * <ul><a name="line.909"></a>
-<span class="sourceLineNo">910</span> * <li><b>Name:</b> <js>"RestContext.defaultResponseHeaders.omo"</js><a name="line.910"></a>
-<span class="sourceLineNo">911</span> * <li><b>Data type:</b> <code>Map&lt;String,String&gt;</code><a name="line.911"></a>
-<span class="sourceLineNo">912</span> * <li><b>Default:</b> empty map<a name="line.912"></a>
-<span class="sourceLineNo">913</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.913"></a>
-<span class="sourceLineNo">914</span> * <li><b>Annotations:</b><a name="line.914"></a>
-<span class="sourceLineNo">915</span> * <ul><a name="line.915"></a>
-<span class="sourceLineNo">916</span> * <li class='ja'>{@link RestResource#defaultResponseHeaders()}<a name="line.916"></a>
-<span class="sourceLineNo">917</span> * </ul><a name="line.917"></a>
-<span class="sourceLineNo">918</span> * <li><b>Methods:</b><a name="line.918"></a>
-<span class="sourceLineNo">919</span> * <ul><a name="line.919"></a>
-<span class="sourceLineNo">920</span> * <li class='jm'>{@link RestContextBuilder#defaultResponseHeader(String,Object)}<a name="line.920"></a>
-<span class="sourceLineNo">921</span> * <li class='jm'>{@link RestContextBuilder#defaultResponseHeaders(String...)}<a name="line.921"></a>
-<span class="sourceLineNo">922</span> * </ul><a name="line.922"></a>
-<span class="sourceLineNo">923</span> * </ul><a name="line.923"></a>
-<span class="sourceLineNo">924</span> *<a name="line.924"></a>
-<span class="sourceLineNo">925</span> * <h5 class='section'>Description:</h5><a name="line.925"></a>
-<span class="sourceLineNo">926</span> * <p><a name="line.926"></a>
-<span class="sourceLineNo">927</span> * Specifies default values for response headers if they're not set after the Java REST method is called.<a name="line.927"></a>
-<span class="sourceLineNo">928</span> *<a name="line.928"></a>
-<span class="sourceLineNo">929</span> * <h5 class='section'>Notes:</h5><a name="line.929"></a>
-<span class="sourceLineNo">930</span> * <ul class='spaced-list'><a name="line.930"></a>
-<span class="sourceLineNo">931</span> * <li><a name="line.931"></a>
-<span class="sourceLineNo">932</span> * Strings are in the format <js>"Header-Name: header-value"</js>.<a name="line.932"></a>
-<span class="sourceLineNo">933</span> * <li><a name="line.933"></a>
-<span class="sourceLineNo">934</span> * This is equivalent to calling {@link RestResponse#setHeader(String, String)} programmatically in each of<a name="line.934"></a>
-<span class="sourceLineNo">935</span> * the Java methods.<a name="line.935"></a>
-<span class="sourceLineNo">936</span> * <li><a name="line.936"></a>
-<span class="sourceLineNo">937</span> * The header value will not be set if the header value has already been specified (hence the 'default' in the name).<a name="line.937"></a>
-<span class="sourceLineNo">938</span> * </ul><a name="line.938"></a>
-<span class="sourceLineNo">939</span> *<a name="line.939"></a>
-<span class="sourceLineNo">940</span> * <h5 class='section'>Example:</h5><a name="line.940"></a>
-<span class="sourceLineNo">941</span> * <p class='bcode w800'><a name="line.941"></a>
-<span class="sourceLineNo">942</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.942"></a>
-<span class="sourceLineNo">943</span> * <ja>@RestResource</ja>(defaultResponseHeaders={<js>"Content-Type: $C{REST/defaultContentType,text/plain}"</js>,<js>"My-Header: $C{REST/myHeaderValue}"</js>})<a name="line.943"></a>
-<span class="sourceLineNo">944</span> * <jk>public class</jk> MyResource {<a name="line.944"></a>
-<span class="sourceLineNo">945</span> *<a name="line.945"></a>
-<span class="sourceLineNo">946</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.946"></a>
-<span class="sourceLineNo">947</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.947"></a>
-<span class="sourceLineNo">948</span> *<a name="line.948"></a>
-<span class="sourceLineNo">949</span> * <jc>// Using method on builder.</jc><a name="line.949"></a>
-<span class="sourceLineNo">950</span> * builder<a name="line.950"></a>
-<span class="sourceLineNo">951</span> * .defaultResponseHeader(<js>"Content-Type"</js>, <js>"text/plain"</js>);<a name="line.951"></a>
-<span class="sourceLineNo">952</span> * .defaultResponseHeaders(<js>"My-Header: foo"</js>);<a name="line.952"></a>
-<span class="sourceLineNo">953</span> *<a name="line.953"></a>
-<span class="sourceLineNo">954</span> * <jc>// Same, but using property.</jc><a name="line.954"></a>
-<span class="sourceLineNo">955</span> * builder<a name="line.955"></a>
-<span class="sourceLineNo">956</span> * .addTo(<jsf>REST_defaultRequestHeaders</jsf>, <js>"Accept"</js>, <js>"application/json"</js>);<a name="line.956"></a>
-<span class="sourceLineNo">957</span> * .addTo(<jsf>REST_defaultRequestHeaders</jsf>, <js>"My-Header"</js>, <js>"foo"</js>);<a name="line.957"></a>
-<span class="sourceLineNo">958</span> * }<a name="line.958"></a>
-<span class="sourceLineNo">959</span> *<a name="line.959"></a>
-<span class="sourceLineNo">960</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.960"></a>
-<span class="sourceLineNo">961</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.961"></a>
-<span class="sourceLineNo">962</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.962"></a>
-<span class="sourceLineNo">963</span> * builder.defaultResponseHeader(<js>"Content-Type"</js>, <js>"text/plain"</js>);<a name="line.963"></a>
-<span class="sourceLineNo">964</span> * }<a name="line.964"></a>
-<span class="sourceLineNo">965</span> * }<a name="line.965"></a>
-<span class="sourceLineNo">966</span> * </p><a name="line.966"></a>
-<span class="sourceLineNo">967</span> */<a name="line.967"></a>
-<span class="sourceLineNo">968</span> public static final String REST_defaultResponseHeaders = PREFIX + "defaultResponseHeaders.omo";<a name="line.968"></a>
-<span class="sourceLineNo">969</span><a name="line.969"></a>
-<span class="sourceLineNo">970</span> /**<a name="line.970"></a>
-<span class="sourceLineNo">971</span> * Configuration property: Compression encoders.<a name="line.971"></a>
-<span class="sourceLineNo">972</span> *<a name="line.972"></a>
-<span class="sourceLineNo">973</span> * <h5 class='section'>Property:</h5><a name="line.973"></a>
-<span class="sourceLineNo">974</span> * <ul><a name="line.974"></a>
-<span class="sourceLineNo">975</span> * <li><b>Name:</b> <js>"RestContext.encoders.o"</js><a name="line.975"></a>
-<span class="sourceLineNo">976</span> * <li><b>Data type:</b> <code>List&lt;{@link Encoder} | Class&lt;? <jk>extends</jk> {@link Encoder}&gt;&gt;</code><a name="line.976"></a>
-<span class="sourceLineNo">977</span> * <li><b>Default:</b> empty list<a name="line.977"></a>
-<span class="sourceLineNo">978</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.978"></a>
-<span class="sourceLineNo">979</span> * <li><b>Annotations:</b><a name="line.979"></a>
-<span class="sourceLineNo">980</span> * <ul><a name="line.980"></a>
-<span class="sourceLineNo">981</span> * <li class='ja'>{@link RestResource#encoders()}<a name="line.981"></a>
-<span class="sourceLineNo">982</span> * <li class='ja'>{@link RestMethod#encoders()}<a name="line.982"></a>
-<span class="sourceLineNo">983</span> * </ul><a name="line.983"></a>
-<span class="sourceLineNo">984</span> * <li><b>Methods:</b><a name="line.984"></a>
-<span class="sourceLineNo">985</span> * <ul><a name="line.985"></a>
-<span class="sourceLineNo">986</span> * <li class='jm'>{@link RestContextBuilder#encoders(Class...)}<a name="line.986"></a>
-<span class="sourceLineNo">987</span> * <li class='jm'>{@link RestContextBuilder#encoders(Encoder...)}<a name="line.987"></a>
-<span class="sourceLineNo">988</span> * </ul><a name="line.988"></a>
-<span class="sourceLineNo">989</span> * </ul><a name="line.989"></a>
-<span class="sourceLineNo">990</span> *<a name="line.990"></a>
-<span class="sourceLineNo">991</span> * <h5 class='section'>Description:</h5><a name="line.991"></a>
-<span class="sourceLineNo">992</span> * <p><a name="line.992"></a>
-<span class="sourceLineNo">993</span> * These can be used to enable various kinds of compression (e.g. <js>"gzip"</js>) on requests and responses.<a name="line.993"></a>
-<span class="sourceLineNo">994</span> *<a name="line.994"></a>
-<span class="sourceLineNo">995</span> * <h5 class='section'>Example:</h5><a name="line.995"></a>
-<span class="sourceLineNo">996</span> * <p class='bcode w800'><a name="line.996"></a>
-<span class="sourceLineNo">997</span> * <jc>// Option #1 - Registered via annotation.</jc><a name="line.997"></a>
-<span class="sourceLineNo">998</span> * <ja>@RestResource</ja>(encoders={GzipEncoder.<jk>class</jk>})<a name="line.998"></a>
-<span class="sourceLineNo">999</span> * <jk>public class</jk> MyResource {<a name="line.999"></a>
-<span class="sourceLineNo">1000</span> *<a name="line.1000"></a>
-<span class="sourceLineNo">1001</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.1001"></a>
-<span class="sourceLineNo">1002</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1002"></a>
-<span class="sourceLineNo">1003</span> *<a name="line.1003"></a>
-<span class="sourceLineNo">1004</span> * <jc>// Using method on builder.</jc><a name="line.1004"></a>
-<span class="sourceLineNo">1005</span> * builder.encoders(GzipEncoder.<jk>class</jk>);<a name="line.1005"></a>
-<span class="sourceLineNo">1006</span> *<a name="line.1006"></a>
-<span class="sourceLineNo">1007</span> * <jc>// Same, but using property.</jc><a name="line.1007"></a>
-<span class="sourceLineNo">1008</span> * builder.addTo(<jsf>REST_encoders</jsf>, GzipEncoder.<jk>class</jk>);<a name="line.1008"></a>
-<span class="sourceLineNo">1009</span> * }<a name="line.1009"></a>
-<span class="sourceLineNo">1010</span> *<a name="line.1010"></a>
-<span class="sourceLineNo">1011</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.1011"></a>
-<span class="sourceLineNo">1012</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1012"></a>
-<span class="sourceLineNo">1013</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1013"></a>
-<span class="sourceLineNo">1014</span> * builder.encoders(GzipEncoder.<jk>class</jk>);<a name="line.1014"></a>
-<span class="sourceLineNo">1015</span> * }<a name="line.1015"></a>
-<span class="sourceLineNo">1016</span> *<a name="line.1016"></a>
-<span class="sourceLineNo">1017</span> * <jc>// Override at the method level.</jc><a name="line.1017"></a>
-<span class="sourceLineNo">1018</span> * <ja>@RestMethod</ja>(encoders={MySpecialEncoder.<jk>class</jk>}, inherit={<js>"ENCODERS"</js>})<a name="line.1018"></a>
-<span class="sourceLineNo">1019</span> * public Object myMethod() {...}<a name="line.1019"></a>
-<span class="sourceLineNo">1020</span> * }<a name="line.1020"></a>
-<span class="sourceLineNo">1021</span> * </p><a name="line.1021"></a>
-<span class="sourceLineNo">1022</span> *<a name="line.1022"></a>
-<span class="sourceLineNo">1023</span> * <h5 class='section'>Notes:</h5><a name="line.1023"></a>
-<span class="sourceLineNo">1024</span> * <ul class='spaced-list'><a name="line.1024"></a>
-<span class="sourceLineNo">1025</span> * <li><a name="line.1025"></a>
-<span class="sourceLineNo">1026</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.1026"></a>
-<span class="sourceLineNo">1027</span> * <ul><a name="line.1027"></a>
-<span class="sourceLineNo">1028</span> * <li><code><jk>public</jk> T(BeanContext)</code><a name="line.1028"></a>
-<span class="sourceLineNo">1029</span> * <li><code><jk>public</jk> T()</code><a name="line.1029"></a>
-<span class="sourceLineNo">1030</span> * </ul><a name="line.1030"></a>
-<span class="sourceLineNo">1031</span> * <li><a name="line.1031"></a>
-<span class="sourceLineNo">1032</span> * Inner classes of the REST resource class are allowed.<a name="line.1032"></a>
-<span class="sourceLineNo">1033</span> * </ul><a name="line.1033"></a>
-<span class="sourceLineNo">1034</span> *<a name="line.1034"></a>
-<span class="sourceLineNo">1035</span> * <h5 class='section'>See Also:</h5><a name="line.1035"></a>
-<span class="sourceLineNo">1036</span> * <ul><a name="line.1036"></a>
-<span class="sourceLineNo">1037</span> * <li class='link'>{@doc juneau-rest-server.Encoders}<a name="line.1037"></a>
-<span class="sourceLineNo">1038</span> * </ul><a name="line.1038"></a>
-<span class="sourceLineNo">1039</span> */<a name="line.1039"></a>
-<span class="sourceLineNo">1040</span> public static final String REST_encoders = PREFIX + "encoders.lo";<a name="line.1040"></a>
-<span class="sourceLineNo">1041</span><a name="line.1041"></a>
-<span class="sourceLineNo">1042</span> /**<a name="line.1042"></a>
-<span class="sourceLineNo">1043</span> * Configuration property: Class-level guards.<a name="line.1043"></a>
-<span class="sourceLineNo">1044</span> *<a name="line.1044"></a>
-<span class="sourceLineNo">1045</span> * <h5 class='section'>Property:</h5><a name="line.1045"></a>
-<span class="sourceLineNo">1046</span> * <ul><a name="line.1046"></a>
-<span class="sourceLineNo">1047</span> * <li><b>Name:</b> <js>"RestContext.guards.lo"</js><a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> * <li><b>Data type:</b> <code>List&lt;{@link RestGuard} | Class&lt;? <jk>extends</jk> {@link RestGuard}&gt;&gt;</code><a name="line.1048"></a>
-<span class="sourceLineNo">1049</span> * <li><b>Default:</b> empty list<a name="line.1049"></a>
-<span class="sourceLineNo">1050</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> * <li><b>Annotations:</b><a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> * <ul><a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> * <li class='ja'>{@link RestResource#guards()}<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> * <li class='ja'>{@link RestMethod#guards()}<a name="line.1054"></a>
-<span class="sourceLineNo">1055</span> * </ul><a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> * <li><b>Methods:</b><a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> * <ul><a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> * <li class='jm'>{@link RestContextBuilder#guards(Class...)}<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> * <li class='jm'>{@link RestContextBuilder#guards(RestGuard...)}<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> * </ul><a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> * </ul><a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> *<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> * <h5 class='section'>Description:</h5><a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> * <p><a name="line.1064"></a>
-<span class="sourceLineNo">1065</span> * Associates one or more {@link RestGuard RestGuards} with all REST methods defined in this class.<a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> * <br>These guards get called immediately before execution of any REST method in this class.<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> *<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * <p><a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * If multiple guards are specified, <b>ALL</b> guards must pass.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * <br>Note that this is different than matchers were only ONE matcher needs to pass.<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> *<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> * <h5 class='section'>Example:</h5><a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> * <p class='bcode w800'><a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> * <jc>// Define a guard that only lets Billy make a request.</jc><a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> * <jk>public</jk> BillyGuard <jk>extends</jk> RestGuard {<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> * <ja>@Override</ja><a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> * <jk>public boolean</jk> isRequestAllowed(RestRequest req) {<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> * <jk>return</jk> req.getUserPrincipal().getName().equals(<js>"Billy"</js>);<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> * }<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> * }<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> *<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> * <jc>// Option #1 - Registered via annotation.</jc><a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> * <ja>@RestResource</ja>(guards={BillyGuard.<jk>class</jk>})<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> * <jk>public class</jk> MyResource {<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> *<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> *<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> * <jc>// Using method on builder.</jc><a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> * builder.guards(BillyGuard.<jk>class</jk>);<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> *<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> * <jc>// Same, but using property.</jc><a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> * builder.addTo(<jsf>REST_guards</jsf>, BillyGuard.<jk>class</jk>);<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> * }<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> *<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> * builder.guards(BillyGuard.<jk>class</jk>);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> * }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> *<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> * <jc>// Override at the method level.</jc><a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> * <ja>@RestMethod</ja>(guards={SomeOtherGuard.<jk>class</jk>})<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> * public Object myMethod() {...}<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> * }<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> * </p><a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> *<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> * <h5 class='section'>Notes:</h5><a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> * <ul class='spaced-list'><a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> * <li><a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> * <ul><a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> * <li><code><jk>public</jk> T()</code><a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> * </ul><a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> * <li><a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> * Inner classes of the REST resource class are allowed.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> * </ul><a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> *<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> * <h5 class='section'>See Also:</h5><a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> * <ul><a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> * <li class='link'>{@doc juneau-rest-server.Guards}<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> * </ul><a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> */<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> public static final String REST_guards = PREFIX + "guards.lo";<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span><a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> /**<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> * Configuration property: REST info provider.<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> *<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> * <h5 class='section'>Property:</h5><a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> * <ul><a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> * <li><b>Name:</b> <js>"RestContext.infoProvider.o"</js><a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> * <li><b>Data type:</b> <code>{@link RestInfoProvider} | Class&lt;? <jk>extends</jk> {@link RestInfoProvider}&gt;</code><a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> * <li><b>Default:</b> {@link BasicRestInfoProvider}<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> * <li><b>Annotations:</b><a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> * <ul><a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> * <li class='ja'>{@link RestResource#infoProvider()}<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> * </ul><a name="line.1139"></a>
-<span class="sourceLineNo">1140</span> * <li><b>Methods:</b><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> * <ul><a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> * <li class='jm'>{@link RestContextBuilder#infoProvider(Class)}<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> * <li class='jm'>{@link RestContextBuilder#infoProvider(RestInfoProvider)}<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> * </ul><a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> * </ul><a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> *<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> * <h5 class='section'>Description:</h5><a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> * <p><a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> * Class used to retrieve title/description/swagger information about a resource.<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> *<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> * <h5 class='section'>Example:</h5><a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> * <p class='bcode w800'><a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> * <jc>// Our customized info provider.</jc><a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> * <jc>// Extend from the default implementation and selectively override values.</jc><a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> * <jk>public class</jk> MyRestInfoProvider <jk>extends</jk> BasicRestInfoProvider {<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span> *<a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> * <jc>// Must provide this constructor!</jc><a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> * <jk>public</jk> MyRestInfoProvider(RestContext context) {<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> * <jk>super</jk>(context);<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> * }<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> *<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> * <ja>@Override</ja><a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> * <jk>public</jk> Swagger getSwaggerFromFile(RestRequest req) <jk>throws</jk> RestException {<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> * <jc>// Provide our own method of retrieving swagger from file system.</jc><a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> * }<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> *<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> * <ja>@Override</ja><a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> * <jk>public</jk> Swagger getSwagger(RestRequest req) <jk>throws</jk> RestException {<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> * Swagger s = <jk>super</jk>.getSwagger(req);<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> * <jc>// Made inline modifications to generated swagger.</jc><a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> * <jk>return</jk> s;<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> * }<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> *<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> * <ja>@Override</ja><a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> * <jk>public</jk> String getSiteName(RestRequest req) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> * <jc>// Override the site name.</jc><a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> * }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> * }<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> *<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> * <jc>// Option #1 - Registered via annotation resolving to a config file setting with default value.</jc><a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> * <ja>@RestResource</ja>(infoProvider=MyRestInfoProvider.<jk>class</jk>)<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span> * <jk>public class</jk> MyResource {<a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> *<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> *<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> * <jc>// Using method on builder.</jc><a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> * builder.infoProvider(MyRestInfoProvider.<jk>class</jk>);<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span> *<a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> * <jc>// Same, but using property.</jc><a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * builder.set(<jsf>REST_infoProvider</jsf>, MyRestInfoProvider.<jk>class</jk>);<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * }<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> *<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> * builder.infoProvider(MyRestInfoProvider.<jk>class</jk>);<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> * }<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> * }<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> * </p><a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> *<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> * <h5 class='section'>Notes:</h5><a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> * <ul class='spaced-list'><a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> * <li><a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> * <ul><a name="line.1206"></a>
-<span class="sourceLineNo">1207</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> * <li><code><jk>public</jk> T()</code><a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * </ul><a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> * <li><a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> * Inner classes of the REST resource class are allowed.<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> * </ul><a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> */<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> public static final String REST_infoProvider = PREFIX + "infoProvider.o";<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span><a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> /**<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> * Configuration property: REST logger.<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> *<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> * <h5 class='section'>Property:</h5><a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> * <ul><a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> * <li><b>Name:</b> <js>"RestContext.logger.o"</js><a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> * <li><b>Data type:</b> <code>{@link RestLogger} | Class&lt;? <jk>extends</jk> {@link RestLogger}&gt;</code><a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> * <li><b>Default:</b> {@link BasicRestLogger}<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> * <li><b>Annotations:</b><a name="line.1225"></a>
-<span class="sourceLineNo">1226</span> * <ul><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> * <li class='ja'>{@link RestResource#logger()}<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * </ul><a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> * <li><b>Methods:</b><a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> * <ul><a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> * <li class='jm'>{@link RestContextBuilder#logger(Class)}<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> * <li class='jm'>{@link RestContextBuilder#logger(RestLogger)}<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> * </ul><a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> * </ul><a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> *<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> * <h5 class='section'>Description:</h5><a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> * <p><a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> * Specifies the logger to use for logging.<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span> *<a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> * <p><a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> * Two implementations are provided by default:<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> * <ul><a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> * <li class='jc'>{@link BasicRestLogger} - Default logging.<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> * <li class='jc'>{@link NoOpRestLogger} - Logging disabled.<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> * </ul><a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> *<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> * <p><a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> * Loggers are accessible through the following:<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> * <ul><a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> * <li class='jm'>{@link RestContext#getLogger() RestContext.getLogger()}<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> * <li class='jm'>{@link RestRequest#getLogger() RestRequest.getLogger()}<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> * </ul><a name="line.1252"></a>
-<span class="sourceLineNo">1253</span> *<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> * <h5 class='section'>Example:</h5><a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> * <p class='bcode w800'><a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> * <jc>// Our customized logger.</jc><a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> * <jk>public class</jk> MyRestLogger <jk>extends</jk> BasicRestLogger {<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> *<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span> * <ja>@Override</ja><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> * <jk>public void</jk> log(Level level, Throwable cause, String msg, Object...args) {<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * <jc>// Handle logging ourselves.</jc><a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * }<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> * }<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> *<a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * <jc>// Option #1 - Registered via annotation resolving to a config file setting with default value.</jc><a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * <ja>@RestResource</ja>(logger=MyRestLogger.<jk>class</jk>)<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * <jk>public class</jk> MyResource {<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> *<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> *<a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> * <jc>// Using method on builder.</jc><a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * builder.logger(MyRestLogger.<jk>class</jk>);<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> *<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * <jc>// Same, but using property.</jc><a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> * builder.set(<jsf>REST_logger</jsf>, MyRestLogger.<jk>class</jk>);<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> * }<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.1279"></a>
-<span class="sourceLineNo">1280</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> * builder.logger(MyRestLogger.<jk>class</jk>);<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> * }<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> * }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span> * </p><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> *<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> * <h5 class='section'>See Also:</h5><a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> * <ul><a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> * <li class='link'>{@doc juneau-rest-server.LoggingAndErrorHandling}<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> * </ul><a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> */<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> public static final String REST_logger = PREFIX + "logger.o";<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span><a name="line.1293"></a>
-<span class="sourceLineNo">1294</span> /**<a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> * Configuration property: The maximum allowed input size (in bytes) on HTTP requests.<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> *<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> * <h5 class='section'>Property:</h5><a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> * <ul><a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> * <li><b>Name:</b> <js>"RestContext.maxInput.s"</js><a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> * <li><b>Data type:</b> <code>String</code><a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> * <li><b>Default:</b> <js>"100M"</js><a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1302"></a>
-<span class="sourceLineNo">1303</span> * <li><b>Annotations:</b><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> * <ul><a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> * <li class='ja'>{@link RestResource#maxInput()}<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> * <li class='ja'>{@link RestMethod#maxInput()}<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> * </ul><a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> * <li><b>Methods:</b><a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> * <ul><a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> * <li class='jm'>{@link RestContextBuilder#maxInput(String)}<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> * </ul><a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> * </ul><a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> *<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> * <h5 class='section'>Description:</h5><a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> * <p><a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> * Useful for alleviating DoS attacks by throwing an exception when too much input is received instead of resulting<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> * in out-of-memory errors which could affect system stability.<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> *<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span> * <h5 class='section'>Example:</h5><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> * <p class='bcode w800'><a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> * <ja>@RestResource</ja>(maxInput=<js>"$C{REST/maxInput,10M}"</js>)<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> * <jk>public class</jk> MyResource {<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> *<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> *<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> * <jc>// Using method on builder.</jc><a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> * builder.maxInput(<js>"10M"</js>);<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> *<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> * <jc>// Same, but using property.</jc><a name="line.1331"></a>
-<span class="sourceLineNo">1332</span> * builder.set(<jsf>REST_maxInput</jsf>, <js>"10M"</js>);<a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> * }<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> *<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> * builder.maxInput(<js>"10M"</js>);<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> * }<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> *<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> * <jc>// Override at the method level.</jc><a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> * <ja>@RestMethod</ja>(maxInput=<js>"10M"</js>)<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> * public Object myMethod() {...}<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> * }<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> * </p><a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> *<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> * <h5 class='section'>Notes:</h5><a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> * <ul class='spaced-list'><a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> * <li><a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> * String value that gets resolved to a <jk>long</jk>.<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span> * <li><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> * Can be suffixed with any of the following representing kilobytes, megabytes, and gigabytes:<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * <js>'K'</js>, <js>'M'</js>, <js>'G'</js>.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> * <li><a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> * A value of <js>"-1"</js> can be used to represent no limit.<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> * </ul><a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> */<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> public static final String REST_maxInput = PREFIX + "maxInput.s";<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span><a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> /**<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> * Configuration property: Messages.<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> *<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> * <h5 class='section'>Property:</h5><a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> * <ul><a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> * <li><b>Name:</b> <js>"RestContext.messages.lo"</js><a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> * <li><b>Data type:</b> <code>List&lt;{@link MessageBundleLocation}&gt;</code><a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> * <li><b>Default:</b> <jk>null</jk><a name="line.1367"></a>
-<span class="sourceLineNo">1368</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> * <li><b>Annotations:</b><a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> * <ul><a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> * <li class='ja'>{@link RestResource#messages()}<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> * </ul><a name="line.1372"></a>
-<span class="sourceLineNo">1373</span> * <li><b>Methods:</b><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> * <ul><a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> * <li class='jm'>{@link RestContextBuilder#messages(String)},<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> * <li class='jm'>{@link RestContextBuilder#messages(Class,String)}<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> * <li class='jm'>{@link RestContextBuilder#messages(MessageBundleLocation...)}<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> * </ul><a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> * </ul><a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> *<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> * <h5 class='section'>Description:</h5><a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> * <p><a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> * Identifies the location of the resource bundle for this class.<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> *<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> * <p><a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> * This annotation is used to provide localized messages for the following methods:<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> * <ul><a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> * <li class='jm'>{@link RestRequest#getMessage(String, Object...)}<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> * <li class='jm'>{@link RestContext#getMessages() RestContext.getMessages()}<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span> * </ul><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> *<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> * <p><a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> * Messages are also available by passing either of the following parameter types into your Java method:<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> * <ul><a name="line.1394"></a>
-<span class="sourceLineNo">1395</span> * <li class='jc'>{@link ResourceBundle} - Basic Java resource bundle.<a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> * <li class='jc'>{@link MessageBundle} - Extended resource bundle with several convenience methods.<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> * </ul><a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> *<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span> * <p><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> * Messages passed into Java methods already have their locale set to that of the incoming request.<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> *<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> * <p><a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> * The value can be a relative path like <js>"nls/Messages"</js>, indicating to look for the resource bundle<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span> * <js>"com.foo.sample.nls.Messages"</js> if the resource class is in <js>"com.foo.sample"</js>, or it can be an<a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> * absolute path like <js>"com.foo.sample.nls.Messages"</js><a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> *<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> * <h5 class='section'>Examples:</h5><a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> * <p class='bcode w800'><a name="line.1408"></a>
-<span class="sourceLineNo">1409</span> * <jk>package</jk> org.apache.foo;<a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> *<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> * <jc>// Resolve messages to org/apache/foo/nls/MyMessages.properties</jc><a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> * <ja>@RestResource</ja>(messages=<js>"nls/MyMessages"</js>)<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> * <jk>public class</jk> MyResource {...}<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span> *<a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> * <ja>@RestMethod</ja>(name=<js>"GET"</js>, path=<js>"/hello/{you}"</js>)<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> * <jk>public</jk> Object helloYou(RestRequest req, MessageBundle messages, <ja>@Path</ja>(<js>"name"</js>) String you)) {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> * String s;<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> *<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span> * <jc>// Get it from the RestRequest object.</jc><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> * s = req.getMessage(<js>"HelloMessage"</js>, you);<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> *<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> * <jc>// Or get it from the method parameter.</jc><a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> * s = messages.getString(<js>"HelloMessage"</js>, you);<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span> *<a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> * <jc>// Or get the message in a locale different from the request.</jc><a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> * s = messages.getString(Locale.<jsf>UK</jsf>, <js>"HelloMessage"</js>, you);<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> *<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> * <jk>return</jk> s;<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span> * }<a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> * }<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> * </p><a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> *<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> * <h5 class='section'>Notes:</h5><a name="line.1433"></a>
-<span class="sourceLineNo">1434</span> * <ul class='spaced-list'><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> * <li<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> * >Mappings are cumulative from super classes.<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> * <br>Therefore, you can find and retrieve messages up the class-hierarchy chain.<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span> * </ul><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> *<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * <h5 class='section'>See Also:</h5><a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <ul><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * <li class='link'>{@doc juneau-rest-server.Messages}<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * </ul><a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> public static final String REST_messages = PREFIX + "messages.lo";<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span><a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> /**<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> * Configuration property: MIME types.<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> *<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span> * <h5 class='section'>Property:</h5><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> * <ul><a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> * <li><b>Name:</b> <js>"RestContext.mimeTypes.ss"</js><a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> * <li><b>Data type:</b> <code>Set&lt;String&gt;</code><a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> * <li><b>Default:</b> empty list<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> * <li><b>Annotations:</b><a name="line.1456"></a>
-<span class="sourceLineNo">1457</span> * <ul><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> * <li class='ja'>{@link RestResource#mimeTypes()}<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> * </ul><a name="line.1459"></a>
-<span class="sourceLineNo">1460</span> * <li><b>Methods:</b><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> * <ul><a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * <li class='jm'>{@link RestContextBuilder#mimeTypes(String...)}<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * </ul><a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * </ul><a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> *<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> * <h5 class='section'>Description:</h5><a name="line.1466"></a>
-<span class="sourceLineNo">1467</span> * <p><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> * Defines MIME-type file type mappings.<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> *<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> * <p><a name="line.1470"></a>
-<span class="sourceLineNo">1471</span> * Used for specifying the content type on file resources retrieved through the following methods:<a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> * <ul><a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> * <li class='jm'>{@link RestContext#resolveStaticFile(String) RestContext.resolveStaticFile(String)}<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String,boolean,MediaType)}<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String,boolean)}<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> * <li class='jm'>{@link RestRequest#getClasspathReaderResource(String)}<a name="line.1476"></a>
-<span class="sourceLineNo">1477</span> * </ul><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> *<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> * <p><a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> * This list appends to the existing list provided by {@link ExtendedMimetypesFileTypeMap}.<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> *<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span> * <h5 class='section'>Example:</h5><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> * <p class='bcode w800'><a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> * <ja>@RestResource</ja>(mimeTypes={<js>"text/plain txt text TXT"</js>})<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> * <jk>public class</jk> MyResource {<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> *<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> *<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> * <jc>// Using method on builder.</jc><a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> * builder.mimeTypes(<js>"text/plain txt text TXT"</js>);<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> *<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> * <jc>// Same, but using property.</jc><a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> * builder.addTo(<jsf>REST_mimeTypes</jsf>, <js>"text/plain txt text TXT"</js>);<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> * }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> *<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> * builder.mimeTypes(<js>"text/plain txt text TXT"</js>);<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> * }<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> * }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span> * </p><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> *<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> * <h5 class='section'>Notes:</h5><a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> * <ul class='spaced-list'><a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> * <li><a name="line.1508"></a>
-<span class="sourceLineNo">1509</span> * Values are .mime.types formatted entry string.<a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> * <br>Example: <js>"image/svg+xml svg"</js><a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * </ul><a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> public static final String REST_mimeTypes = PREFIX + "mimeTypes.ss";<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span><a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> /**<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> * Configuration property: Java method parameter resolvers.<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> *<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span> * <h5 class='section'>Property:</h5><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> * <ul><a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> * <li><b>Name:</b> <js>"RestContext.paramResolvers.lo"</js><a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> * <li><b>Data type:</b> <code>List&lt;{@link RestMethodParam} | Class&lt;? <jk>extends</jk> {@link RestMethodParam}&gt;&gt;</code><a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> * <li><b>Default:</b> empty list<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> * <li><b>Annotations:</b><a name="line.1524"></a>
-<span class="sourceLineNo">1525</span> * <ul><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> * <li class='ja'>{@link RestResource#paramResolvers()}<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> * </ul><a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> * <li><b>Methods:</b><a name="line.1528"></a>
-<span class="sourceLineNo">1529</span> * <ul><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> * <li class='jm'>{@link RestContextBuilder#paramResolvers(Class...)}<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> * <li class='jm'>{@link RestContextBuilder#paramResolvers(RestMethodParam...)}<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> * </ul><a name="line.1532"></a>
-<span class="sourceLineNo">1533</span> * </ul><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> *<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> * <h5 class='section'>Description:</h5><a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> * <p><a name="line.1536"></a>
-<span class="sourceLineNo">1537</span> * By default, the Juneau framework will automatically Java method parameters of various types (e.g.<a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> * <code>RestRequest</code>, <code>Accept</code>, <code>Reader</code>).<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> * This setting allows you to provide your own resolvers for your own class types that you want resolved.<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> *<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> * <p><a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> * For example, if you want to pass in instances of <code>MySpecialObject</code> to your Java method, define<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> * the following resolver:<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span> * <p class='bcode w800'><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> * <jc>// Define a parameter resolver for resolving MySpecialObject objects.</jc><a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> * <jk>public class</jk> MyRestParam <jk>extends</jk> RestMethodParam {<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> *<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> * <jc>// Must have no-arg constructor!</jc><a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> * <jk>public</jk> MyRestParam() {<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> * <jc>// First two parameters help with Swagger doc generation.</jc><a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> * <jk>super</jk>(<jsf>QUERY</jsf>, <js>"myparam"</js>, MySpecialObject.<jk>class</jk>);<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> * }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> *<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> * <jc>// The method that creates our object.<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> * // In this case, we're taking in a query parameter and converting it to our object.</jc><a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> * <jk>public</jk> Object resolve(RestRequest req, RestResponse res) <jk>throws</jk> Exception {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> * <jk>return new</jk> MySpecialObject(req.getQuery().get(<js>"myparam"</js>));<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> * }<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> * }<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> *<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> * <jc>// Option #1 - Registered via annotation.</jc><a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> * <ja>@RestResource</ja>(paramResolvers=MyRestParam.<jk>class</jk>)<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> * <jk>public class</jk> MyResource {<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> *<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> * <jc>// Option #2 - Registered via builder passed in through resource constructor.</jc><a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> *<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> * <jc>// Using method on builder.</jc><a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> * builder.paramResolvers(MyRestParam.<jk>class</jk>);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> *<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> * <jc>// Same, but using property.</jc><a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> * builder.addTo(<jsf>REST_paramResolver</jsf>, MyRestParam.<jk>class</jk>);<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> * }<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> *<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> * <jc>// Option #3 - Registered via builder passed in through init method.</jc><a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> * builder.paramResolvers(MyRestParam.<jk>class</jk>);<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> * }<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> *<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> * <jc>// Now pass it into your method.</jc><a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> * <ja>@RestMethod</ja>(...)<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span> * <jk>public</jk> Object doMyMethod(MySpecialObject mySpeciaObject) {<a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> * <jc>// Do something with it.</jc><a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * }<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> * }<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> * </p><a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> *<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> * <h5 class='section'>Notes:</h5><a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> * <ul class='spaced-list'><a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> * <li><a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> * <ul><a name="line.1593"></a>
-<span class="sourceLineNo">1594</span> * <li><code><jk>public</jk> T(BeanContext)</code><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> * <li><code><jk>public</jk> T()</code><a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> * </ul><a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> * <li><a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> * Inner classes of the REST resource class are allowed.<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> * <li><a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> * Refer to {@link RestMethodParam} for the list of predefined parameter resolvers.<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span> * </ul><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> */<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public static final String REST_paramResolvers = PREFIX + "paramResolvers.lo";<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span><a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> /**<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span> * Configuration property: Parsers.<a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> *<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> * <h5 class='section'>Property:</h5><a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> * <ul><a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> * <li><b>Name:</b> <js>"RestContext.parsers.lo"</js><a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> * <li><b>Data type:</b> <code>List&lt;{@link Parser} | Class&lt;? <jk>extends</jk> {@link Parser}&gt;&gt;</code><a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> * <li><b>Default:</b> empty list<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> * <li><b>Annotations:</b><a name="line.1614"></a>
-<span class="sourceLineNo">1615</span> * <ul><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> * <li class='ja'>{@link RestResource#parsers()}<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> * <li class='ja'>{@link RestMethod#parsers()}<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> * </ul><a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> * <li><b>Methods:</b><a name="line.1619"></a>
-<span class="sourceLineNo">1620</span> * <ul><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> * <li class='jm'>{@link RestContextBuilder#parsers(Object...)}<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> * <li class='jm'>{@link RestContextBuilder#parsers(Class...)}<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> * <li class='jm'>{@link RestContextBuilder#parsers(boolean,Object...)}<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> * </ul><a name="line.1624"></a>
-<span class="sourceLineNo">1625</span> * </ul><a name="line.1625"></a>
-<span class="sourceLineNo">1626</span> *<a name="line.1626"></a>
-<span class="sourceLineNo">1627</span> * <h5 class='section'>Description:</h5><a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> * <p><a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> * Adds class-level parsers to this resource.<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> *<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span> * <p><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> * Parsers are used to convert the body of HTTP requests into POJOs.<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> * <br>Any of the Juneau framework parsers can be used in this setting.<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> * <br>The parser selected is based on the request <code>Content-Type</code> header matched against the values returned by the following method<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> * using a best-match algorithm:<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span> * <ul><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> * <li class='jm'>{@link Parser#getMediaTypes()}<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> * </ul><a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> *<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> * <h5 class='section'>Example:</h5><a name="line.1640"></a>
-<span class="sourceLineNo">1641</span> * <p class='bcode w800'><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> * <ja>@RestResource</ja>(parsers={JsonParser.<jk>class</jk>, XmlParser.<jk>class</jk>})<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> * <jk>public class</jk> MyResource {<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> *<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> *<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> * <jc>// Using method on builder.</jc><a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> * builder.parsers(JsonParser.<jk>class</jk>, XmlParser.<jk>class</jk>);<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span> *<a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> * <jc>// Same, but use pre-instantiated parsers.</jc><a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> * builder.parsers(JsonParser.<jsf>DEFAULT</jsf>, XmlParser.<jsf>DEFAULT</jsf>);<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> *<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> * <jc>// Same, but using property.</jc><a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> * builder.set(<jsf>REST_parsers</jsf>, JsonParser.<jk>class</jk>, XmlParser.<jk>class</jk>);<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> * }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> *<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1659"></a>
-<span class="sourceLineNo">1660</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> * builder.parsers(JsonParser.<jk>class</jk>, XmlParser.<jk>class</jk>);<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> * }<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> *<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span> * <jc>// Override at the method level.</jc><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> * <ja>@RestMethod</ja>(parsers={HtmlParser.<jk>class</jk>})<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> * <jk>public</jk> Object myMethod(<ja>@Body</ja> MyPojo myPojo) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> * <jc>// Do something with your parsed POJO.</jc><a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> * }<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> * }<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> * </p><a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> *<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> * <h5 class='section'>Notes:</h5><a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> * <ul class='spaced-list'><a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> * <li><a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> * When defined as a class, properties/transforms defined on the resource/method are inherited.<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span> * <li><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> * When defined as an instance, properties/transforms defined on the resource/method are NOT inherited.<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> * <li><a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> * Typically, you'll want your resource to extend directly from {@link BasicRestServlet} which comes<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> * preconfigured with the following parsers:<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> * <ul><a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> * <li class='jc'>{@link JsonParser}<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span> * <li class='jc'>{@link XmlParser}<a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> * <li class='jc'>{@link HtmlParser}<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> * <li class='jc'>{@link UonParser}<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> * <li class='jc'>{@link UrlEncodingParser}<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> * <li class='jc'>{@link MsgPackParser}<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span> * <li class='jc'>{@link PlainTextParser}<a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> * </ul><a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> * </ul><a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> *<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> * <h5 class='section'>See Also:</h5><a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> * <ul><a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> * <li class='link'>{@doc juneau-rest-server.Parsers}<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> * </ul><a name="line.1696"></a>
-<span class="sourceLineNo">1697</span> */<a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> public static final String REST_parsers = PREFIX + "parsers.lo";<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span><a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> /**<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span> * Configuration property: HTTP part parser.<a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> *<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> * <h5 class='section'>Property:</h5><a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> * <ul><a name="line.1704"></a>
-<span class="sourceLineNo">1705</span> * <li><b>Name:</b> <js>"RestContext.partParser.o"</js><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> * <li><b>Data type:</b> <code>{@link HttpPartParser} | Class&lt;? <jk>extends</jk> {@link HttpPartParser}&gt;</code><a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> * <li><b>Default:</b> {@link OpenApiParser}<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1708"></a>
-<span class="sourceLineNo">1709</span> * <li><b>Annotations:</b><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> * <ul><a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> * <li class='ja'>{@link RestResource#partParser()}<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> * </ul><a name="line.1712"></a>
-<span class="sourceLineNo">1713</span> * <li><b>Methods:</b><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> * <ul><a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> * <li class='jm'>{@link RestContextBuilder#partParser(Class)}<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> * <li class='jm'>{@link RestContextBuilder#partParser(HttpPartParser)}<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span> * </ul><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> * </ul><a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> *<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> * <h5 class='section'>Description:</h5><a name="line.1720"></a>
-<span class="sourceLineNo">1721</span> * <p><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> * Specifies the {@link HttpPartParser} to use for parsing headers, query/form parameters, and URI parts.<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> *<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> * <p><a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> * The default value is {@link OpenApiParser} which allows for both plain-text and URL-Encoded-Object-Notation values.<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> * <br>If your parts contain text that can be confused with UON (e.g. <js>"(foo)"</js>), you can switch to<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * {@link SimplePartParser} which treats everything as plain text.<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> *<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * <h5 class='section'>Example:</h5><a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * <p class='bcode w800'><a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * <ja>@RestResource</ja>(partParser=SimplePartParser.<jk>class</jk>)<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * <jk>public class</jk> MyResource {<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> *<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1735"></a>
-<span class="sourceLineNo">1736</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> *<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> * <jc>// Using method on builder.</jc><a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> * builder.partParser(SimplePartParser.<jk>class</jk>);<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span> *<a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> * <jc>// Same, but using property.</jc><a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> * builder.set(<jsf>REST_partParser</jsf>, SimplePartParser.<jk>class</jk>);<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> * }<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> *<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> * builder.partParser(SimplePartParser.<jk>class</jk>);<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> * }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span> *<a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> * <ja>@RestMethod</ja>(...)<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * <jk>public</jk> Object myMethod(<ja>@Header</ja>(<js>"My-Header"</js>) MyParsedHeader h, <ja>@Query</ja>(<js>"myquery"</js>) MyParsedQuery q) {<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * <jc>// Do something with your parsed parts.</jc><a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> * }<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> * }<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> * </p><a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> *<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> * <h5 class='section'>Notes:</h5><a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> * <ul class='spaced-list'><a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> * <li><a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> * When defined as a class, properties/transforms defined on the resource/method are inherited.<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> * <li><a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> * When defined as an instance, properties/transforms defined on the resource/method are NOT inherited.<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> * </ul><a name="line.1764"></a>
-<span class="sourceLineNo">1765</span> */<a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public static final String REST_partParser = PREFIX + "partParser.o";<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span><a name="line.1767"></a>
-<span class="sourceLineNo">1768</span> /**<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> * Configuration property: HTTP part serializer.<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span> *<a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> * <h5 class='section'>Property:</h5><a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * <ul><a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * <li><b>Name:</b> <js>"RestContext.partSerializer.o"</js><a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * <li><b>Data type:</b> <code>{@link HttpPartSerializer} | Class&lt;? <jk>extends</jk> {@link HttpPartSerializer}&gt;</code><a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * <li><b>Default:</b> {@link OpenApiSerializer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> * <li><b>Annotations:</b><a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> * <ul><a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> * <li class='ja'>{@link RestResource#partSerializer()}<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> * </ul><a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> * <li><b>Methods:</b><a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> * <ul><a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> * <li class='jm'>{@link RestContextBuilder#partSerializer(Class)}<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> * <li class='jm'>{@link RestContextBuilder#partSerializer(HttpPartSerializer)}<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span> * </ul><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> * </ul><a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> *<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> * <h5 class='section'>Description:</h5><a name="line.1788"></a>
-<span class="sourceLineNo">1789</span> * <p><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> * Specifies the {@link HttpPartSerializer} to use for serializing headers, query/form parameters, and URI parts.<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> *<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> * <p><a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> * The default value is {@link OpenApiSerializer} which serializes based on OpenAPI rules, but defaults to UON notation for beans and maps, and<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> * plain text for everything else.<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> * <br>Other options include:<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> * <ul><a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> * <li class='jc'>{@link SimplePartSerializer} - Always serializes to plain text.<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> * <li class='jc'>{@link UonSerializer} - Always serializers to UON.<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span> * </ul><a name="line.1799"></a>
-<span class="sourceLineNo">1800</span> *<a name="line.1800"></a>
-<span class="sourceLineNo">1801</span> * <h5 class='section'>Example:</h5><a name="line.1801"></a>
-<span class="sourceLineNo">1802</span> * <p class='bcode w800'><a name="line.1802"></a>
-<span class="sourceLineNo">1803</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1803"></a>
-<span class="sourceLineNo">1804</span> * <ja>@RestResource</ja>(partSerializer=SimplePartSerializer.<jk>class</jk>)<a name="line.1804"></a>
-<span class="sourceLineNo">1805</span> * <jk>public class</jk> MyResource {<a name="line.1805"></a>
-<span class="sourceLineNo">1806</span> *<a name="line.1806"></a>
-<span class="sourceLineNo">1807</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1807"></a>
-<span class="sourceLineNo">1808</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1808"></a>
-<span class="sourceLineNo">1809</span> *<a name="line.1809"></a>
-<span class="sourceLineNo">1810</span> * <jc>// Using method on builder.</jc><a name="line.1810"></a>
-<span class="sourceLineNo">1811</span> * builder.partSerializer(SimplePartSerializer.<jk>class</jk>);<a name="line.1811"></a>
-<span class="sourceLineNo">1812</span> *<a name="line.1812"></a>
-<span class="sourceLineNo">1813</span> * <jc>// Same, but using property.</jc><a name="line.1813"></a>
-<span class="sourceLineNo">1814</span> * builder.set(<jsf>REST_partSerializer</jsf>, SimplePartSerializer.<jk>class</jk>);<a name="line.1814"></a>
-<span class="sourceLineNo">1815</span> * }<a name="line.1815"></a>
-<span class="sourceLineNo">1816</span> *<a name="line.1816"></a>
-<span class="sourceLineNo">1817</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1817"></a>
-<span class="sourceLineNo">1818</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1818"></a>
-<span class="sourceLineNo">1819</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1819"></a>
-<span class="sourceLineNo">1820</span> * builder.partSerializer(SimplePartSerializer.<jk>class</jk>);<a name="line.1820"></a>
-<span class="sourceLineNo">1821</span> * }<a name="line.1821"></a>
-<span class="sourceLineNo">1822</span> *<a name="line.1822"></a>
-<span class="sourceLineNo">1823</span> * <ja>@RestMethod</ja>(...)<a name="line.1823"></a>
-<span class="sourceLineNo">1824</span> * <jk>public</jk> Object myMethod(RestResponse res) {<a name="line.1824"></a>
-<span class="sourceLineNo">1825</span> * <jc>// Set a header to a POJO.</jc><a name="line.1825"></a>
-<span class="sourceLineNo">1826</span> * res.setHeader(<js>"My-Header"</js>, <jk>new</jk> MyPojo());<a name="line.1826"></a>
-<span class="sourceLineNo">1827</span> * }<a name="line.1827"></a>
-<span class="sourceLineNo">1828</span> * }<a name="line.1828"></a>
-<span class="sourceLineNo">1829</span> * </p><a name="line.1829"></a>
-<span class="sourceLineNo">1830</span> *<a name="line.1830"></a>
-<span class="sourceLineNo">1831</span> * <h5 class='section'>Notes:</h5><a name="line.1831"></a>
-<span class="sourceLineNo">1832</span> * <ul class='spaced-list'><a name="line.1832"></a>
-<span class="sourceLineNo">1833</span> * <li><a name="line.1833"></a>
-<span class="sourceLineNo">1834</span> * When defined as a class, properties/transforms defined on the resource/method are inherited.<a name="line.1834"></a>
-<span class="sourceLineNo">1835</span> * <li><a name="line.1835"></a>
-<span class="sourceLineNo">1836</span> * When defined as an instance, properties/transforms defined on the resource/method are NOT inherited.<a name="line.1836"></a>
-<span class="sourceLineNo">1837</span> * </ul><a name="line.1837"></a>
-<span class="sourceLineNo">1838</span> */<a name="line.1838"></a>
-<span class="sourceLineNo">1839</span> public static final String REST_partSerializer = PREFIX + "partSerializer.o";<a name="line.1839"></a>
-<span class="sourceLineNo">1840</span><a name="line.1840"></a>
-<span class="sourceLineNo">1841</span> /**<a name="line.1841"></a>
-<span class="sourceLineNo">1842</span> * Configuration property: Resource path.<a name="line.1842"></a>
-<span class="sourceLineNo">1843</span> *<a name="line.1843"></a>
-<span class="sourceLineNo">1844</span> * <h5 class='section'>Property:</h5><a name="line.1844"></a>
-<span class="sourceLineNo">1845</span> * <ul><a name="line.1845"></a>
-<span class="sourceLineNo">1846</span> * <li><b>Name:</b> <js>"RestContext.path.s"</js><a name="line.1846"></a>
-<span class="sourceLineNo">1847</span> * <li><b>Data type:</b> <code>String</code><a name="line.1847"></a>
-<span class="sourceLineNo">1848</span> * <li><b>Default:</b> <jk>null</jk><a name="line.1848"></a>
-<span class="sourceLineNo">1849</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1849"></a>
-<span class="sourceLineNo">1850</span> * <li><b>Annotations:</b><a name="line.1850"></a>
-<span class="sourceLineNo">1851</span> * <ul><a name="line.1851"></a>
-<span class="sourceLineNo">1852</span> * <li class='ja'>{@link RestResource#path()}<a name="line.1852"></a>
-<span class="sourceLineNo">1853</span> * </ul><a name="line.1853"></a>
-<span class="sourceLineNo">1854</span> * <li><b>Methods:</b><a name="line.1854"></a>
-<span class="sourceLineNo">1855</span> * <ul><a name="line.1855"></a>
-<span class="sourceLineNo">1856</span> * <li class='jm'>{@link RestContextBuilder#path(String)}<a name="line.1856"></a>
-<span class="sourceLineNo">1857</span> * </ul><a name="line.1857"></a>
-<span class="sourceLineNo">1858</span> * </ul><a name="line.1858"></a>
-<span class="sourceLineNo">1859</span> *<a name="line.1859"></a>
-<span class="sourceLineNo">1860</span> * <h5 class='section'>Description:</h5><a name="line.1860"></a>
-<span class="sourceLineNo">1861</span> * <p><a name="line.1861"></a>
-<span class="sourceLineNo">1862</span> * Identifies the URL subpath relative to the ascendant resource.<a name="line.1862"></a>
-<span class="sourceLineNo">1863</span> *<a name="line.1863"></a>
-<span class="sourceLineNo">1864</span> * <p><a name="line.1864"></a>
-<span class="sourceLineNo">1865</span> * This setting is critical for the routing of HTTP requests from ascendant to child resources.<a name="line.1865"></a>
-<span class="sourceLineNo">1866</span> *<a name="line.1866"></a>
-<span class="sourceLineNo">1867</span> * <h5 class='section'>Example:</h5><a name="line.1867"></a>
-<span class="sourceLineNo">1868</span> * <p class='bcode w800'><a name="line.1868"></a>
-<span class="sourceLineNo">1869</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1869"></a>
-<span class="sourceLineNo">1870</span> * <ja>@RestResource</ja>(path=<js>"/myResource"</js>)<a name="line.1870"></a>
-<span class="sourceLineNo">1871</span> * <jk>public class</jk> MyResource {<a name="line.1871"></a>
-<span class="sourceLineNo">1872</span> *<a name="line.1872"></a>
-<span class="sourceLineNo">1873</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1873"></a>
-<span class="sourceLineNo">1874</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1874"></a>
-<span class="sourceLineNo">1875</span> *<a name="line.1875"></a>
-<span class="sourceLineNo">1876</span> * <jc>// Using method on builder.</jc><a name="line.1876"></a>
-<span class="sourceLineNo">1877</span> * builder.path(<js>"/myResource"</js>);<a name="line.1877"></a>
-<span class="sourceLineNo">1878</span> *<a name="line.1878"></a>
-<span class="sourceLineNo">1879</span> * <jc>// Same, but using property.</jc><a name="line.1879"></a>
-<span class="sourceLineNo">1880</span> * builder.set(<jsf>REST_path</jsf>, <js>"/myResource"</js>);<a name="line.1880"></a>
-<span class="sourceLineNo">1881</span> * }<a name="line.1881"></a>
-<span class="sourceLineNo">1882</span> *<a name="line.1882"></a>
-<span class="sourceLineNo">1883</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1883"></a>
-<span class="sourceLineNo">1884</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1884"></a>
-<span class="sourceLineNo">1885</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1885"></a>
-<span class="sourceLineNo">1886</span> * builder.path(<js>"/myResource"</js>);<a name="line.1886"></a>
-<span class="sourceLineNo">1887</span> * }<a name="line.1887"></a>
-<span class="sourceLineNo">1888</span> * }<a name="line.1888"></a>
-<span class="sourceLineNo">1889</span> * </p><a name="line.1889"></a>
-<span class="sourceLineNo">1890</span> *<a name="line.1890"></a>
-<span class="sourceLineNo">1891</span> * <p><a name="line.1891"></a>
-<span class="sourceLineNo">1892</span> * <h5 class='section'>Notes:</h5><a name="line.1892"></a>
-<span class="sourceLineNo">1893</span> * <ul class='spaced-list'><a name="line.1893"></a>
-<span class="sourceLineNo">1894</span> * <li><a name="line.1894"></a>
-<span class="sourceLineNo">1895</span> * This annotation is ignored on top-level servlets (i.e. servlets defined in <code>web.xml</code> files).<a name="line.1895"></a>
-<span class="sourceLineNo">1896</span> * <br>Therefore, implementers can optionally specify a path value for documentation purposes.<a name="line.1896"></a>
-<span class="sourceLineNo">1897</span> * <li><a name="line.1897"></a>
-<span class="sourceLineNo">1898</span> * Typically, this setting is only applicable to resources defined as children through the<a name="line.1898"></a>
-<span class="sourceLineNo">1899</span> * {@link RestResource#children() @RestResource(children)} annotation.<a name="line.1899"></a>
-<span class="sourceLineNo">1900</span> * <br>However, it may be used in other ways (e.g. defining paths for top-level resources in microservices).<a name="line.1900"></a>
-<span class="sourceLineNo">1901</span> * <li><a name="line.1901"></a>
-<span class="sourceLineNo">1902</span> * Slashes are trimmed from the path ends.<a name="line.1902"></a>
-<span class="sourceLineNo">1903</span> * <br>As a convention, you may want to start your path with <js>'/'</js> simple because it make it easier to read.<a name="line.1903"></a>
-<span class="sourceLineNo">1904</span> * <li><a name="line.1904"></a>
-<span class="sourceLineNo">1905</span> * This path is available through the following method:<a name="line.1905"></a>
-<span class="sourceLineNo">1906</span> * <ul><a name="line.1906"></a>
-<span class="sourceLineNo">1907</span> * <li class='jm'>{@link RestContext#getPath() RestContext.getPath()}<a name="line.1907"></a>
-<span class="sourceLineNo">1908</span> * </ul><a name="line.1908"></a>
-<span class="sourceLineNo">1909</span> * </ul><a name="line.1909"></a>
-<span class="sourceLineNo">1910</span> */<a name="line.1910"></a>
-<span class="sourceLineNo">1911</span> public static final String REST_path = PREFIX + "path.s";<a name="line.1911"></a>
-<span class="sourceLineNo">1912</span><a name="line.1912"></a>
-<span class="sourceLineNo">1913</span> /**<a name="line.1913"></a>
-<span class="sourceLineNo">1914</span> * Configuration property: Render response stack traces in responses.<a name="line.1914"></a>
-<span class="sourceLineNo">1915</span> *<a name="line.1915"></a>
-<span class="sourceLineNo">1916</span> * <h5 class='section'>Property:</h5><a name="line.1916"></a>
-<span class="sourceLineNo">1917</span> * <ul><a name="line.1917"></a>
-<span class="sourceLineNo">1918</span> * <li><b>Name:</b> <js>"RestContext.renderResponseStackTraces.b"</js><a name="line.1918"></a>
-<span class="sourceLineNo">1919</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.1919"></a>
-<span class="sourceLineNo">1920</span> * <li><b>Default:</b> <jk>false</jk><a name="line.1920"></a>
-<span class="sourceLineNo">1921</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1921"></a>
-<span class="sourceLineNo">1922</span> * <li><b>Annotations:</b><a name="line.1922"></a>
-<span class="sourceLineNo">1923</span> * <ul><a name="line.1923"></a>
-<span class="sourceLineNo">1924</span> * <li class='ja'>{@link RestResource#renderResponseStackTraces()}<a name="line.1924"></a>
-<span class="sourceLineNo">1925</span> * </ul><a name="line.1925"></a>
-<span class="sourceLineNo">1926</span> * <li><b>Methods:</b><a name="line.1926"></a>
-<span class="sourceLineNo">1927</span> * <ul><a name="line.1927"></a>
-<span class="sourceLineNo">1928</span> * <li class='jm'>{@link RestContextBuilder#renderResponseStackTraces(boolean)}<a name="line.1928"></a>
-<span class="sourceLineNo">1929</span> * <li class='jm'>{@link RestContextBuilder#renderResponseStackTraces()}<a name="line.1929"></a>
-<span class="sourceLineNo">1930</span> * </ul><a name="line.1930"></a>
-<span class="sourceLineNo">1931</span> * </ul><a name="line.1931"></a>
-<span class="sourceLineNo">1932</span> *<a name="line.1932"></a>
-<span class="sourceLineNo">1933</span> * <h5 class='section'>Description:</h5><a name="line.1933"></a>
-<span class="sourceLineNo">1934</span> * <p><a name="line.1934"></a>
-<span class="sourceLineNo">1935</span> * Render stack traces in HTTP response bodies when errors occur.<a name="line.1935"></a>
-<span class="sourceLineNo">1936</span> *<a name="line.1936"></a>
-<span class="sourceLineNo">1937</span> * <h5 class='section'>Example:</h5><a name="line.1937"></a>
-<span class="sourceLineNo">1938</span> * <p class='bcode w800'><a name="line.1938"></a>
-<span class="sourceLineNo">1939</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.1939"></a>
-<span class="sourceLineNo">1940</span> * <ja>@RestResource</ja>(renderResponseStackTraces=<jk>true</jk>)<a name="line.1940"></a>
-<span class="sourceLineNo">1941</span> * <jk>public class</jk> MyResource {<a name="line.1941"></a>
-<span class="sourceLineNo">1942</span> *<a name="line.1942"></a>
-<span class="sourceLineNo">1943</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.1943"></a>
-<span class="sourceLineNo">1944</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1944"></a>
-<span class="sourceLineNo">1945</span> *<a name="line.1945"></a>
-<span class="sourceLineNo">1946</span> * <jc>// Using method on builder.</jc><a name="line.1946"></a>
-<span class="sourceLineNo">1947</span> * builder.renderResponseStackTraces();<a name="line.1947"></a>
-<span class="sourceLineNo">1948</span> *<a name="line.1948"></a>
-<span class="sourceLineNo">1949</span> * <jc>// Same, but using property.</jc><a name="line.1949"></a>
-<span class="sourceLineNo">1950</span> * builder.set(<jsf>REST_renderResponseStackTraces</jsf>, <jk>true</jk>);<a name="line.1950"></a>
-<span class="sourceLineNo">1951</span> * }<a name="line.1951"></a>
-<span class="sourceLineNo">1952</span> *<a name="line.1952"></a>
-<span class="sourceLineNo">1953</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.1953"></a>
-<span class="sourceLineNo">1954</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.1954"></a>
-<span class="sourceLineNo">1955</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.1955"></a>
-<span class="sourceLineNo">1956</span> * builder.renderResponseStackTraces();<a name="line.1956"></a>
-<span class="sourceLineNo">1957</span> * }<a name="line.1957"></a>
-<span class="sourceLineNo">1958</span> * }<a name="line.1958"></a>
-<span class="sourceLineNo">1959</span> * </p><a name="line.1959"></a>
-<span class="sourceLineNo">1960</span> *<a name="line.1960"></a>
-<span class="sourceLineNo">1961</span> * <h5 class='section'>Notes:</h5><a name="line.1961"></a>
-<span class="sourceLineNo">1962</span> * <ul class='spaced-list'><a name="line.1962"></a>
-<span class="sourceLineNo">1963</span> * <li><a name="line.1963"></a>
-<span class="sourceLineNo">1964</span> * Useful for debugging, although allowing stack traces to be rendered may cause security concerns so use<a name="line.1964"></a>
-<span class="sourceLineNo">1965</span> * caution when enabling.<a name="line.1965"></a>
-<span class="sourceLineNo">1966</span> * <li><a name="line.1966"></a>
-<span class="sourceLineNo">1967</span> * This setting is available through the following method:<a name="line.1967"></a>
-<span class="sourceLineNo">1968</span> * <ul><a name="line.1968"></a>
-<span class="sourceLineNo">1969</span> * <li class='jm'>{@link RestContext#isRenderResponseStackTraces() RestContext.isRenderResponseStackTraces()}<a name="line.1969"></a>
-<span class="sourceLineNo">1970</span> * </ul><a name="line.1970"></a>
-<span class="sourceLineNo">1971</span> * That method is used by {@link BasicRestCallHandler#handleError(HttpServletRequest, HttpServletResponse, Throwable)}.<a name="line.1971"></a>
-<span class="sourceLineNo">1972</span> * </ul><a name="line.1972"></a>
-<span class="sourceLineNo">1973</span> */<a name="line.1973"></a>
-<span class="sourceLineNo">1974</span> public static final String REST_renderResponseStackTraces = PREFIX + "renderResponseStackTraces.b";<a name="line.1974"></a>
-<span class="sourceLineNo">1975</span><a name="line.1975"></a>
-<span class="sourceLineNo">1976</span> /**<a name="line.1976"></a>
-<span class="sourceLineNo">1977</span> * Configuration property: REST resource resolver.<a name="line.1977"></a>
-<span class="sourceLineNo">1978</span> *<a name="line.1978"></a>
-<span class="sourceLineNo">1979</span> * <h5 class='section'>Property:</h5><a name="line.1979"></a>
-<span class="sourceLineNo">1980</span> * <ul><a name="line.1980"></a>
-<span class="sourceLineNo">1981</span> * <li><b>Name:</b> <js>"RestContext.resourceResolver.o"</js><a name="line.1981"></a>
-<span class="sourceLineNo">1982</span> * <li><b>Data type:</b> <code>{@link RestResourceResolver} | Class&lt;? <jk>extends</jk> {@link RestResourceResolver}&gt;</code><a name="line.1982"></a>
-<span class="sourceLineNo">1983</span> * <li><b>Default:</b> {@link BasicRestResourceResolver}<a name="line.1983"></a>
-<span class="sourceLineNo">1984</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.1984"></a>
-<span class="sourceLineNo">1985</span> * <li><b>Annotations:</b><a name="line.1985"></a>
-<span class="sourceLineNo">1986</span> * <ul><a name="line.1986"></a>
-<span class="sourceLineNo">1987</span> * <li class='ja'>{@link RestResource#resourceResolver()}<a name="line.1987"></a>
-<span class="sourceLineNo">1988</span> * </ul><a name="line.1988"></a>
-<span class="sourceLineNo">1989</span> * <li><b>Methods:</b><a name="line.1989"></a>
-<span class="sourceLineNo">1990</span> * <ul><a name="line.1990"></a>
-<span class="sourceLineNo">1991</span> * <li class='jm'>{@link RestContextBuilder#resourceResolver(Class)}<a name="line.1991"></a>
-<span class="sourceLineNo">1992</span> * <li class='jm'>{@link RestContextBuilder#resourceResolver(RestResourceResolver)}<a name="line.1992"></a>
-<span class="sourceLineNo">1993</span> * </ul><a name="line.1993"></a>
-<span class="sourceLineNo">1994</span> * </ul><a name="line.1994"></a>
-<span class="sourceLineNo">1995</span> *<a name="line.1995"></a>
-<span class="sourceLineNo">1996</span> * <h5 class='section'>Description:</h5><a name="line.1996"></a>
-<span class="sourceLineNo">1997</span> * <p><a name="line.1997"></a>
-<span class="sourceLineNo">1998</span> * The resolver used for resolving instances of child resources.<a name="line.1998"></a>
-<span class="sourceLineNo">1999</span> *<a name="line.1999"></a>
-<span class="sourceLineNo">2000</span> * <p><a name="line.2000"></a>
-<span class="sourceLineNo">2001</span> * Can be used to provide customized resolution of REST resource class instances (e.g. resources retrieve from Spring).<a name="line.2001"></a>
-<span class="sourceLineNo">2002</span> *<a name="line.2002"></a>
-<span class="sourceLineNo">2003</span> * <h5 class='section'>Example:</h5><a name="line.2003"></a>
-<span class="sourceLineNo">2004</span> * <p class='bcode w800'><a name="line.2004"></a>
-<span class="sourceLineNo">2005</span> * <jc>// Our custom resource resolver. </jc><a name="line.2005"></a>
-<span class="sourceLineNo">2006</span> * <jk>public class</jk> MyResourceResolver <jk>extends</jk> RestResourceResolverSimple {<a name="line.2006"></a>
-<span class="sourceLineNo">2007</span> *<a name="line.2007"></a>
-<span class="sourceLineNo">2008</span> * <ja>@Override</ja><a name="line.2008"></a>
-<span class="sourceLineNo">2009</span> * <jk>public</jk> Object resolve(Class&lt;?&gt; resourceType, RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2009"></a>
-<span class="sourceLineNo">2010</span> * Object resource = <jsm>findOurResourceSomehow</jsm>(resourceType);<a name="line.2010"></a>
-<span class="sourceLineNo">2011</span> *<a name="line.2011"></a>
-<span class="sourceLineNo">2012</span> * <jc>// If we can't resolve it, use default resolution.</jc><a name="line.2012"></a>
-<span class="sourceLineNo">2013</span> * <jk>if</jk> (resource == <jk>null</jk>)<a name="line.2013"></a>
-<span class="sourceLineNo">2014</span> * resource = <jk>super</jk>.resolve(resourceType, builder);<a name="line.2014"></a>
-<span class="sourceLineNo">2015</span> *<a name="line.2015"></a>
-<span class="sourceLineNo">2016</span> * <jk>return</jk> resource;<a name="line.2016"></a>
-<span class="sourceLineNo">2017</span> * }<a name="line.2017"></a>
-<span class="sourceLineNo">2018</span> * }<a name="line.2018"></a>
-<span class="sourceLineNo">2019</span> *<a name="line.2019"></a>
-<span class="sourceLineNo">2020</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.2020"></a>
-<span class="sourceLineNo">2021</span> * <ja>@RestResource</ja>(resourceResolver=MyResourceResolver.<jk>class</jk>)<a name="line.2021"></a>
-<span class="sourceLineNo">2022</span> * <jk>public class</jk> MyResource {<a name="line.2022"></a>
-<span class="sourceLineNo">2023</span> *<a name="line.2023"></a>
-<span class="sourceLineNo">2024</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2024"></a>
-<span class="sourceLineNo">2025</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2025"></a>
-<span class="sourceLineNo">2026</span> *<a name="line.2026"></a>
-<span class="sourceLineNo">2027</span> * <jc>// Using method on builder.</jc><a name="line.2027"></a>
-<span class="sourceLineNo">2028</span> * builder.resourceResolver(MyResourceResolver.<jk>class</jk>);<a name="line.2028"></a>
-<span class="sourceLineNo">2029</span> *<a name="line.2029"></a>
-<span class="sourceLineNo">2030</span> * <jc>// Same, but using property.</jc><a name="line.2030"></a>
-<span class="sourceLineNo">2031</span> * builder.set(<jsf>REST_resourceResolver</jsf>, MyResourceResolver.<jk>class</jk>);<a name="line.2031"></a>
-<span class="sourceLineNo">2032</span> * }<a name="line.2032"></a>
-<span class="sourceLineNo">2033</span> *<a name="line.2033"></a>
-<span class="sourceLineNo">2034</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2034"></a>
-<span class="sourceLineNo">2035</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2035"></a>
-<span class="sourceLineNo">2036</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2036"></a>
-<span class="sourceLineNo">2037</span> * builder.resourceResolver(MyResourceResolver.<jk>class</jk>);<a name="line.2037"></a>
-<span class="sourceLineNo">2038</span> * }<a name="line.2038"></a>
-<span class="sourceLineNo">2039</span> * }<a name="line.2039"></a>
-<span class="sourceLineNo">2040</span> * </p><a name="line.2040"></a>
-<span class="sourceLineNo">2041</span> *<a name="line.2041"></a>
-<span class="sourceLineNo">2042</span> * <h5 class='section'>Notes:</h5><a name="line.2042"></a>
-<span class="sourceLineNo">2043</span> * <ul class='spaced-list'><a name="line.2043"></a>
-<span class="sourceLineNo">2044</span> * <li><a name="line.2044"></a>
-<span class="sourceLineNo">2045</span> * Unless overridden, resource resolvers are inherited from ascendant resources.<a name="line.2045"></a>
-<span class="sourceLineNo">2046</span> * <li><a name="line.2046"></a>
-<span class="sourceLineNo">2047</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.2047"></a>
-<span class="sourceLineNo">2048</span> * <ul><a name="line.2048"></a>
-<span class="sourceLineNo">2049</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.2049"></a>
-<span class="sourceLineNo">2050</span> * <li><code><jk>public</jk> T()</code><a name="line.2050"></a>
-<span class="sourceLineNo">2051</span> * </ul><a name="line.2051"></a>
-<span class="sourceLineNo">2052</span> * <li><a name="line.2052"></a>
-<span class="sourceLineNo">2053</span> * Inner classes of the REST resource class are allowed.<a name="line.2053"></a>
-<span class="sourceLineNo">2054</span> * </ul><a name="line.2054"></a>
-<span class="sourceLineNo">2055</span> *<a name="line.2055"></a>
-<span class="sourceLineNo">2056</span> * <h5 class='section'>See Also:</h5><a name="line.2056"></a>
-<span class="sourceLineNo">2057</span> * <ul><a name="line.2057"></a>
-<span class="sourceLineNo">2058</span> * <li class='link'>{@doc juneau-rest-server.Instantiation.ResourceResolvers}<a name="line.2058"></a>
-<span class="sourceLineNo">2059</span> * <li class='link'>{@doc juneau-rest-server.Injection}<a name="line.2059"></a>
-<span class="sourceLineNo">2060</span> * </ul><a name="line.2060"></a>
-<span class="sourceLineNo">2061</span> */<a name="line.2061"></a>
-<span class="sourceLineNo">2062</span> public static final String REST_resourceResolver = PREFIX + "resourceResolver.o";<a name="line.2062"></a>
-<span class="sourceLineNo">2063</span><a name="line.2063"></a>
-<span class="sourceLineNo">2064</span> /**<a name="line.2064"></a>
-<span class="sourceLineNo">2065</span> * Configuration property: Response handlers.<a name="line.2065"></a>
-<span class="sourceLineNo">2066</span> *<a name="line.2066"></a>
-<span class="sourceLineNo">2067</span> * <h5 class='section'>Property:</h5><a name="line.2067"></a>
-<span class="sourceLineNo">2068</span> * <ul><a name="line.2068"></a>
-<span class="sourceLineNo">2069</span> * <li><b>Name:</b> <js>"RestContext.responseHandlers.lo"</js><a name="line.2069"></a>
-<span class="sourceLineNo">2070</span> * <li><b>Data type:</b> <code>List&lt;{@link ResponseHandler} | Class&lt;? <jk>extends</jk> {@link ResponseHandler}&gt;&gt;</code><a name="line.2070"></a>
-<span class="sourceLineNo">2071</span> * <li><b>Default:</b> empty list<a name="line.2071"></a>
-<span class="sourceLineNo">2072</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2072"></a>
-<span class="sourceLineNo">2073</span> * <li><b>Annotations:</b><a name="line.2073"></a>
-<span class="sourceLineNo">2074</span> * <ul><a name="line.2074"></a>
-<span class="sourceLineNo">2075</span> * <li class='ja'>{@link RestResource#responseHandlers()}<a name="line.2075"></a>
-<span class="sourceLineNo">2076</span> * </ul><a name="line.2076"></a>
-<span class="sourceLineNo">2077</span> * <li><b>Methods:</b><a name="line.2077"></a>
-<span class="sourceLineNo">2078</span> * <ul><a name="line.2078"></a>
-<span class="sourceLineNo">2079</span> * <li class='jm'>{@link RestContextBuilder#responseHandlers(Class...)}<a name="line.2079"></a>
-<span class="sourceLineNo">2080</span> * <li class='jm'>{@link RestContextBuilder#responseHandlers(ResponseHandler...)}<a name="line.2080"></a>
-<span class="sourceLineNo">2081</span> * </ul><a name="line.2081"></a>
-<span class="sourceLineNo">2082</span> * </ul><a name="line.2082"></a>
-<span class="sourceLineNo">2083</span> *<a name="line.2083"></a>
-<span class="sourceLineNo">2084</span> * <h5 class='section'>Description:</h5><a name="line.2084"></a>
-<span class="sourceLineNo">2085</span> * <p><a name="line.2085"></a>
-<span class="sourceLineNo">2086</span> * Specifies a list of {@link ResponseHandler} classes that know how to convert POJOs returned by REST methods or<a name="line.2086"></a>
-<span class="sourceLineNo">2087</span> * set via {@link RestResponse#setOutput(Object)} into appropriate HTTP responses.<a name="line.2087"></a>
-<span class="sourceLineNo">2088</span> *<a name="line.2088"></a>
-<span class="sourceLineNo">2089</span> * <p><a name="line.2089"></a>
-<span class="sourceLineNo">2090</span> * By default, the following response handlers are provided out-of-the-box:<a name="line.2090"></a>
-<span class="sourceLineNo">2091</span> * <ul><a name="line.2091"></a>
-<span class="sourceLineNo">2092</span> * <li class='jc'>{@link ReaderHandler} - {@link Reader} objects.<a name="line.2092"></a>
-<span class="sourceLineNo">2093</span> * <li class='jc'>{@link InputStreamHandler} - {@link InputStream} objects.<a name="line.2093"></a>
-<span class="sourceLineNo">2094</span> * <li class='jc'>{@link DefaultHandler} - All other POJOs.<a name="line.2094"></a>
-<span class="sourceLineNo">2095</span> * </ul><a name="line.2095"></a>
-<span class="sourceLineNo">2096</span> *<a name="line.2096"></a>
-<span class="sourceLineNo">2097</span> * <h5 class='section'>Example:</h5><a name="line.2097"></a>
-<span class="sourceLineNo">2098</span> * <p class='bcode w800'><a name="line.2098"></a>
-<span class="sourceLineNo">2099</span> * <jc>// Our custom response handler for MySpecialObject objects. </jc><a name="line.2099"></a>
-<span class="sourceLineNo">2100</span> * <jk>public class</jk> MyResponseHandler <jk>implements</jk> ResponseHandler {<a name="line.2100"></a>
-<span class="sourceLineNo">2101</span> *<a name="line.2101"></a>
-<span class="sourceLineNo">2102</span> * <ja>@Override</ja><a name="line.2102"></a>
-<span class="sourceLineNo">2103</span> * <jk>public boolean</jk> handle(RestRequest req, RestResponse res, Object output) <jk>throws</jk> IOException, RestException {<a name="line.2103"></a>
-<span class="sourceLineNo">2104</span> * <jk>if</jk> (output <jk>instanceof</jk> MySpecialObject) {<a name="line.2104"></a>
-<span class="sourceLineNo">2105</span> * <jk>try</jk> (Writer w = res.getNegotiatedWriter()) {<a name="line.2105"></a>
-<span class="sourceLineNo">2106</span> * <jc>//Pipe it to the writer ourselves.</jc><a name="line.2106"></a>
-<span class="sourceLineNo">2107</span> * }<a name="line.2107"></a>
-<span class="sourceLineNo">2108</span> * <jk>return true</jk>; <jc>// We handled it.</jc><a name="line.2108"></a>
-<span class="sourceLineNo">2109</span> * }<a name="line.2109"></a>
-<span class="sourceLineNo">2110</span> * <jk>return false</jk>; <jc>// We didn't handle it.</jc><a name="line.2110"></a>
-<span class="sourceLineNo">2111</span> * }<a name="line.2111"></a>
-<span class="sourceLineNo">2112</span> * }<a name="line.2112"></a>
-<span class="sourceLineNo">2113</span> *<a name="line.2113"></a>
-<span class="sourceLineNo">2114</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.2114"></a>
-<span class="sourceLineNo">2115</span> * <ja>@RestResource</ja>(responseHandlers=MyResponseHandler.<jk>class</jk>)<a name="line.2115"></a>
-<span class="sourceLineNo">2116</span> * <jk>public class</jk> MyResource {<a name="line.2116"></a>
-<span class="sourceLineNo">2117</span> *<a name="line.2117"></a>
-<span class="sourceLineNo">2118</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2118"></a>
-<span class="sourceLineNo">2119</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2119"></a>
-<span class="sourceLineNo">2120</span> *<a name="line.2120"></a>
-<span class="sourceLineNo">2121</span> * <jc>// Using method on builder.</jc><a name="line.2121"></a>
-<span class="sourceLineNo">2122</span> * builder.responseHandlers(MyResponseHandler.<jk>class</jk>);<a name="line.2122"></a>
-<span class="sourceLineNo">2123</span> *<a name="line.2123"></a>
-<span class="sourceLineNo">2124</span> * <jc>// Same, but using property.</jc><a name="line.2124"></a>
-<span class="sourceLineNo">2125</span> * builder.addTo(<jsf>REST_responseHandlers</jsf>, MyResponseHandler.<jk>class</jk>);<a name="line.2125"></a>
-<span class="sourceLineNo">2126</span> * }<a name="line.2126"></a>
-<span class="sourceLineNo">2127</span> *<a name="line.2127"></a>
-<span class="sourceLineNo">2128</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2128"></a>
-<span class="sourceLineNo">2129</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2129"></a>
-<span class="sourceLineNo">2130</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2130"></a>
-<span class="sourceLineNo">2131</span> * builder.responseHandlers(MyResponseHandler.<jk>class</jk>);<a name="line.2131"></a>
-<span class="sourceLineNo">2132</span> * }<a name="line.2132"></a>
-<span class="sourceLineNo">2133</span> *<a name="line.2133"></a>
-<span class="sourceLineNo">2134</span> * <ja>@RestMethod</ja>(...)<a name="line.2134"></a>
-<span class="sourceLineNo">2135</span> * <jk>public</jk> Object myMethod() {<a name="line.2135"></a>
-<span class="sourceLineNo">2136</span> * <jc>// Return a special object for our handler.</jc><a name="line.2136"></a>
-<span class="sourceLineNo">2137</span> * <jk>return new</jk> MySpecialObject();<a name="line.2137"></a>
-<span class="sourceLineNo">2138</span> * }<a name="line.2138"></a>
-<span class="sourceLineNo">2139</span> * }<a name="line.2139"></a>
-<span class="sourceLineNo">2140</span> * </p><a name="line.2140"></a>
-<span class="sourceLineNo">2141</span> *<a name="line.2141"></a>
-<span class="sourceLineNo">2142</span> * <h5 class='section'>Notes:</h5><a name="line.2142"></a>
-<span class="sourceLineNo">2143</span> * <ul class='spaced-list'><a name="line.2143"></a>
-<span class="sourceLineNo">2144</span> * <li><a name="line.2144"></a>
-<span class="sourceLineNo">2145</span> * Response handlers resolvers are always inherited from ascendant resources.<a name="line.2145"></a>
-<span class="sourceLineNo">2146</span> * <li><a name="line.2146"></a>
-<span class="sourceLineNo">2147</span> * When defined as a class, the implementation must have one of the following constructors:<a name="line.2147"></a>
-<span class="sourceLineNo">2148</span> * <ul><a name="line.2148"></a>
-<span class="sourceLineNo">2149</span> * <li><code><jk>public</jk> T(RestContext)</code><a name="line.2149"></a>
-<span class="sourceLineNo">2150</span> * <li><code><jk>public</jk> T()</code><a name="line.2150"></a>
-<span class="sourceLineNo">2151</span> * </ul><a name="line.2151"></a>
-<span class="sourceLineNo">2152</span> * <li><a name="line.2152"></a>
-<span class="sourceLineNo">2153</span> * Inner classes of the REST resource class are allowed.<a name="line.2153"></a>
-<span class="sourceLineNo">2154</span> * </ul><a name="line.2154"></a>
-<span class="sourceLineNo">2155</span> */<a name="line.2155"></a>
-<span class="sourceLineNo">2156</span> public static final String REST_responseHandlers = PREFIX + "responseHandlers.lo";<a name="line.2156"></a>
-<span class="sourceLineNo">2157</span><a name="line.2157"></a>
-<span class="sourceLineNo">2158</span> /**<a name="line.2158"></a>
-<span class="sourceLineNo">2159</span> * Configuration property: Serializers.<a name="line.2159"></a>
-<span class="sourceLineNo">2160</span> *<a name="line.2160"></a>
-<span class="sourceLineNo">2161</span> * <h5 class='section'>Property:</h5><a name="line.2161"></a>
-<span class="sourceLineNo">2162</span> * <ul><a name="line.2162"></a>
-<span class="sourceLineNo">2163</span> * <li><b>Name:</b> <js>"RestContext.serializers.lo"</js><a name="line.2163"></a>
-<span class="sourceLineNo">2164</span> * <li><b>Data type:</b> <code>List&lt;{@link Serializer} | Class&lt;? <jk>extends</jk> {@link Serializer}&gt;&gt;</code><a name="line.2164"></a>
-<span class="sourceLineNo">2165</span> * <li><b>Default:</b> empty list<a name="line.2165"></a>
-<span class="sourceLineNo">2166</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2166"></a>
-<span class="sourceLineNo">2167</span> * <li><b>Annotations:</b><a name="line.2167"></a>
-<span class="sourceLineNo">2168</span> * <ul><a name="line.2168"></a>
-<span class="sourceLineNo">2169</span> * <li class='ja'>{@link RestResource#serializers()}<a name="line.2169"></a>
-<span class="sourceLineNo">2170</span> * <li class='ja'>{@link RestMethod#serializers()}<a name="line.2170"></a>
-<span class="sourceLineNo">2171</span> * </ul><a name="line.2171"></a>
-<span class="sourceLineNo">2172</span> * <li><b>Methods:</b><a name="line.2172"></a>
-<span class="sourceLineNo">2173</span> * <ul><a name="line.2173"></a>
-<span class="sourceLineNo">2174</span> * <li class='jm'>{@link RestContextBuilder#serializers(Object...)}<a name="line.2174"></a>
-<span class="sourceLineNo">2175</span> * <li class='jm'>{@link RestContextBuilder#serializers(Class...)}<a name="line.2175"></a>
-<span class="sourceLineNo">2176</span> * <li class='jm'>{@link RestContextBuilder#serializers(boolean,Object...)}<a name="line.2176"></a>
-<span class="sourceLineNo">2177</span> * </ul><a name="line.2177"></a>
-<span class="sourceLineNo">2178</span> * </ul><a name="line.2178"></a>
-<span class="sourceLineNo">2179</span> *<a name="line.2179"></a>
-<span class="sourceLineNo">2180</span> * <h5 class='section'>Description:</h5><a name="line.2180"></a>
-<span class="sourceLineNo">2181</span> * <p><a name="line.2181"></a>
-<span class="sourceLineNo">2182</span> * Adds class-level serializers to this resource.<a name="line.2182"></a>
-<span class="sourceLineNo">2183</span> *<a name="line.2183"></a>
-<span class="sourceLineNo">2184</span> * <p><a name="line.2184"></a>
-<span class="sourceLineNo">2185</span> * Serializer are used to convert POJOs to HTTP response bodies.<a name="line.2185"></a>
-<span class="sourceLineNo">2186</span> * <br>Any of the Juneau framework serializers can be used in this setting.<a name="line.2186"></a>
-<span class="sourceLineNo">2187</span> * <br>The serializer selected is based on the request <code>Accept</code> header matched against the values returned by the following method<a name="line.2187"></a>
-<span class="sourceLineNo">2188</span> * using a best-match algorithm:<a name="line.2188"></a>
-<span class="sourceLineNo">2189</span> * <ul><a name="line.2189"></a>
-<span class="sourceLineNo">2190</span> * <li class='jm'>{@link Serializer#getMediaTypeRanges()}<a name="line.2190"></a>
-<span class="sourceLineNo">2191</span> * </ul><a name="line.2191"></a>
-<span class="sourceLineNo">2192</span> *<a name="line.2192"></a>
-<span class="sourceLineNo">2193</span> * <h5 class='section'>Example:</h5><a name="line.2193"></a>
-<span class="sourceLineNo">2194</span> * <p class='bcode w800'><a name="line.2194"></a>
-<span class="sourceLineNo">2195</span> * <jc>// Option #1 - Defined via annotation.</jc><a name="line.2195"></a>
-<span class="sourceLineNo">2196</span> * <ja>@RestResource</ja>(serializers={JsonSerializer.<jk>class</jk>, XmlSerializer.<jk>class</jk>})<a name="line.2196"></a>
-<span class="sourceLineNo">2197</span> * <jk>public class</jk> MyResource {<a name="line.2197"></a>
-<span class="sourceLineNo">2198</span> *<a name="line.2198"></a>
-<span class="sourceLineNo">2199</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2199"></a>
-<span class="sourceLineNo">2200</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2200"></a>
-<span class="sourceLineNo">2201</span> *<a name="line.2201"></a>
-<span class="sourceLineNo">2202</span> * <jc>// Using method on builder.</jc><a name="line.2202"></a>
-<span class="sourceLineNo">2203</span> * builder.serializers(JsonSerializer.<jk>class</jk>, XmlSerializer.<jk>class</jk>);<a name="line.2203"></a>
-<span class="sourceLineNo">2204</span> *<a name="line.2204"></a>
-<span class="sourceLineNo">2205</span> * <jc>// Same, but use pre-instantiated parsers.</jc><a name="line.2205"></a>
-<span class="sourceLineNo">2206</span> * builder.serializers(JsonSerializer.<jsf>DEFAULT</jsf>, XmlSerializer.<jsf>DEFAULT</jsf>);<a name="line.2206"></a>
-<span class="sourceLineNo">2207</span> *<a name="line.2207"></a>
-<span class="sourceLineNo">2208</span> * <jc>// Same, but using property.</jc><a name="line.2208"></a>
-<span class="sourceLineNo">2209</span> * builder.set(<jsf>REST_serializers</jsf>, JsonSerializer.<jk>class</jk>, XmlSerializer.<jk>class</jk>);<a name="line.2209"></a>
-<span class="sourceLineNo">2210</span> * }<a name="line.2210"></a>
-<span class="sourceLineNo">2211</span> *<a name="line.2211"></a>
-<span class="sourceLineNo">2212</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2212"></a>
-<span class="sourceLineNo">2213</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2213"></a>
-<span class="sourceLineNo">2214</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2214"></a>
-<span class="sourceLineNo">2215</span> * builder.serializers(JsonSerializer.<jk>class</jk>, XmlSerializer.<jk>class</jk>);<a name="line.2215"></a>
-<span class="sourceLineNo">2216</span> * }<a name="line.2216"></a>
-<span class="sourceLineNo">2217</span> *<a name="line.2217"></a>
-<span class="sourceLineNo">2218</span> * <jc>// Override at the method level.</jc><a name="line.2218"></a>
-<span class="sourceLineNo">2219</span> * <ja>@RestMethod</ja>(serializers={HtmlSerializer.<jk>class</jk>})<a name="line.2219"></a>
-<span class="sourceLineNo">2220</span> * <jk>public</jk> MyPojo myMethod() {<a name="line.2220"></a>
-<span class="sourceLineNo">2221</span> * <jc>// Return a POJO to be serialized.</jc><a name="line.2221"></a>
-<span class="sourceLineNo">2222</span> * <jk>return new</jk> MyPojo();<a name="line.2222"></a>
-<span class="sourceLineNo">2223</span> * }<a name="line.2223"></a>
-<span class="sourceLineNo">2224</span> * }<a name="line.2224"></a>
-<span class="sourceLineNo">2225</span> * </p><a name="line.2225"></a>
-<span class="sourceLineNo">2226</span> *<a name="line.2226"></a>
-<span class="sourceLineNo">2227</span> * <h5 class='section'>Notes:</h5><a name="line.2227"></a>
-<span class="sourceLineNo">2228</span> * <ul class='spaced-list'><a name="line.2228"></a>
-<span class="sourceLineNo">2229</span> * <li><a name="line.2229"></a>
-<span class="sourceLineNo">2230</span> * When defined as a class, properties/transforms defined on the resource/method are inherited.<a name="line.2230"></a>
-<span class="sourceLineNo">2231</span> * <li><a name="line.2231"></a>
-<span class="sourceLineNo">2232</span> * When defined as an instance, properties/transforms defined on the resource/method are NOT inherited.<a name="line.2232"></a>
-<span class="sourceLineNo">2233</span> * <li><a name="line.2233"></a>
-<span class="sourceLineNo">2234</span> * Typically, you'll want your resource to extend directly from {@link BasicRestServlet} which comes<a name="line.2234"></a>
-<span class="sourceLineNo">2235</span> * preconfigured with the following serializers:<a name="line.2235"></a>
-<span class="sourceLineNo">2236</span> * <ul><a name="line.2236"></a>
-<span class="sourceLineNo">2237</span> * <li class='jc'>{@link HtmlDocSerializer}<a name="line.2237"></a>
-<span class="sourceLineNo">2238</span> * <li class='jc'>{@link HtmlStrippedDocSerializer}<a name="line.2238"></a>
-<span class="sourceLineNo">2239</span> * <li class='jc'>{@link HtmlSchemaDocSerializer}<a name="line.2239"></a>
-<span class="sourceLineNo">2240</span> * <li class='jc'>{@link JsonSerializer}<a name="line.2240"></a>
-<span class="sourceLineNo">2241</span> * <li class='jc'>{@link SimpleJsonSerializer}<a name="line.2241"></a>
-<span class="sourceLineNo">2242</span> * <li class='jc'>{@link JsonSchemaSerializer}<a name="line.2242"></a>
-<span class="sourceLineNo">2243</span> * <li class='jc'>{@link XmlDocSerializer}<a name="line.2243"></a>
-<span class="sourceLineNo">2244</span> * <li class='jc'>{@link XmlSchemaDocSerializer}<a name="line.2244"></a>
-<span class="sourceLineNo">2245</span> * <li class='jc'>{@link UonSerializer}<a name="line.2245"></a>
-<span class="sourceLineNo">2246</span> * <li class='jc'>{@link UrlEncodingSerializer}<a name="line.2246"></a>
-<span class="sourceLineNo">2247</span> * <li class='jc'>{@link MsgPackSerializer}<a name="line.2247"></a>
-<span class="sourceLineNo">2248</span> * <li class='jc'>{@link SoapXmlSerializer}<a name="line.2248"></a>
-<span class="sourceLineNo">2249</span> * <li class='jc'>{@link PlainTextSerializer}<a name="line.2249"></a>
-<span class="sourceLineNo">2250</span> * </ul><a name="line.2250"></a>
-<span class="sourceLineNo">2251</span> * </ul><a name="line.2251"></a>
-<span class="sourceLineNo">2252</span> *<a name="line.2252"></a>
-<span class="sourceLineNo">2253</span> * <h5 class='section'>See Also:</h5><a name="line.2253"></a>
-<span class="sourceLineNo">2254</span> * <ul><a name="line.2254"></a>
-<span class="sourceLineNo">2255</span> * <li class='link'>{@doc juneau-rest-server.Serializers}<a name="line.2255"></a>
-<span class="sourceLineNo">2256</span> * </ul><a name="line.2256"></a>
-<span class="sourceLineNo">2257</span> * <p><a name="line.2257"></a>
-<span class="sourceLineNo">2258</span> */<a name="line.2258"></a>
-<span class="sourceLineNo">2259</span> public static final String REST_serializers = PREFIX + "serializers.lo";<a name="line.2259"></a>
-<span class="sourceLineNo">2260</span><a name="line.2260"></a>
-<span class="sourceLineNo">2261</span> /**<a name="line.2261"></a>
-<span class="sourceLineNo">2262</span> * Configuration property: Static file response headers.<a name="line.2262"></a>
-<span class="sourceLineNo">2263</span> *<a name="line.2263"></a>
-<span class="sourceLineNo">2264</span> * <h5 class='section'>Property:</h5><a name="line.2264"></a>
-<span class="sourceLineNo">2265</span> * <ul><a name="line.2265"></a>
-<span class="sourceLineNo">2266</span> * <li><b>Name:</b> <js>"RestContext.staticFileResponseHeaders.omo"</js><a name="line.2266"></a>
-<span class="sourceLineNo">2267</span> * <li><b>Data type:</b> <code>Map&lt;String,String&gt;</code><a name="line.2267"></a>
-<span class="sourceLineNo">2268</span> * <li><b>Default:</b> <code>{<js>'Cache-Control'</js>: <js>'max-age=86400, public</js>}</code><a name="line.2268"></a>
-<span class="sourceLineNo">2269</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2269"></a>
-<span class="sourceLineNo">2270</span> * <li><b>Annotations:</b><a name="line.2270"></a>
-<span class="sourceLineNo">2271</span> * <ul><a name="line.2271"></a>
-<span class="sourceLineNo">2272</span> * <li class='ja'>{@link RestResource#staticFileResponseHeaders()}<a name="line.2272"></a>
-<span class="sourceLineNo">2273</span> * </ul><a name="line.2273"></a>
-<span class="sourceLineNo">2274</span> * <li><b>Methods:</b><a name="line.2274"></a>
-<span class="sourceLineNo">2275</span> * <ul><a name="line.2275"></a>
-<span class="sourceLineNo">2276</span> * <li class='jm'>{@link RestContextBuilder#staticFileResponseHeaders(boolean,Map)}<a name="line.2276"></a>
-<span class="sourceLineNo">2277</span> * <li class='jm'>{@link RestContextBuilder#staticFileResponseHeaders(String...)}<a name="line.2277"></a>
-<span class="sourceLineNo">2278</span> * <li class='jm'>{@link RestContextBuilder#staticFileResponseHeader(String,String)}<a name="line.2278"></a>
-<span class="sourceLineNo">2279</span> * </ul><a name="line.2279"></a>
-<span class="sourceLineNo">2280</span> * </ul><a name="line.2280"></a>
-<span class="sourceLineNo">2281</span> *<a name="line.2281"></a>
-<span class="sourceLineNo">2282</span> * <h5 class='section'>Description:</h5><a name="line.2282"></a>
-<span class="sourceLineNo">2283</span> * <p><a name="line.2283"></a>
-<span class="sourceLineNo">2284</span> * Used to customize the headers on responses returned for statically-served files.<a name="line.2284"></a>
-<span class="sourceLineNo">2285</span> *<a name="line.2285"></a>
-<span class="sourceLineNo">2286</span> * <h5 class='section'>Example:</h5><a name="line.2286"></a>
-<span class="sourceLineNo">2287</span> * <p class='bcode w800'><a name="line.2287"></a>
-<span class="sourceLineNo">2288</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2288"></a>
-<span class="sourceLineNo">2289</span> * <ja>@RestResource</ja>(<a name="line.2289"></a>
-<span class="sourceLineNo">2290</span> * staticFileResponseHeaders={<a name="line.2290"></a>
-<span class="sourceLineNo">2291</span> * <js>"Cache-Control: $C{REST/cacheControl,nocache}"</js>,<a name="line.2291"></a>
-<span class="sourceLineNo">2292</span> * <js>"My-Header: $C{REST/myHeaderValue}"</js><a name="line.2292"></a>
-<span class="sourceLineNo">2293</span> * }<a name="line.2293"></a>
-<span class="sourceLineNo">2294</span> * )<a name="line.2294"></a>
-<span class="sourceLineNo">2295</span> * <jk>public class</jk> MyResource {<a name="line.2295"></a>
-<span class="sourceLineNo">2296</span> *<a name="line.2296"></a>
-<span class="sourceLineNo">2297</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2297"></a>
-<span class="sourceLineNo">2298</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2298"></a>
-<span class="sourceLineNo">2299</span> *<a name="line.2299"></a>
-<span class="sourceLineNo">2300</span> * <jc>// Using method on builder.</jc><a name="line.2300"></a>
-<span class="sourceLineNo">2301</span> * builder<a name="line.2301"></a>
-<span class="sourceLineNo">2302</span> * .staticFileResponseHeader(<js>"Cache-Control"</js>, <js>"nocache"</js>);<a name="line.2302"></a>
-<span class="sourceLineNo">2303</span> * .staticFileResponseHeaders(<js>"My-Header: foo"</js>);<a name="line.2303"></a>
-<span class="sourceLineNo">2304</span> *<a name="line.2304"></a>
-<span class="sourceLineNo">2305</span> * <jc>// Same, but using property.</jc><a name="line.2305"></a>
-<span class="sourceLineNo">2306</span> * builder<a name="line.2306"></a>
-<span class="sourceLineNo">2307</span> * .addTo(<jsf>REST_staticFileResponseHeaders</jsf>, <js>"Cache-Control"</js>, <js>"nocache"</js>);<a name="line.2307"></a>
-<span class="sourceLineNo">2308</span> * .addTo(<jsf>REST_staticFileResponseHeaders</jsf>, <js>"My-Header"</js>, <js>"foo"</js>);<a name="line.2308"></a>
-<span class="sourceLineNo">2309</span> * }<a name="line.2309"></a>
-<span class="sourceLineNo">2310</span> *<a name="line.2310"></a>
-<span class="sourceLineNo">2311</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2311"></a>
-<span class="sourceLineNo">2312</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2312"></a>
-<span class="sourceLineNo">2313</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2313"></a>
-<span class="sourceLineNo">2314</span> * builder.staticFileResponseHeader(<js>"Cache-Control"</js>, <js>"nocache"</js>);<a name="line.2314"></a>
-<span class="sourceLineNo">2315</span> * }<a name="line.2315"></a>
-<span class="sourceLineNo">2316</span> * }<a name="line.2316"></a>
-<span class="sourceLineNo">2317</span> * </p><a name="line.2317"></a>
-<span class="sourceLineNo">2318</span> *<a name="line.2318"></a>
-<span class="sourceLineNo">2319</span> * <h5 class='section'>See Also:</h5><a name="line.2319"></a>
-<span class="sourceLineNo">2320</span> * <ul><a name="line.2320"></a>
-<span class="sourceLineNo">2321</span> * <li class='jf'>{@link #REST_staticFiles} for information about statically-served files.<a name="line.2321"></a>
-<span class="sourceLineNo">2322</span> * </ul><a name="line.2322"></a>
-<span class="sourceLineNo">2323</span> */<a name="line.2323"></a>
-<span class="sourceLineNo">2324</span> public static final String REST_staticFileResponseHeaders = PREFIX + "staticFileResponseHeaders.omo";<a name="line.2324"></a>
-<span class="sourceLineNo">2325</span><a name="line.2325"></a>
-<span class="sourceLineNo">2326</span> /**<a name="line.2326"></a>
-<span class="sourceLineNo">2327</span> * Configuration property: Static file mappings.<a name="line.2327"></a>
-<span class="sourceLineNo">2328</span> *<a name="line.2328"></a>
-<span class="sourceLineNo">2329</span> * <h5 class='section'>Property:</h5><a name="line.2329"></a>
-<span class="sourceLineNo">2330</span> * <ul><a name="line.2330"></a>
-<span class="sourceLineNo">2331</span> * <li><b>Name:</b> <js>"RestContext.staticFiles.lo"</js><a name="line.2331"></a>
-<span class="sourceLineNo">2332</span> * <li><b>Data type:</b> <code>List&lt;StaticFileMapping&gt;</code><a name="line.2332"></a>
-<span class="sourceLineNo">2333</span> * <li><b>Default:</b> <jk>null</jk><a name="line.2333"></a>
-<span class="sourceLineNo">2334</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2334"></a>
-<span class="sourceLineNo">2335</span> * <li><b>Annotations:</b><a name="line.2335"></a>
-<span class="sourceLineNo">2336</span> * <ul><a name="line.2336"></a>
-<span class="sourceLineNo">2337</span> * <li class='ja'>{@link RestResource#staticFiles()}<a name="line.2337"></a>
-<span class="sourceLineNo">2338</span> * </ul><a name="line.2338"></a>
-<span class="sourceLineNo">2339</span> * <li><b>Methods:</b><a name="line.2339"></a>
-<span class="sourceLineNo">2340</span> * <ul><a name="line.2340"></a>
-<span class="sourceLineNo">2341</span> * <li class='jm'>{@link RestContextBuilder#staticFiles(String)},<a name="line.2341"></a>
-<span class="sourceLineNo">2342</span> * <li class='jm'>{@link RestContextBuilder#staticFiles(Class,String)}<a name="line.2342"></a>
-<span class="sourceLineNo">2343</span> * <li class='jm'>{@link RestContextBuilder#staticFiles(String,String)}<a name="line.2343"></a>
-<span class="sourceLineNo">2344</span> * <li class='jm'>{@link RestContextBuilder#staticFiles(Class,String,String)}<a name="line.2344"></a>
-<span class="sourceLineNo">2345</span> * <li class='jm'>{@link RestContextBuilder#staticFiles(StaticFileMapping...)}<a name="line.2345"></a>
-<span class="sourceLineNo">2346</span> * </ul><a name="line.2346"></a>
-<span class="sourceLineNo">2347</span> * </ul><a name="line.2347"></a>
-<span class="sourceLineNo">2348</span> *<a name="line.2348"></a>
-<span class="sourceLineNo">2349</span> * <h5 class='section'>Description:</h5><a name="line.2349"></a>
-<span class="sourceLineNo">2350</span> * <p><a name="line.2350"></a>
-<span class="sourceLineNo">2351</span> * Used to define paths and locations of statically-served files such as images or HTML documents<a name="line.2351"></a>
-<span class="sourceLineNo">2352</span> * from the classpath or file system.<a name="line.2352"></a>
-<span class="sourceLineNo">2353</span> *<a name="line.2353"></a>
-<span class="sourceLineNo">2354</span> * <p><a name="line.2354"></a>
-<span class="sourceLineNo">2355</span> * An example where this class is used is in the {@link RestResource#staticFiles} annotation:<a name="line.2355"></a>
-<span class="sourceLineNo">2356</span> * <p class='bcode w800'><a name="line.2356"></a>
-<span class="sourceLineNo">2357</span> * <jk>package</jk> com.foo.mypackage;<a name="line.2357"></a>
-<span class="sourceLineNo">2358</span> *<a name="line.2358"></a>
-<span class="sourceLineNo">2359</span> * <ja>@RestResource</ja>(<a name="line.2359"></a>
-<span class="sourceLineNo">2360</span> * path=<js>"/myresource"</js>,<a name="line.2360"></a>
-<span class="sourceLineNo">2361</span> * staticFiles={<a name="line.2361"></a>
-<span class="sourceLineNo">2362</span> * <js>"htdocs:docs"</js>,<a name="line.2362"></a>
-<span class="sourceLineNo">2363</span> * <js>"styles:styles"</js><a name="line.2363"></a>
-<span class="sourceLineNo">2364</span> * }<a name="line.2364"></a>
-<span class="sourceLineNo">2365</span> * )<a name="line.2365"></a>
-<span class="sourceLineNo">2366</span> * <jk>public class</jk> MyResource <jk>extends</jk> BasicRestServlet {...}<a name="line.2366"></a>
-<span class="sourceLineNo">2367</span> * </p><a name="line.2367"></a>
-<span class="sourceLineNo">2368</span> *<a name="line.2368"></a>
-<span class="sourceLineNo">2369</span> * <p><a name="line.2369"></a>
-<span class="sourceLineNo">2370</span> * In the example above, given a GET request to the following URL...<a name="line.2370"></a>
-<span class="sourceLineNo">2371</span> * <p class='bcode w800'><a name="line.2371"></a>
-<span class="sourceLineNo">2372</span> * /myresource/htdocs/foobar.html<a name="line.2372"></a>
-<span class="sourceLineNo">2373</span> * </p><a name="line.2373"></a>
-<span class="sourceLineNo">2374</span> * <br>...the servlet will attempt to find the <code>foobar.html</code> file in the following ordered locations:<a name="line.2374"></a>
-<span class="sourceLineNo">2375</span> * <ol class='spaced-list'><a name="line.2375"></a>
-<span class="sourceLineNo">2376</span> * <li><code>com.foo.mypackage.docs</code> package.<a name="line.2376"></a>
-<span class="sourceLineNo">2377</span> * <li><code>[working-dir]/docs</code> directory.<a name="line.2377"></a>
-<span class="sourceLineNo">2378</span> * </ol><a name="line.2378"></a>
-<span class="sourceLineNo">2379</span> *<a name="line.2379"></a>
-<span class="sourceLineNo">2380</span> * <h5 class='section'>See Also:</h5><a name="line.2380"></a>
-<span class="sourceLineNo">2381</span> * <ul><a name="line.2381"></a>
-<span class="sourceLineNo">2382</span> * <li class='jf'>{@link #REST_classpathResourceFinder} for configuring how classpath resources are located and retrieved.<a name="line.2382"></a>
-<span class="sourceLineNo">2383</span> * <li class='jf'>{@link #REST_mimeTypes} for configuring the media types based on file extension.<a name="line.2383"></a>
-<span class="sourceLineNo">2384</span> * <li class='jf'>{@link #REST_staticFileResponseHeaders} for configuring response headers on statically served files.<a name="line.2384"></a>
-<span class="sourceLineNo">2385</span> * <li class='jf'>{@link #REST_useClasspathResourceCaching} for configuring static file caching.<a name="line.2385"></a>
-<span class="sourceLineNo">2386</span> * <li class='jm'>{@link RestContext#getClasspathResource(String,Locale)} for retrieving static files.<a name="line.2386"></a>
-<span class="sourceLineNo">2387</span> * </ul><a name="line.2387"></a>
-<span class="sourceLineNo">2388</span> *<a name="line.2388"></a>
-<span class="sourceLineNo">2389</span> * <h5 class='section'>Notes:</h5><a name="line.2389"></a>
-<span class="sourceLineNo">2390</span> * <ul class='spaced-list'><a name="line.2390"></a>
-<span class="sourceLineNo">2391</span> * <li><a name="line.2391"></a>
-<span class="sourceLineNo">2392</span> * Mappings are cumulative from super classes.<a name="line.2392"></a>
-<span class="sourceLineNo">2393</span> * <li><a name="line.2393"></a>
-<span class="sourceLineNo">2394</span> * Child resources can override mappings made on parent class resources.<a name="line.2394"></a>
-<span class="sourceLineNo">2395</span> * </ul><a name="line.2395"></a>
-<span class="sourceLineNo">2396</span> */<a name="line.2396"></a>
-<span class="sourceLineNo">2397</span> public static final String REST_staticFiles = PREFIX + "staticFiles.lo";<a name="line.2397"></a>
-<span class="sourceLineNo">2398</span><a name="line.2398"></a>
-<span class="sourceLineNo">2399</span> /**<a name="line.2399"></a>
-<span class="sourceLineNo">2400</span> * Configuration property: Supported accept media types.<a name="line.2400"></a>
-<span class="sourceLineNo">2401</span> *<a name="line.2401"></a>
-<span class="sourceLineNo">2402</span> * <h5 class='section'>Property:</h5><a name="line.2402"></a>
-<span class="sourceLineNo">2403</span> * <ul><a name="line.2403"></a>
-<span class="sourceLineNo">2404</span> * <li><b>Name:</b> <js>"RestContext.produces.ls"</js><a name="line.2404"></a>
-<span class="sourceLineNo">2405</span> * <li><b>Data type:</b> <code>List&lt;String&gt;</code><a name="line.2405"></a>
-<span class="sourceLineNo">2406</span> * <li><b>Default:</b> empty list<a name="line.2406"></a>
-<span class="sourceLineNo">2407</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2407"></a>
-<span class="sourceLineNo">2408</span> * <li><b>Annotations:</b><a name="line.2408"></a>
-<span class="sourceLineNo">2409</span> * <ul><a name="line.2409"></a>
-<span class="sourceLineNo">2410</span> * <li class='ja'>{@link RestResource#produces()}<a name="line.2410"></a>
-<span class="sourceLineNo">2411</span> * <li class='ja'>{@link RestMethod#produces()}<a name="line.2411"></a>
-<span class="sourceLineNo">2412</span> * </ul><a name="line.2412"></a>
-<span class="sourceLineNo">2413</span> * <li><b>Methods:</b><a name="line.2413"></a>
-<span class="sourceLineNo">2414</span> * <ul><a name="line.2414"></a>
-<span class="sourceLineNo">2415</span> * <li class='jm'>{@link RestContextBuilder#produces(boolean,String...)}<a name="line.2415"></a>
-<span class="sourceLineNo">2416</span> * <li class='jm'>{@link RestContextBuilder#produces(boolean,MediaType...)}<a name="line.2416"></a>
-<span class="sourceLineNo">2417</span> * </ul><a name="line.2417"></a>
-<span class="sourceLineNo">2418</span> * </ul><a name="line.2418"></a>
-<span class="sourceLineNo">2419</span> *<a name="line.2419"></a>
-<span class="sourceLineNo">2420</span> * <h5 class='section'>Description:</h5><a name="line.2420"></a>
-<span class="sourceLineNo">2421</span> * <p><a name="line.2421"></a>
-<span class="sourceLineNo">2422</span> * Overrides the media types inferred from the serializers that identify what media types can be produced by the resource.<a name="line.2422"></a>
-<span class="sourceLineNo">2423</span> * <br>An example where this might be useful if you have serializers registered that handle media types that you<a name="line.2423"></a>
-<span class="sourceLineNo">2424</span> * don't want exposed in the Swagger documentation.<a name="line.2424"></a>
-<span class="sourceLineNo">2425</span> *<a name="line.2425"></a>
-<span class="sourceLineNo">2426</span> * <h5 class='section'>Example:</h5><a name="line.2426"></a>
-<span class="sourceLineNo">2427</span> * <p class='bcode w800'><a name="line.2427"></a>
-<span class="sourceLineNo">2428</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2428"></a>
-<span class="sourceLineNo">2429</span> * <ja>@RestResource</ja>(produces={<js>"$C{REST/supportedProduces,application/json}"</js>})<a name="line.2429"></a>
-<span class="sourceLineNo">2430</span> * <jk>public class</jk> MyResource {<a name="line.2430"></a>
-<span class="sourceLineNo">2431</span> *<a name="line.2431"></a>
-<span class="sourceLineNo">2432</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2432"></a>
-<span class="sourceLineNo">2433</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2433"></a>
-<span class="sourceLineNo">2434</span> *<a name="line.2434"></a>
-<span class="sourceLineNo">2435</span> * <jc>// Using method on builder.</jc><a name="line.2435"></a>
-<span class="sourceLineNo">2436</span> * builder.produces(<jk>false</jk>, <js>"application/json"</js>)<a name="line.2436"></a>
-<span class="sourceLineNo">2437</span> *<a name="line.2437"></a>
-<span class="sourceLineNo">2438</span> * <jc>// Same, but using property.</jc><a name="line.2438"></a>
-<span class="sourceLineNo">2439</span> * builder.set(<jsf>REST_produces</jsf>, <js>"application/json"</js>);<a name="line.2439"></a>
-<span class="sourceLineNo">2440</span> * }<a name="line.2440"></a>
-<span class="sourceLineNo">2441</span> *<a name="line.2441"></a>
-<span class="sourceLineNo">2442</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2442"></a>
-<span class="sourceLineNo">2443</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2443"></a>
-<span class="sourceLineNo">2444</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2444"></a>
-<span class="sourceLineNo">2445</span> * builder.produces(<jk>false</jk>, <js>"application/json"</js>);<a name="line.2445"></a>
-<span class="sourceLineNo">2446</span> * }<a name="line.2446"></a>
-<span class="sourceLineNo">2447</span> * }<a name="line.2447"></a>
-<span class="sourceLineNo">2448</span> * </p><a name="line.2448"></a>
-<span class="sourceLineNo">2449</span> *<a name="line.2449"></a>
-<span class="sourceLineNo">2450</span> * <p><a name="line.2450"></a>
-<span class="sourceLineNo">2451</span> * This affects the returned values from the following:<a name="line.2451"></a>
-<span class="sourceLineNo">2452</span> * <ul><a name="line.2452"></a>
-<span class="sourceLineNo">2453</span> * <li class='jm'>{@link RestContext#getProduces() RestContext.getProduces()}<a name="line.2453"></a>
-<span class="sourceLineNo">2454</span> * <li class='jm'>{@link RestRequest#getProduces()}<a name="line.2454"></a>
-<span class="sourceLineNo">2455</span> * <li class='jm'>{@link RestInfoProvider#getSwagger(RestRequest)} - Affects produces field.<a name="line.2455"></a>
-<span class="sourceLineNo">2456</span> * </ul><a name="line.2456"></a>
-<span class="sourceLineNo">2457</span> */<a name="line.2457"></a>
-<span class="sourceLineNo">2458</span> public static final String REST_produces = PREFIX + "produces.ls";<a name="line.2458"></a>
-<span class="sourceLineNo">2459</span><a name="line.2459"></a>
-<span class="sourceLineNo">2460</span> /**<a name="line.2460"></a>
-<span class="sourceLineNo">2461</span> * Configuration property: Supported content media types.<a name="line.2461"></a>
-<span class="sourceLineNo">2462</span> *<a name="line.2462"></a>
-<span class="sourceLineNo">2463</span> * <h5 class='section'>Property:</h5><a name="line.2463"></a>
-<span class="sourceLineNo">2464</span> * <ul><a name="line.2464"></a>
-<span class="sourceLineNo">2465</span> * <li><b>Name:</b> <js>"RestContext.consumes.ls"</js><a name="line.2465"></a>
-<span class="sourceLineNo">2466</span> * <li><b>Data type:</b> <code>List&lt;String&gt;</code><a name="line.2466"></a>
-<span class="sourceLineNo">2467</span> * <li><b>Default:</b> empty list<a name="line.2467"></a>
-<span class="sourceLineNo">2468</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2468"></a>
-<span class="sourceLineNo">2469</span> * <li><b>Annotations:</b><a name="line.2469"></a>
-<span class="sourceLineNo">2470</span> * <ul><a name="line.2470"></a>
-<span class="sourceLineNo">2471</span> * <li class='ja'>{@link RestResource#consumes()}<a name="line.2471"></a>
-<span class="sourceLineNo">2472</span> * <li class='ja'>{@link RestMethod#consumes()}<a name="line.2472"></a>
-<span class="sourceLineNo">2473</span> * </ul><a name="line.2473"></a>
-<span class="sourceLineNo">2474</span> * <li><b>Methods:</b><a name="line.2474"></a>
-<span class="sourceLineNo">2475</span> * <ul><a name="line.2475"></a>
-<span class="sourceLineNo">2476</span> * <li class='jm'>{@link RestContextBuilder#consumes(boolean,String...)}<a name="line.2476"></a>
-<span class="sourceLineNo">2477</span> * <li class='jm'>{@link RestContextBuilder#consumes(boolean,MediaType...)}<a name="line.2477"></a>
-<span class="sourceLineNo">2478</span> * </ul><a name="line.2478"></a>
-<span class="sourceLineNo">2479</span> * </ul><a name="line.2479"></a>
-<span class="sourceLineNo">2480</span> *<a name="line.2480"></a>
-<span class="sourceLineNo">2481</span> * <h5 class='section'>Description:</h5><a name="line.2481"></a>
-<span class="sourceLineNo">2482</span> * <p><a name="line.2482"></a>
-<span class="sourceLineNo">2483</span> * Overrides the media types inferred from the parsers that identify what media types can be consumed by the resource.<a name="line.2483"></a>
-<span class="sourceLineNo">2484</span> * <br>An example where this might be useful if you have parsers registered that handle media types that you<a name="line.2484"></a>
-<span class="sourceLineNo">2485</span> * don't want exposed in the Swagger documentation.<a name="line.2485"></a>
-<span class="sourceLineNo">2486</span> *<a name="line.2486"></a>
-<span class="sourceLineNo">2487</span> * <h5 class='section'>Example:</h5><a name="line.2487"></a>
-<span class="sourceLineNo">2488</span> * <p class='bcode w800'><a name="line.2488"></a>
-<span class="sourceLineNo">2489</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2489"></a>
-<span class="sourceLineNo">2490</span> * <ja>@RestResource</ja>(consumes={<js>"$C{REST/supportedConsumes,application/json}"</js>})<a name="line.2490"></a>
-<span class="sourceLineNo">2491</span> * <jk>public class</jk> MyResource {<a name="line.2491"></a>
-<span class="sourceLineNo">2492</span> *<a name="line.2492"></a>
-<span class="sourceLineNo">2493</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2493"></a>
-<span class="sourceLineNo">2494</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2494"></a>
-<span class="sourceLineNo">2495</span> *<a name="line.2495"></a>
-<span class="sourceLineNo">2496</span> * <jc>// Using method on builder.</jc><a name="line.2496"></a>
-<span class="sourceLineNo">2497</span> * builder.consumes(<jk>false</jk>, <js>"application/json"</js>)<a name="line.2497"></a>
-<span class="sourceLineNo">2498</span> *<a name="line.2498"></a>
-<span class="sourceLineNo">2499</span> * <jc>// Same, but using property.</jc><a name="line.2499"></a>
-<span class="sourceLineNo">2500</span> * builder.set(<jsf>REST_consumes</jsf>, <js>"application/json"</js>);<a name="line.2500"></a>
-<span class="sourceLineNo">2501</span> * }<a name="line.2501"></a>
-<span class="sourceLineNo">2502</span> *<a name="line.2502"></a>
-<span class="sourceLineNo">2503</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2503"></a>
-<span class="sourceLineNo">2504</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2504"></a>
-<span class="sourceLineNo">2505</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2505"></a>
-<span class="sourceLineNo">2506</span> * builder.consumes(<jk>false</jk>, <js>"application/json"</js>);<a name="line.2506"></a>
-<span class="sourceLineNo">2507</span> * }<a name="line.2507"></a>
-<span class="sourceLineNo">2508</span> * }<a name="line.2508"></a>
-<span class="sourceLineNo">2509</span> * </p><a name="line.2509"></a>
-<span class="sourceLineNo">2510</span> *<a name="line.2510"></a>
-<span class="sourceLineNo">2511</span> * <p><a name="line.2511"></a>
-<span class="sourceLineNo">2512</span> * This affects the returned values from the following:<a name="line.2512"></a>
-<span class="sourceLineNo">2513</span> * <ul><a name="line.2513"></a>
-<span class="sourceLineNo">2514</span> * <li class='jm'>{@link RestContext#getConsumes() RestContext.getConsumes()}<a name="line.2514"></a>
-<span class="sourceLineNo">2515</span> * <li class='jm'>{@link RestRequest#getConsumes()}<a name="line.2515"></a>
-<span class="sourceLineNo">2516</span> * <li class='jm'>{@link RestInfoProvider#getSwagger(RestRequest)} - Affects consumes field.<a name="line.2516"></a>
-<span class="sourceLineNo">2517</span> * </ul><a name="line.2517"></a>
-<span class="sourceLineNo">2518</span> */<a name="line.2518"></a>
-<span class="sourceLineNo">2519</span> public static final String REST_consumes = PREFIX + "consumes.ls";<a name="line.2519"></a>
-<span class="sourceLineNo">2520</span><a name="line.2520"></a>
-<span class="sourceLineNo">2521</span> /**<a name="line.2521"></a>
-<span class="sourceLineNo">2522</span> * Configuration property: Use classpath resource caching.<a name="line.2522"></a>
-<span class="sourceLineNo">2523</span> *<a name="line.2523"></a>
-<span class="sourceLineNo">2524</span> * <h5 class='section'>Property:</h5><a name="line.2524"></a>
-<span class="sourceLineNo">2525</span> * <ul><a name="line.2525"></a>
-<span class="sourceLineNo">2526</span> * <li><b>Name:</b> <js>"RestContext.useClasspathResourceCaching.b"</js><a name="line.2526"></a>
-<span class="sourceLineNo">2527</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.2527"></a>
-<span class="sourceLineNo">2528</span> * <li><b>Default:</b> <jk>true</jk><a name="line.2528"></a>
-<span class="sourceLineNo">2529</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2529"></a>
-<span class="sourceLineNo">2530</span> * <li><b>Annotations:</b><a name="line.2530"></a>
-<span class="sourceLineNo">2531</span> * <ul><a name="line.2531"></a>
-<span class="sourceLineNo">2532</span> * <li class='ja'>{@link RestResource#useClasspathResourceCaching()}<a name="line.2532"></a>
-<span class="sourceLineNo">2533</span> * </ul><a name="line.2533"></a>
-<span class="sourceLineNo">2534</span> * <li><b>Methods:</b><a name="line.2534"></a>
-<span class="sourceLineNo">2535</span> * <ul><a name="line.2535"></a>
-<span class="sourceLineNo">2536</span> * <li class='jm'>{@link RestContextBuilder#useClasspathResourceCaching(boolean)}<a name="line.2536"></a>
-<span class="sourceLineNo">2537</span> * </ul><a name="line.2537"></a>
-<span class="sourceLineNo">2538</span> * </ul><a name="line.2538"></a>
-<span class="sourceLineNo">2539</span> *<a name="line.2539"></a>
-<span class="sourceLineNo">2540</span> * <h5 class='section'>Description:</h5><a name="line.2540"></a>
-<span class="sourceLineNo">2541</span> * <p><a name="line.2541"></a>
-<span class="sourceLineNo">2542</span> * When enabled, resources retrieved via {@link RestContext#getClasspathResource(String, Locale)} (and related<a name="line.2542"></a>
-<span class="sourceLineNo">2543</span> * methods) will be cached in memory to speed subsequent lookups.<a name="line.2543"></a>
-<span class="sourceLineNo">2544</span> *<a name="line.2544"></a>
-<span class="sourceLineNo">2545</span> * <h5 class='section'>Example:</h5><a name="line.2545"></a>
-<span class="sourceLineNo">2546</span> * <p class='bcode w800'><a name="line.2546"></a>
-<span class="sourceLineNo">2547</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2547"></a>
-<span class="sourceLineNo">2548</span> * <ja>@RestResource</ja>(useClasspathResourceCaching=<js>"$C{REST/useClasspathResourceCaching,false}"</js>)<a name="line.2548"></a>
-<span class="sourceLineNo">2549</span> * <jk>public class</jk> MyResource {<a name="line.2549"></a>
-<span class="sourceLineNo">2550</span> *<a name="line.2550"></a>
-<span class="sourceLineNo">2551</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2551"></a>
-<span class="sourceLineNo">2552</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2552"></a>
-<span class="sourceLineNo">2553</span> *<a name="line.2553"></a>
-<span class="sourceLineNo">2554</span> * <jc>// Using method on builder.</jc><a name="line.2554"></a>
-<span class="sourceLineNo">2555</span> * builder.useClasspathResourceCaching(<jk>false</jk>)<a name="line.2555"></a>
-<span class="sourceLineNo">2556</span> *<a name="line.2556"></a>
-<span class="sourceLineNo">2557</span> * <jc>// Same, but using property.</jc><a name="line.2557"></a>
-<span class="sourceLineNo">2558</span> * builder.set(<jsf>REST_useClasspathResourceCaching</jsf>, <jk>false</jk>);<a name="line.2558"></a>
-<span class="sourceLineNo">2559</span> * }<a name="line.2559"></a>
-<span class="sourceLineNo">2560</span> *<a name="line.2560"></a>
-<span class="sourceLineNo">2561</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2561"></a>
-<span class="sourceLineNo">2562</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2562"></a>
-<span class="sourceLineNo">2563</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2563"></a>
-<span class="sourceLineNo">2564</span> * builder.useClasspathResourceCaching(<jk>false</jk>)<a name="line.2564"></a>
-<span class="sourceLineNo">2565</span> * }<a name="line.2565"></a>
-<span class="sourceLineNo">2566</span> * }<a name="line.2566"></a>
-<span class="sourceLineNo">2567</span> * </p><a name="line.2567"></a>
-<span class="sourceLineNo">2568</span> *<a name="line.2568"></a>
-<span class="sourceLineNo">2569</span> * <h5 class='section'>See Also:</h5><a name="line.2569"></a>
-<span class="sourceLineNo">2570</span> * <ul><a name="line.2570"></a>
-<span class="sourceLineNo">2571</span> * <li class='jf'>{@link #REST_staticFiles} for information about static files.<a name="line.2571"></a>
-<span class="sourceLineNo">2572</span> * </ul><a name="line.2572"></a>
-<span class="sourceLineNo">2573</span> */<a name="line.2573"></a>
-<span class="sourceLineNo">2574</span> public static final String REST_useClasspathResourceCaching = PREFIX + "useClasspathResourceCaching.b";<a name="line.2574"></a>
-<span class="sourceLineNo">2575</span><a name="line.2575"></a>
-<span class="sourceLineNo">2576</span> /**<a name="line.2576"></a>
-<span class="sourceLineNo">2577</span> * Configuration property: Use stack trace hashes.<a name="line.2577"></a>
-<span class="sourceLineNo">2578</span> *<a name="line.2578"></a>
-<span class="sourceLineNo">2579</span> * <h5 class='section'>Property:</h5><a name="line.2579"></a>
-<span class="sourceLineNo">2580</span> * <ul><a name="line.2580"></a>
-<span class="sourceLineNo">2581</span> * <li><b>Name:</b> <js>"RestContext.useStackTraceHashes.b"</js><a name="line.2581"></a>
-<span class="sourceLineNo">2582</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.2582"></a>
-<span class="sourceLineNo">2583</span> * <li><b>Default:</b> <jk>true</jk><a name="line.2583"></a>
-<span class="sourceLineNo">2584</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2584"></a>
-<span class="sourceLineNo">2585</span> * <li><b>Annotations:</b><a name="line.2585"></a>
-<span class="sourceLineNo">2586</span> * <ul><a name="line.2586"></a>
-<span class="sourceLineNo">2587</span> * <li class='ja'>{@link RestResource#useStackTraceHashes()}<a name="line.2587"></a>
-<span class="sourceLineNo">2588</span> * </ul><a name="line.2588"></a>
-<span class="sourceLineNo">2589</span> * <li><b>Methods:</b><a name="line.2589"></a>
-<span class="sourceLineNo">2590</span> * <ul><a name="line.2590"></a>
-<span class="sourceLineNo">2591</span> * <li class='jm'>{@link RestContextBuilder#useStackTraceHashes(boolean)}<a name="line.2591"></a>
-<span class="sourceLineNo">2592</span> * </ul><a name="line.2592"></a>
-<span class="sourceLineNo">2593</span> * </ul><a name="line.2593"></a>
-<span class="sourceLineNo">2594</span> *<a name="line.2594"></a>
-<span class="sourceLineNo">2595</span> * <h5 class='section'>Description:</h5><a name="line.2595"></a>
-<span class="sourceLineNo">2596</span> * <p><a name="line.2596"></a>
-<span class="sourceLineNo">2597</span> * When enabled, the number of times an exception has occurred will be tracked based on stack trace hashsums.<a name="line.2597"></a>
-<span class="sourceLineNo">2598</span> *<a name="line.2598"></a>
-<span class="sourceLineNo">2599</span> * <p><a name="line.2599"></a>
-<span class="sourceLineNo">2600</span> * Affects the following methods:<a name="line.2600"></a>
-<span class="sourceLineNo">2601</span> * <ul><a name="line.2601"></a>
-<span class="sourceLineNo">2602</span> * <li class='jm'>{@link RestContext#getStackTraceOccurrence(Throwable) RestContext.getStackTraceOccurrance(Throwable)}<a name="line.2602"></a>
-<span class="sourceLineNo">2603</span> * <li class='jm'>{@link RestCallHandler#handleError(HttpServletRequest, HttpServletResponse, Throwable)}<a name="line.2603"></a>
-<span class="sourceLineNo">2604</span> * <li class='jm'>{@link RestException#getOccurrence()} - Returns the number of times this exception occurred.<a name="line.2604"></a>
-<span class="sourceLineNo">2605</span> * </ul><a name="line.2605"></a>
-<span class="sourceLineNo">2606</span> *<a name="line.2606"></a>
-<span class="sourceLineNo">2607</span> * <h5 class='section'>Example:</h5><a name="line.2607"></a>
-<span class="sourceLineNo">2608</span> * <p class='bcode w800'><a name="line.2608"></a>
-<span class="sourceLineNo">2609</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2609"></a>
-<span class="sourceLineNo">2610</span> * <ja>@RestResource</ja>(useStackTraceHashes=<js>"$C{REST/useStackTraceHashes,false}"</js>)<a name="line.2610"></a>
-<span class="sourceLineNo">2611</span> * <jk>public class</jk> MyResource {<a name="line.2611"></a>
-<span class="sourceLineNo">2612</span> *<a name="line.2612"></a>
-<span class="sourceLineNo">2613</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2613"></a>
-<span class="sourceLineNo">2614</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2614"></a>
-<span class="sourceLineNo">2615</span> *<a name="line.2615"></a>
-<span class="sourceLineNo">2616</span> * <jc>// Using method on builder.</jc><a name="line.2616"></a>
-<span class="sourceLineNo">2617</span> * builder.useStackTraceHashes(<jk>false</jk>)<a name="line.2617"></a>
-<span class="sourceLineNo">2618</span> *<a name="line.2618"></a>
-<span class="sourceLineNo">2619</span> * <jc>// Same, but using property.</jc><a name="line.2619"></a>
-<span class="sourceLineNo">2620</span> * builder.set(<jsf>REST_useStackTraceHashes</jsf>, <jk>false</jk>);<a name="line.2620"></a>
-<span class="sourceLineNo">2621</span> * }<a name="line.2621"></a>
-<span class="sourceLineNo">2622</span> *<a name="line.2622"></a>
-<span class="sourceLineNo">2623</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2623"></a>
-<span class="sourceLineNo">2624</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2624"></a>
-<span class="sourceLineNo">2625</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2625"></a>
-<span class="sourceLineNo">2626</span> * builder.useStackTraceHashes(<jk>false</jk>)<a name="line.2626"></a>
-<span class="sourceLineNo">2627</span> * }<a name="line.2627"></a>
-<span class="sourceLineNo">2628</span> * }<a name="line.2628"></a>
-<span class="sourceLineNo">2629</span> * </p><a name="line.2629"></a>
-<span class="sourceLineNo">2630</span> */<a name="line.2630"></a>
-<span class="sourceLineNo">2631</span> public static final String REST_useStackTraceHashes = PREFIX + "useStackTraceHashes.b";<a name="line.2631"></a>
-<span class="sourceLineNo">2632</span><a name="line.2632"></a>
-<span class="sourceLineNo">2633</span> /**<a name="line.2633"></a>
-<span class="sourceLineNo">2634</span> * Configuration property: Resource URI authority path.<a name="line.2634"></a>
-<span class="sourceLineNo">2635</span> *<a name="line.2635"></a>
-<span class="sourceLineNo">2636</span> * <h5 class='section'>Property:</h5><a name="line.2636"></a>
-<span class="sourceLineNo">2637</span> * <ul><a name="line.2637"></a>
-<span class="sourceLineNo">2638</span> * <li><b>Name:</b> <js>"RestContext.uriAuthority.s"</js><a name="line.2638"></a>
-<span class="sourceLineNo">2639</span> * <li><b>Data type:</b> <code>String</code><a name="line.2639"></a>
-<span class="sourceLineNo">2640</span> * <li><b>Default:</b> <jk>null</jk><a name="line.2640"></a>
-<span class="sourceLineNo">2641</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2641"></a>
-<span class="sourceLineNo">2642</span> * <li><b>Annotations:</b><a name="line.2642"></a>
-<span class="sourceLineNo">2643</span> * <ul><a name="line.2643"></a>
-<span class="sourceLineNo">2644</span> * <li class='ja'>{@link RestResource#uriAuthority()}<a name="line.2644"></a>
-<span class="sourceLineNo">2645</span> * </ul><a name="line.2645"></a>
-<span class="sourceLineNo">2646</span> * <li><b>Methods:</b><a name="line.2646"></a>
-<span class="sourceLineNo">2647</span> * <ul><a name="line.2647"></a>
-<span class="sourceLineNo">2648</span> * <li class='jm'>{@link RestContextBuilder#uriAuthority(String)}<a name="line.2648"></a>
-<span class="sourceLineNo">2649</span> * </ul><a name="line.2649"></a>
-<span class="sourceLineNo">2650</span> * </ul><a name="line.2650"></a>
-<span class="sourceLineNo">2651</span> *<a name="line.2651"></a>
-<span class="sourceLineNo">2652</span> * <h5 class='section'>Description:</h5><a name="line.2652"></a>
-<span class="sourceLineNo">2653</span> * <p><a name="line.2653"></a>
-<span class="sourceLineNo">2654</span> * Overrides the authority path value for this resource and any child resources.<a name="line.2654"></a>
-<span class="sourceLineNo">2655</span> *<a name="line.2655"></a>
-<span class="sourceLineNo">2656</span> * <p><a name="line.2656"></a>
-<span class="sourceLineNo">2657</span> * Affects the following methods:<a name="line.2657"></a>
-<span class="sourceLineNo">2658</span> * <ul><a name="line.2658"></a>
-<span class="sourceLineNo">2659</span> * <li class='jm'>{@link RestRequest#getAuthorityPath()}<a name="line.2659"></a>
-<span class="sourceLineNo">2660</span> * </ul><a name="line.2660"></a>
-<span class="sourceLineNo">2661</span> *<a name="line.2661"></a>
-<span class="sourceLineNo">2662</span> * <p><a name="line.2662"></a>
-<span class="sourceLineNo">2663</span> * If you do not specify the authority, it is automatically calculated via the following:<a name="line.2663"></a>
-<span class="sourceLineNo">2664</span> *<a name="line.2664"></a>
-<span class="sourceLineNo">2665</span> * <p class='bcode w800'><a name="line.2665"></a>
-<span class="sourceLineNo">2666</span> * String scheme = request.getScheme();<a name="line.2666"></a>
-<span class="sourceLineNo">2667</span> * <jk>int</jk> port = request.getServerPort();<a name="line.2667"></a>
-<span class="sourceLineNo">2668</span> * StringBuilder sb = <jk>new</jk> StringBuilder(request.getScheme()).append(<js>"://"</js>).append(request.getServerName());<a name="line.2668"></a>
-<span class="sourceLineNo">2669</span> * <jk>if</jk> (! (port == 80 && <js>"http"</js>.equals(scheme) || port == 443 && <js>"https"</js>.equals(scheme)))<a name="line.2669"></a>
-<span class="sourceLineNo">2670</span> * sb.append(<js>':'</js>).append(port);<a name="line.2670"></a>
-<span class="sourceLineNo">2671</span> * authorityPath = sb.toString();<a name="line.2671"></a>
-<span class="sourceLineNo">2672</span> * </p><a name="line.2672"></a>
-<span class="sourceLineNo">2673</span> *<a name="line.2673"></a>
-<span class="sourceLineNo">2674</span> * <h5 class='section'>Example:</h5><a name="line.2674"></a>
-<span class="sourceLineNo">2675</span> * <p class='bcode w800'><a name="line.2675"></a>
-<span class="sourceLineNo">2676</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2676"></a>
-<span class="sourceLineNo">2677</span> * <ja>@RestResource</ja>(<a name="line.2677"></a>
-<span class="sourceLineNo">2678</span> * path=<js>"/servlet"</js>,<a name="line.2678"></a>
-<span class="sourceLineNo">2679</span> * uriAuthority=<js>"$C{REST/authorityPathOverride,http://localhost:10000}"</js><a name="line.2679"></a>
-<span class="sourceLineNo">2680</span> * )<a name="line.2680"></a>
-<span class="sourceLineNo">2681</span> * <jk>public class</jk> MyResource {<a name="line.2681"></a>
-<span class="sourceLineNo">2682</span> *<a name="line.2682"></a>
-<span class="sourceLineNo">2683</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2683"></a>
-<span class="sourceLineNo">2684</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2684"></a>
-<span class="sourceLineNo">2685</span> *<a name="line.2685"></a>
-<span class="sourceLineNo">2686</span> * <jc>// Using method on builder.</jc><a name="line.2686"></a>
-<span class="sourceLineNo">2687</span> * builder.uriAuthority(<js>"http://localhost:10000"</js>);<a name="line.2687"></a>
-<span class="sourceLineNo">2688</span> *<a name="line.2688"></a>
-<span class="sourceLineNo">2689</span> * <jc>// Same, but using property.</jc><a name="line.2689"></a>
-<span class="sourceLineNo">2690</span> * builder.set(<jsf>REST_uriAuthority</jsf>, <js>"http://localhost:10000"</js>);<a name="line.2690"></a>
-<span class="sourceLineNo">2691</span> * }<a name="line.2691"></a>
-<span class="sourceLineNo">2692</span> *<a name="line.2692"></a>
-<span class="sourceLineNo">2693</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2693"></a>
-<span class="sourceLineNo">2694</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2694"></a>
-<span class="sourceLineNo">2695</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2695"></a>
-<span class="sourceLineNo">2696</span> * builder.uriAuthority(<js>"http://localhost:10000"</js>);<a name="line.2696"></a>
-<span class="sourceLineNo">2697</span> * }<a name="line.2697"></a>
-<span class="sourceLineNo">2698</span> * }<a name="line.2698"></a>
-<span class="sourceLineNo">2699</span> * </p><a name="line.2699"></a>
-<span class="sourceLineNo">2700</span> */<a name="line.2700"></a>
-<span class="sourceLineNo">2701</span> public static final String REST_uriAuthority = PREFIX + "uriAuthority.s";<a name="line.2701"></a>
-<span class="sourceLineNo">2702</span><a name="line.2702"></a>
-<span class="sourceLineNo">2703</span> /**<a name="line.2703"></a>
-<span class="sourceLineNo">2704</span> * Configuration property: Resource URI context path.<a name="line.2704"></a>
-<span class="sourceLineNo">2705</span> *<a name="line.2705"></a>
-<span class="sourceLineNo">2706</span> * <h5 class='section'>Property:</h5><a name="line.2706"></a>
-<span class="sourceLineNo">2707</span> * <ul><a name="line.2707"></a>
-<span class="sourceLineNo">2708</span> * <li><b>Name:</b> <js>"RestContext.uriContext.s"</js><a name="line.2708"></a>
-<span class="sourceLineNo">2709</span> * <li><b>Data type:</b> <code>String</code><a name="line.2709"></a>
-<span class="sourceLineNo">2710</span> * <li><b>Default:</b> <jk>null</jk><a name="line.2710"></a>
-<span class="sourceLineNo">2711</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2711"></a>
-<span class="sourceLineNo">2712</span> * <li><b>Annotations:</b><a name="line.2712"></a>
-<span class="sourceLineNo">2713</span> * <ul><a name="line.2713"></a>
-<span class="sourceLineNo">2714</span> * <li class='ja'>{@link RestResource#uriContext()}<a name="line.2714"></a>
-<span class="sourceLineNo">2715</span> * </ul><a name="line.2715"></a>
-<span class="sourceLineNo">2716</span> * <li><b>Methods:</b><a name="line.2716"></a>
-<span class="sourceLineNo">2717</span> * <ul><a name="line.2717"></a>
-<span class="sourceLineNo">2718</span> * <li class='jm'>{@link RestContextBuilder#uriContext(String)}<a name="line.2718"></a>
-<span class="sourceLineNo">2719</span> * </ul><a name="line.2719"></a>
-<span class="sourceLineNo">2720</span> * </ul><a name="line.2720"></a>
-<span class="sourceLineNo">2721</span> *<a name="line.2721"></a>
-<span class="sourceLineNo">2722</span> * <h5 class='section'>Description:</h5><a name="line.2722"></a>
-<span class="sourceLineNo">2723</span> * <p><a name="line.2723"></a>
-<span class="sourceLineNo">2724</span> * Overrides the context path value for this resource and any child resources.<a name="line.2724"></a>
-<span class="sourceLineNo">2725</span> *<a name="line.2725"></a>
-<span class="sourceLineNo">2726</span> * <p><a name="line.2726"></a>
-<span class="sourceLineNo">2727</span> * This setting is useful if you want to use <js>"context:/child/path"</js> URLs in child resource POJOs but<a name="line.2727"></a>
-<span class="sourceLineNo">2728</span> * the context path is not actually specified on the servlet container.<a name="line.2728"></a>
-<span class="sourceLineNo">2729</span> *<a name="line.2729"></a>
-<span class="sourceLineNo">2730</span> * <p><a name="line.2730"></a>
-<span class="sourceLineNo">2731</span> * Affects the following methods:<a name="line.2731"></a>
-<span class="sourceLineNo">2732</span> * <ul><a name="line.2732"></a>
-<span class="sourceLineNo">2733</span> * <li class='jm'>{@link RestRequest#getContextPath()} - Returns the overridden context path for the resource.<a name="line.2733"></a>
-<span class="sourceLineNo">2734</span> * <li class='jm'>{@link RestRequest#getServletPath()} - Includes the overridden context path for the resource.<a name="line.2734"></a>
-<span class="sourceLineNo">2735</span> * </ul><a name="line.2735"></a>
-<span class="sourceLineNo">2736</span> *<a name="line.2736"></a>
-<span class="sourceLineNo">2737</span> * <h5 class='section'>Example:</h5><a name="line.2737"></a>
-<span class="sourceLineNo">2738</span> * <p class='bcode w800'><a name="line.2738"></a>
-<span class="sourceLineNo">2739</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2739"></a>
-<span class="sourceLineNo">2740</span> * <ja>@RestResource</ja>(<a name="line.2740"></a>
-<span class="sourceLineNo">2741</span> * path=<js>"/servlet"</js>,<a name="line.2741"></a>
-<span class="sourceLineNo">2742</span> * uriContext=<js>"$C{REST/contextPathOverride,/foo}"</js><a name="line.2742"></a>
-<span class="sourceLineNo">2743</span> * )<a name="line.2743"></a>
-<span class="sourceLineNo">2744</span> * <jk>public class</jk> MyResource {<a name="line.2744"></a>
-<span class="sourceLineNo">2745</span> *<a name="line.2745"></a>
-<span class="sourceLineNo">2746</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2746"></a>
-<span class="sourceLineNo">2747</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2747"></a>
-<span class="sourceLineNo">2748</span> *<a name="line.2748"></a>
-<span class="sourceLineNo">2749</span> * <jc>// Using method on builder.</jc><a name="line.2749"></a>
-<span class="sourceLineNo">2750</span> * builder.uriContext(<js>"/foo"</js>);<a name="line.2750"></a>
-<span class="sourceLineNo">2751</span> *<a name="line.2751"></a>
-<span class="sourceLineNo">2752</span> * <jc>// Same, but using property.</jc><a name="line.2752"></a>
-<span class="sourceLineNo">2753</span> * builder.set(<jsf>REST_uriContext</jsf>, <js>"/foo"</js>);<a name="line.2753"></a>
-<span class="sourceLineNo">2754</span> * }<a name="line.2754"></a>
-<span class="sourceLineNo">2755</span> *<a name="line.2755"></a>
-<span class="sourceLineNo">2756</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2756"></a>
-<span class="sourceLineNo">2757</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2757"></a>
-<span class="sourceLineNo">2758</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2758"></a>
-<span class="sourceLineNo">2759</span> * builder.uriContext(<js>"/foo"</js>);<a name="line.2759"></a>
-<span class="sourceLineNo">2760</span> * }<a name="line.2760"></a>
-<span class="sourceLineNo">2761</span> * }<a name="line.2761"></a>
-<span class="sourceLineNo">2762</span> * </p><a name="line.2762"></a>
-<span class="sourceLineNo">2763</span> */<a name="line.2763"></a>
-<span class="sourceLineNo">2764</span> public static final String REST_uriContext = PREFIX + "uriContext.s";<a name="line.2764"></a>
-<span class="sourceLineNo">2765</span><a name="line.2765"></a>
-<span class="sourceLineNo">2766</span> /**<a name="line.2766"></a>
-<span class="sourceLineNo">2767</span> * Configuration property: URI resolution relativity.<a name="line.2767"></a>
-<span class="sourceLineNo">2768</span> *<a name="line.2768"></a>
-<span class="sourceLineNo">2769</span> * <h5 class='section'>Property:</h5><a name="line.2769"></a>
-<span class="sourceLineNo">2770</span> * <ul><a name="line.2770"></a>
-<span class="sourceLineNo">2771</span> * <li><b>Name:</b> <js>"RestContext.uriRelativity.s"</js><a name="line.2771"></a>
-<span class="sourceLineNo">2772</span> * <li><b>Data type:</b> <code>String</code><a name="line.2772"></a>
-<span class="sourceLineNo">2773</span> * <li><b>Default:</b> <js>"RESOURCE"</js><a name="line.2773"></a>
-<span class="sourceLineNo">2774</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2774"></a>
-<span class="sourceLineNo">2775</span> * <li><b>Annotations:</b><a name="line.2775"></a>
-<span class="sourceLineNo">2776</span> * <ul><a name="line.2776"></a>
-<span class="sourceLineNo">2777</span> * <li class='ja'>{@link RestResource#uriRelativity()}<a name="line.2777"></a>
-<span class="sourceLineNo">2778</span> * </ul><a name="line.2778"></a>
-<span class="sourceLineNo">2779</span> * <li><b>Methods:</b><a name="line.2779"></a>
-<span class="sourceLineNo">2780</span> * <ul><a name="line.2780"></a>
-<span class="sourceLineNo">2781</span> * <li class='jm'>{@link RestContextBuilder#uriRelativity(String)}<a name="line.2781"></a>
-<span class="sourceLineNo">2782</span> * </ul><a name="line.2782"></a>
-<span class="sourceLineNo">2783</span> * </ul><a name="line.2783"></a>
-<span class="sourceLineNo">2784</span> *<a name="line.2784"></a>
-<span class="sourceLineNo">2785</span> * <h5 class='section'>Description:</h5><a name="line.2785"></a>
-<span class="sourceLineNo">2786</span> * <p><a name="line.2786"></a>
-<span class="sourceLineNo">2787</span> * Specifies how relative URIs should be interpreted by serializers.<a name="line.2787"></a>
-<span class="sourceLineNo">2788</span> *<a name="line.2788"></a>
-<span class="sourceLineNo">2789</span> * <p><a name="line.2789"></a>
-<span class="sourceLineNo">2790</span> * See {@link UriResolution} for possible values.<a name="line.2790"></a>
-<span class="sourceLineNo">2791</span> *<a name="line.2791"></a>
-<span class="sourceLineNo">2792</span> * <p><a name="line.2792"></a>
-<span class="sourceLineNo">2793</span> * Affects the following methods:<a name="line.2793"></a>
-<span class="sourceLineNo">2794</span> * <ul><a name="line.2794"></a>
-<span class="sourceLineNo">2795</span> * <li class='jm'>{@link RestRequest#getUriResolver()}<a name="line.2795"></a>
-<span class="sourceLineNo">2796</span> * </ul><a name="line.2796"></a>
-<span class="sourceLineNo">2797</span> *<a name="line.2797"></a>
-<span class="sourceLineNo">2798</span> * <h5 class='section'>Example:</h5><a name="line.2798"></a>
-<span class="sourceLineNo">2799</span> * <p class='bcode w800'><a name="line.2799"></a>
-<span class="sourceLineNo">2800</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2800"></a>
-<span class="sourceLineNo">2801</span> * <ja>@RestResource</ja>(<a name="line.2801"></a>
-<span class="sourceLineNo">2802</span> * path=<js>"/servlet"</js>,<a name="line.2802"></a>
-<span class="sourceLineNo">2803</span> * uriRelativity=<js>"$C{REST/uriRelativity,PATH_INFO}"</js><a name="line.2803"></a>
-<span class="sourceLineNo">2804</span> * )<a name="line.2804"></a>
-<span class="sourceLineNo">2805</span> * <jk>public class</jk> MyResource {<a name="line.2805"></a>
-<span class="sourceLineNo">2806</span> *<a name="line.2806"></a>
-<span class="sourceLineNo">2807</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2807"></a>
-<span class="sourceLineNo">2808</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2808"></a>
-<span class="sourceLineNo">2809</span> *<a name="line.2809"></a>
-<span class="sourceLineNo">2810</span> * <jc>// Using method on builder.</jc><a name="line.2810"></a>
-<span class="sourceLineNo">2811</span> * builder.uriRelativity(<js>"PATH_INFO"</js>);<a name="line.2811"></a>
-<span class="sourceLineNo">2812</span> *<a name="line.2812"></a>
-<span class="sourceLineNo">2813</span> * <jc>// Same, but using property.</jc><a name="line.2813"></a>
-<span class="sourceLineNo">2814</span> * builder.set(<jsf>REST_uriRelativity</jsf>, <js>"PATH_INFO"</js>);<a name="line.2814"></a>
-<span class="sourceLineNo">2815</span> * }<a name="line.2815"></a>
-<span class="sourceLineNo">2816</span> *<a name="line.2816"></a>
-<span class="sourceLineNo">2817</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2817"></a>
-<span class="sourceLineNo">2818</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2818"></a>
-<span class="sourceLineNo">2819</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2819"></a>
-<span class="sourceLineNo">2820</span> * builder.uriRelativity(<js>"PATH_INFO"</js>);<a name="line.2820"></a>
-<span class="sourceLineNo">2821</span> * }<a name="line.2821"></a>
-<span class="sourceLineNo">2822</span> * }<a name="line.2822"></a>
-<span class="sourceLineNo">2823</span> * </p><a name="line.2823"></a>
-<span class="sourceLineNo">2824</span> */<a name="line.2824"></a>
-<span class="sourceLineNo">2825</span> public static final String REST_uriRelativity = PREFIX + "uriRelativity.s";<a name="line.2825"></a>
-<span class="sourceLineNo">2826</span><a name="line.2826"></a>
-<span class="sourceLineNo">2827</span> /**<a name="line.2827"></a>
-<span class="sourceLineNo">2828</span> * Configuration property: URI resolution.<a name="line.2828"></a>
-<span class="sourceLineNo">2829</span> *<a name="line.2829"></a>
-<span class="sourceLineNo">2830</span> * <h5 class='section'>Property:</h5><a name="line.2830"></a>
-<span class="sourceLineNo">2831</span> * <ul><a name="line.2831"></a>
-<span class="sourceLineNo">2832</span> * <li><b>Name:</b> <js>"RestContext.uriResolution.s"</js><a name="line.2832"></a>
-<span class="sourceLineNo">2833</span> * <li><b>Data type:</b> <code>String</code><a name="line.2833"></a>
-<span class="sourceLineNo">2834</span> * <li><b>Default:</b> <js>"ROOT_RELATIVE"</js><a name="line.2834"></a>
-<span class="sourceLineNo">2835</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2835"></a>
-<span class="sourceLineNo">2836</span> * <li><b>Annotations:</b><a name="line.2836"></a>
-<span class="sourceLineNo">2837</span> * <ul><a name="line.2837"></a>
-<span class="sourceLineNo">2838</span> * <li class='ja'>{@link RestResource#uriResolution()}<a name="line.2838"></a>
-<span class="sourceLineNo">2839</span> * </ul><a name="line.2839"></a>
-<span class="sourceLineNo">2840</span> * <li><b>Methods:</b><a name="line.2840"></a>
-<span class="sourceLineNo">2841</span> * <ul><a name="line.2841"></a>
-<span class="sourceLineNo">2842</span> * <li class='jm'>{@link RestContextBuilder#uriResolution(String)}<a name="line.2842"></a>
-<span class="sourceLineNo">2843</span> * </ul><a name="line.2843"></a>
-<span class="sourceLineNo">2844</span> * </ul><a name="line.2844"></a>
-<span class="sourceLineNo">2845</span> *<a name="line.2845"></a>
-<span class="sourceLineNo">2846</span> * <h5 class='section'>Description:</h5><a name="line.2846"></a>
-<span class="sourceLineNo">2847</span> * <p><a name="line.2847"></a>
-<span class="sourceLineNo">2848</span> * Specifies how relative URIs should be interpreted by serializers.<a name="line.2848"></a>
-<span class="sourceLineNo">2849</span> *<a name="line.2849"></a>
-<span class="sourceLineNo">2850</span> * <p><a name="line.2850"></a>
-<span class="sourceLineNo">2851</span> * See {@link UriResolution} for possible values.<a name="line.2851"></a>
-<span class="sourceLineNo">2852</span> *<a name="line.2852"></a>
-<span class="sourceLineNo">2853</span> * <p><a name="line.2853"></a>
-<span class="sourceLineNo">2854</span> * Affects the following methods:<a name="line.2854"></a>
-<span class="sourceLineNo">2855</span> * <ul><a name="line.2855"></a>
-<span class="sourceLineNo">2856</span> * <li class='jm'>{@link RestRequest#getUriResolver()}<a name="line.2856"></a>
-<span class="sourceLineNo">2857</span> * </ul><a name="line.2857"></a>
-<span class="sourceLineNo">2858</span> *<a name="line.2858"></a>
-<span class="sourceLineNo">2859</span> * <h5 class='section'>Example:</h5><a name="line.2859"></a>
-<span class="sourceLineNo">2860</span> * <p class='bcode w800'><a name="line.2860"></a>
-<span class="sourceLineNo">2861</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.2861"></a>
-<span class="sourceLineNo">2862</span> * <ja>@RestResource</ja>(<a name="line.2862"></a>
-<span class="sourceLineNo">2863</span> * path=<js>"/servlet"</js>,<a name="line.2863"></a>
-<span class="sourceLineNo">2864</span> * uriResolution=<js>"$C{REST/uriResolution,ABSOLUTE}"</js><a name="line.2864"></a>
-<span class="sourceLineNo">2865</span> * )<a name="line.2865"></a>
-<span class="sourceLineNo">2866</span> * <jk>public class</jk> MyResource {<a name="line.2866"></a>
-<span class="sourceLineNo">2867</span> *<a name="line.2867"></a>
-<span class="sourceLineNo">2868</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.2868"></a>
-<span class="sourceLineNo">2869</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2869"></a>
-<span class="sourceLineNo">2870</span> *<a name="line.2870"></a>
-<span class="sourceLineNo">2871</span> * <jc>// Using method on builder.</jc><a name="line.2871"></a>
-<span class="sourceLineNo">2872</span> * builder.uriResolution(<js>"ABSOLUTE"</js>);<a name="line.2872"></a>
-<span class="sourceLineNo">2873</span> *<a name="line.2873"></a>
-<span class="sourceLineNo">2874</span> * <jc>// Same, but using property.</jc><a name="line.2874"></a>
-<span class="sourceLineNo">2875</span> * builder.set(<jsf>REST_uriResolution</jsf>, <js>"ABSOLUTE"</js>);<a name="line.2875"></a>
-<span class="sourceLineNo">2876</span> * }<a name="line.2876"></a>
-<span class="sourceLineNo">2877</span> *<a name="line.2877"></a>
-<span class="sourceLineNo">2878</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.2878"></a>
-<span class="sourceLineNo">2879</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.2879"></a>
-<span class="sourceLineNo">2880</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.2880"></a>
-<span class="sourceLineNo">2881</span> * builder.uriResolution(<js>"ABSOLUTE"</js>);<a name="line.2881"></a>
-<span class="sourceLineNo">2882</span> * }<a name="line.2882"></a>
-<span class="sourceLineNo">2883</span> * }<a name="line.2883"></a>
-<span class="sourceLineNo">2884</span> * </p><a name="line.2884"></a>
-<span class="sourceLineNo">2885</span> */<a name="line.2885"></a>
-<span class="sourceLineNo">2886</span> public static final String REST_uriResolution = PREFIX + "uriResolution.s";<a name="line.2886"></a>
-<span class="sourceLineNo">2887</span><a name="line.2887"></a>
-<span class="sourceLineNo">2888</span> /**<a name="line.2888"></a>
-<span class="sourceLineNo">2889</span> * Configuration property: HTML Widgets.<a name="line.2889"></a>
-<span class="sourceLineNo">2890</span> *<a name="line.2890"></a>
-<span class="sourceLineNo">2891</span> * <h5 class='section'>Property:</h5><a name="line.2891"></a>
-<span class="sourceLineNo">2892</span> * <ul><a name="line.2892"></a>
-<span class="sourceLineNo">2893</span> * <li><b>Name:</b> <js>"RestContext.widgets.lo"</js><a name="line.2893"></a>
-<span class="sourceLineNo">2894</span> * <li><b>Data type:</b> <code>List&lt;{@link Widget} | Class&lt;? <jk>extends</jk> {@link Widget}&gt;&gt;</code><a name="line.2894"></a>
-<span class="sourceLineNo">2895</span> * <li><b>Default:</b> empty list<a name="line.2895"></a>
-<span class="sourceLineNo">2896</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.2896"></a>
-<span class="sourceLineNo">2897</span> * <li><b>Annotations:</b><a name="line.2897"></a>
-<span class="sourceLineNo">2898</span> * <ul><a name="line.2898"></a>
-<span class="sourceLineNo">2899</span> * <li class='ja'>{@link HtmlDoc#widgets()}<a name="line.2899"></a>
-<span class="sourceLineNo">2900</span> * </ul><a name="line.2900"></a>
-<span class="sourceLineNo">2901</span> * <li><b>Methods:</b><a name="line.2901"></a>
-<span class="sourceLineNo">2902</span> * <ul><a name="line.2902"></a>
-<span class="sourceLineNo">2903</span> * <li class='jm'>{@link RestContextBuilder#widgets(Class...)}<a name="line.2903"></a>
-<span class="sourceLineNo">2904</span> * <li class='jm'>{@link RestContextBuilder#widgets(Widget...)}<a name="line.2904"></a>
-<span class="sourceLineNo">2905</span> * <li class='jm'>{@link RestContextBuilder#widgets(boolean,Widget...)}<a name="line.2905"></a>
-<span class="sourceLineNo">2906</span> * </ul><a name="line.2906"></a>
-<span class="sourceLineNo">2907</span> * </ul><a name="line.2907"></a>
-<span class="sourceLineNo">2908</span> *<a name="line.2908"></a>
-<span class="sourceLineNo">2909</span> * <h5 class='section'>Description:</h5><a name="line.2909"></a>
-<span class="sourceLineNo">2910</span> * <p><a name="line.2910"></a>
-<span class="sourceLineNo">2911</span> * Defines widgets that can be used in conjunction with string variables of the form <js>"$W{name}"</js>to quickly<a name="line.2911"></a>
-<span class="sourceLineNo">2912</span> * generate arbitrary replacement text.<a name="line.2912"></a>
-<span class="sourceLineNo">2913</span> *<a name="line.2913"></a>
-<span class="sourceLineNo">2914</span> * Widgets resolve the following variables:<a name="line.2914"></a>
-<span class="sourceLineNo">2915</span> * <ul class='spaced-list'><a name="line.2915"></a>
-<span class="sourceLineNo">2916</span> * <li><js>"$W{name}"</js> - Contents returned by {@link Widget#getHtml(RestRequest)}.<a name="line.2916"></a>
-<span class="sourceLineNo">2917</span> * <li><js>"$W{name.script}"</js> - Contents returned by {@link Widget#getScript(RestRequest)}.<a name="line.2917"></a>
-<span class="sourceLineNo">2918</span> * <br>The script contents are automatically inserted into the <xt>&lt;head/script&gt;</xt> section<a name="line.2918"></a>
-<span class="sourceLineNo">2919</span> * in the HTML page.<a name="line.2919"></a>
-<span class="sourceLineNo">2920</span> * <li><js>"$W{name.style}"</js> - Contents returned by {@link Widget#getStyle(RestRequest)}.<a name="line.2920"></a>
-<span class="sourceLineNo">2921</span> * <br>The styles contents are automatically inserted into the <xt>&lt;head/style&gt;</xt> section<a name="line.2921"></a>
-<span class="sourceLineNo">2922</span> * in the HTML page.<a name="line.2922"></a>
-<span class="sourceLineNo">2923</span> * </ul><a name="line.2923"></a>
-<span class="sourceLineNo">2924</span> *<a name="line.2924"></a>
-<span class="sourceLineNo">2925</span> * <p><a name="line.2925"></a>
-<span class="sourceLineNo">2926</span> * The following examples shows how to associate a widget with a REST method and then have it rendered in the links<a name="line.2926"></a>
-<span class="sourceLineNo">2927</span> * and aside section of the page:<a name="line.2927"></a>
-<span class="sourceLineNo">2928</span> *<a name="line.2928"></a>
-<span class="sourceLineNo">2929</span> * <p class='bcode w800'><a name="line.2929"></a>
-<span class="sourceLineNo">2930</span> * <ja>@RestMethod</ja>(<a name="line.2930"></a>
-<span class="sourceLineNo">2931</span> * widgets={<a name="line.2931"></a>
-<span class="sourceLineNo">2932</span> * MyWidget.<jk>class</jk><a name="line.2932"></a>
-<span class="sourceLineNo">2933</span> * }<a name="line.2933"></a>
-<span class="sourceLineNo">2934</span> * htmldoc=<ja>@HtmlDoc</ja>(<a name="line.2934"></a>
-<span class="sourceLineNo">2935</span> * navlinks={<a name="line.2935"></a>
-<span class="sourceLineNo">2936</span> * <js>"$W{MyWidget}"</js><a name="line.2936"></a>
-<span class="sourceLineNo">2937</span> * },<a name="line.2937"></a>
-<span class="sourceLineNo">2938</span> * aside={<a name="line.2938"></a>
-<span class="sourceLineNo">2939</span> * <js>"Check out this widget: $W{MyWidget}"</js><a name="line.2939"></a>
-<span class="sourceLineNo">2940</span> * }<a name="line.2940"></a>
-<span class="sourceLineNo">2941</span> * )<a name="line.2941"></a>
-<span class="sourceLineNo">2942</span> * )<a name="line.2942"></a>
-<span class="sourceLineNo">2943</span> * </p><a name="line.2943"></a>
-<span class="sourceLineNo">2944</span> *<a name="line.2944"></a>
-<span class="sourceLineNo">2945</span> * <h5 class='section'>Notes:</h5><a name="line.2945"></a>
-<span class="sourceLineNo">2946</span> * <ul class='spaced-list'><a name="line.2946"></a>
-<span class="sourceLineNo">2947</span> * <li><a name="line.2947"></a>
-<span class="sourceLineNo">2948</span> * Widgets are inherited from super classes, but can be overridden by reusing the widget name.<a name="line.2948"></a>
-<span class="sourceLineNo">2949</span> * </ul><a name="line.2949"></a>
-<span class="sourceLineNo">2950</span> *<a name="line.2950"></a>
-<span class="sourceLineNo">2951</span> * <h5 class='section'>See Also:</h5><a name="line.2951"></a>
-<span class="sourceLineNo">2952</span> * <ul><a name="line.2952"></a>
-<span class="sourceLineNo">2953</span> * <li class='link'>{@doc juneau-rest-server.HtmlDocAnnotation.Widgets}<a name="line.2953"></a>
-<span class="sourceLineNo">2954</span> * </ul><a name="line.2954"></a>
-<span class="sourceLineNo">2955</span> */<a name="line.2955"></a>
-<span class="sourceLineNo">2956</span> public static final String REST_widgets = PREFIX + "widgets.lo";<a name="line.2956"></a>
+<span class="sourceLineNo">044</span>import org.apache.juneau.msgpack.*;<a name="line.44"></a>
+<span class="sourceLineNo">045</span>import org.apache.juneau.oapi.*;<a name="line.45"></a>
+<span class="sourceLineNo">046</span>import org.apache.juneau.parser.*;<a name="line.46"></a>
+<span class="sourceLineNo">047</span>import org.apache.juneau.plaintext.*;<a name="line.47"></a>
+<span class="sourceLineNo">048</span>import org.apache.juneau.remote.*;<a name="line.48"></a>
+<span class="sourceLineNo">049</span>import org.apache.juneau.rest.annotation.*;<a name="line.49"></a>
+<span class="sourceLineNo">050</span>import org.apache.juneau.rest.converters.*;<a name="line.50"></a>
+<span class="sourceLineNo">051</span>import org.apache.juneau.rest.exception.*;<a name="line.51"></a>
+<span class="sourceLineNo">052</span>import org.apache.juneau.rest.helper.*;<a name="line.52"></a>
+<span class="sourceLineNo">053</span>import org.apache.juneau.rest.reshandlers.*;<a name="line.53"></a>
+<span class="sourceLineNo">054</span>import org.apache.juneau.rest.util.*;<a name="line.54"></a>
+<span class="sourceLineNo">055</span>import org.apache.juneau.rest.vars.*;<a name="line.55"></a>
+<span class="sourceLineNo">056</span>import org.apache.juneau.rest.widget.*;<a name="line.56"></a>
+<span class="sourceLineNo">057</span>import org.apache.juneau.serializer.*;<a name="line.57"></a>
+<span class="sourceLineNo">058</span>import org.apache.juneau.soap.*;<a name="line.58"></a>
+<span class="sourceLineNo">059</span>import org.apache.juneau.svl.*;<a name="line.59"></a>
+<span class="sourceLineNo">060</span>import org.apache.juneau.uon.*;<a name="line.60"></a>
+<span class="sourceLineNo">061</span>import org.apache.juneau.urlencoding.*;<a name="line.61"></a>
+<span class="sourceLineNo">062</span>import org.apache.juneau.utils.*;<a name="line.62"></a>
+<span class="sourceLineNo">063</span>import org.apache.juneau.xml.*;<a name="line.63"></a>
+<span class="sourceLineNo">064</span>import org.apache.juneau.xmlschema.*;<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">067</span> * Contains all the configuration on a REST resource and the entry points for handling REST calls.<a name="line.67"></a>
+<span class="sourceLineNo">068</span> *<a name="line.68"></a>
+<span class="sourceLineNo">069</span> * <h5 class='section'>See Also:</h5><a name="line.69"></a>
+<span class="sourceLineNo">070</span> * <ul><a name="line.70"></a>
+<span class="sourceLineNo">071</span> * <li class='link'>{@doc juneau-rest-server.RestContext}<a name="line.71"></a>
+<span class="sourceLineNo">072</span> * </ul><a name="line.72"></a>
+<span class="sourceLineNo">073</span> */<a name="line.73"></a>
+<span class="sourceLineNo">074</span>public final class RestContext extends BeanContext {<a name="line.74"></a>
+<span class="sourceLineNo">075</span><a name="line.75"></a>
+<span class="sourceLineNo">076</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.76"></a>
+<span class="sourceLineNo">077</span> // Configurable properties<a name="line.77"></a>
+<span class="sourceLineNo">078</span> //-------------------------------------------------------------------------------------------------------------------<a name="line.78"></a>
+<span class="sourceLineNo">079</span><a name="line.79"></a>
+<span class="sourceLineNo">080</span> private static final String PREFIX = "RestContext.";<a name="line.80"></a>
+<span class="sourceLineNo">081</span><a name="line.81"></a>
+<span class="sourceLineNo">082</span> /**<a name="line.82"></a>
+<span class="sourceLineNo">083</span> * Configuration property: Allow body URL parameter.<a name="line.83"></a>
+<span class="sourceLineNo">084</span> *<a name="line.84"></a>
+<span class="sourceLineNo">085</span> * <h5 class='section'>Property:</h5><a name="line.85"></a>
+<span class="sourceLineNo">086</span> * <ul><a name="line.86"></a>
+<span class="sourceLineNo">087</span> * <li><b>Name:</b> <js>"RestContext.allowBodyParam.b"</js><a name="line.87"></a>
+<span class="sourceLineNo">088</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.88"></a>
+<span class="sourceLineNo">089</span> * <li><b>Default:</b> <jk>true</jk><a name="line.89"></a>
+<span class="sourceLineNo">090</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.90"></a>
+<span class="sourceLineNo">091</span> * <li><b>Annotations:</b><a name="line.91"></a>
+<span class="sourceLineNo">092</span> * <ul><a name="line.92"></a>
+<span class="sourceLineNo">093</span> * <li class='ja'>{@link RestResource#allowBodyParam()}<a name="line.93"></a>
+<span class="sourceLineNo">094</span> * </ul><a name="line.94"></a>
+<span class="sourceLineNo">095</span> * <li><b>Methods:</b><a name="line.95"></a>
+<span class="sourceLineNo">096</span> * <ul><a name="line.96"></a>
+<span class="sourceLineNo">097</span> * <li class='jm'>{@link RestContextBuilder#allowBodyParam(boolean)}<a name="line.97"></a>
+<span class="sourceLineNo">098</span> * </ul><a name="line.98"></a>
+<span class="sourceLineNo">099</span> * </ul><a name="line.99"></a>
+<span class="sourceLineNo">100</span> *<a name="line.100"></a>
+<span class="sourceLineNo">101</span> * <h5 class='section'>Description:</h5><a name="line.101"></a>
+<span class="sourceLineNo">102</span> * <p><a name="line.102"></a>
+<span class="sourceLineNo">103</span> * When enabled, the HTTP body content on PUT and POST requests can be passed in as text using the <js>"body"</js><a name="line.103"></a>
+<span class="sourceLineNo">104</span> * URL parameter.<a name="line.104"></a>
+<span class="sourceLineNo">105</span> * <br><a name="line.105"></a>
+<span class="sourceLineNo">106</span> * For example:<a name="line.106"></a>
+<span class="sourceLineNo">107</span> * <p class='bcode w800'><a name="line.107"></a>
+<span class="sourceLineNo">108</span> * ?body=(name='John%20Smith',age=45)<a name="line.108"></a>
+<span class="sourceLineNo">109</span> * </p><a name="line.109"></a>
+<span class="sourceLineNo">110</span> *<a name="line.110"></a>
+<span class="sourceLineNo">111</span> * <h5 class='section'>Example:</h5><a name="line.111"></a>
+<span class="sourceLineNo">112</span> * <p class='bcode w800'><a name="line.112"></a>
+<span class="sourceLineNo">113</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.113"></a>
+<span class="sourceLineNo">114</span> * <ja>@RestResource</ja>(allowBodyParam=<js>"$C{REST/allowBodyParam,false}"</js>)<a name="line.114"></a>
+<span class="sourceLineNo">115</span> * <jk>public class</jk> MyResource {<a name="line.115"></a>
+<span class="sourceLineNo">116</span> *<a name="line.116"></a>
+<span class="sourceLineNo">117</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.117"></a>
+<span class="sourceLineNo">118</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.118"></a>
+<span class="sourceLineNo">119</span> *<a name="line.119"></a>
+<span class="sourceLineNo">120</span> * <jc>// Using method on builder.</jc><a name="line.120"></a>
+<span class="sourceLineNo">121</span> * builder.allowBodyParam(<jk>false</jk>);<a name="line.121"></a>
+<span class="sourceLineNo">122</span> *<a name="line.122"></a>
+<span class="sourceLineNo">123</span> * <jc>// Same, but using property.</jc><a name="line.123"></a>
+<span class="sourceLineNo">124</span> * builder.set(<jsf>REST_allowBodyParam</jsf>, <jk>false</jk>);<a name="line.124"></a>
+<span class="sourceLineNo">125</span> * }<a name="line.125"></a>
+<span class="sourceLineNo">126</span> *<a name="line.126"></a>
+<span class="sourceLineNo">127</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.127"></a>
+<span class="sourceLineNo">128</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.128"></a>
+<span class="sourceLineNo">129</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.129"></a>
+<span class="sourceLineNo">130</span> * builder.allowBodyParam(<jk>false</jk>);<a name="line.130"></a>
+<span class="sourceLineNo">131</span> * }<a name="line.131"></a>
+<span class="sourceLineNo">132</span> * }<a name="line.132"></a>
+<span class="sourceLineNo">133</span> * </p><a name="line.133"></a>
+<span class="sourceLineNo">134</span> *<a name="line.134"></a>
+<span class="sourceLineNo">135</span> * <h5 class='section'>Notes:</h5><a name="line.135"></a>
+<span class="sourceLineNo">136</span> * <ul class='spaced-list'><a name="line.136"></a>
+<span class="sourceLineNo">137</span> * <li><a name="line.137"></a>
+<span class="sourceLineNo">138</span> * <js>'body'</js> parameter name is case-insensitive.<a name="line.138"></a>
+<span class="sourceLineNo">139</span> * <li><a name="line.139"></a>
+<span class="sourceLineNo">140</span> * Useful for debugging PUT and POST methods using only a browser.<a name="line.140"></a>
+<span class="sourceLineNo">141</span> * </ul><a name="line.141"></a>
+<span class="sourceLineNo">142</span> */<a name="line.142"></a>
+<span class="sourceLineNo">143</span> public static final String REST_allowBodyParam = PREFIX + "allowBodyParam.b";<a name="line.143"></a>
+<span class="sourceLineNo">144</span><a name="line.144"></a>
+<span class="sourceLineNo">145</span> /**<a name="line.145"></a>
+<span class="sourceLineNo">146</span> * Configuration property: Allowed method parameters.<a name="line.146"></a>
+<span class="sourceLineNo">147</span> *<a name="line.147"></a>
+<span class="sourceLineNo">148</span> * <h5 class='section'>Property:</h5><a name="line.148"></a>
+<span class="sourceLineNo">149</span> * <ul><a name="line.149"></a>
+<span class="sourceLineNo">150</span> * <li><b>Name:</b> <js>"RestContext.allowedMethodParams.s"</js><a name="line.150"></a>
+<span class="sourceLineNo">151</span> * <li><b>Data type:</b> <code>String</code><a name="line.151"></a>
+<span class="sourceLineNo">152</span> * <li><b>Default:</b> <js>"HEAD,OPTIONS"</js><a name="line.152"></a>
+<span class="sourceLineNo">153</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.153"></a>
+<span class="sourceLineNo">154</span> * <li><b>Annotations:</b><a name="line.154"></a>
+<span class="sourceLineNo">155</span> * <ul><a name="line.155"></a>
+<span class="sourceLineNo">156</span> * <li class='ja'>{@link RestResource#allowedMethodParams()}<a name="line.156"></a>
+<span class="sourceLineNo">157</span> * </ul><a name="line.157"></a>
+<span class="sourceLineNo">158</span> * <li><b>Methods:</b><a name="line.158"></a>
+<span class="sourceLineNo">159</span> * <ul><a name="line.159"></a>
+<span class="sourceLineNo">160</span> * <li class='jm'>{@link RestContextBuilder#allowedMethodParams(String...)}<a name="line.160"></a>
+<span class="sourceLineNo">161</span> * </ul><a name="line.161"></a>
+<span class="sourceLineNo">162</span> * </ul><a name="line.162"></a>
+<span class="sourceLineNo">163</span> *<a name="line.163"></a>
+<span class="sourceLineNo">164</span> * <h5 class='section'>Description:</h5><a name="line.164"></a>
+<span class="sourceLineNo">165</span> * <p><a name="line.165"></a>
+<span class="sourceLineNo">166</span> * When specified, the HTTP method can be overridden by passing in a <js>"method"</js> URL parameter on a regular<a name="line.166"></a>
+<span class="sourceLineNo">167</span> * GET request.<a name="line.167"></a>
+<span class="sourceLineNo">168</span> * <br><a name="line.168"></a>
+<span class="sourceLineNo">169</span> * For example:<a name="line.169"></a>
+<span class="sourceLineNo">170</span> * <p class='bcode w800'><a name="line.170"></a>
+<span class="sourceLineNo">171</span> * ?method=OPTIONS<a name="line.171"></a>
+<span class="sourceLineNo">172</span> * </p><a name="line.172"></a>
+<span class="sourceLineNo">173</span> *<a name="line.173"></a>
+<span class="sourceLineNo">174</span> * <h5 class='section'>Example:</h5><a name="line.174"></a>
+<span class="sourceLineNo">175</span> * <p class='bcode w800'><a name="line.175"></a>
+<span class="sourceLineNo">176</span> * <jc>// Option #1 - Defined via annotation resolving to a config file setting with default value.</jc><a name="line.176"></a>
+<span class="sourceLineNo">177</span> * <ja>@RestResource</ja>(allowMethodParams=<js>"$C{REST/allowMethodParams,HEAD\,OPTIONS\,PUT}"</js>)<a name="line.177"></a>
+<span class="sourceLineNo">178</span> * <jk>public class</jk> MyResource {<a name="line.178"></a>
+<span class="sourceLineNo">179</span> *<a name="line.179"></a>
+<span class="sourceLineNo">180</span> * <jc>// Option #2 - Defined via builder passed in through resource constructor.</jc><a name="line.180"></a>
+<span class="sourceLineNo">181</span> * <jk>public</jk> MyResource(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.181"></a>
+<span class="sourceLineNo">182</span> *<a name="line.182"></a>
+<span class="sourceLineNo">183</span> * <jc>// Using method on builder.</jc><a name="line.183"></a>
+<span class="sourceLineNo">184</span> * builder.allowMethodParams(<js>"HEAD,OPTIONS,PUT"</js>);<a name="line.184"></a>
+<span class="sourceLineNo">185</span> *<a name="line.185"></a>
+<span class="sourceLineNo">186</span> * <jc>// Same, but using property.</jc><a name="line.186"></a>
+<span class="sourceLineNo">187</span> * builder.set(<jsf>REST_allowMethodParams</jsf>, <js>"HEAD,OPTIONS,PUT"</js>);<a name="line.187"></a>
+<span class="sourceLineNo">188</span> * }<a name="line.188"></a>
+<span class="sourceLineNo">189</span> *<a name="line.189"></a>
+<span class="sourceLineNo">190</span> * <jc>// Option #3 - Defined via builder passed in through init method.</jc><a name="line.190"></a>
+<span class="sourceLineNo">191</span> * <ja>@RestHook</ja>(<jsf>INIT</jsf>)<a name="line.191"></a>
+<span class="sourceLineNo">192</span> * <jk>public void</jk> init(RestContextBuilder builder) <jk>throws</jk> Exception {<a name="line.192"></a>
+<span class="sourceLineNo">193</span> * builder.allowMethodParams(<js>"HEAD"</js>, <js>"OPTIONS"</js>, <js>"PUT"</js>);<a name="line.193"></a>
+<span class="sourceLineNo">194</span> * }<a name="line.194"></a>
+<span class="sourceLineNo">195</span> * }<a name="line.195"></a>
+<span class="sourceLineNo">196</span> * </p><a name="line.196"></a>
+<span class="sourceLineNo">197</span> *<a name="line.197"></a>
+<span class="sourceLineNo">198</span> * <h5 class='section'>Notes:</h5><a name="line.198"></a>
+<span class="sourceLineNo">199</span> * <ul class='spaced-list'><a name="line.199"></a>
+<span class="sourceLineNo">200</span> * <li><a name="line.200"></a>
+<span class="sourceLineNo">201</span> * Format is a comma-delimited list of HTTP method names that can be passed in as a method parameter.<a name="line.201"></a>
+<span class="sourceLineNo">202</span> * <li><a name="line.202"></a>
+<span class="sourceLineNo">203</span> * <js>'method'</js> parameter name is case-insensitive.<a name="line.203"></a>
+<span class="sourceLineNo">204</span> * <li><a name="line.204"></a>
+<span class="sourceLineNo">205</span> * Use <js>"*"</js> to represent all methods.<a name="line.205"></a>
+<span class="sourceLineNo">206</span> * </ul><a name="line.206"></a>
+<span class="sourceLineNo">207</span> *<a name="line.207"></a>
+<span class="sourceLineNo">208</span> * <p><a name="line.208"></a>
+<span class="sourceLineNo">209</span> * Note that per the {@doc RFC2616.section9 HTTP specification}, special care should<a name="line.209"></a>
+<span class="sourceLineNo">210</span> * be taken when allowing non-safe (POST, PUT, DELETE) methods to be invoked through GET requests.<a name="line.210"></a>
+<span class="sourceLineNo">211</span> */<a name="line.211"></a>
+<span class="sourceLineNo">212</span> public static final String REST_allowedMethodParams = PREFIX + "allowedMethodParams.s";<a name="line.212"></a>
+<span class="sourceLineNo">213</span><a name="line.213"></a>
+<span class="sourceLineNo">214</span> /**<a name="line.214"></a>
+<span class="sourceLineNo">215</span> * Configuration property: Allow header URL parameters.<a name="line.215"></a>
+<span class="sourceLineNo">216</span> *<a name="line.216"></a>
+<span class="sourceLineNo">217</span> * <h5 class='section'>Property:</h5><a name="line.217"></a>
+<span class="sourceLineNo">218</span> * <ul><a name="line.218"></a>
+<span class="sourceLineNo">219</span> * <li><b>Name:</b> <js>"RestContext.allowHeaderParams.b"</js><a name="line.219"></a>
+<span class="sourceLineNo">220</span> * <li><b>Data type:</b> <code>Boolean</code><a name="line.220"></a>
+<span class="sourceLineNo">221</span> * <li><b>Default:</b> <jk>true</jk><a name="line.221"></a>
+<span class="sourceLineNo">222</span> * <li><b>Session property:</b> <jk>false</jk><a name="line.222"></a>
+<span class="sourceLineNo">223</span> * <li><b>Annotations:</b><a name="line.223"></a>
+<span class="sourceLineNo">224</span> * <ul><a name="line.224"></a>
+<span class="sourceLineNo">225</span> * <li class='ja'>{@link RestResource#allowHeaderParams()}<a name="line.225"></a>
+<span class="sourceLineNo">226</span> * </ul><a name="line.226"></a>
+<span class="sourceLineNo">227</span> * <li><b>Methods:</b><a name="line.227"></a>
+<span class="sourceLineNo">228</span> * <ul><a name="line.228"></a>
+<span class="sourceLineNo">229</span> * <li class='jm'>{@link RestContextBuilder#allowHeaderParams(boolean)}<a name="line.229"></a>
+<span class="sourceLineNo">230</span> * </ul><a name="line.230"></a>
+<span class="sourceLineNo">231</span> * </ul><a name="line.231"></a>
+<span class="sourceLineNo">232</span> *<a name="line.232"></a>
+<span class="sourceLineNo">233</span> * <h5 class='section'>Description:</h5><a name="line.233"></a>
+<span class="sourceLineNo">234</span> * <p><a name="line.234"></a>
+<span class="sourceLineNo">235</span> * When enabled, headers such as <js>"Accept"</js> and <js>"Content-Type"</js> to be passed in as URL query<a name="line.235"></a>
+<span class="sourceLineNo">236</span> * parameters.<a name="line.236"></a>
+<span class="sourceLineNo">237</span> * <br><a name="line.237"></a>
+<span class="sourceLineNo">238</span> * For example:<a name="line.238"></a>
+<span class="sourceLineNo">239</span> * <p class='bcode w800'><a name="line.239"></a>
+<span class="sourceLineNo">240</span> * ?Accept=text/json&amp;Content-Type=text/json<a name="line.240"></a>
+<span class="sourceLineNo">241</span> * </p><a name="line.241"></a>
+<span class="sourceLineNo">242</span> *<a name="line.242"></a>
... 20158 lines suppressed ...