com.github.jknack.handlebars

Class Context

java.lang.Object

com.github.jknack.handlebars.Context

public class Context
extends Object

Mustache/Handlebars are contextual template engines. This class represent the 'context stack' of a template.

• Objects and hashes should be pushed onto the context stack.
• All elements on the context stack should be accessible.
• Multiple sections per template should be permitted.
• Failed context lookups should be considered falsy.
• Dotted names should be valid for Section tags.
• Dotted names that cannot be resolved should be considered falsy.
• Dotted Names - Context Precedence: Dotted names should be resolved against former resolutions.

Since:

0.1.0

Author:

edgar.espina

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Context.Builder A context builder.

Field Summary

Fields

Modifier and Type	Field and Description
static String	INVOCATION_STACK The qualified name for partials.
static String	PARAM_SIZE Number of parameters of a helper.
static String	PARTIALS The qualified name for partials.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Context(Object model) Creates a new context.

Method Summary

Methods

Modifier and Type	Method and Description
Context	data(Map<String,?> attributes) Store the map in the data storage.
<T> T	data(String name) Read the attribute from the data storage.
Context	data(String name, Object value) Set an attribute in the data storage.
void	destroy() Destroy this context by cleaning up instance attributes.
Object	get(String key) Lookup the given key inside the context stack.
Object	model() Resolved as '.' or 'this' inside templates.
static Context.Builder	newBuilder(Context parent, Object model) Start a new context builder.
static Context.Builder	newBuilder(Object model) Start a new context builder.
static Context	newContext(Context parent, Object model) Creates a new child context.
static Context	newContext(Object model) Creates a new root context.
Context	parent() The parent context or null.
Set<Map.Entry<String,Object>>	propertySet() List all the properties and values of model().
Set<Map.Entry<String,Object>>	propertySet(Object context) List all the properties and values for the given object.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

PARTIALS

public static final String PARTIALS

The qualified name for partials. Internal use.

INVOCATION_STACK

public static final String INVOCATION_STACK

The qualified name for partials. Internal use.

PARAM_SIZE

public static final String PARAM_SIZE

Number of parameters of a helper. Internal use.

Constructor Detail

Context

protected Context(Object model)

Creates a new context.

Parameters:

model - The target value. Resolved as '.' or 'this' inside templates. Required.

Method Detail

data

public <T> T data(String name)

Read the attribute from the data storage.

Type Parameters:

T - Data type.

Parameters:

name - The attribute's name.

Returns:

The attribute value or null.

data

public Context data(String name,
           Object value)

Set an attribute in the data storage.

Parameters:

name - The attribute's name. Required.

value - The attribute's value. Required.

Returns:

This context.

data

public Context data(Map<String,?> attributes)

Store the map in the data storage.

Parameters:

attributes - The attributes to add. Required.

Returns:

This context.

model

public Object model()

Resolved as '.' or 'this' inside templates.

Returns:

The model or data.

parent

public Context parent()

The parent context or null.

Returns:

The parent context or null.

propertySet

public Set<Map.Entry<String,Object>> propertySet(Object context)

List all the properties and values for the given object.

Parameters:

context - The context object.

Returns:

All the properties and values for the given object.

propertySet

public Set<Map.Entry<String,Object>> propertySet()

List all the properties and values of model().

Returns:

All the properties and values of model().

get

public Object get(String key)

Lookup the given key inside the context stack.

• Objects and hashes should be pushed onto the context stack.
• All elements on the context stack should be accessible.
• Multiple sections per template should be permitted.
• Failed context lookups should be considered falsey.
• Dotted names should be valid for Section tags.
• Dotted names that cannot be resolved should be considered falsey.
• Dotted Names - Context Precedence: Dotted names should be resolved against former resolutions.

Parameters:

key - The object key.

Returns:

The value associated to the given key or null if no value is found.

destroy

public void destroy()

Destroy this context by cleaning up instance attributes.

toString

public String toString()

Overrides:

toString in class Object

newBuilder

public static Context.Builder newBuilder(Context parent,
                         Object model)

Start a new context builder.

Parameters:

parent - The parent context. Required.

model - The model data.

Returns:

A new context builder.

newBuilder

public static Context.Builder newBuilder(Object model)

Start a new context builder.

Parameters:

model - The model data.

Returns:

A new context builder.

newContext

public static Context newContext(Context parent,
                 Object model)

Creates a new child context.

Parameters:

parent - The parent context. Required.

model - The model data.

Returns:

A new child context.

newContext

public static Context newContext(Object model)

Creates a new root context.

Parameters:

model - The model data.

Returns:

A new root context.