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<?>) {<a name="line.465"></a> <span class="sourceLineNo">466</span> Class<?> c = (Class<?>)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<?> oc = (Class<?>)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<?> oc = (Class<?>)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<String, CallRouter.Builder> 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<?>[] beanFilters;<a name="line.535"></a> -<span class="sourceLineNo">536</span> Class<?>[] pojoSwaps;<a name="line.536"></a> -<span class="sourceLineNo">537</span> Map<Class<?>,RestParam> paramResolvers = new HashMap<Class<?>,RestParam>();<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<MediaType> supportedContentTypes, supportedAcceptTypes;<a name="line.549"></a> -<span class="sourceLineNo">550</span> Map<String,String> defaultRequestHeaders = new TreeMap<String,String>(String.CASE_INSENSITIVE_ORDER);<a name="line.550"></a> -<span class="sourceLineNo">551</span> Map<String,Object> defaultResponseHeaders;<a name="line.551"></a> -<span class="sourceLineNo">552</span> BeanContext beanContext;<a name="line.552"></a> -<span class="sourceLineNo">553</span> List<RestConverter> converters = new ArrayList<RestConverter>();<a name="line.553"></a> -<span class="sourceLineNo">554</span> List<RestGuard> guards = new ArrayList<RestGuard>();<a name="line.554"></a> -<span class="sourceLineNo">555</span> List<ResponseHandler> responseHandlers = new ArrayList<ResponseHandler>();<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<String,String> 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<String> allowMethodParams = new LinkedHashSet<String>();<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<String,Widget> 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<String, CallRouter.Builder> 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<?>[] beanFilters;<a name="line.538"></a> +<span class="sourceLineNo">539</span> Class<?>[] pojoSwaps;<a name="line.539"></a> +<span class="sourceLineNo">540</span> Map<Class<?>,RestParam> paramResolvers = new HashMap<Class<?>,RestParam>();<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<MediaType> supportedContentTypes, supportedAcceptTypes;<a name="line.552"></a> +<span class="sourceLineNo">553</span> Map<String,String> defaultRequestHeaders = new TreeMap<String,String>(String.CASE_INSENSITIVE_ORDER);<a name="line.553"></a> +<span class="sourceLineNo">554</span> Map<String,Object> defaultResponseHeaders;<a name="line.554"></a> +<span class="sourceLineNo">555</span> BeanContext beanContext;<a name="line.555"></a> +<span class="sourceLineNo">556</span> List<RestConverter> converters = new ArrayList<RestConverter>();<a name="line.556"></a> +<span class="sourceLineNo">557</span> List<RestGuard> guards = new ArrayList<RestGuard>();<a name="line.557"></a> +<span class="sourceLineNo">558</span> List<ResponseHandler> responseHandlers = new ArrayList<ResponseHandler>();<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<String,String> 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<String> allowMethodParams = new LinkedHashSet<String>();<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<String,Widget> 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<Class<?>,RestResource> 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<?> 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<Class<?>,RestResource> e : restResourceAnnotationsChildFirst.entrySet()) {<a name="line.605"></a> -<span class="sourceLineNo">606</span> Class<?> 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<Class<?>,RestResource> 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<?> 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<Class<?>,RestResource> e : restResourceAnnotationsChildFirst.entrySet()) {<a name="line.608"></a> +<span class="sourceLineNo">609</span> Class<?> 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<String,Object>(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<String,Object>(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<Class<?>,String> p = (Pair<Class<?>,String>)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<String,String>();<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<Class<?>,String> p = (Pair<Class<?>,String>)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> * <p><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> * <h6 class='figure'>Example:</h6><a name="line.699"></a> -<span class="sourceLineNo">700</span> * <p class='bcode'><a name="line.700"></a> -<span class="sourceLineNo">701</span> * <ja>@RestResource</ja>(<a name="line.701"></a> -<span class="sourceLineNo">702</span> * messages=<js>"nls/Messages"</js>,<a name="line.702"></a> -<span class="sourceLineNo">703</span> * properties={<a name="line.703"></a> -<span class="sourceLineNo">704</span> * <ja>@Property</ja>(name=<js>"title"</js>,value=<js>"$L{title}"</js>), <jc>// Localized variable in Messages.properties</jc><a name="line.704"></a> -<span class="sourceLineNo">705</span> * <ja>@Property</ja>(name=<js>"javaVendor"</js>,value=<js>"$S{java.vendor,Oracle}"</js>), <jc>// System property with default value</jc><a name="line.705"></a> -<span class="sourceLineNo">706</span> * <ja>@Property</ja>(name=<js>"foo"</js>,value=<js>"bar"</js>),<a name="line.706"></a> -<span class="sourceLineNo">707</span> * <ja>@Property</ja>(name=<js>"bar"</js>,value=<js>"baz"</js>),<a name="line.707"></a> -<span class="sourceLineNo">708</span> * <ja>@Property</ja>(name=<js>"v1"</js>,value=<js>"$R{foo}"</js>), <jc>// Request variable. value="bar"</jc><a name="line.708"></a> -<span class="sourceLineNo">709</span> * <ja>@Property</ja>(name=<js>"v2"</js>,value=<js>"$R{$R{foo}}"</js>) <jc>// Nested request variable. value="baz"</jc><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> * <jk>public class</jk> MyRestResource <jk>extends</jk> RestServletDefault {<a name="line.712"></a> -<span class="sourceLineNo">713</span> * </p><a name="line.713"></a> -<span class="sourceLineNo">714</span> *<a name="line.714"></a> -<span class="sourceLineNo">715</span> * <p><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> * <p class='bcode'><a name="line.717"></a> -<span class="sourceLineNo">718</span> * <ja>@RestMethod</ja>(<a name="line.718"></a> -<span class="sourceLineNo">719</span> * name=<js>"GET"</js>, path=<js>"/{name}/*"</js>,<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> * <js>"up: $R{requestParentURI}"</js>,<a name="line.722"></a> -<span class="sourceLineNo">723</span> * <js>"options: servlet:/?method=OPTIONS"</js>,<a name="line.723"></a> -<span class="sourceLineNo">724</span> * <js>"editLevel: servlet:/editLevel?logger=$A{attribute.name, OFF}"</js><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> * <js>"&lt;h1&gt;$L{MyLocalizedPageTitle}&lt;/h1&gt;"</js><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> * <js>"$F{resources/AsideText.html}"</js><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> * <jk>public</jk> LoggerEntry getLogger(RestRequest req, <ja>@Path</ja> String name) <jk>throws</jk> Exception {<a name="line.734"></a> -<span class="sourceLineNo">735</span> * </p><a name="line.735"></a> -<span class="sourceLineNo">736</span> *<a name="line.736"></a> -<span class="sourceLineNo">737</span> * <p><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> * <ul><a name="line.739"></a> -<span class="sourceLineNo">740</span> * <li><code>$C{key[,defaultValue]}</code> - Config file entry. See {@link ConfigFileVar}.<a name="line.740"></a> -<span class="sourceLineNo">741</span> * <li><code>$E{envVar[,defaultValue]}</code> - Environment variable. See {@link EnvVariablesVar}.<a name="line.741"></a> -<span class="sourceLineNo">742</span> * <li><code>$F{path[,defaultValue]}</code> - File resource. See {@link FileVar}.<a name="line.742"></a> -<span class="sourceLineNo">743</span> * <li><code>$I{name[,defaultValue]}</code> - Servlet init parameter. See {@link ServletInitParamVar}.<a name="line.743"></a> -<span class="sourceLineNo">744</span> * <li><code>$L{key[,args...]}</code> - Localized message. See {@link LocalizationVar}.<a name="line.744"></a> -<span class="sourceLineNo">745</span> * <li><code>$R{key[,args...]}</code> - Request variable. See {@link RequestVar}.<a name="line.745"></a> -<span class="sourceLineNo">746</span> * <li><code>$S{systemProperty[,defaultValue]}</code> - System property. See {@link SystemPropertiesVar}.<a name="line.746"></a> -<span class="sourceLineNo">747</span> * <li><code>$SA{contentType,key[,defaultValue]}</code> - Serialized request attribute. See {@link SerializedRequestAttrVar}.<a name="line.747"></a> -<span class="sourceLineNo">748</span> * <li><code>$U{uri}</code> - URI resolver. See {@link UrlVar}.<a name="line.748"></a> -<span class="sourceLineNo">749</span> * <li><code>$UE{uriPart}</code> - URL-Encoder. See {@link UrlEncodeVar}.<a name="line.749"></a> -<span class="sourceLineNo">750</span> * <li><code>$W{widgetName}</code> - HTML widget variable. See {@link WidgetVar}.<a name="line.750"></a> -<span class="sourceLineNo">751</span> * </ul><a name="line.751"></a> -<span class="sourceLineNo">752</span> *<a name="line.752"></a> -<span class="sourceLineNo">753</span> * <p><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> * <ul><a name="line.755"></a> -<span class="sourceLineNo">756</span> * <li><code>$IF{booleanArg,thenValue[,elseValue]}</code> - If/else variable. See {@link IfVar}.<a name="line.756"></a> -<span class="sourceLineNo">757</span> * <li><code>$SW{stringArg(,pattern,thenValue)+[,elseValue]}</code> - Switch variable. See {@link SwitchVar}.<a name="line.757"></a> -<span class="sourceLineNo">758</span> * </ul><a name="line.758"></a> -<span class="sourceLineNo">759</span> *<a name="line.759"></a> -<span class="sourceLineNo">760</span> * <p><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> * <code>Resource</code> 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> * <p><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> * <ul><a name="line.776"></a> -<span class="sourceLineNo">777</span> * <li>{@link RestResource#config() @RestResource.config()} annotation.<a name="line.777"></a> -<span class="sourceLineNo">778</span> * <li>{@link RestConfig#setConfigFile(ConfigFile)} method.<a name="line.778"></a> -<span class="sourceLineNo">779</span> * </ul><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 <jk>null</jk>.<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> * <p><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> * <ul><a name="line.792"></a> -<span class="sourceLineNo">793</span> * <li>{@link RestResource#staticFiles() @RestResource.staticFiles()} annotation.<a name="line.793"></a> -<span class="sourceLineNo">794</span> * <li>{@link RestConfig#addStaticFiles(Class, String)} method.<a name="line.794"></a> -<span class="sourceLineNo">795</span> * </ul><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 <jk>null</jk> 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<String,String> 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> * <p><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<Class<?>,String> p = (Pair<Class<?>,String>)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<String,String>();<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<Class<?>,String> p = (Pair<Class<?>,String>)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> * <p><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> * <h6 class='figure'>Example:</h6><a name="line.702"></a> +<span class="sourceLineNo">703</span> * <p class='bcode'><a name="line.703"></a> +<span class="sourceLineNo">704</span> * <ja>@RestResource</ja>(<a name="line.704"></a> +<span class="sourceLineNo">705</span> * messages=<js>"nls/Messages"</js>,<a name="line.705"></a> +<span class="sourceLineNo">706</span> * properties={<a name="line.706"></a> +<span class="sourceLineNo">707</span> * <ja>@Property</ja>(name=<js>"title"</js>,value=<js>"$L{title}"</js>), <jc>// Localized variable in Messages.properties</jc><a name="line.707"></a> +<span class="sourceLineNo">708</span> * <ja>@Property</ja>(name=<js>"javaVendor"</js>,value=<js>"$S{java.vendor,Oracle}"</js>), <jc>// System property with default value</jc><a name="line.708"></a> +<span class="sourceLineNo">709</span> * <ja>@Property</ja>(name=<js>"foo"</js>,value=<js>"bar"</js>),<a name="line.709"></a> +<span class="sourceLineNo">710</span> * <ja>@Property</ja>(name=<js>"bar"</js>,value=<js>"baz"</js>),<a name="line.710"></a> +<span class="sourceLineNo">711</span> * <ja>@Property</ja>(name=<js>"v1"</js>,value=<js>"$R{foo}"</js>), <jc>// Request variable. value="bar"</jc><a name="line.711"></a> +<span class="sourceLineNo">712</span> * <ja>@Property</ja>(name=<js>"v2"</js>,value=<js>"$R{$R{foo}}"</js>) <jc>// Nested request variable. value="baz"</jc><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> * <jk>public class</jk> MyRestResource <jk>extends</jk> RestServletDefault {<a name="line.715"></a> +<span class="sourceLineNo">716</span> * </p><a name="line.716"></a> +<span class="sourceLineNo">717</span> *<a name="line.717"></a> +<span class="sourceLineNo">718</span> * <p><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> * <p class='bcode'><a name="line.720"></a> +<span class="sourceLineNo">721</span> * <ja>@RestMethod</ja>(<a name="line.721"></a> +<span class="sourceLineNo">722</span> * name=<js>"GET"</js>, path=<js>"/{name}/*"</js>,<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> * <js>"up: $R{requestParentURI}"</js>,<a name="line.725"></a> +<span class="sourceLineNo">726</span> * <js>"options: servlet:/?method=OPTIONS"</js>,<a name="line.726"></a> +<span class="sourceLineNo">727</span> * <js>"editLevel: servlet:/editLevel?logger=$A{attribute.name, OFF}"</js><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> * <js>"&lt;h1&gt;$L{MyLocalizedPageTitle}&lt;/h1&gt;"</js><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> * <js>"$F{resources/AsideText.html}"</js><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> * <jk>public</jk> LoggerEntry getLogger(RestRequest req, <ja>@Path</ja> String name) <jk>throws</jk> Exception {<a name="line.737"></a> +<span class="sourceLineNo">738</span> * </p><a name="line.738"></a> +<span class="sourceLineNo">739</span> *<a name="line.739"></a> +<span class="sourceLineNo">740</span> * <p><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> * <ul><a name="line.742"></a> +<span class="sourceLineNo">743</span> * <li><code>$C{key[,defaultValue]}</code> - Config file entry. See {@link ConfigFileVar}.<a name="line.743"></a> +<span class="sourceLineNo">744</span> * <li><code>$E{envVar[,defaultValue]}</code> - Environment variable. See {@link EnvVariablesVar}.<a name="line.744"></a> +<span class="sourceLineNo">745</span> * <li><code>$F{path[,defaultValue]}</code> - File resource. See {@link FileVar}.<a name="line.745"></a> +<span class="sourceLineNo">746</span> * <li><code>$I{name[,defaultValue]}</code> - Servlet init parameter. See {@link ServletInitParamVar}.<a name="line.746"></a> +<span class="sourceLineNo">747</span> * <li><code>$L{key[,args...]}</code> - Localized message. See {@link LocalizationVar}.<a name="line.747"></a> +<span class="sourceLineNo">748</span> * <li><code>$R{key[,args...]}</code> - Request variable. See {@link RequestVar}.<a name="line.748"></a> +<span class="sourceLineNo">749</span> * <li><code>$S{systemProperty[,defaultValue]}</code> - System property. See {@link SystemPropertiesVar}.<a name="line.749"></a> +<span class="sourceLineNo">750</span> * <li><code>$SA{contentType,key[,defaultValue]}</code> - Serialized request attribute. See {@link SerializedRequestAttrVar}.<a name="line.750"></a> +<span class="sourceLineNo">751</span> * <li><code>$U{uri}</code> - URI resolver. See {@link UrlVar}.<a name="line.751"></a> +<span class="sourceLineNo">752</span> * <li><code>$UE{uriPart}</code> - URL-Encoder. See {@link UrlEncodeVar}.<a name="line.752"></a> +<span class="sourceLineNo">753</span> * <li><code>$W{widgetName}</code> - HTML widget variable. See {@link WidgetVar}.<a name="line.753"></a> +<span class="sourceLineNo">754</span> * </ul><a name="line.754"></a> +<span class="sourceLineNo">755</span> *<a name="line.755"></a> +<span class="sourceLineNo">756</span> * <p><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> * <ul><a name="line.758"></a> +<span class="sourceLineNo">759</span> * <li><code>$IF{booleanArg,thenValue[,elseValue]}</code> - If/else variable. See {@link IfVar}.<a name="line.759"></a> +<span class="sourceLineNo">760</span> * <li><code>$SW{stringArg(,pattern,thenValue)+[,elseValue]}</code> - Switch variable. See {@link SwitchVar}.<a name="line.760"></a> +<span class="sourceLineNo">761</span> * </ul><a name="line.761"></a> +<span class="sourceLineNo">762</span> *<a name="line.762"></a> +<span class="sourceLineNo">763</span> * <p><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> * <code>Resource</code> 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> * <p><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> * <ul><a name="line.779"></a> +<span class="sourceLineNo">780</span> * <li>{@link RestResource#config() @RestResource.config()} annotation.<a name="line.780"></a> +<span class="sourceLineNo">781</span> * <li>{@link RestConfig#setConfigFile(ConfigFile)} method.<a name="line.781"></a> +<span class="sourceLineNo">782</span> * </ul><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 <jk>null</jk>.<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> * <p><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> * <ul><a name="line.795"></a> +<span class="sourceLineNo">796</span> * <li>{@link RestResource#staticFiles() @RestResource.staticFiles()} annotation.<a name="line.796"></a> +<span class="sourceLineNo">797</span> * <li>{@link RestConfig#addStaticFiles(Class, String)} method.<a name="line.797"></a> +<span class="sourceLineNo">798</span> * </ul><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 <jk>null</jk> 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<String,String> 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> * <p><a name="line.839"></a> -<span class="sourceLineNo">840</span> * If the <code>locale</code> 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 <js>"MyResource.txt"</js> 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> * <ol><a name="line.843"></a> -<span class="sourceLineNo">844</span> * <li><js>"MyResource_ja_JP.txt"</js><a name="line.844"></a> -<span class="sourceLineNo">845</span> * <li><js>"MyResource_ja.txt"</js><a name="line.845"></a> -<span class="sourceLineNo">846</span> * <li><js>"MyResource.txt"</js><a name="line.846"></a> -<span class="sourceLineNo">847</span> * </ol><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 <jk>null</jk> 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 <jk>null</jk> 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> * <p><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> * <p><a name="line.842"></a> +<span class="sourceLineNo">843</span> * If the <code>locale</code> 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 <js>"MyResource.txt"</js> 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> * <ol><a name="line.846"></a> +<span class="sourceLineNo">847</span> * <li><js>"MyResource_ja_JP.txt"</js><a name="line.847"></a> +<span class="sourceLineNo">848</span> * <li><js>"MyResource_ja.txt"</js><a name="line.848"></a> +<span class="sourceLineNo">849</span> * <li><js>"MyResource.txt"</js><a name="line.849"></a> +<span class="sourceLineNo">850</span> * </ol><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 <jk>null</jk> 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 <jk>null</jk> 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>
