Package io.github.erdos.stencil

Class API

java.lang.Object

io.github.erdos.stencil.API

public final class API
extends Object

Method Summary

Modifier and Type	Method	Description
static PreparedFragment	fragment(File fragmentFile)
static PreparedFragment	fragment(File fragmentFile, PrepareOptions options)	Prepares a document fragment from the file system.
static PreparedTemplate	prepare(File templateFile)	Prepares a document template file from the file system.
static PreparedTemplate	prepare(File templateFile, PrepareOptions options)	Prepares a document template file from the file system.
static EvaluatedDocument	render(PreparedTemplate template, TemplateData data)
static EvaluatedDocument	render(PreparedTemplate template, Map<String,PreparedFragment> fragments, TemplateData data)
static EvaluatedDocument	render(PreparedTemplate template, Map<String,PreparedFragment> fragments, TemplateData data, Collection<Function> customFunctions)

Methods inherited from class java.lang.Object

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

Method Details

prepare

public static PreparedTemplate prepare(File templateFile)
                                throws IOException

Prepares a document template file from the file system.

Throws:

IOException

prepare

public static PreparedTemplate prepare(File templateFile,
 PrepareOptions options)
                                throws IOException

Prepares a document template file from the file system.

Throws:

IOException

fragment

public static PreparedFragment fragment(File fragmentFile,
 PrepareOptions options)
                                 throws IOException

Prepares a document fragment from the file system. Fragments can be used to embed extra content when rendering document templates. For example, custom headers and footers can be reused across documents this way.

Parameters:

fragmentFile - template file from file system to be used as document fragment

Returns:

fragment instance, not null

Throws:

IllegalArgumentException - when fragmentFile is null

IOException - on file system error

FileNotFoundException - when file is not found on file system

fragment

public static PreparedFragment fragment(File fragmentFile)
                                 throws IOException

Throws:

IOException

render

public static EvaluatedDocument render(PreparedTemplate template,
 TemplateData data)

render

public static EvaluatedDocument render(PreparedTemplate template,
 Map<String,PreparedFragment> fragments,
 TemplateData data)

render

public static EvaluatedDocument render(PreparedTemplate template,
 Map<String,PreparedFragment> fragments,
 TemplateData data,
 Collection<Function> customFunctions)