xapi.source.write

Class Template

java.lang.Object

xapi.source.write.Template

Direct Known Subclasses:

MappedTemplate

public class Template
extends Object

A fast, lightweight string templating system with zero dependencies.

You supply a template String and an array of tokens to replace when calling #apply(String...). The order of tokens supplied in the constructor corresponds to the order of strings supplied in apply().

The Template will compile your string into an executable stack, which generates output with extreme efficiency; the only string-matching performed is during Template compile, and it processes all tokens in a single, efficient iteration of the template String.

This ensures an absolute minimum of processing, and allows large templates with a large number of replacements to scale nicely.

Usage:

 assert
 new Template("$1, $2!", "$1", "$2")
 .apply("Hello", "World")
 .equals("Hello, World!");

 assert
 new Template("(*[])$.toArray(new Object[$.size()])", "*", "$")
 .apply("Callable<String>", "myList")
 .equals("(Callable<String>[])myList.toArray(new Object[myList.size()])");
 

Author:

"James X. Nelson (james@wetheinter.net)"

Constructor Summary

Constructors

Constructor and Description
Template(String template, Iterable<String> replaceables)
Template(String template, String... replaceables)

Method Summary

Modifier and Type	Method and Description
String	apply(Object... args) Applies the current template to the supplied arguments.
void	setToStringer(ToStringer toString)
protected static String[]	toArray(Iterable<String> items)

Methods inherited from class java.lang.Object

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

Constructor Detail

Template

public Template(String template,
                String... replaceables)

Template

public Template(String template,
                Iterable<String> replaceables)

Method Detail

toArray

protected static String[] toArray(Iterable<String> items)

setToStringer

public void setToStringer(ToStringer toString)

apply

public String apply(Object... args)

Applies the current template to the supplied arguments.