com.google.template.soy.parsepasses.contextautoesc

Class ContextualAutoescaper

java.lang.Object

com.google.template.soy.parsepasses.contextautoesc.ContextualAutoescaper

public final class ContextualAutoescaper
extends Object

Inserts directives into print commands by looking at the context in which a print appears, and derives templates and rewrites calls so that each template is entered only in contexts consistent with its escaping conventions.

E.g. it will rewrite

{template example autoescape="contextual"} <p>Hello, {$world}! {/template} to {template example autoescape="contextual"} <p>Hello, {$world |escapeHtml}! {/template}

Constructor Summary

Constructors

Constructor and Description
ContextualAutoescaper(com.google.common.collect.ImmutableMap<String,? extends SoyPrintDirective> soyDirectivesMap) This injected ctor provides a blank constructor that is filled, in normal compiler operation, with the core and basic directives defined in com.google.template.soy.{basic,core}directives, and any custom directives supplied on the command line.

Method Summary

Modifier and Type	Method and Description
Context	getTemplateEndContext(String templateName) Null if no typing has been done for the named template, or otherwise the context after a call to the named template.
List<TemplateNode>	rewrite(SoyFileSetNode fileSet, ErrorReporter errorReporter) Rewrites the given Soy files so that dynamic output is properly escaped according to the context in which it appears.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContextualAutoescaper

public ContextualAutoescaper(com.google.common.collect.ImmutableMap<String,? extends SoyPrintDirective> soyDirectivesMap)

This injected ctor provides a blank constructor that is filled, in normal compiler operation, with the core and basic directives defined in com.google.template.soy.{basic,core}directives, and any custom directives supplied on the command line.

Parameters:

soyDirectivesMap - Map of all SoyPrintDirectives (name to directive) such that soyDirectivesMap.get(key).getName().equals(key) for all key in soyDirectivesMap.keySet().

Method Detail

rewrite

public List<TemplateNode> rewrite(SoyFileSetNode fileSet,
                                  ErrorReporter errorReporter)

Rewrites the given Soy files so that dynamic output is properly escaped according to the context in which it appears.

Parameters:

fileSet - Modified in place.

Returns:

Extra templates which were derived from templates under fileSet and which must be compiled with fileSet to produce a correct output. See DerivedTemplateUtils for an explanation of these.

getTemplateEndContext

public Context getTemplateEndContext(String templateName)

Null if no typing has been done for the named template, or otherwise the context after a call to the named template. Since we derive templates by start context at the call site, there is no start context parameter.

Parameters:

templateName - A qualified template name.