ninja.template

Class TemplateEngineJsonP

java.lang.Object

ninja.template.TemplateEngineJsonP

All Implemented Interfaces:

TemplateEngine

public class TemplateEngineJsonP
extends java.lang.Object
implements TemplateEngine

JSONP engine. Outputs the given result as JSONP output: Javascript callback with data as a parameter. Contains JSONP validation regular expression to test the validness of the JSONP callback. The valid callbacks are simple functions like myJsFunction or simple object path looking like: something1.something2.something3 . See ninja.template.TemplateEngineJsonPValidatorTest for supported cases tests. This is a subset of rules from the following article:

See Also:

Sanitizing JSONP callbacks

Constructor Summary

Constructors

Constructor and Description
TemplateEngineJsonP(com.fasterxml.jackson.databind.ObjectMapper objectMapper, NinjaProperties properties)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getContentType() Get the content type this template engine renders
java.lang.String	getSuffixOfTemplatingEngine() For instance returns ".ftl.html" Or .ftl.json.
void	invoke(Context context, Result result) Render the given object to the given context
static boolean	isThisASecureCallbackName(java.lang.String callback) Tests whether the given function name is a valid JSONP function name/path.

Methods inherited from class java.lang.Object

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

Constructor Detail

TemplateEngineJsonP

@Inject
public TemplateEngineJsonP(com.fasterxml.jackson.databind.ObjectMapper objectMapper,
                                   NinjaProperties properties)

Method Detail

invoke

public void invoke(Context context,
                   Result result)

Description copied from interface: TemplateEngine

Render the given object to the given context

Specified by:

invoke in interface TemplateEngine

Parameters:

context - The context to render to

result - The result to render

getContentType

public java.lang.String getContentType()

Description copied from interface: TemplateEngine

Get the content type this template engine renders

Specified by:

getContentType in interface TemplateEngine

Returns:

The content type this template engine renders

getSuffixOfTemplatingEngine

public java.lang.String getSuffixOfTemplatingEngine()

Description copied from interface: TemplateEngine

For instance returns ".ftl.html" Or .ftl.json.

Or anything else. To display error messages in a nice way...

But Gson for instance does not use a template to render stuff. Therefore it will return null

Specified by:

getSuffixOfTemplatingEngine in interface TemplateEngine

Returns:

name of suffix or null if engine is not using a template on disk.

isThisASecureCallbackName

public static boolean isThisASecureCallbackName(java.lang.String callback)

Tests whether the given function name is a valid JSONP function name/path.

Parameters:

callback - Callback value to test.

Returns:

Whether the given function name is a valid JSONP function name/path.