Add means to obtain parent context(s) in Fragment.

Closes #77.
This commit is contained in:
Michael Bayne
2016-05-15 11:06:58 -07:00
parent 06347ba7eb
commit 115f496947
@@ -40,12 +40,6 @@ public class Template
* the variable context that was in effect at the time the lambda was called.
*/
public abstract class Fragment {
/** Returns the context object in effect for this fragment. The actual type of the object
* depends on the structure of the data passed to the top-level template. You know where
* your lambdas are executed, so you know what type to which to cast the context in order
* to inspect it (be that a {@code Map} or a POJO or something else). */
public abstract Object context ();
/** Executes this fragment; writes its result to {@code out}. */
public abstract void execute (Writer out);
@@ -68,6 +62,19 @@ public class Template
return out.toString();
}
/** Returns the context object in effect for this fragment. The actual type of the object
* depends on the structure of the data passed to the top-level template. You know where
* your lambdas are executed, so you know what type to which to cast the context in order
* to inspect it (be that a {@code Map} or a POJO or something else). */
public abstract Object context ();
/** Like {@link #context()} btu returns the {@code n}th parent context object. {@code 0}
* returns the same value as {@link #context()}, {@code 1} returns the parent context,
* {@code 2} returns the grandparent and so forth. Note that if you request a parent that
* does not exist an exception will be thrown. You should only use this method when you
* know your lambda is run consistently in a context with a particular lineage. */
public abstract Object context (int n);
/** Decompiles the template inside this lamdba and returns <em>an approximation</em> of
* the original template from which it was parsed. This is not the exact character for
* character representation because the original text is not preserved because that would
@@ -146,19 +153,25 @@ public class Template
protected Fragment createFragment (final Segment[] segs, final Context currentCtx) {
return new Fragment() {
@Override public Object context () {
return currentCtx.data;
}
@Override public void execute (Writer out) {
execute(currentCtx, out);
}
@Override public void execute (Object context, Writer out) {
execute(currentCtx.nest(context, 0, false, false), out);
}
@Override public Object context () {
return currentCtx.data;
}
@Override public Object context (int n) {
return context(currentCtx, n);
}
@Override public StringBuilder decompile (StringBuilder into) {
for (Segment seg : segs) seg.decompile(_compiler.delims, into);
return into;
}
private Object context (Context ctx, int n) {
return (n == 0) ? ctx.data : context(ctx.parent, n-1);
}
private void execute (Context ctx, Writer out) {
for (Segment seg : segs) {
seg.execute(Template.this, ctx, out);