Package freemarker.core

Class CombinedMarkupOutputFormat

java.lang.Object

freemarker.core.OutputFormat

freemarker.core.MarkupOutputFormat<MO>

freemarker.core.CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>

freemarker.core.CombinedMarkupOutputFormat

public final class CombinedMarkupOutputFormat
extends CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>

Represents two markup formats nested into each other. For example, markdown nested into HTML.

Since:

2.3.24

Constructor Summary

Constructors

Constructor	Description
CombinedMarkupOutputFormat(MarkupOutputFormat outer, MarkupOutputFormat inner)	Same as CombinedMarkupOutputFormat(String, MarkupOutputFormat, MarkupOutputFormat) with null as the name parameter.
CombinedMarkupOutputFormat(java.lang.String name, MarkupOutputFormat outer, MarkupOutputFormat inner)

Method Summary

Modifier and Type	Method	Description
java.lang.String	escapePlainText(java.lang.String plainTextContent)	Should give the same result as MarkupOutputFormat.fromPlainTextByEscaping(String) and then MarkupOutputFormat.getMarkupString(TemplateMarkupOutputModel), but the implementation may uses a more efficient solution.
MarkupOutputFormat	getInnerOutputFormat()
java.lang.String	getMimeType()	Returns the MIME type of the output format.
java.lang.String	getName()	The short name used to refer to this format (like in the #ftl header).
MarkupOutputFormat	getOuterOutputFormat()
boolean	isAutoEscapedByDefault()	Tells if by default auto-escaping should be on for this format.
boolean	isLegacyBuiltInBypassed(java.lang.String builtInName)	Tells if a string built-in that can't handle a TemplateMarkupOutputModel left hand operand can bypass this object as is.
boolean	isOutputFormatMixingAllowed()	Tells if this output format allows inserting TemplateMarkupOutputModel-s of another output formats into it.
protected TemplateCombinedMarkupOutputModel	newTemplateMarkupOutputModel(java.lang.String plainTextContent, java.lang.String markupContent)	Creates a new CommonTemplateMarkupOutputModel that's bound to this OutputFormat instance.
void	output(java.lang.String textToEsc, java.io.Writer out)	Equivalent to calling MarkupOutputFormat.fromPlainTextByEscaping(String) and then MarkupOutputFormat.output(TemplateMarkupOutputModel, Writer), but the implementation may uses a more efficient solution.

Methods inherited from class freemarker.core.CommonMarkupOutputFormat

concat, fromMarkup, fromPlainTextByEscaping, getMarkupString, getSourcePlainText, isEmpty, output

Methods inherited from class freemarker.core.OutputFormat

toString, toStringExtraProperties

Methods inherited from class java.lang.Object

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

Constructor Detail

CombinedMarkupOutputFormat

public CombinedMarkupOutputFormat(MarkupOutputFormat outer,
                                  MarkupOutputFormat inner)

Same as CombinedMarkupOutputFormat(String, MarkupOutputFormat, MarkupOutputFormat) with null as the name parameter.

CombinedMarkupOutputFormat

public CombinedMarkupOutputFormat(java.lang.String name,
                                  MarkupOutputFormat outer,
                                  MarkupOutputFormat inner)

Parameters:

name - Maybe null, in which case it defaults to outer.getName() + "{" + inner.getName() + "}".

Method Detail

getName

public java.lang.String getName()

Description copied from class: OutputFormat

The short name used to refer to this format (like in the #ftl header).

Specified by:

getName in class OutputFormat

getMimeType

public java.lang.String getMimeType()

Description copied from class: OutputFormat

Returns the MIME type of the output format. This might comes handy when generating a HTTP response. null null if this output format doesn't clearly corresponds to a specific MIME type.

Specified by:

getMimeType in class OutputFormat

output

public void output(java.lang.String textToEsc,
                   java.io.Writer out)
            throws java.io.IOException,
                   TemplateModelException

Description copied from class: MarkupOutputFormat

Equivalent to calling MarkupOutputFormat.fromPlainTextByEscaping(String) and then MarkupOutputFormat.output(TemplateMarkupOutputModel, Writer), but the implementation may uses a more efficient solution.

Specified by:

output in class CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>

Throws:

java.io.IOException

TemplateModelException

escapePlainText

public java.lang.String escapePlainText(java.lang.String plainTextContent)
                                 throws TemplateModelException

Description copied from class: MarkupOutputFormat

Should give the same result as MarkupOutputFormat.fromPlainTextByEscaping(String) and then MarkupOutputFormat.getMarkupString(TemplateMarkupOutputModel), but the implementation may uses a more efficient solution.

Specified by:

escapePlainText in class MarkupOutputFormat<TemplateCombinedMarkupOutputModel>

Throws:

TemplateModelException

isLegacyBuiltInBypassed

public boolean isLegacyBuiltInBypassed(java.lang.String builtInName)
                                throws TemplateModelException

Description copied from class: MarkupOutputFormat

Tells if a string built-in that can't handle a TemplateMarkupOutputModel left hand operand can bypass this object as is. A typical such case would be when a TemplateHTMLOutputModel of "HTML" format bypasses ?html.

Specified by:

isLegacyBuiltInBypassed in class MarkupOutputFormat<TemplateCombinedMarkupOutputModel>

Throws:

TemplateModelException

isAutoEscapedByDefault

public boolean isAutoEscapedByDefault()

Description copied from class: MarkupOutputFormat

Tells if by default auto-escaping should be on for this format. It should be true if you need to escape on most of the places where you insert values.

Overrides:

isAutoEscapedByDefault in class CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>

See Also:

Configuration.setAutoEscapingPolicy(int)

isOutputFormatMixingAllowed

public boolean isOutputFormatMixingAllowed()

Description copied from class: OutputFormat

Tells if this output format allows inserting TemplateMarkupOutputModel-s of another output formats into it. If true, the foreign TemplateMarkupOutputModel will be inserted into the output as is (like if the surrounding output format was the same). This is usually a bad idea to allow, as such an event could indicate application bugs. If this method returns false (recommended), then FreeMarker will try to assimilate the inserted value by converting its format to this format, which will currently (2.3.24) cause exception, unless the inserted value is made by escaping plain text and the target format is non-escaping, in which case format conversion is trivially possible. (It's not impossible that conversions will be extended beyond this, if there will be demand for that.)

true value is used by UndefinedOutputFormat.

Overrides:

isOutputFormatMixingAllowed in class CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>

getOuterOutputFormat

public MarkupOutputFormat getOuterOutputFormat()

getInnerOutputFormat

public MarkupOutputFormat getInnerOutputFormat()

newTemplateMarkupOutputModel

protected TemplateCombinedMarkupOutputModel newTemplateMarkupOutputModel(java.lang.String plainTextContent,
                                                                         java.lang.String markupContent)

Description copied from class: CommonMarkupOutputFormat

Creates a new CommonTemplateMarkupOutputModel that's bound to this OutputFormat instance.

Specified by:

newTemplateMarkupOutputModel in class CommonMarkupOutputFormat<TemplateCombinedMarkupOutputModel>