org.apache.tapestry.dom
Interface MarkupModel

All Known Implementing Classes:

DefaultMarkupModel, XMLMarkupModel

public interface MarkupModel

Used by a the DOM to determine how to produce markup. Delegates details about converted entities and some formatting details. This exists to handle the differences between traditional HTML output (which is SGML based, meaning there can be elements that are valid without a close tag) and "modern" XML, such as XHTML. Generally speaking, for XHTML it is vital that a !DOCTYPE be included in the rendered response, or the browser will be unable to display the result properly.

Method Summary

void	encode(String content, StringBuilder buffer) Encodes the characters into the buffer, converting control characters (such as '<') into corresponding entities (such as &lt;).
void	encodeQuoted(String content, StringBuilder buffer) Encodes the characters into the buffer for use in a quoted value (that is, an attribute value), converting control characters (such as '<') into corresponding entities (such as &lt;).
EndTagStyle	getEndTagStyle(String element) For a given element, determines how the end tag for the element should be rendered.
boolean	isXML() Returns true if the document markup is XML, which is used to determine the need for an XML declaration at the start of the document, and whether CDATA sections are supported.

Method Detail

encode

void encode(String content,
            StringBuilder buffer)

Encodes the characters into the buffer, converting control characters (such as '<') into corresponding entities (such as &lt;).

Parameters:

content - to be filtered

buffer - to receive the filtered content

encodeQuoted

void encodeQuoted(String content,
                  StringBuilder buffer)

Encodes the characters into the buffer for use in a quoted value (that is, an attribute value), converting control characters (such as '<') into corresponding entities (such as &lt;). In addition, double quotes must be quoted or otherwise escaped.

Parameters:

content - to be filtered

buffer - to receive the filtered content

getEndTagStyle

EndTagStyle getEndTagStyle(String element)

For a given element, determines how the end tag for the element should be rendered.

isXML

boolean isXML()

Returns true if the document markup is XML, which is used to determine the need for an XML declaration at the start of the document, and whether CDATA sections are supported.

Returns:

true for XML output, false for HTML (SGML) output