Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   * Copyright 2014 Attila Szegedi, Daniel Dekany, Jonathan Revusky
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
 package freemarker.cache;
Finds the TemplateLoader-level (storage-level) template source for the template name witch which the template was requested (as in freemarker.template.Configuration.getTemplate(java.lang.String)). This usually means trying various TemplateLoader-level template names (so called source names; see also freemarker.template.Template.getSourceName()) that were deduced from the requested name. Trying a name usually means calling TemplateLookupContext.lookupWithAcquisitionStrategy(java.lang.String) with it and checking the value of TemplateLookupResult.isPositive().

Before you write your own lookup strategy, know that:

  • A template lookup strategy meant to operate solely with template names, not with TemplateLoader-s directly. Basically, it's a mapping between the template names that templates and API-s like freemarker.template.Configuration.getTemplate(java.lang.String) see, and those that the underlying TemplateLoader sees.
  • A template lookup strategy doesn't influence the template's name (freemarker.template.Template.getName()), which is the normalized form of the template name as it was requested (with freemarker.template.Configuration.getTemplate(java.lang.String), etc.). It only influences the so called source name of the template (freemarker.template.Template.getSourceName()). The template's name is used as the basis for resolving relative inclusions/imports in the template. The source name is pretty much only used in error messages as error location, and of course, to actually load the template "file".
  • Understand the impact of the last point if your template lookup strategy fiddles not only with the file name part of the template name, but also with the directory part. For example, one may want to map "foo.ftl" to "en/foo.ftl", "fr/foo.ftl", etc. That's legal, but the result is kind of like if you had several root directories ("en/", "fr/", etc.) that are layered over each other to form a single merged directory. (This is what's desirable in typical applications, yet it can be confusing.)

 public abstract class TemplateLookupStrategy {


The default lookup strategy of FreeMarker.

Through an example: Assuming localized lookup is enabled and that a template is requested for the name example.ftl and Locale("es", "ES", "Traditional_WIN"), it will try the following template names, in this order: "foo_en_AU_Traditional_WIN.ftl", "foo_en_AU_Traditional.ftl", "foo_en_AU.ftl", "foo_en.ftl", "foo.ftl". It stops at the first variation where it finds a template. (If the template name contains "*" steps, finding the template for the attempted localized variation happens with the template acquisition mechanism.) If localized lookup is disabled, it won't try to add any locale strings, so it just looks for "foo.ftl".

The generation of the localized name variation with the default lookup strategy, happens like this: It removes the file extension (the part starting with the last dot), then appends java.util.Locale.toString() after it, and puts back the extension. Then it starts to remove the parts from the end of the locale, considering "_" as the separator between the parts. It won't remove parts that are not part of the locale string (like if the requested template name is foo_bar.ftl, it won't remove the "_bar").

     public static final TemplateLookupStrategy DEFAULT_2_3_0 = new Default020300();
Finds the template source that matches the template name, locale (if not null) and other parameters specified in the TemplateLookupContext. See also the class-level TemplateLookupStrategy documentation to understand lookup strategies more.

ctx Contains the parameters for which the matching template need to be found, and operations that are needed to implement the strategy. Some of the important input parameters are: TemplateLookupContext.getTemplateName(), TemplateLookupContext.getTemplateLocale(). The most important operations are TemplateLookupContext.lookupWithAcquisitionStrategy(java.lang.String) and TemplateLookupContext.createNegativeLookupResult(). (Note that you deliberately can't use TemplateLoader-s directly to implement lookup.)
Usually the return value of TemplateLookupContext.lookupWithAcquisitionStrategy(java.lang.String), or TemplateLookupContext#createNegativeLookupResult() if no matching template exists. Can't be null.
     public abstract TemplateLookupResult lookup(TemplateLookupContext ctxthrows IOException;
     private static class Default020300 extends TemplateLookupStrategy {
        public TemplateLookupResult lookup(TemplateLookupContext ctxthrows IOException {
            return ctx.lookupWithLocalizedThenAcquisitionStrategy(ctx.getTemplateName(), ctx.getTemplateLocale());
        public String toString() {
            return "TemplateLookupStrategy.DEFAULT_2_3_0";
New to GrepCode? Check out our FAQ X