juneau-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jamesbog...@apache.org
Subject [4/8] incubator-juneau-website git commit: Update javadocs.
Date Wed, 12 Jul 2017 13:20:02 GMT
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/5c69dfed/content/site/apidocs/src-html/org/apache/juneau/rest/RestContext.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/rest/RestContext.html b/content/site/apidocs/src-html/org/apache/juneau/rest/RestContext.html
index a797cc7..f68e4ab 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/rest/RestContext.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/rest/RestContext.html
@@ -472,1294 +472,1297 @@
 <span class="sourceLineNo">464</span>               r = p.second();<a name="line.464"></a>
 <span class="sourceLineNo">465</span>            } else if (o instanceof Class&lt;?&gt;) {<a name="line.465"></a>
 <span class="sourceLineNo">466</span>               Class&lt;?&gt; c = (Class&lt;?&gt;)o;<a name="line.466"></a>
-<span class="sourceLineNo">467</span>               r = c;<a name="line.467"></a>
-<span class="sourceLineNo">468</span>            } else {<a name="line.468"></a>
-<span class="sourceLineNo">469</span>               r = o;<a name="line.469"></a>
-<span class="sourceLineNo">470</span>            }<a name="line.470"></a>
-<span class="sourceLineNo">471</span><a name="line.471"></a>
-<span class="sourceLineNo">472</span>            RestConfig childConfig = null;<a name="line.472"></a>
-<span class="sourceLineNo">473</span><a name="line.473"></a>
-<span class="sourceLineNo">474</span>            if (o instanceof Class) {<a name="line.474"></a>
-<span class="sourceLineNo">475</span>               Class&lt;?&gt; oc = (Class&lt;?&gt;)o;<a name="line.475"></a>
-<span class="sourceLineNo">476</span>               childConfig = new RestConfig(config.inner, oc, this);<a name="line.476"></a>
-<span class="sourceLineNo">477</span>               r = rrr.resolve(oc, childConfig);<a name="line.477"></a>
-<span class="sourceLineNo">478</span>            } else {<a name="line.478"></a>
-<span class="sourceLineNo">479</span>               r = o;<a name="line.479"></a>
-<span class="sourceLineNo">480</span>               childConfig = new RestConfig(config.inner, o.getClass(), this);<a name="line.480"></a>
-<span class="sourceLineNo">481</span>            }<a name="line.481"></a>
-<span class="sourceLineNo">482</span><a name="line.482"></a>
-<span class="sourceLineNo">483</span>            if (r instanceof RestServlet) {<a name="line.483"></a>
-<span class="sourceLineNo">484</span>               RestServlet rs = (RestServlet)r;<a name="line.484"></a>
-<span class="sourceLineNo">485</span>               rs.init(childConfig);<a name="line.485"></a>
-<span class="sourceLineNo">486</span>               if (rs.getContext() == null)<a name="line.486"></a>
-<span class="sourceLineNo">487</span>                  throw new RestException(SC_INTERNAL_SERVER_ERROR, "Servlet {0} not initialized.  init(RestConfig) was not called.  This can occur if you've overridden this method but didn't call super.init(RestConfig).", rs.getClass().getName());<a name="line.487"></a>
-<span class="sourceLineNo">488</span>               path = childConfig.path;<a name="line.488"></a>
-<span class="sourceLineNo">489</span>               childResources.put(path, rs.getContext());<a name="line.489"></a>
-<span class="sourceLineNo">490</span>            } else {<a name="line.490"></a>
-<span class="sourceLineNo">491</span><a name="line.491"></a>
-<span class="sourceLineNo">492</span>               // Call the init(RestConfig) method.<a name="line.492"></a>
-<span class="sourceLineNo">493</span>               java.lang.reflect.Method m2 = findPublicMethod(r.getClass(), "init", Void.class, RestConfig.class);<a name="line.493"></a>
-<span class="sourceLineNo">494</span>               if (m2 != null)<a name="line.494"></a>
-<span class="sourceLineNo">495</span>                  m2.invoke(r, childConfig);<a name="line.495"></a>
-<span class="sourceLineNo">496</span><a name="line.496"></a>
-<span class="sourceLineNo">497</span>               RestContext rc2 = new RestContext(r, childConfig);<a name="line.497"></a>
-<span class="sourceLineNo">498</span><a name="line.498"></a>
-<span class="sourceLineNo">499</span>               // Call the init(RestContext) method.<a name="line.499"></a>
-<span class="sourceLineNo">500</span>               m2 = findPublicMethod(r.getClass(), "init", Void.class, RestContext.class);<a name="line.500"></a>
-<span class="sourceLineNo">501</span>               if (m2 != null)<a name="line.501"></a>
-<span class="sourceLineNo">502</span>                  m2.invoke(r, rc2);<a name="line.502"></a>
-<span class="sourceLineNo">503</span><a name="line.503"></a>
-<span class="sourceLineNo">504</span>               path = childConfig.path;<a name="line.504"></a>
-<span class="sourceLineNo">505</span>               childResources.put(path, rc2);<a name="line.505"></a>
-<span class="sourceLineNo">506</span>            }<a name="line.506"></a>
-<span class="sourceLineNo">507</span>         }<a name="line.507"></a>
-<span class="sourceLineNo">508</span><a name="line.508"></a>
-<span class="sourceLineNo">509</span>         callHandler = config.callHandler == null ? new RestCallHandler(this) : resolve(RestCallHandler.class, config.callHandler, this);<a name="line.509"></a>
-<span class="sourceLineNo">510</span>         infoProvider = config.infoProvider == null ? new RestInfoProvider(this) : resolve(RestInfoProvider.class, config.infoProvider, this);<a name="line.510"></a>
+<span class="sourceLineNo">467</span>               // Don't allow specifying yourself as a child.  Causes an infinite loop.<a name="line.467"></a>
+<span class="sourceLineNo">468</span>               if (c == config.resourceClass)<a name="line.468"></a>
+<span class="sourceLineNo">469</span>                  continue;<a name="line.469"></a>
+<span class="sourceLineNo">470</span>               r = c;<a name="line.470"></a>
+<span class="sourceLineNo">471</span>            } else {<a name="line.471"></a>
+<span class="sourceLineNo">472</span>               r = o;<a name="line.472"></a>
+<span class="sourceLineNo">473</span>            }<a name="line.473"></a>
+<span class="sourceLineNo">474</span><a name="line.474"></a>
+<span class="sourceLineNo">475</span>            RestConfig childConfig = null;<a name="line.475"></a>
+<span class="sourceLineNo">476</span><a name="line.476"></a>
+<span class="sourceLineNo">477</span>            if (o instanceof Class) {<a name="line.477"></a>
+<span class="sourceLineNo">478</span>               Class&lt;?&gt; oc = (Class&lt;?&gt;)o;<a name="line.478"></a>
+<span class="sourceLineNo">479</span>               childConfig = new RestConfig(config.inner, oc, this);<a name="line.479"></a>
+<span class="sourceLineNo">480</span>               r = rrr.resolve(oc, childConfig);<a name="line.480"></a>
+<span class="sourceLineNo">481</span>            } else {<a name="line.481"></a>
+<span class="sourceLineNo">482</span>               r = o;<a name="line.482"></a>
+<span class="sourceLineNo">483</span>               childConfig = new RestConfig(config.inner, o.getClass(), this);<a name="line.483"></a>
+<span class="sourceLineNo">484</span>            }<a name="line.484"></a>
+<span class="sourceLineNo">485</span><a name="line.485"></a>
+<span class="sourceLineNo">486</span>            if (r instanceof RestServlet) {<a name="line.486"></a>
+<span class="sourceLineNo">487</span>               RestServlet rs = (RestServlet)r;<a name="line.487"></a>
+<span class="sourceLineNo">488</span>               rs.init(childConfig);<a name="line.488"></a>
+<span class="sourceLineNo">489</span>               if (rs.getContext() == null)<a name="line.489"></a>
+<span class="sourceLineNo">490</span>                  throw new RestException(SC_INTERNAL_SERVER_ERROR, "Servlet {0} not initialized.  init(RestConfig) was not called.  This can occur if you've overridden this method but didn't call super.init(RestConfig).", rs.getClass().getName());<a name="line.490"></a>
+<span class="sourceLineNo">491</span>               path = childConfig.path;<a name="line.491"></a>
+<span class="sourceLineNo">492</span>               childResources.put(path, rs.getContext());<a name="line.492"></a>
+<span class="sourceLineNo">493</span>            } else {<a name="line.493"></a>
+<span class="sourceLineNo">494</span><a name="line.494"></a>
+<span class="sourceLineNo">495</span>               // Call the init(RestConfig) method.<a name="line.495"></a>
+<span class="sourceLineNo">496</span>               java.lang.reflect.Method m2 = findPublicMethod(r.getClass(), "init", Void.class, RestConfig.class);<a name="line.496"></a>
+<span class="sourceLineNo">497</span>               if (m2 != null)<a name="line.497"></a>
+<span class="sourceLineNo">498</span>                  m2.invoke(r, childConfig);<a name="line.498"></a>
+<span class="sourceLineNo">499</span><a name="line.499"></a>
+<span class="sourceLineNo">500</span>               RestContext rc2 = new RestContext(r, childConfig);<a name="line.500"></a>
+<span class="sourceLineNo">501</span><a name="line.501"></a>
+<span class="sourceLineNo">502</span>               // Call the init(RestContext) method.<a name="line.502"></a>
+<span class="sourceLineNo">503</span>               m2 = findPublicMethod(r.getClass(), "init", Void.class, RestContext.class);<a name="line.503"></a>
+<span class="sourceLineNo">504</span>               if (m2 != null)<a name="line.504"></a>
+<span class="sourceLineNo">505</span>                  m2.invoke(r, rc2);<a name="line.505"></a>
+<span class="sourceLineNo">506</span><a name="line.506"></a>
+<span class="sourceLineNo">507</span>               path = childConfig.path;<a name="line.507"></a>
+<span class="sourceLineNo">508</span>               childResources.put(path, rc2);<a name="line.508"></a>
+<span class="sourceLineNo">509</span>            }<a name="line.509"></a>
+<span class="sourceLineNo">510</span>         }<a name="line.510"></a>
 <span class="sourceLineNo">511</span><a name="line.511"></a>
-<span class="sourceLineNo">512</span>      } catch (RestException e) {<a name="line.512"></a>
-<span class="sourceLineNo">513</span>         _initException = e;<a name="line.513"></a>
-<span class="sourceLineNo">514</span>         throw e;<a name="line.514"></a>
-<span class="sourceLineNo">515</span>      } catch (Exception e) {<a name="line.515"></a>
-<span class="sourceLineNo">516</span>         _initException = new RestException(SC_INTERNAL_SERVER_ERROR, e);<a name="line.516"></a>
+<span class="sourceLineNo">512</span>         callHandler = config.callHandler == null ? new RestCallHandler(this) : resolve(RestCallHandler.class, config.callHandler, this);<a name="line.512"></a>
+<span class="sourceLineNo">513</span>         infoProvider = config.infoProvider == null ? new RestInfoProvider(this) : resolve(RestInfoProvider.class, config.infoProvider, this);<a name="line.513"></a>
+<span class="sourceLineNo">514</span><a name="line.514"></a>
+<span class="sourceLineNo">515</span>      } catch (RestException e) {<a name="line.515"></a>
+<span class="sourceLineNo">516</span>         _initException = e;<a name="line.516"></a>
 <span class="sourceLineNo">517</span>         throw e;<a name="line.517"></a>
-<span class="sourceLineNo">518</span>      } finally {<a name="line.518"></a>
-<span class="sourceLineNo">519</span>         initException = _initException;<a name="line.519"></a>
-<span class="sourceLineNo">520</span>      }<a name="line.520"></a>
-<span class="sourceLineNo">521</span>   }<a name="line.521"></a>
-<span class="sourceLineNo">522</span><a name="line.522"></a>
-<span class="sourceLineNo">523</span>   private static void addToRouter(Map&lt;String, CallRouter.Builder&gt; routers, String httpMethodName, CallMethod cm) throws RestServletException {<a name="line.523"></a>
-<span class="sourceLineNo">524</span>      if (! routers.containsKey(httpMethodName))<a name="line.524"></a>
-<span class="sourceLineNo">525</span>         routers.put(httpMethodName, new CallRouter.Builder(httpMethodName));<a name="line.525"></a>
-<span class="sourceLineNo">526</span>      routers.get(httpMethodName).add(cm);<a name="line.526"></a>
-<span class="sourceLineNo">527</span>   }<a name="line.527"></a>
-<span class="sourceLineNo">528</span><a name="line.528"></a>
-<span class="sourceLineNo">529</span>   private static class Builder {<a name="line.529"></a>
-<span class="sourceLineNo">530</span><a name="line.530"></a>
-<span class="sourceLineNo">531</span>      boolean allowHeaderParams, allowBodyParam, renderResponseStackTraces, useStackTraceHashes;<a name="line.531"></a>
-<span class="sourceLineNo">532</span>      VarResolver varResolver;<a name="line.532"></a>
-<span class="sourceLineNo">533</span>      ConfigFile configFile;<a name="line.533"></a>
-<span class="sourceLineNo">534</span>      ObjectMap properties;<a name="line.534"></a>
-<span class="sourceLineNo">535</span>      Class&lt;?&gt;[] beanFilters;<a name="line.535"></a>
-<span class="sourceLineNo">536</span>      Class&lt;?&gt;[] pojoSwaps;<a name="line.536"></a>
-<span class="sourceLineNo">537</span>      Map&lt;Class&lt;?&gt;,RestParam&gt; paramResolvers = new HashMap&lt;Class&lt;?&gt;,RestParam&gt;();<a name="line.537"></a>
-<span class="sourceLineNo">538</span>      SerializerGroup serializers;<a name="line.538"></a>
-<span class="sourceLineNo">539</span>      ParserGroup parsers;<a name="line.539"></a>
-<span class="sourceLineNo">540</span>      UrlEncodingSerializer urlEncodingSerializer;<a name="line.540"></a>
-<span class="sourceLineNo">541</span>      UrlEncodingParser urlEncodingParser;<a name="line.541"></a>
-<span class="sourceLineNo">542</span>      EncoderGroup encoders;<a name="line.542"></a>
-<span class="sourceLineNo">543</span>      String clientVersionHeader = "", defaultCharset, paramFormat, htmlHeader, htmlNav, htmlAside, htmlStyle,<a name="line.543"></a>
-<span class="sourceLineNo">544</span>            htmlStylesheet, htmlScript, htmlFooter, htmlNoResultsMessage;<a name="line.544"></a>
-<span class="sourceLineNo">545</span>      String[] htmlLinks;<a name="line.545"></a>
-<span class="sourceLineNo">546</span>      boolean htmlNoWrap;<a name="line.546"></a>
-<span class="sourceLineNo">547</span>      HtmlDocTemplate htmlTemplate;<a name="line.547"></a>
-<span class="sourceLineNo">548</span><a name="line.548"></a>
-<span class="sourceLineNo">549</span>      List&lt;MediaType&gt; supportedContentTypes, supportedAcceptTypes;<a name="line.549"></a>
-<span class="sourceLineNo">550</span>      Map&lt;String,String&gt; defaultRequestHeaders = new TreeMap&lt;String,String&gt;(String.CASE_INSENSITIVE_ORDER);<a name="line.550"></a>
-<span class="sourceLineNo">551</span>      Map&lt;String,Object&gt; defaultResponseHeaders;<a name="line.551"></a>
-<span class="sourceLineNo">552</span>      BeanContext beanContext;<a name="line.552"></a>
-<span class="sourceLineNo">553</span>      List&lt;RestConverter&gt; converters = new ArrayList&lt;RestConverter&gt;();<a name="line.553"></a>
-<span class="sourceLineNo">554</span>      List&lt;RestGuard&gt; guards = new ArrayList&lt;RestGuard&gt;();<a name="line.554"></a>
-<span class="sourceLineNo">555</span>      List&lt;ResponseHandler&gt; responseHandlers = new ArrayList&lt;ResponseHandler&gt;();<a name="line.555"></a>
-<span class="sourceLineNo">556</span>      MimetypesFileTypeMap mimetypesFileTypeMap;<a name="line.556"></a>
-<span class="sourceLineNo">557</span>      StreamResource favIcon;<a name="line.557"></a>
-<span class="sourceLineNo">558</span>      Map&lt;String,String&gt; staticFilesMap;<a name="line.558"></a>
-<span class="sourceLineNo">559</span>      String[] staticFilesPrefixes;<a name="line.559"></a>
-<span class="sourceLineNo">560</span>      MessageBundle messageBundle;<a name="line.560"></a>
-<span class="sourceLineNo">561</span>      Set&lt;String&gt; allowMethodParams = new LinkedHashSet&lt;String&gt;();<a name="line.561"></a>
-<span class="sourceLineNo">562</span>      RestLogger logger;<a name="line.562"></a>
-<span class="sourceLineNo">563</span>      String fullPath;<a name="line.563"></a>
-<span class="sourceLineNo">564</span>      Map&lt;String,Widget&gt; htmlWidgets;<a name="line.564"></a>
-<span class="sourceLineNo">565</span><a name="line.565"></a>
-<span class="sourceLineNo">566</span>      @SuppressWarnings("unchecked")<a name="line.566"></a>
-<span class="sourceLineNo">567</span>      private Builder(Object resource, RestConfig sc) throws Exception {<a name="line.567"></a>
+<span class="sourceLineNo">518</span>      } catch (Exception e) {<a name="line.518"></a>
+<span class="sourceLineNo">519</span>         _initException = new RestException(SC_INTERNAL_SERVER_ERROR, e);<a name="line.519"></a>
+<span class="sourceLineNo">520</span>         throw e;<a name="line.520"></a>
+<span class="sourceLineNo">521</span>      } finally {<a name="line.521"></a>
+<span class="sourceLineNo">522</span>         initException = _initException;<a name="line.522"></a>
+<span class="sourceLineNo">523</span>      }<a name="line.523"></a>
+<span class="sourceLineNo">524</span>   }<a name="line.524"></a>
+<span class="sourceLineNo">525</span><a name="line.525"></a>
+<span class="sourceLineNo">526</span>   private static void addToRouter(Map&lt;String, CallRouter.Builder&gt; routers, String httpMethodName, CallMethod cm) throws RestServletException {<a name="line.526"></a>
+<span class="sourceLineNo">527</span>      if (! routers.containsKey(httpMethodName))<a name="line.527"></a>
+<span class="sourceLineNo">528</span>         routers.put(httpMethodName, new CallRouter.Builder(httpMethodName));<a name="line.528"></a>
+<span class="sourceLineNo">529</span>      routers.get(httpMethodName).add(cm);<a name="line.529"></a>
+<span class="sourceLineNo">530</span>   }<a name="line.530"></a>
+<span class="sourceLineNo">531</span><a name="line.531"></a>
+<span class="sourceLineNo">532</span>   private static class Builder {<a name="line.532"></a>
+<span class="sourceLineNo">533</span><a name="line.533"></a>
+<span class="sourceLineNo">534</span>      boolean allowHeaderParams, allowBodyParam, renderResponseStackTraces, useStackTraceHashes;<a name="line.534"></a>
+<span class="sourceLineNo">535</span>      VarResolver varResolver;<a name="line.535"></a>
+<span class="sourceLineNo">536</span>      ConfigFile configFile;<a name="line.536"></a>
+<span class="sourceLineNo">537</span>      ObjectMap properties;<a name="line.537"></a>
+<span class="sourceLineNo">538</span>      Class&lt;?&gt;[] beanFilters;<a name="line.538"></a>
+<span class="sourceLineNo">539</span>      Class&lt;?&gt;[] pojoSwaps;<a name="line.539"></a>
+<span class="sourceLineNo">540</span>      Map&lt;Class&lt;?&gt;,RestParam&gt; paramResolvers = new HashMap&lt;Class&lt;?&gt;,RestParam&gt;();<a name="line.540"></a>
+<span class="sourceLineNo">541</span>      SerializerGroup serializers;<a name="line.541"></a>
+<span class="sourceLineNo">542</span>      ParserGroup parsers;<a name="line.542"></a>
+<span class="sourceLineNo">543</span>      UrlEncodingSerializer urlEncodingSerializer;<a name="line.543"></a>
+<span class="sourceLineNo">544</span>      UrlEncodingParser urlEncodingParser;<a name="line.544"></a>
+<span class="sourceLineNo">545</span>      EncoderGroup encoders;<a name="line.545"></a>
+<span class="sourceLineNo">546</span>      String clientVersionHeader = "", defaultCharset, paramFormat, htmlHeader, htmlNav, htmlAside, htmlStyle,<a name="line.546"></a>
+<span class="sourceLineNo">547</span>            htmlStylesheet, htmlScript, htmlFooter, htmlNoResultsMessage;<a name="line.547"></a>
+<span class="sourceLineNo">548</span>      String[] htmlLinks;<a name="line.548"></a>
+<span class="sourceLineNo">549</span>      boolean htmlNoWrap;<a name="line.549"></a>
+<span class="sourceLineNo">550</span>      HtmlDocTemplate htmlTemplate;<a name="line.550"></a>
+<span class="sourceLineNo">551</span><a name="line.551"></a>
+<span class="sourceLineNo">552</span>      List&lt;MediaType&gt; supportedContentTypes, supportedAcceptTypes;<a name="line.552"></a>
+<span class="sourceLineNo">553</span>      Map&lt;String,String&gt; defaultRequestHeaders = new TreeMap&lt;String,String&gt;(String.CASE_INSENSITIVE_ORDER);<a name="line.553"></a>
+<span class="sourceLineNo">554</span>      Map&lt;String,Object&gt; defaultResponseHeaders;<a name="line.554"></a>
+<span class="sourceLineNo">555</span>      BeanContext beanContext;<a name="line.555"></a>
+<span class="sourceLineNo">556</span>      List&lt;RestConverter&gt; converters = new ArrayList&lt;RestConverter&gt;();<a name="line.556"></a>
+<span class="sourceLineNo">557</span>      List&lt;RestGuard&gt; guards = new ArrayList&lt;RestGuard&gt;();<a name="line.557"></a>
+<span class="sourceLineNo">558</span>      List&lt;ResponseHandler&gt; responseHandlers = new ArrayList&lt;ResponseHandler&gt;();<a name="line.558"></a>
+<span class="sourceLineNo">559</span>      MimetypesFileTypeMap mimetypesFileTypeMap;<a name="line.559"></a>
+<span class="sourceLineNo">560</span>      StreamResource favIcon;<a name="line.560"></a>
+<span class="sourceLineNo">561</span>      Map&lt;String,String&gt; staticFilesMap;<a name="line.561"></a>
+<span class="sourceLineNo">562</span>      String[] staticFilesPrefixes;<a name="line.562"></a>
+<span class="sourceLineNo">563</span>      MessageBundle messageBundle;<a name="line.563"></a>
+<span class="sourceLineNo">564</span>      Set&lt;String&gt; allowMethodParams = new LinkedHashSet&lt;String&gt;();<a name="line.564"></a>
+<span class="sourceLineNo">565</span>      RestLogger logger;<a name="line.565"></a>
+<span class="sourceLineNo">566</span>      String fullPath;<a name="line.566"></a>
+<span class="sourceLineNo">567</span>      Map&lt;String,Widget&gt; htmlWidgets;<a name="line.567"></a>
 <span class="sourceLineNo">568</span><a name="line.568"></a>
-<span class="sourceLineNo">569</span>         PropertyStore ps = sc.createPropertyStore();<a name="line.569"></a>
-<span class="sourceLineNo">570</span><a name="line.570"></a>
-<span class="sourceLineNo">571</span>         LinkedHashMap&lt;Class&lt;?&gt;,RestResource&gt; restResourceAnnotationsChildFirst = findAnnotationsMap(RestResource.class, resource.getClass());<a name="line.571"></a>
-<span class="sourceLineNo">572</span><a name="line.572"></a>
-<span class="sourceLineNo">573</span>         allowHeaderParams = ps.getProperty(REST_allowHeaderParams, boolean.class, true);<a name="line.573"></a>
-<span class="sourceLineNo">574</span>         allowBodyParam = ps.getProperty(REST_allowBodyParam, boolean.class, true);<a name="line.574"></a>
-<span class="sourceLineNo">575</span>         renderResponseStackTraces = ps.getProperty(REST_renderResponseStackTraces, boolean.class, false);<a name="line.575"></a>
-<span class="sourceLineNo">576</span>         useStackTraceHashes = ps.getProperty(REST_useStackTraceHashes, boolean.class, true);<a name="line.576"></a>
-<span class="sourceLineNo">577</span>         defaultCharset = ps.getProperty(REST_defaultCharset, String.class, "utf-8");<a name="line.577"></a>
-<span class="sourceLineNo">578</span>         paramFormat = ps.getProperty(REST_paramFormat, String.class, "");<a name="line.578"></a>
-<span class="sourceLineNo">579</span><a name="line.579"></a>
-<span class="sourceLineNo">580</span>         for (String m : split(ps.getProperty(REST_allowMethodParam, String.class, "")))<a name="line.580"></a>
-<span class="sourceLineNo">581</span>            if (m.equals("true"))  // For backwards compatibility when this was a boolean field.<a name="line.581"></a>
-<span class="sourceLineNo">582</span>               allowMethodParams.add("*");<a name="line.582"></a>
-<span class="sourceLineNo">583</span>            else<a name="line.583"></a>
-<span class="sourceLineNo">584</span>               allowMethodParams.add(m.toUpperCase());<a name="line.584"></a>
-<span class="sourceLineNo">585</span><a name="line.585"></a>
-<span class="sourceLineNo">586</span>         varResolver = sc.varResolverBuilder<a name="line.586"></a>
-<span class="sourceLineNo">587</span>            .vars(FileVar.class, LocalizationVar.class, RequestVar.class, SerializedRequestAttrVar.class, ServletInitParamVar.class, UrlVar.class, UrlEncodeVar.class, WidgetVar.class)<a name="line.587"></a>
-<span class="sourceLineNo">588</span>            .build()<a name="line.588"></a>
-<span class="sourceLineNo">589</span>         ;<a name="line.589"></a>
-<span class="sourceLineNo">590</span>         configFile = sc.configFile.getResolving(this.varResolver);<a name="line.590"></a>
-<span class="sourceLineNo">591</span>         properties = sc.properties;<a name="line.591"></a>
-<span class="sourceLineNo">592</span>         Collections.reverse(sc.beanFilters);<a name="line.592"></a>
-<span class="sourceLineNo">593</span>         Collections.reverse(sc.pojoSwaps);<a name="line.593"></a>
-<span class="sourceLineNo">594</span>         beanFilters = toObjectArray(sc.beanFilters, Class.class);<a name="line.594"></a>
-<span class="sourceLineNo">595</span>         pojoSwaps = toObjectArray(sc.pojoSwaps, Class.class);<a name="line.595"></a>
-<span class="sourceLineNo">596</span><a name="line.596"></a>
-<span class="sourceLineNo">597</span>         for (Class&lt;?&gt; c : sc.paramResolvers) {<a name="line.597"></a>
-<span class="sourceLineNo">598</span>            RestParam rp = newInstance(RestParam.class, c);<a name="line.598"></a>
-<span class="sourceLineNo">599</span>            paramResolvers.put(rp.forClass(), rp);<a name="line.599"></a>
-<span class="sourceLineNo">600</span>         }<a name="line.600"></a>
-<span class="sourceLineNo">601</span><a name="line.601"></a>
-<span class="sourceLineNo">602</span>         clientVersionHeader = sc.clientVersionHeader;<a name="line.602"></a>
-<span class="sourceLineNo">603</span><a name="line.603"></a>
-<span class="sourceLineNo">604</span>         // Find resource resource bundle location.<a name="line.604"></a>
-<span class="sourceLineNo">605</span>         for (Map.Entry&lt;Class&lt;?&gt;,RestResource&gt; e : restResourceAnnotationsChildFirst.entrySet()) {<a name="line.605"></a>
-<span class="sourceLineNo">606</span>            Class&lt;?&gt; c = e.getKey();<a name="line.606"></a>
-<span class="sourceLineNo">607</span>            RestResource r = e.getValue();<a name="line.607"></a>
-<span class="sourceLineNo">608</span>            if (! r.messages().isEmpty()) {<a name="line.608"></a>
-<span class="sourceLineNo">609</span>               if (messageBundle == null)<a name="line.609"></a>
-<span class="sourceLineNo">610</span>                  messageBundle = new MessageBundle(c, r.messages());<a name="line.610"></a>
-<span class="sourceLineNo">611</span>               else<a name="line.611"></a>
-<span class="sourceLineNo">612</span>                  messageBundle.addSearchPath(c, r.messages());<a name="line.612"></a>
-<span class="sourceLineNo">613</span>            }<a name="line.613"></a>
-<span class="sourceLineNo">614</span>         }<a name="line.614"></a>
-<span class="sourceLineNo">615</span><a name="line.615"></a>
-<span class="sourceLineNo">616</span>         if (messageBundle == null)<a name="line.616"></a>
-<span class="sourceLineNo">617</span>            messageBundle = new MessageBundle(resource.getClass(), "");<a name="line.617"></a>
+<span class="sourceLineNo">569</span>      @SuppressWarnings("unchecked")<a name="line.569"></a>
+<span class="sourceLineNo">570</span>      private Builder(Object resource, RestConfig sc) throws Exception {<a name="line.570"></a>
+<span class="sourceLineNo">571</span><a name="line.571"></a>
+<span class="sourceLineNo">572</span>         PropertyStore ps = sc.createPropertyStore();<a name="line.572"></a>
+<span class="sourceLineNo">573</span><a name="line.573"></a>
+<span class="sourceLineNo">574</span>         LinkedHashMap&lt;Class&lt;?&gt;,RestResource&gt; restResourceAnnotationsChildFirst = findAnnotationsMap(RestResource.class, resource.getClass());<a name="line.574"></a>
+<span class="sourceLineNo">575</span><a name="line.575"></a>
+<span class="sourceLineNo">576</span>         allowHeaderParams = ps.getProperty(REST_allowHeaderParams, boolean.class, true);<a name="line.576"></a>
+<span class="sourceLineNo">577</span>         allowBodyParam = ps.getProperty(REST_allowBodyParam, boolean.class, true);<a name="line.577"></a>
+<span class="sourceLineNo">578</span>         renderResponseStackTraces = ps.getProperty(REST_renderResponseStackTraces, boolean.class, false);<a name="line.578"></a>
+<span class="sourceLineNo">579</span>         useStackTraceHashes = ps.getProperty(REST_useStackTraceHashes, boolean.class, true);<a name="line.579"></a>
+<span class="sourceLineNo">580</span>         defaultCharset = ps.getProperty(REST_defaultCharset, String.class, "utf-8");<a name="line.580"></a>
+<span class="sourceLineNo">581</span>         paramFormat = ps.getProperty(REST_paramFormat, String.class, "");<a name="line.581"></a>
+<span class="sourceLineNo">582</span><a name="line.582"></a>
+<span class="sourceLineNo">583</span>         for (String m : split(ps.getProperty(REST_allowMethodParam, String.class, "")))<a name="line.583"></a>
+<span class="sourceLineNo">584</span>            if (m.equals("true"))  // For backwards compatibility when this was a boolean field.<a name="line.584"></a>
+<span class="sourceLineNo">585</span>               allowMethodParams.add("*");<a name="line.585"></a>
+<span class="sourceLineNo">586</span>            else<a name="line.586"></a>
+<span class="sourceLineNo">587</span>               allowMethodParams.add(m.toUpperCase());<a name="line.587"></a>
+<span class="sourceLineNo">588</span><a name="line.588"></a>
+<span class="sourceLineNo">589</span>         varResolver = sc.varResolverBuilder<a name="line.589"></a>
+<span class="sourceLineNo">590</span>            .vars(FileVar.class, LocalizationVar.class, RequestVar.class, SerializedRequestAttrVar.class, ServletInitParamVar.class, UrlVar.class, UrlEncodeVar.class, WidgetVar.class)<a name="line.590"></a>
+<span class="sourceLineNo">591</span>            .build()<a name="line.591"></a>
+<span class="sourceLineNo">592</span>         ;<a name="line.592"></a>
+<span class="sourceLineNo">593</span>         configFile = sc.configFile.getResolving(this.varResolver);<a name="line.593"></a>
+<span class="sourceLineNo">594</span>         properties = sc.properties;<a name="line.594"></a>
+<span class="sourceLineNo">595</span>         Collections.reverse(sc.beanFilters);<a name="line.595"></a>
+<span class="sourceLineNo">596</span>         Collections.reverse(sc.pojoSwaps);<a name="line.596"></a>
+<span class="sourceLineNo">597</span>         beanFilters = toObjectArray(sc.beanFilters, Class.class);<a name="line.597"></a>
+<span class="sourceLineNo">598</span>         pojoSwaps = toObjectArray(sc.pojoSwaps, Class.class);<a name="line.598"></a>
+<span class="sourceLineNo">599</span><a name="line.599"></a>
+<span class="sourceLineNo">600</span>         for (Class&lt;?&gt; c : sc.paramResolvers) {<a name="line.600"></a>
+<span class="sourceLineNo">601</span>            RestParam rp = newInstance(RestParam.class, c);<a name="line.601"></a>
+<span class="sourceLineNo">602</span>            paramResolvers.put(rp.forClass(), rp);<a name="line.602"></a>
+<span class="sourceLineNo">603</span>         }<a name="line.603"></a>
+<span class="sourceLineNo">604</span><a name="line.604"></a>
+<span class="sourceLineNo">605</span>         clientVersionHeader = sc.clientVersionHeader;<a name="line.605"></a>
+<span class="sourceLineNo">606</span><a name="line.606"></a>
+<span class="sourceLineNo">607</span>         // Find resource resource bundle location.<a name="line.607"></a>
+<span class="sourceLineNo">608</span>         for (Map.Entry&lt;Class&lt;?&gt;,RestResource&gt; e : restResourceAnnotationsChildFirst.entrySet()) {<a name="line.608"></a>
+<span class="sourceLineNo">609</span>            Class&lt;?&gt; c = e.getKey();<a name="line.609"></a>
+<span class="sourceLineNo">610</span>            RestResource r = e.getValue();<a name="line.610"></a>
+<span class="sourceLineNo">611</span>            if (! r.messages().isEmpty()) {<a name="line.611"></a>
+<span class="sourceLineNo">612</span>               if (messageBundle == null)<a name="line.612"></a>
+<span class="sourceLineNo">613</span>                  messageBundle = new MessageBundle(c, r.messages());<a name="line.613"></a>
+<span class="sourceLineNo">614</span>               else<a name="line.614"></a>
+<span class="sourceLineNo">615</span>                  messageBundle.addSearchPath(c, r.messages());<a name="line.615"></a>
+<span class="sourceLineNo">616</span>            }<a name="line.616"></a>
+<span class="sourceLineNo">617</span>         }<a name="line.617"></a>
 <span class="sourceLineNo">618</span><a name="line.618"></a>
-<span class="sourceLineNo">619</span>         ps.addBeanFilters(beanFilters).addPojoSwaps(pojoSwaps).setProperties(properties);<a name="line.619"></a>
-<span class="sourceLineNo">620</span><a name="line.620"></a>
-<span class="sourceLineNo">621</span>         serializers = sc.serializers.beanFilters(beanFilters).pojoSwaps(pojoSwaps).properties(properties).listener(sc.serializerListener).build();<a name="line.621"></a>
-<span class="sourceLineNo">622</span>         parsers = sc.parsers.beanFilters(beanFilters).pojoSwaps(pojoSwaps).properties(properties).listener(sc.parserListener).build();<a name="line.622"></a>
-<span class="sourceLineNo">623</span>         urlEncodingSerializer = new UrlEncodingSerializer(ps);<a name="line.623"></a>
-<span class="sourceLineNo">624</span>         urlEncodingParser = new UrlEncodingParser(ps);<a name="line.624"></a>
-<span class="sourceLineNo">625</span>         encoders = sc.encoders.build();<a name="line.625"></a>
-<span class="sourceLineNo">626</span>         supportedContentTypes = sc.supportedContentTypes != null ? sc.supportedContentTypes : serializers.getSupportedMediaTypes();<a name="line.626"></a>
-<span class="sourceLineNo">627</span>         supportedAcceptTypes = sc.supportedAcceptTypes != null ? sc.supportedAcceptTypes : parsers.getSupportedMediaTypes();<a name="line.627"></a>
-<span class="sourceLineNo">628</span>         defaultRequestHeaders.putAll(sc.defaultRequestHeaders);<a name="line.628"></a>
-<span class="sourceLineNo">629</span>         defaultResponseHeaders = Collections.unmodifiableMap(new LinkedHashMap&lt;String,Object&gt;(sc.defaultResponseHeaders));<a name="line.629"></a>
-<span class="sourceLineNo">630</span>         beanContext = ps.getBeanContext();<a name="line.630"></a>
-<span class="sourceLineNo">631</span><a name="line.631"></a>
-<span class="sourceLineNo">632</span>         for (Object o : sc.converters)<a name="line.632"></a>
-<span class="sourceLineNo">633</span>            converters.add(resolve(RestConverter.class, o));<a name="line.633"></a>
+<span class="sourceLineNo">619</span>         if (messageBundle == null)<a name="line.619"></a>
+<span class="sourceLineNo">620</span>            messageBundle = new MessageBundle(resource.getClass(), "");<a name="line.620"></a>
+<span class="sourceLineNo">621</span><a name="line.621"></a>
+<span class="sourceLineNo">622</span>         ps.addBeanFilters(beanFilters).addPojoSwaps(pojoSwaps).setProperties(properties);<a name="line.622"></a>
+<span class="sourceLineNo">623</span><a name="line.623"></a>
+<span class="sourceLineNo">624</span>         serializers = sc.serializers.beanFilters(beanFilters).pojoSwaps(pojoSwaps).properties(properties).listener(sc.serializerListener).build();<a name="line.624"></a>
+<span class="sourceLineNo">625</span>         parsers = sc.parsers.beanFilters(beanFilters).pojoSwaps(pojoSwaps).properties(properties).listener(sc.parserListener).build();<a name="line.625"></a>
+<span class="sourceLineNo">626</span>         urlEncodingSerializer = new UrlEncodingSerializer(ps);<a name="line.626"></a>
+<span class="sourceLineNo">627</span>         urlEncodingParser = new UrlEncodingParser(ps);<a name="line.627"></a>
+<span class="sourceLineNo">628</span>         encoders = sc.encoders.build();<a name="line.628"></a>
+<span class="sourceLineNo">629</span>         supportedContentTypes = sc.supportedContentTypes != null ? sc.supportedContentTypes : serializers.getSupportedMediaTypes();<a name="line.629"></a>
+<span class="sourceLineNo">630</span>         supportedAcceptTypes = sc.supportedAcceptTypes != null ? sc.supportedAcceptTypes : parsers.getSupportedMediaTypes();<a name="line.630"></a>
+<span class="sourceLineNo">631</span>         defaultRequestHeaders.putAll(sc.defaultRequestHeaders);<a name="line.631"></a>
+<span class="sourceLineNo">632</span>         defaultResponseHeaders = Collections.unmodifiableMap(new LinkedHashMap&lt;String,Object&gt;(sc.defaultResponseHeaders));<a name="line.632"></a>
+<span class="sourceLineNo">633</span>         beanContext = ps.getBeanContext();<a name="line.633"></a>
 <span class="sourceLineNo">634</span><a name="line.634"></a>
-<span class="sourceLineNo">635</span>         for (Object o : sc.guards)<a name="line.635"></a>
-<span class="sourceLineNo">636</span>            guards.add(resolve(RestGuard.class, o));<a name="line.636"></a>
+<span class="sourceLineNo">635</span>         for (Object o : sc.converters)<a name="line.635"></a>
+<span class="sourceLineNo">636</span>            converters.add(resolve(RestConverter.class, o));<a name="line.636"></a>
 <span class="sourceLineNo">637</span><a name="line.637"></a>
-<span class="sourceLineNo">638</span>         for (Object o : sc.responseHandlers)<a name="line.638"></a>
-<span class="sourceLineNo">639</span>            responseHandlers.add(resolve(ResponseHandler.class, o));<a name="line.639"></a>
+<span class="sourceLineNo">638</span>         for (Object o : sc.guards)<a name="line.638"></a>
+<span class="sourceLineNo">639</span>            guards.add(resolve(RestGuard.class, o));<a name="line.639"></a>
 <span class="sourceLineNo">640</span><a name="line.640"></a>
-<span class="sourceLineNo">641</span>         mimetypesFileTypeMap = sc.mimeTypes;<a name="line.641"></a>
-<span class="sourceLineNo">642</span><a name="line.642"></a>
-<span class="sourceLineNo">643</span>         VarResolver vr = sc.getVarResolverBuilder().build();<a name="line.643"></a>
-<span class="sourceLineNo">644</span><a name="line.644"></a>
-<span class="sourceLineNo">645</span>         if (sc.favIcon != null) {<a name="line.645"></a>
-<span class="sourceLineNo">646</span>            Object o = sc.favIcon;<a name="line.646"></a>
-<span class="sourceLineNo">647</span>            InputStream is = null;<a name="line.647"></a>
-<span class="sourceLineNo">648</span>            if (o instanceof Pair) {<a name="line.648"></a>
-<span class="sourceLineNo">649</span>               Pair&lt;Class&lt;?&gt;,String&gt; p = (Pair&lt;Class&lt;?&gt;,String&gt;)o;<a name="line.649"></a>
-<span class="sourceLineNo">650</span>               is = ReflectionUtils.getResource(p.first(), vr.resolve(p.second()));<a name="line.650"></a>
-<span class="sourceLineNo">651</span>            } else {<a name="line.651"></a>
-<span class="sourceLineNo">652</span>               is = toInputStream(o);<a name="line.652"></a>
-<span class="sourceLineNo">653</span>            }<a name="line.653"></a>
-<span class="sourceLineNo">654</span>            if (is != null)<a name="line.654"></a>
-<span class="sourceLineNo">655</span>               favIcon = new StreamResource(MediaType.forString("image/x-icon"), is);<a name="line.655"></a>
-<span class="sourceLineNo">656</span>         }<a name="line.656"></a>
-<span class="sourceLineNo">657</span><a name="line.657"></a>
-<span class="sourceLineNo">658</span>         staticFilesMap = new LinkedHashMap&lt;String,String&gt;();<a name="line.658"></a>
-<span class="sourceLineNo">659</span>         if (sc.staticFiles != null) {<a name="line.659"></a>
-<span class="sourceLineNo">660</span>            for (Object o : sc.staticFiles) {<a name="line.660"></a>
-<span class="sourceLineNo">661</span>               if (o instanceof Pair) {<a name="line.661"></a>
-<span class="sourceLineNo">662</span>                  Pair&lt;Class&lt;?&gt;,String&gt; p = (Pair&lt;Class&lt;?&gt;,String&gt;)o;<a name="line.662"></a>
-<span class="sourceLineNo">663</span>                  // TODO - Currently doesn't take parent class location into account.<a name="line.663"></a>
-<span class="sourceLineNo">664</span>                  staticFilesMap.putAll(JsonParser.DEFAULT.parse(vr.resolve(p.second()), LinkedHashMap.class));<a name="line.664"></a>
-<span class="sourceLineNo">665</span>               } else {<a name="line.665"></a>
-<span class="sourceLineNo">666</span>                  throw new RuntimeException("TODO");<a name="line.666"></a>
-<span class="sourceLineNo">667</span>               }<a name="line.667"></a>
-<span class="sourceLineNo">668</span>            }<a name="line.668"></a>
-<span class="sourceLineNo">669</span>         }<a name="line.669"></a>
-<span class="sourceLineNo">670</span>         staticFilesPrefixes = staticFilesMap.keySet().toArray(new String[0]);<a name="line.670"></a>
-<span class="sourceLineNo">671</span><a name="line.671"></a>
-<span class="sourceLineNo">672</span>         logger = sc.logger == null ? new RestLogger.NoOp() : resolve(RestLogger.class, sc.logger);<a name="line.672"></a>
-<span class="sourceLineNo">673</span><a name="line.673"></a>
-<span class="sourceLineNo">674</span>         fullPath = (sc.parentContext == null ? "" : (sc.parentContext.fullPath + '/')) + sc.path;<a name="line.674"></a>
-<span class="sourceLineNo">675</span><a name="line.675"></a>
-<span class="sourceLineNo">676</span>         htmlWidgets = sc.htmlWidgets;<a name="line.676"></a>
-<span class="sourceLineNo">677</span>         htmlHeader = sc.htmlHeader;<a name="line.677"></a>
-<span class="sourceLineNo">678</span>         htmlLinks = sc.htmlLinks;<a name="line.678"></a>
-<span class="sourceLineNo">679</span>         htmlNav = sc.htmlNav;<a name="line.679"></a>
-<span class="sourceLineNo">680</span>         htmlAside = sc.htmlAside;<a name="line.680"></a>
-<span class="sourceLineNo">681</span>         htmlStyle = sc.htmlStyle;<a name="line.681"></a>
-<span class="sourceLineNo">682</span>         htmlStylesheet = sc.htmlStylesheet;<a name="line.682"></a>
-<span class="sourceLineNo">683</span>         htmlScript = sc.htmlScript;<a name="line.683"></a>
-<span class="sourceLineNo">684</span>         htmlFooter = sc.htmlFooter;<a name="line.684"></a>
-<span class="sourceLineNo">685</span>         htmlNoWrap = sc.htmlNoWrap;<a name="line.685"></a>
-<span class="sourceLineNo">686</span>         htmlNoResultsMessage = sc.htmlNoResultsMessage;<a name="line.686"></a>
-<span class="sourceLineNo">687</span>         htmlTemplate = ClassUtils.newInstance(HtmlDocTemplate.class, sc.htmlTemplate);<a name="line.687"></a>
-<span class="sourceLineNo">688</span>      }<a name="line.688"></a>
-<span class="sourceLineNo">689</span>   }<a name="line.689"></a>
-<span class="sourceLineNo">690</span><a name="line.690"></a>
-<span class="sourceLineNo">691</span>   /**<a name="line.691"></a>
-<span class="sourceLineNo">692</span>    * Returns the variable resolver for this servlet.<a name="line.692"></a>
-<span class="sourceLineNo">693</span>    *<a name="line.693"></a>
-<span class="sourceLineNo">694</span>    * &lt;p&gt;<a name="line.694"></a>
-<span class="sourceLineNo">695</span>    * Variable resolvers are used to replace variables in property values.<a name="line.695"></a>
-<span class="sourceLineNo">696</span>    * They can be nested arbitrarily deep.<a name="line.696"></a>
-<span class="sourceLineNo">697</span>    * They can also return values that themselves contain other variables.<a name="line.697"></a>
-<span class="sourceLineNo">698</span>    *<a name="line.698"></a>
-<span class="sourceLineNo">699</span>    * &lt;h6 class='figure'&gt;Example:&lt;/h6&gt;<a name="line.699"></a>
-<span class="sourceLineNo">700</span>    * &lt;p class='bcode'&gt;<a name="line.700"></a>
-<span class="sourceLineNo">701</span>    *    &lt;ja&gt;@RestResource&lt;/ja&gt;(<a name="line.701"></a>
-<span class="sourceLineNo">702</span>    *       messages=&lt;js&gt;"nls/Messages"&lt;/js&gt;,<a name="line.702"></a>
-<span class="sourceLineNo">703</span>    *       properties={<a name="line.703"></a>
-<span class="sourceLineNo">704</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"title"&lt;/js&gt;,value=&lt;js&gt;"$L{title}"&lt;/js&gt;),  &lt;jc&gt;// Localized variable in Messages.properties&lt;/jc&gt;<a name="line.704"></a>
-<span class="sourceLineNo">705</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"javaVendor"&lt;/js&gt;,value=&lt;js&gt;"$S{java.vendor,Oracle}"&lt;/js&gt;),  &lt;jc&gt;// System property with default value&lt;/jc&gt;<a name="line.705"></a>
-<span class="sourceLineNo">706</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"foo"&lt;/js&gt;,value=&lt;js&gt;"bar"&lt;/js&gt;),<a name="line.706"></a>
-<span class="sourceLineNo">707</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"bar"&lt;/js&gt;,value=&lt;js&gt;"baz"&lt;/js&gt;),<a name="line.707"></a>
-<span class="sourceLineNo">708</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"v1"&lt;/js&gt;,value=&lt;js&gt;"$R{foo}"&lt;/js&gt;),  &lt;jc&gt;// Request variable.  value="bar"&lt;/jc&gt;<a name="line.708"></a>
-<span class="sourceLineNo">709</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"v2"&lt;/js&gt;,value=&lt;js&gt;"$R{$R{foo}}"&lt;/js&gt;)  &lt;jc&gt;// Nested request variable. value="baz"&lt;/jc&gt;<a name="line.709"></a>
-<span class="sourceLineNo">710</span>    *       }<a name="line.710"></a>
-<span class="sourceLineNo">711</span>    *    )<a name="line.711"></a>
-<span class="sourceLineNo">712</span>    *    &lt;jk&gt;public class&lt;/jk&gt; MyRestResource &lt;jk&gt;extends&lt;/jk&gt; RestServletDefault {<a name="line.712"></a>
-<span class="sourceLineNo">713</span>    * &lt;/p&gt;<a name="line.713"></a>
-<span class="sourceLineNo">714</span>    *<a name="line.714"></a>
-<span class="sourceLineNo">715</span>    * &lt;p&gt;<a name="line.715"></a>
-<span class="sourceLineNo">716</span>    * A typical usage pattern involves using variables inside the {@link HtmlDoc} annotation:<a name="line.716"></a>
-<span class="sourceLineNo">717</span>    * &lt;p class='bcode'&gt;<a name="line.717"></a>
-<span class="sourceLineNo">718</span>    *    &lt;ja&gt;@RestMethod&lt;/ja&gt;(<a name="line.718"></a>
-<span class="sourceLineNo">719</span>    *       name=&lt;js&gt;"GET"&lt;/js&gt;, path=&lt;js&gt;"/{name}/*"&lt;/js&gt;,<a name="line.719"></a>
-<span class="sourceLineNo">720</span>    *       htmldoc=@HtmlDoc(<a name="line.720"></a>
-<span class="sourceLineNo">721</span>    *          links={<a name="line.721"></a>
-<span class="sourceLineNo">722</span>    *             &lt;js&gt;"up: $R{requestParentURI}"&lt;/js&gt;,<a name="line.722"></a>
-<span class="sourceLineNo">723</span>    *             &lt;js&gt;"options: servlet:/?method=OPTIONS"&lt;/js&gt;,<a name="line.723"></a>
-<span class="sourceLineNo">724</span>    *             &lt;js&gt;"editLevel: servlet:/editLevel?logger=$A{attribute.name, OFF}"&lt;/js&gt;<a name="line.724"></a>
-<span class="sourceLineNo">725</span>    *          }<a name="line.725"></a>
-<span class="sourceLineNo">726</span>    *          header={<a name="line.726"></a>
-<span class="sourceLineNo">727</span>    *             &lt;js&gt;"&amp;lt;h1&amp;gt;$L{MyLocalizedPageTitle}&amp;lt;/h1&amp;gt;"&lt;/js&gt;<a name="line.727"></a>
-<span class="sourceLineNo">728</span>    *          },<a name="line.728"></a>
-<span class="sourceLineNo">729</span>    *          aside={<a name="line.729"></a>
-<span class="sourceLineNo">730</span>    *             &lt;js&gt;"$F{resources/AsideText.html}"&lt;/js&gt;<a name="line.730"></a>
-<span class="sourceLineNo">731</span>    *          }<a name="line.731"></a>
-<span class="sourceLineNo">732</span>    *       )<a name="line.732"></a>
-<span class="sourceLineNo">733</span>    *    )<a name="line.733"></a>
-<span class="sourceLineNo">734</span>    *    &lt;jk&gt;public&lt;/jk&gt; LoggerEntry getLogger(RestRequest req, &lt;ja&gt;@Path&lt;/ja&gt; String name) &lt;jk&gt;throws&lt;/jk&gt; Exception {<a name="line.734"></a>
-<span class="sourceLineNo">735</span>    * &lt;/p&gt;<a name="line.735"></a>
-<span class="sourceLineNo">736</span>    *<a name="line.736"></a>
-<span class="sourceLineNo">737</span>    * &lt;p&gt;<a name="line.737"></a>
-<span class="sourceLineNo">738</span>    * The following is the default list of supported variables:<a name="line.738"></a>
-<span class="sourceLineNo">739</span>    * &lt;ul&gt;<a name="line.739"></a>
-<span class="sourceLineNo">740</span>    *    &lt;li&gt;&lt;code&gt;$C{key[,defaultValue]}&lt;/code&gt; - Config file entry. See {@link ConfigFileVar}.<a name="line.740"></a>
-<span class="sourceLineNo">741</span>    *    &lt;li&gt;&lt;code&gt;$E{envVar[,defaultValue]}&lt;/code&gt; - Environment variable. See {@link EnvVariablesVar}.<a name="line.741"></a>
-<span class="sourceLineNo">742</span>    *    &lt;li&gt;&lt;code&gt;$F{path[,defaultValue]}&lt;/code&gt; - File resource. See {@link FileVar}.<a name="line.742"></a>
-<span class="sourceLineNo">743</span>    *    &lt;li&gt;&lt;code&gt;$I{name[,defaultValue]}&lt;/code&gt; - Servlet init parameter. See {@link ServletInitParamVar}.<a name="line.743"></a>
-<span class="sourceLineNo">744</span>    *    &lt;li&gt;&lt;code&gt;$L{key[,args...]}&lt;/code&gt; - Localized message. See {@link LocalizationVar}.<a name="line.744"></a>
-<span class="sourceLineNo">745</span>    *    &lt;li&gt;&lt;code&gt;$R{key[,args...]}&lt;/code&gt; - Request variable. See {@link RequestVar}.<a name="line.745"></a>
-<span class="sourceLineNo">746</span>    *    &lt;li&gt;&lt;code&gt;$S{systemProperty[,defaultValue]}&lt;/code&gt; - System property. See {@link SystemPropertiesVar}.<a name="line.746"></a>
-<span class="sourceLineNo">747</span>    *    &lt;li&gt;&lt;code&gt;$SA{contentType,key[,defaultValue]}&lt;/code&gt; - Serialized request attribute. See {@link SerializedRequestAttrVar}.<a name="line.747"></a>
-<span class="sourceLineNo">748</span>    *    &lt;li&gt;&lt;code&gt;$U{uri}&lt;/code&gt; - URI resolver. See {@link UrlVar}.<a name="line.748"></a>
-<span class="sourceLineNo">749</span>    *    &lt;li&gt;&lt;code&gt;$UE{uriPart}&lt;/code&gt; - URL-Encoder. See {@link UrlEncodeVar}.<a name="line.749"></a>
-<span class="sourceLineNo">750</span>    *    &lt;li&gt;&lt;code&gt;$W{widgetName}&lt;/code&gt; - HTML widget variable. See {@link WidgetVar}.<a name="line.750"></a>
-<span class="sourceLineNo">751</span>    * &lt;/ul&gt;<a name="line.751"></a>
-<span class="sourceLineNo">752</span>    *<a name="line.752"></a>
-<span class="sourceLineNo">753</span>    * &lt;p&gt;<a name="line.753"></a>
-<span class="sourceLineNo">754</span>    * The following syntax variables are also provided:<a name="line.754"></a>
-<span class="sourceLineNo">755</span>    * &lt;ul&gt;<a name="line.755"></a>
-<span class="sourceLineNo">756</span>    *    &lt;li&gt;&lt;code&gt;$IF{booleanArg,thenValue[,elseValue]}&lt;/code&gt; - If/else variable. See {@link IfVar}.<a name="line.756"></a>
-<span class="sourceLineNo">757</span>    *    &lt;li&gt;&lt;code&gt;$SW{stringArg(,pattern,thenValue)+[,elseValue]}&lt;/code&gt; - Switch variable. See {@link SwitchVar}.<a name="line.757"></a>
-<span class="sourceLineNo">758</span>    * &lt;/ul&gt;<a name="line.758"></a>
-<span class="sourceLineNo">759</span>    *<a name="line.759"></a>
-<span class="sourceLineNo">760</span>    * &lt;p&gt;<a name="line.760"></a>
-<span class="sourceLineNo">761</span>    * The list of variables can be extended using the {@link RestConfig#addVars(Class...)} method.<a name="line.761"></a>
-<span class="sourceLineNo">762</span>    * For example, this is used to add support for the Args and Manifest-File variables in the microservice<a name="line.762"></a>
-<span class="sourceLineNo">763</span>    * &lt;code&gt;Resource&lt;/code&gt; class.<a name="line.763"></a>
-<span class="sourceLineNo">764</span>    *<a name="line.764"></a>
-<span class="sourceLineNo">765</span>    * @return The var resolver in use by this resource.<a name="line.765"></a>
-<span class="sourceLineNo">766</span>    */<a name="line.766"></a>
-<span class="sourceLineNo">767</span>   public VarResolver getVarResolver() {<a name="line.767"></a>
-<span class="sourceLineNo">768</span>      return varResolver;<a name="line.768"></a>
-<span class="sourceLineNo">769</span>   }<a name="line.769"></a>
-<span class="sourceLineNo">770</span><a name="line.770"></a>
-<span class="sourceLineNo">771</span>   /**<a name="line.771"></a>
-<span class="sourceLineNo">772</span>    * Returns the config file associated with this servlet.<a name="line.772"></a>
-<span class="sourceLineNo">773</span>    *<a name="line.773"></a>
-<span class="sourceLineNo">774</span>    * &lt;p&gt;<a name="line.774"></a>
-<span class="sourceLineNo">775</span>    * The config file is identified via one of the following:<a name="line.775"></a>
-<span class="sourceLineNo">776</span>    * &lt;ul&gt;<a name="line.776"></a>
-<span class="sourceLineNo">777</span>    *    &lt;li&gt;{@link RestResource#config() @RestResource.config()} annotation.<a name="line.777"></a>
-<span class="sourceLineNo">778</span>    *    &lt;li&gt;{@link RestConfig#setConfigFile(ConfigFile)} method.<a name="line.778"></a>
-<span class="sourceLineNo">779</span>    * &lt;/ul&gt;<a name="line.779"></a>
-<span class="sourceLineNo">780</span>    *<a name="line.780"></a>
-<span class="sourceLineNo">781</span>    * @return The resolving config file associated with this servlet.  Never &lt;jk&gt;null&lt;/jk&gt;.<a name="line.781"></a>
-<span class="sourceLineNo">782</span>    */<a name="line.782"></a>
-<span class="sourceLineNo">783</span>   public ConfigFile getConfigFile() {<a name="line.783"></a>
-<span class="sourceLineNo">784</span>      return configFile;<a name="line.784"></a>
-<span class="sourceLineNo">785</span>   }<a name="line.785"></a>
-<span class="sourceLineNo">786</span><a name="line.786"></a>
-<span class="sourceLineNo">787</span>   /**<a name="line.787"></a>
-<span class="sourceLineNo">788</span>    * Resolve a static resource file.<a name="line.788"></a>
-<span class="sourceLineNo">789</span>    *<a name="line.789"></a>
-<span class="sourceLineNo">790</span>    * &lt;p&gt;<a name="line.790"></a>
-<span class="sourceLineNo">791</span>    * The location of static resources are defined via one of the following:<a name="line.791"></a>
-<span class="sourceLineNo">792</span>    * &lt;ul&gt;<a name="line.792"></a>
-<span class="sourceLineNo">793</span>    *    &lt;li&gt;{@link RestResource#staticFiles() @RestResource.staticFiles()} annotation.<a name="line.793"></a>
-<span class="sourceLineNo">794</span>    *    &lt;li&gt;{@link RestConfig#addStaticFiles(Class, String)} method.<a name="line.794"></a>
-<span class="sourceLineNo">795</span>    * &lt;/ul&gt;<a name="line.795"></a>
-<span class="sourceLineNo">796</span>    *<a name="line.796"></a>
-<span class="sourceLineNo">797</span>    * @param pathInfo The unencoded path info.<a name="line.797"></a>
-<span class="sourceLineNo">798</span>    * @return The resource, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be resolved.<a name="line.798"></a>
-<span class="sourceLineNo">799</span>    * @throws IOException<a name="line.799"></a>
-<span class="sourceLineNo">800</span>    */<a name="line.800"></a>
-<span class="sourceLineNo">801</span>   public StreamResource resolveStaticFile(String pathInfo) throws IOException {<a name="line.801"></a>
-<span class="sourceLineNo">802</span>      if (! staticFilesCache.containsKey(pathInfo)) {<a name="line.802"></a>
-<span class="sourceLineNo">803</span>         String p = urlDecode(trimSlashes(pathInfo));<a name="line.803"></a>
-<span class="sourceLineNo">804</span>         if (p.indexOf("..") != -1)<a name="line.804"></a>
-<span class="sourceLineNo">805</span>            throw new RestException(SC_NOT_FOUND, "Invalid path");<a name="line.805"></a>
-<span class="sourceLineNo">806</span>         for (Map.Entry&lt;String,String&gt; e : staticFilesMap.entrySet()) {<a name="line.806"></a>
-<span class="sourceLineNo">807</span>            String key = trimSlashes(e.getKey());<a name="line.807"></a>
-<span class="sourceLineNo">808</span>            if (p.startsWith(key)) {<a name="line.808"></a>
-<span class="sourceLineNo">809</span>               String remainder = (p.equals(key) ? "" : p.substring(key.length()));<a name="line.809"></a>
-<span class="sourceLineNo">810</span>               if (remainder.isEmpty() || remainder.startsWith("/")) {<a name="line.810"></a>
-<span class="sourceLineNo">811</span>                  String p2 = trimSlashes(e.getValue()) + remainder;<a name="line.811"></a>
-<span class="sourceLineNo">812</span>                  InputStream is = getResource(p2, null);<a name="line.812"></a>
-<span class="sourceLineNo">813</span>                  if (is != null) {<a name="line.813"></a>
-<span class="sourceLineNo">814</span>                     try {<a name="line.814"></a>
-<span class="sourceLineNo">815</span>                        int i = p2.lastIndexOf('/');<a name="line.815"></a>
-<span class="sourceLineNo">816</span>                        String name = (i == -1 ? p2 : p2.substring(i+1));<a name="line.816"></a>
-<span class="sourceLineNo">817</span>                        String mediaType = mimetypesFileTypeMap.getContentType(name);<a name="line.817"></a>
-<span class="sourceLineNo">818</span>                        ObjectMap headers = new ObjectMap().append("Cache-Control", "max-age=86400, public");<a name="line.818"></a>
-<span class="sourceLineNo">819</span>                        staticFilesCache.put(pathInfo, new StreamResource(MediaType.forString(mediaType), headers, is));<a name="line.819"></a>
-<span class="sourceLineNo">820</span>                        return staticFilesCache.get(pathInfo);<a name="line.820"></a>
-<span class="sourceLineNo">821</span>                     } finally {<a name="line.821"></a>
-<span class="sourceLineNo">822</span>                        is.close();<a name="line.822"></a>
-<span class="sourceLineNo">823</span>                     }<a name="line.823"></a>
-<span class="sourceLineNo">824</span>                  }<a name="line.824"></a>
-<span class="sourceLineNo">825</span>               }<a name="line.825"></a>
-<span class="sourceLineNo">826</span>            }<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>      return staticFilesCache.get(pathInfo);<a name="line.829"></a>
-<span class="sourceLineNo">830</span>   }<a name="line.830"></a>
-<span class="sourceLineNo">831</span><a name="line.831"></a>
-<span class="sourceLineNo">832</span>   /**<a name="line.832"></a>
-<span class="sourceLineNo">833</span>    * Same as {@link Class#getResourceAsStream(String)} except if it doesn't find the resource on this class, searches<a name="line.833"></a>
-<span class="sourceLineNo">834</span>    * up the parent hierarchy chain.<a name="line.834"></a>
-<span class="sourceLineNo">835</span>    *<a name="line.835"></a>
-<span class="sourceLineNo">836</span>    * &lt;p&gt;<a name="line.836"></a>
-<span class="sourceLineNo">837</span>    * If the resource cannot be found in the classpath, then an attempt is made to look in the JVM working directory.<a name="line.837"></a>
+<span class="sourceLineNo">641</span>         for (Object o : sc.responseHandlers)<a name="line.641"></a>
+<span class="sourceLineNo">642</span>            responseHandlers.add(resolve(ResponseHandler.class, o));<a name="line.642"></a>
+<span class="sourceLineNo">643</span><a name="line.643"></a>
+<span class="sourceLineNo">644</span>         mimetypesFileTypeMap = sc.mimeTypes;<a name="line.644"></a>
+<span class="sourceLineNo">645</span><a name="line.645"></a>
+<span class="sourceLineNo">646</span>         VarResolver vr = sc.getVarResolverBuilder().build();<a name="line.646"></a>
+<span class="sourceLineNo">647</span><a name="line.647"></a>
+<span class="sourceLineNo">648</span>         if (sc.favIcon != null) {<a name="line.648"></a>
+<span class="sourceLineNo">649</span>            Object o = sc.favIcon;<a name="line.649"></a>
+<span class="sourceLineNo">650</span>            InputStream is = null;<a name="line.650"></a>
+<span class="sourceLineNo">651</span>            if (o instanceof Pair) {<a name="line.651"></a>
+<span class="sourceLineNo">652</span>               Pair&lt;Class&lt;?&gt;,String&gt; p = (Pair&lt;Class&lt;?&gt;,String&gt;)o;<a name="line.652"></a>
+<span class="sourceLineNo">653</span>               is = ReflectionUtils.getResource(p.first(), vr.resolve(p.second()));<a name="line.653"></a>
+<span class="sourceLineNo">654</span>            } else {<a name="line.654"></a>
+<span class="sourceLineNo">655</span>               is = toInputStream(o);<a name="line.655"></a>
+<span class="sourceLineNo">656</span>            }<a name="line.656"></a>
+<span class="sourceLineNo">657</span>            if (is != null)<a name="line.657"></a>
+<span class="sourceLineNo">658</span>               favIcon = new StreamResource(MediaType.forString("image/x-icon"), is);<a name="line.658"></a>
+<span class="sourceLineNo">659</span>         }<a name="line.659"></a>
+<span class="sourceLineNo">660</span><a name="line.660"></a>
+<span class="sourceLineNo">661</span>         staticFilesMap = new LinkedHashMap&lt;String,String&gt;();<a name="line.661"></a>
+<span class="sourceLineNo">662</span>         if (sc.staticFiles != null) {<a name="line.662"></a>
+<span class="sourceLineNo">663</span>            for (Object o : sc.staticFiles) {<a name="line.663"></a>
+<span class="sourceLineNo">664</span>               if (o instanceof Pair) {<a name="line.664"></a>
+<span class="sourceLineNo">665</span>                  Pair&lt;Class&lt;?&gt;,String&gt; p = (Pair&lt;Class&lt;?&gt;,String&gt;)o;<a name="line.665"></a>
+<span class="sourceLineNo">666</span>                  // TODO - Currently doesn't take parent class location into account.<a name="line.666"></a>
+<span class="sourceLineNo">667</span>                  staticFilesMap.putAll(JsonParser.DEFAULT.parse(vr.resolve(p.second()), LinkedHashMap.class));<a name="line.667"></a>
+<span class="sourceLineNo">668</span>               } else {<a name="line.668"></a>
+<span class="sourceLineNo">669</span>                  throw new RuntimeException("TODO");<a name="line.669"></a>
+<span class="sourceLineNo">670</span>               }<a name="line.670"></a>
+<span class="sourceLineNo">671</span>            }<a name="line.671"></a>
+<span class="sourceLineNo">672</span>         }<a name="line.672"></a>
+<span class="sourceLineNo">673</span>         staticFilesPrefixes = staticFilesMap.keySet().toArray(new String[0]);<a name="line.673"></a>
+<span class="sourceLineNo">674</span><a name="line.674"></a>
+<span class="sourceLineNo">675</span>         logger = sc.logger == null ? new RestLogger.NoOp() : resolve(RestLogger.class, sc.logger);<a name="line.675"></a>
+<span class="sourceLineNo">676</span><a name="line.676"></a>
+<span class="sourceLineNo">677</span>         fullPath = (sc.parentContext == null ? "" : (sc.parentContext.fullPath + '/')) + sc.path;<a name="line.677"></a>
+<span class="sourceLineNo">678</span><a name="line.678"></a>
+<span class="sourceLineNo">679</span>         htmlWidgets = sc.htmlWidgets;<a name="line.679"></a>
+<span class="sourceLineNo">680</span>         htmlHeader = sc.htmlHeader;<a name="line.680"></a>
+<span class="sourceLineNo">681</span>         htmlLinks = sc.htmlLinks;<a name="line.681"></a>
+<span class="sourceLineNo">682</span>         htmlNav = sc.htmlNav;<a name="line.682"></a>
+<span class="sourceLineNo">683</span>         htmlAside = sc.htmlAside;<a name="line.683"></a>
+<span class="sourceLineNo">684</span>         htmlStyle = sc.htmlStyle;<a name="line.684"></a>
+<span class="sourceLineNo">685</span>         htmlStylesheet = sc.htmlStylesheet;<a name="line.685"></a>
+<span class="sourceLineNo">686</span>         htmlScript = sc.htmlScript;<a name="line.686"></a>
+<span class="sourceLineNo">687</span>         htmlFooter = sc.htmlFooter;<a name="line.687"></a>
+<span class="sourceLineNo">688</span>         htmlNoWrap = sc.htmlNoWrap;<a name="line.688"></a>
+<span class="sourceLineNo">689</span>         htmlNoResultsMessage = sc.htmlNoResultsMessage;<a name="line.689"></a>
+<span class="sourceLineNo">690</span>         htmlTemplate = ClassUtils.newInstance(HtmlDocTemplate.class, sc.htmlTemplate);<a name="line.690"></a>
+<span class="sourceLineNo">691</span>      }<a name="line.691"></a>
+<span class="sourceLineNo">692</span>   }<a name="line.692"></a>
+<span class="sourceLineNo">693</span><a name="line.693"></a>
+<span class="sourceLineNo">694</span>   /**<a name="line.694"></a>
+<span class="sourceLineNo">695</span>    * Returns the variable resolver for this servlet.<a name="line.695"></a>
+<span class="sourceLineNo">696</span>    *<a name="line.696"></a>
+<span class="sourceLineNo">697</span>    * &lt;p&gt;<a name="line.697"></a>
+<span class="sourceLineNo">698</span>    * Variable resolvers are used to replace variables in property values.<a name="line.698"></a>
+<span class="sourceLineNo">699</span>    * They can be nested arbitrarily deep.<a name="line.699"></a>
+<span class="sourceLineNo">700</span>    * They can also return values that themselves contain other variables.<a name="line.700"></a>
+<span class="sourceLineNo">701</span>    *<a name="line.701"></a>
+<span class="sourceLineNo">702</span>    * &lt;h6 class='figure'&gt;Example:&lt;/h6&gt;<a name="line.702"></a>
+<span class="sourceLineNo">703</span>    * &lt;p class='bcode'&gt;<a name="line.703"></a>
+<span class="sourceLineNo">704</span>    *    &lt;ja&gt;@RestResource&lt;/ja&gt;(<a name="line.704"></a>
+<span class="sourceLineNo">705</span>    *       messages=&lt;js&gt;"nls/Messages"&lt;/js&gt;,<a name="line.705"></a>
+<span class="sourceLineNo">706</span>    *       properties={<a name="line.706"></a>
+<span class="sourceLineNo">707</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"title"&lt;/js&gt;,value=&lt;js&gt;"$L{title}"&lt;/js&gt;),  &lt;jc&gt;// Localized variable in Messages.properties&lt;/jc&gt;<a name="line.707"></a>
+<span class="sourceLineNo">708</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"javaVendor"&lt;/js&gt;,value=&lt;js&gt;"$S{java.vendor,Oracle}"&lt;/js&gt;),  &lt;jc&gt;// System property with default value&lt;/jc&gt;<a name="line.708"></a>
+<span class="sourceLineNo">709</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"foo"&lt;/js&gt;,value=&lt;js&gt;"bar"&lt;/js&gt;),<a name="line.709"></a>
+<span class="sourceLineNo">710</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"bar"&lt;/js&gt;,value=&lt;js&gt;"baz"&lt;/js&gt;),<a name="line.710"></a>
+<span class="sourceLineNo">711</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"v1"&lt;/js&gt;,value=&lt;js&gt;"$R{foo}"&lt;/js&gt;),  &lt;jc&gt;// Request variable.  value="bar"&lt;/jc&gt;<a name="line.711"></a>
+<span class="sourceLineNo">712</span>    *          &lt;ja&gt;@Property&lt;/ja&gt;(name=&lt;js&gt;"v2"&lt;/js&gt;,value=&lt;js&gt;"$R{$R{foo}}"&lt;/js&gt;)  &lt;jc&gt;// Nested request variable. value="baz"&lt;/jc&gt;<a name="line.712"></a>
+<span class="sourceLineNo">713</span>    *       }<a name="line.713"></a>
+<span class="sourceLineNo">714</span>    *    )<a name="line.714"></a>
+<span class="sourceLineNo">715</span>    *    &lt;jk&gt;public class&lt;/jk&gt; MyRestResource &lt;jk&gt;extends&lt;/jk&gt; RestServletDefault {<a name="line.715"></a>
+<span class="sourceLineNo">716</span>    * &lt;/p&gt;<a name="line.716"></a>
+<span class="sourceLineNo">717</span>    *<a name="line.717"></a>
+<span class="sourceLineNo">718</span>    * &lt;p&gt;<a name="line.718"></a>
+<span class="sourceLineNo">719</span>    * A typical usage pattern involves using variables inside the {@link HtmlDoc} annotation:<a name="line.719"></a>
+<span class="sourceLineNo">720</span>    * &lt;p class='bcode'&gt;<a name="line.720"></a>
+<span class="sourceLineNo">721</span>    *    &lt;ja&gt;@RestMethod&lt;/ja&gt;(<a name="line.721"></a>
+<span class="sourceLineNo">722</span>    *       name=&lt;js&gt;"GET"&lt;/js&gt;, path=&lt;js&gt;"/{name}/*"&lt;/js&gt;,<a name="line.722"></a>
+<span class="sourceLineNo">723</span>    *       htmldoc=@HtmlDoc(<a name="line.723"></a>
+<span class="sourceLineNo">724</span>    *          links={<a name="line.724"></a>
+<span class="sourceLineNo">725</span>    *             &lt;js&gt;"up: $R{requestParentURI}"&lt;/js&gt;,<a name="line.725"></a>
+<span class="sourceLineNo">726</span>    *             &lt;js&gt;"options: servlet:/?method=OPTIONS"&lt;/js&gt;,<a name="line.726"></a>
+<span class="sourceLineNo">727</span>    *             &lt;js&gt;"editLevel: servlet:/editLevel?logger=$A{attribute.name, OFF}"&lt;/js&gt;<a name="line.727"></a>
+<span class="sourceLineNo">728</span>    *          }<a name="line.728"></a>
+<span class="sourceLineNo">729</span>    *          header={<a name="line.729"></a>
+<span class="sourceLineNo">730</span>    *             &lt;js&gt;"&amp;lt;h1&amp;gt;$L{MyLocalizedPageTitle}&amp;lt;/h1&amp;gt;"&lt;/js&gt;<a name="line.730"></a>
+<span class="sourceLineNo">731</span>    *          },<a name="line.731"></a>
+<span class="sourceLineNo">732</span>    *          aside={<a name="line.732"></a>
+<span class="sourceLineNo">733</span>    *             &lt;js&gt;"$F{resources/AsideText.html}"&lt;/js&gt;<a name="line.733"></a>
+<span class="sourceLineNo">734</span>    *          }<a name="line.734"></a>
+<span class="sourceLineNo">735</span>    *       )<a name="line.735"></a>
+<span class="sourceLineNo">736</span>    *    )<a name="line.736"></a>
+<span class="sourceLineNo">737</span>    *    &lt;jk&gt;public&lt;/jk&gt; LoggerEntry getLogger(RestRequest req, &lt;ja&gt;@Path&lt;/ja&gt; String name) &lt;jk&gt;throws&lt;/jk&gt; Exception {<a name="line.737"></a>
+<span class="sourceLineNo">738</span>    * &lt;/p&gt;<a name="line.738"></a>
+<span class="sourceLineNo">739</span>    *<a name="line.739"></a>
+<span class="sourceLineNo">740</span>    * &lt;p&gt;<a name="line.740"></a>
+<span class="sourceLineNo">741</span>    * The following is the default list of supported variables:<a name="line.741"></a>
+<span class="sourceLineNo">742</span>    * &lt;ul&gt;<a name="line.742"></a>
+<span class="sourceLineNo">743</span>    *    &lt;li&gt;&lt;code&gt;$C{key[,defaultValue]}&lt;/code&gt; - Config file entry. See {@link ConfigFileVar}.<a name="line.743"></a>
+<span class="sourceLineNo">744</span>    *    &lt;li&gt;&lt;code&gt;$E{envVar[,defaultValue]}&lt;/code&gt; - Environment variable. See {@link EnvVariablesVar}.<a name="line.744"></a>
+<span class="sourceLineNo">745</span>    *    &lt;li&gt;&lt;code&gt;$F{path[,defaultValue]}&lt;/code&gt; - File resource. See {@link FileVar}.<a name="line.745"></a>
+<span class="sourceLineNo">746</span>    *    &lt;li&gt;&lt;code&gt;$I{name[,defaultValue]}&lt;/code&gt; - Servlet init parameter. See {@link ServletInitParamVar}.<a name="line.746"></a>
+<span class="sourceLineNo">747</span>    *    &lt;li&gt;&lt;code&gt;$L{key[,args...]}&lt;/code&gt; - Localized message. See {@link LocalizationVar}.<a name="line.747"></a>
+<span class="sourceLineNo">748</span>    *    &lt;li&gt;&lt;code&gt;$R{key[,args...]}&lt;/code&gt; - Request variable. See {@link RequestVar}.<a name="line.748"></a>
+<span class="sourceLineNo">749</span>    *    &lt;li&gt;&lt;code&gt;$S{systemProperty[,defaultValue]}&lt;/code&gt; - System property. See {@link SystemPropertiesVar}.<a name="line.749"></a>
+<span class="sourceLineNo">750</span>    *    &lt;li&gt;&lt;code&gt;$SA{contentType,key[,defaultValue]}&lt;/code&gt; - Serialized request attribute. See {@link SerializedRequestAttrVar}.<a name="line.750"></a>
+<span class="sourceLineNo">751</span>    *    &lt;li&gt;&lt;code&gt;$U{uri}&lt;/code&gt; - URI resolver. See {@link UrlVar}.<a name="line.751"></a>
+<span class="sourceLineNo">752</span>    *    &lt;li&gt;&lt;code&gt;$UE{uriPart}&lt;/code&gt; - URL-Encoder. See {@link UrlEncodeVar}.<a name="line.752"></a>
+<span class="sourceLineNo">753</span>    *    &lt;li&gt;&lt;code&gt;$W{widgetName}&lt;/code&gt; - HTML widget variable. See {@link WidgetVar}.<a name="line.753"></a>
+<span class="sourceLineNo">754</span>    * &lt;/ul&gt;<a name="line.754"></a>
+<span class="sourceLineNo">755</span>    *<a name="line.755"></a>
+<span class="sourceLineNo">756</span>    * &lt;p&gt;<a name="line.756"></a>
+<span class="sourceLineNo">757</span>    * The following syntax variables are also provided:<a name="line.757"></a>
+<span class="sourceLineNo">758</span>    * &lt;ul&gt;<a name="line.758"></a>
+<span class="sourceLineNo">759</span>    *    &lt;li&gt;&lt;code&gt;$IF{booleanArg,thenValue[,elseValue]}&lt;/code&gt; - If/else variable. See {@link IfVar}.<a name="line.759"></a>
+<span class="sourceLineNo">760</span>    *    &lt;li&gt;&lt;code&gt;$SW{stringArg(,pattern,thenValue)+[,elseValue]}&lt;/code&gt; - Switch variable. See {@link SwitchVar}.<a name="line.760"></a>
+<span class="sourceLineNo">761</span>    * &lt;/ul&gt;<a name="line.761"></a>
+<span class="sourceLineNo">762</span>    *<a name="line.762"></a>
+<span class="sourceLineNo">763</span>    * &lt;p&gt;<a name="line.763"></a>
+<span class="sourceLineNo">764</span>    * The list of variables can be extended using the {@link RestConfig#addVars(Class...)} method.<a name="line.764"></a>
+<span class="sourceLineNo">765</span>    * For example, this is used to add support for the Args and Manifest-File variables in the microservice<a name="line.765"></a>
+<span class="sourceLineNo">766</span>    * &lt;code&gt;Resource&lt;/code&gt; class.<a name="line.766"></a>
+<span class="sourceLineNo">767</span>    *<a name="line.767"></a>
+<span class="sourceLineNo">768</span>    * @return The var resolver in use by this resource.<a name="line.768"></a>
+<span class="sourceLineNo">769</span>    */<a name="line.769"></a>
+<span class="sourceLineNo">770</span>   public VarResolver getVarResolver() {<a name="line.770"></a>
+<span class="sourceLineNo">771</span>      return varResolver;<a name="line.771"></a>
+<span class="sourceLineNo">772</span>   }<a name="line.772"></a>
+<span class="sourceLineNo">773</span><a name="line.773"></a>
+<span class="sourceLineNo">774</span>   /**<a name="line.774"></a>
+<span class="sourceLineNo">775</span>    * Returns the config file associated with this servlet.<a name="line.775"></a>
+<span class="sourceLineNo">776</span>    *<a name="line.776"></a>
+<span class="sourceLineNo">777</span>    * &lt;p&gt;<a name="line.777"></a>
+<span class="sourceLineNo">778</span>    * The config file is identified via one of the following:<a name="line.778"></a>
+<span class="sourceLineNo">779</span>    * &lt;ul&gt;<a name="line.779"></a>
+<span class="sourceLineNo">780</span>    *    &lt;li&gt;{@link RestResource#config() @RestResource.config()} annotation.<a name="line.780"></a>
+<span class="sourceLineNo">781</span>    *    &lt;li&gt;{@link RestConfig#setConfigFile(ConfigFile)} method.<a name="line.781"></a>
+<span class="sourceLineNo">782</span>    * &lt;/ul&gt;<a name="line.782"></a>
+<span class="sourceLineNo">783</span>    *<a name="line.783"></a>
+<span class="sourceLineNo">784</span>    * @return The resolving config file associated with this servlet.  Never &lt;jk&gt;null&lt;/jk&gt;.<a name="line.784"></a>
+<span class="sourceLineNo">785</span>    */<a name="line.785"></a>
+<span class="sourceLineNo">786</span>   public ConfigFile getConfigFile() {<a name="line.786"></a>
+<span class="sourceLineNo">787</span>      return configFile;<a name="line.787"></a>
+<span class="sourceLineNo">788</span>   }<a name="line.788"></a>
+<span class="sourceLineNo">789</span><a name="line.789"></a>
+<span class="sourceLineNo">790</span>   /**<a name="line.790"></a>
+<span class="sourceLineNo">791</span>    * Resolve a static resource file.<a name="line.791"></a>
+<span class="sourceLineNo">792</span>    *<a name="line.792"></a>
+<span class="sourceLineNo">793</span>    * &lt;p&gt;<a name="line.793"></a>
+<span class="sourceLineNo">794</span>    * The location of static resources are defined via one of the following:<a name="line.794"></a>
+<span class="sourceLineNo">795</span>    * &lt;ul&gt;<a name="line.795"></a>
+<span class="sourceLineNo">796</span>    *    &lt;li&gt;{@link RestResource#staticFiles() @RestResource.staticFiles()} annotation.<a name="line.796"></a>
+<span class="sourceLineNo">797</span>    *    &lt;li&gt;{@link RestConfig#addStaticFiles(Class, String)} method.<a name="line.797"></a>
+<span class="sourceLineNo">798</span>    * &lt;/ul&gt;<a name="line.798"></a>
+<span class="sourceLineNo">799</span>    *<a name="line.799"></a>
+<span class="sourceLineNo">800</span>    * @param pathInfo The unencoded path info.<a name="line.800"></a>
+<span class="sourceLineNo">801</span>    * @return The resource, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be resolved.<a name="line.801"></a>
+<span class="sourceLineNo">802</span>    * @throws IOException<a name="line.802"></a>
+<span class="sourceLineNo">803</span>    */<a name="line.803"></a>
+<span class="sourceLineNo">804</span>   public StreamResource resolveStaticFile(String pathInfo) throws IOException {<a name="line.804"></a>
+<span class="sourceLineNo">805</span>      if (! staticFilesCache.containsKey(pathInfo)) {<a name="line.805"></a>
+<span class="sourceLineNo">806</span>         String p = urlDecode(trimSlashes(pathInfo));<a name="line.806"></a>
+<span class="sourceLineNo">807</span>         if (p.indexOf("..") != -1)<a name="line.807"></a>
+<span class="sourceLineNo">808</span>            throw new RestException(SC_NOT_FOUND, "Invalid path");<a name="line.808"></a>
+<span class="sourceLineNo">809</span>         for (Map.Entry&lt;String,String&gt; e : staticFilesMap.entrySet()) {<a name="line.809"></a>
+<span class="sourceLineNo">810</span>            String key = trimSlashes(e.getKey());<a name="line.810"></a>
+<span class="sourceLineNo">811</span>            if (p.startsWith(key)) {<a name="line.811"></a>
+<span class="sourceLineNo">812</span>               String remainder = (p.equals(key) ? "" : p.substring(key.length()));<a name="line.812"></a>
+<span class="sourceLineNo">813</span>               if (remainder.isEmpty() || remainder.startsWith("/")) {<a name="line.813"></a>
+<span class="sourceLineNo">814</span>                  String p2 = trimSlashes(e.getValue()) + remainder;<a name="line.814"></a>
+<span class="sourceLineNo">815</span>                  InputStream is = getResource(p2, null);<a name="line.815"></a>
+<span class="sourceLineNo">816</span>                  if (is != null) {<a name="line.816"></a>
+<span class="sourceLineNo">817</span>                     try {<a name="line.817"></a>
+<span class="sourceLineNo">818</span>                        int i = p2.lastIndexOf('/');<a name="line.818"></a>
+<span class="sourceLineNo">819</span>                        String name = (i == -1 ? p2 : p2.substring(i+1));<a name="line.819"></a>
+<span class="sourceLineNo">820</span>                        String mediaType = mimetypesFileTypeMap.getContentType(name);<a name="line.820"></a>
+<span class="sourceLineNo">821</span>                        ObjectMap headers = new ObjectMap().append("Cache-Control", "max-age=86400, public");<a name="line.821"></a>
+<span class="sourceLineNo">822</span>                        staticFilesCache.put(pathInfo, new StreamResource(MediaType.forString(mediaType), headers, is));<a name="line.822"></a>
+<span class="sourceLineNo">823</span>                        return staticFilesCache.get(pathInfo);<a name="line.823"></a>
+<span class="sourceLineNo">824</span>                     } finally {<a name="line.824"></a>
+<span class="sourceLineNo">825</span>                        is.close();<a name="line.825"></a>
+<span class="sourceLineNo">826</span>                     }<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>            }<a name="line.829"></a>
+<span class="sourceLineNo">830</span>         }<a name="line.830"></a>
+<span class="sourceLineNo">831</span>      }<a name="line.831"></a>
+<span class="sourceLineNo">832</span>      return staticFilesCache.get(pathInfo);<a name="line.832"></a>
+<span class="sourceLineNo">833</span>   }<a name="line.833"></a>
+<span class="sourceLineNo">834</span><a name="line.834"></a>
+<span class="sourceLineNo">835</span>   /**<a name="line.835"></a>
+<span class="sourceLineNo">836</span>    * Same as {@link Class#getResourceAsStream(String)} except if it doesn't find the resource on this class, searches<a name="line.836"></a>
+<span class="sourceLineNo">837</span>    * up the parent hierarchy chain.<a name="line.837"></a>
 <span class="sourceLineNo">838</span>    *<a name="line.838"></a>
 <span class="sourceLineNo">839</span>    * &lt;p&gt;<a name="line.839"></a>
-<span class="sourceLineNo">840</span>    * If the &lt;code&gt;locale&lt;/code&gt; is specified, then we look for resources whose name matches that locale.<a name="line.840"></a>
-<span class="sourceLineNo">841</span>    * For example, if looking for the resource &lt;js&gt;"MyResource.txt"&lt;/js&gt; for the Japanese locale, we will look for<a name="line.841"></a>
-<span class="sourceLineNo">842</span>    * files in the following order:<a name="line.842"></a>
-<span class="sourceLineNo">843</span>    * &lt;ol&gt;<a name="line.843"></a>
-<span class="sourceLineNo">844</span>    *    &lt;li&gt;&lt;js&gt;"MyResource_ja_JP.txt"&lt;/js&gt;<a name="line.844"></a>
-<span class="sourceLineNo">845</span>    *    &lt;li&gt;&lt;js&gt;"MyResource_ja.txt"&lt;/js&gt;<a name="line.845"></a>
-<span class="sourceLineNo">846</span>    *    &lt;li&gt;&lt;js&gt;"MyResource.txt"&lt;/js&gt;<a name="line.846"></a>
-<span class="sourceLineNo">847</span>    * &lt;/ol&gt;<a name="line.847"></a>
-<span class="sourceLineNo">848</span>    *<a name="line.848"></a>
-<span class="sourceLineNo">849</span>    * @param name The resource name.<a name="line.849"></a>
-<span class="sourceLineNo">850</span>    * @param locale Optional locale.<a name="line.850"></a>
-<span class="sourceLineNo">851</span>    * @return An input stream of the resource, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be found.<a name="line.851"></a>
-<span class="sourceLineNo">852</span>    * @throws IOException<a name="line.852"></a>
-<span class="sourceLineNo">853</span>    */<a name="line.853"></a>
-<span class="sourceLineNo">854</span>   protected InputStream getResource(String name, Locale locale) throws IOException {<a name="line.854"></a>
-<span class="sourceLineNo">855</span>      return resourceFinder.getResourceAsStream(name, locale);<a name="line.855"></a>
-<span class="sourceLineNo">856</span>   }<a name="line.856"></a>
-<span class="sourceLineNo">857</span><a name="line.857"></a>
-<span class="sourceLineNo">858</span>   /**<a name="line.858"></a>
-<span class="sourceLineNo">859</span>    * Reads the input stream from {@link #getResource(String, Locale)} into a String.<a name="line.859"></a>
-<span class="sourceLineNo">860</span>    *<a name="line.860"></a>
-<span class="sourceLineNo">861</span>    * @param name The resource name.<a name="line.861"></a>
-<span class="sourceLineNo">862</span>    * @param locale Optional locale.<a name="line.862"></a>
-<span class="sourceLineNo">863</span>    * @return The contents of the stream as a string, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be found.<a name="line.863"></a>
-<span class="sourceLineNo">864</span>    * @throws IOException If resource could not be found.<a name="line.864"></a>
-<span class="sourceLineNo">865</span>    */<a name="line.865"></a>
-<span class="sourceLineNo">866</span>   public String getResourceAsString(String name, Locale locale) throws IOException {<a name="line.866"></a>
-<span class="sourceLineNo">867</span>      return resourceFinder.getResourceAsString(name, locale);<a name="line.867"></a>
-<span class="sourceLineNo">868</span>   }<a name="line.868"></a>
-<span class="sourceLineNo">869</span><a name="line.869"></a>
-<span class="sourceLineNo">870</span>   /**<a name="line.870"></a>
-<span class="sourceLineNo">871</span>    * Reads the input stream from {@link #getResource(String, Locale)} and parses it into a POJO using the parser<a name="line.871"></a>
-<span class="sourceLineNo">872</span>    * matched by the specified media type.<a name="line.872"></a>
-<span class="sourceLineNo">873</span>    *<a name="line.873"></a>
-<span class="sourceLineNo">874</span>    * &lt;p&gt;<a name="line.874"></a>
-<span class="sourceLineNo">875</span>    * Useful if you want to load predefined POJOs from JSON files in your classpath.<a name="line.875"></a>
+<span class="sourceLineNo">840</span>    * If the resource cannot be found in the classpath, then an attempt is made to look in the JVM working directory.<a name="line.840"></a>
+<span class="sourceLineNo">841</span>    *<a name="line.841"></a>
+<span class="sourceLineNo">842</span>    * &lt;p&gt;<a name="line.842"></a>
+<span class="sourceLineNo">843</span>    * If the &lt;code&gt;locale&lt;/code&gt; is specified, then we look for resources whose name matches that locale.<a name="line.843"></a>
+<span class="sourceLineNo">844</span>    * For example, if looking for the resource &lt;js&gt;"MyResource.txt"&lt;/js&gt; for the Japanese locale, we will look for<a name="line.844"></a>
+<span class="sourceLineNo">845</span>    * files in the following order:<a name="line.845"></a>
+<span class="sourceLineNo">846</span>    * &lt;ol&gt;<a name="line.846"></a>
+<span class="sourceLineNo">847</span>    *    &lt;li&gt;&lt;js&gt;"MyResource_ja_JP.txt"&lt;/js&gt;<a name="line.847"></a>
+<span class="sourceLineNo">848</span>    *    &lt;li&gt;&lt;js&gt;"MyResource_ja.txt"&lt;/js&gt;<a name="line.848"></a>
+<span class="sourceLineNo">849</span>    *    &lt;li&gt;&lt;js&gt;"MyResource.txt"&lt;/js&gt;<a name="line.849"></a>
+<span class="sourceLineNo">850</span>    * &lt;/ol&gt;<a name="line.850"></a>
+<span class="sourceLineNo">851</span>    *<a name="line.851"></a>
+<span class="sourceLineNo">852</span>    * @param name The resource name.<a name="line.852"></a>
+<span class="sourceLineNo">853</span>    * @param locale Optional locale.<a name="line.853"></a>
+<span class="sourceLineNo">854</span>    * @return An input stream of the resource, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be found.<a name="line.854"></a>
+<span class="sourceLineNo">855</span>    * @throws IOException<a name="line.855"></a>
+<span class="sourceLineNo">856</span>    */<a name="line.856"></a>
+<span class="sourceLineNo">857</span>   protected InputStream getResource(String name, Locale locale) throws IOException {<a name="line.857"></a>
+<span class="sourceLineNo">858</span>      return resourceFinder.getResourceAsStream(name, locale);<a name="line.858"></a>
+<span class="sourceLineNo">859</span>   }<a name="line.859"></a>
+<span class="sourceLineNo">860</span><a name="line.860"></a>
+<span class="sourceLineNo">861</span>   /**<a name="line.861"></a>
+<span class="sourceLineNo">862</span>    * Reads the input stream from {@link #getResource(String, Locale)} into a String.<a name="line.862"></a>
+<span class="sourceLineNo">863</span>    *<a name="line.863"></a>
+<span class="sourceLineNo">864</span>    * @param name The resource name.<a name="line.864"></a>
+<span class="sourceLineNo">865</span>    * @param locale Optional locale.<a name="line.865"></a>
+<span class="sourceLineNo">866</span>    * @return The contents of the stream as a string, or &lt;jk&gt;null&lt;/jk&gt; if the resource could not be found.<a name="line.866"></a>
+<span class="sourceLineNo">867</span>    * @throws IOException If resource could not be found.<a name="line.867"></a>
+<span class="sourceLineNo">868</span>    */<a name="line.868"></a>
+<span class="sourceLineNo">869</span>   public String getResourceAsString(String name, Locale locale) throws IOException {<a name="line.869"></a>
+<span class="sourceLineNo">870</span>      return resourceFinder.getResourceAsString(name, locale);<a name="line.870"></a>
+<span class="sourceLineNo">871</span>   }<a name="line.871"></a>
+<span class="sourceLineNo">872</span><a name="line.872"></a>
+<span class="sourceLineNo">873</span>   /**<a name="line.873"></a>
+<span class="sourceLineNo">874</span>    * Reads the input stream from {@link #getResource(String, Locale)} and parses it into a POJO using the parser<a name="line.874"></a>
+<span class="sourceLin

<TRUNCATED>


Mime
View raw message