com.github.mustachejava

Class DefaultMustacheFactory

java.lang.Object

com.github.mustachejava.DefaultMustacheFactory

All Implemented Interfaces:

MustacheFactory

Direct Known Subclasses:

DeferringMustacheFactory, FallbackMustacheFactory

public class DefaultMustacheFactory
extends Object
implements MustacheFactory

Simplest possible code factory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DefaultMustacheFactory.FragmentCacheLoader
protected class	DefaultMustacheFactory.MustacheCacheLoader

Field Summary

Fields

Modifier and Type	Field and Description
protected com.google.common.util.concurrent.ListeningExecutorService	les
protected MustacheParser	mc This parser should work with any MustacheFactory
protected com.google.common.cache.LoadingCache<String,Mustache>	mustacheCache Create the default cache for mustache compilations.
protected ObjectHandler	oh This is the default object handler.
protected int	recursionLimit
protected com.google.common.cache.LoadingCache<FragmentKey,Mustache>	templateCache New templates that are generated at runtime are cached here.

Constructor Summary

Constructors

Constructor and Description
DefaultMustacheFactory()
DefaultMustacheFactory(File fileRoot) Use the file system to resolve mustache templates.
DefaultMustacheFactory(String resourceRoot) Use the classpath to resolve mustache templates.

Method Summary

Methods

Modifier and Type	Method and Description
Mustache	compile(Reader reader, String name) Create a mustache given a reader and a name.
Mustache	compile(Reader reader, String file, String sm, String em)
Mustache	compile(String name) Create a mustache given a resource name.
Mustache	compilePartial(String s) In order to handle recursion, we need a temporary thread local cache during compilation that is ultimately thrown away after the top level partial is complete.
protected com.google.common.cache.LoadingCache<FragmentKey,Mustache>	createLambdaCache()
protected com.google.common.cache.LoadingCache<String,Mustache>	createMustacheCache()
MustacheVisitor	createMustacheVisitor() Creates the visitor for compilation.
void	encode(String value, Writer writer) This defines how "encoded" values are encoded.
String	filterText(String appended, boolean b) Override this method to apply any filtering to text that will appear verbatim in the output template.
ExecutorService	getExecutorService() There is an ExecutorService that is used when executing parallel operations when a Callable is returned from a mustache value or iterable.
Mustache	getFragment(FragmentKey templateKey)
ObjectHandler	getObjectHandler() The object handler knows how to transform names into fields and methods.
Reader	getReader(String resourceName) Given a resource name, construct a reader.
int	getRecursionLimit()
String	resolvePartialPath(String dir, String name, String extension)
void	setExecutorService(ExecutorService es) If you need to specify your own executor service you can.
void	setObjectHandler(ObjectHandler oh) You can override the default object handler post construction.
void	setRecursionLimit(int recursionLimit) Maximum recursion limit for partials.
String	translate(String from) Converts your arbitrary name to another name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mustacheCache

protected final com.google.common.cache.LoadingCache<String,Mustache> mustacheCache

Create the default cache for mustache compilations. This is basically required by the specification to handle recursive templates.

oh

protected ObjectHandler oh

This is the default object handler.

mc

protected final MustacheParser mc

This parser should work with any MustacheFactory

templateCache

protected final com.google.common.cache.LoadingCache<FragmentKey,Mustache> templateCache

New templates that are generated at runtime are cached here. The template key includes the text of the template and the context so we get proper error messages and debugging information.

recursionLimit

protected int recursionLimit

les

protected com.google.common.util.concurrent.ListeningExecutorService les

Constructor Detail

DefaultMustacheFactory

public DefaultMustacheFactory()

DefaultMustacheFactory

public DefaultMustacheFactory(String resourceRoot)

Use the classpath to resolve mustache templates.

Parameters:

resourceRoot -

DefaultMustacheFactory

public DefaultMustacheFactory(File fileRoot)

Use the file system to resolve mustache templates.

Parameters:

fileRoot -

Method Detail

resolvePartialPath

public String resolvePartialPath(String dir,
                        String name,
                        String extension)

createMustacheVisitor

public MustacheVisitor createMustacheVisitor()

Description copied from interface: MustacheFactory

Creates the visitor for compilation.

Specified by:

createMustacheVisitor in interface MustacheFactory

Returns:

visitor

getReader

public Reader getReader(String resourceName)

Description copied from interface: MustacheFactory

Given a resource name, construct a reader.

Specified by:

getReader in interface MustacheFactory

Parameters:

resourceName - used to find the resource

Returns:

a reader

encode

public void encode(String value,
          Writer writer)

Description copied from interface: MustacheFactory

This defines how "encoded" values are encoded. It defaults to something appropriate for HTML output.

Specified by:

encode in interface MustacheFactory

Parameters:

value - the unencoded value

writer - where to encode the value

getObjectHandler

public ObjectHandler getObjectHandler()

Description copied from interface: MustacheFactory

The object handler knows how to transform names into fields and methods.

Specified by:

getObjectHandler in interface MustacheFactory

Returns:

the handler

setObjectHandler

public void setObjectHandler(ObjectHandler oh)

You can override the default object handler post construction.

Parameters:

oh -

getExecutorService

public ExecutorService getExecutorService()

There is an ExecutorService that is used when executing parallel operations when a Callable is returned from a mustache value or iterable.

Returns:

setExecutorService

public void setExecutorService(ExecutorService es)

If you need to specify your own executor service you can.

Parameters:

es -

getFragment

public Mustache getFragment(FragmentKey templateKey)

compile

public Mustache compile(String name)

Description copied from interface: MustacheFactory

Create a mustache given a resource name.

Specified by:

compile in interface MustacheFactory

Parameters:

name - the name of the resource

Returns:

the compiled mustache

compile

public Mustache compile(Reader reader,
               String name)

Description copied from interface: MustacheFactory

Create a mustache given a reader and a name.

Specified by:

compile in interface MustacheFactory

Parameters:

reader - the reader

name - the name of the resource

Returns:

the compiled mustache

compile

public Mustache compile(Reader reader,
               String file,
               String sm,
               String em)

translate

public String translate(String from)

Description copied from interface: MustacheFactory

Converts your arbitrary name to another name.

Specified by:

translate in interface MustacheFactory

Parameters:

from - the tag to replace

Returns:

the new tag

filterText

public String filterText(String appended,
                boolean b)

Override this method to apply any filtering to text that will appear verbatim in the output template.

Parameters:

appended -

b -

Returns:

setRecursionLimit

public void setRecursionLimit(int recursionLimit)

Maximum recursion limit for partials.

getRecursionLimit

public int getRecursionLimit()

compilePartial

public Mustache compilePartial(String s)

In order to handle recursion, we need a temporary thread local cache during compilation that is ultimately thrown away after the top level partial is complete.

Parameters:

s -

Returns:

createMustacheCache

protected com.google.common.cache.LoadingCache<String,Mustache> createMustacheCache()

createLambdaCache

protected com.google.common.cache.LoadingCache<FragmentKey,Mustache> createLambdaCache()