org.xwiki.rendering.renderer.printer
Class XHTMLWikiPrinter

java.lang.Object
  org.xwiki.rendering.renderer.printer.XMLWikiPrinter
      org.xwiki.rendering.renderer.printer.XHTMLWikiPrinter

public class XHTMLWikiPrinter
extends XMLWikiPrinter

Base toolkit class for all XHTML-based renderers. This printer handles whitespaces so that it prints " " when needed (i.e. when the spaces are at the beginning or at the end of an element's content or when there are more than 1 contiguous spaces, except for CDATA sections and inside PRE elements. It also knows how to handle XHTML comments).

Since:

1.7M1

Version:

$Id$

Field Summary

Fields inherited from class org.xwiki.rendering.renderer.printer.XMLWikiPrinter

wikiWriter, xmlWriter

Constructor Summary

XHTMLWikiPrinter(WikiPrinter printer)

Method Summary

void	printRaw(String raw) Print some text without escaping anything, it's supposed to be XML or at least contains only valid characters in XML text node.
void	printSpace() This method should be used to print a space rather than calling printXML(" ").
void	printXML(String str) Print provided text.
void	printXMLComment(String content) Print a XML comment.
void	printXMLComment(String content, boolean escape) Print a XML comment.
void	printXMLElement(String name) Print the xml element.
void	printXMLElement(String name, Map<String,String> attributes) Print the xml element.
void	printXMLElement(String name, String[][] attributes) Print the xml element.
void	printXMLEndCData() End a CDATA section.
void	printXMLEndElement(String name) Print the end tag of xml element.
void	printXMLStartCData() Start a CDATA section.
void	printXMLStartElement(String name) Print the start tag of xml element.
void	printXMLStartElement(String name, Attributes attributes) Print the start tag of xml element.
void	printXMLStartElement(String name, Map<String,String> attributes) Print the start tag of xml element.
void	printXMLStartElement(String name, String[][] attributes) Print the start tag of xml element.

Methods inherited from class org.xwiki.rendering.renderer.printer.XMLWikiPrinter

getXMLWriter, printEntity, setWikiPrinter

Methods inherited from class java.lang.Object

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

Constructor Detail

XHTMLWikiPrinter

public XHTMLWikiPrinter(WikiPrinter printer)

Parameters:

printer - the object to which to write the XHTML output to

Method Detail

printXML

public void printXML(String str)

Print provided text. Takes care of xml escaping.

Overrides:

printXML in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXML(java.lang.String)

printXMLElement

public void printXMLElement(String name)

Print the xml element. In the form .

Overrides:

printXMLElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLElement(java.lang.String)

printXMLElement

public void printXMLElement(String name,
                            String[][] attributes)

Print the xml element. In the form .

Overrides:

printXMLElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLElement(java.lang.String, java.lang.String[][])

printXMLElement

public void printXMLElement(String name,
                            Map<String,String> attributes)

Print the xml element. In the form .

Overrides:

printXMLElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLElement(java.lang.String, java.util.Map)

printXMLStartElement

public void printXMLStartElement(String name)

Print the start tag of xml element. In the form <name>.

Overrides:

printXMLStartElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLStartElement(java.lang.String)

printXMLStartElement

public void printXMLStartElement(String name,
                                 String[][] attributes)

Print the start tag of xml element. In the form <name att1="value1" att2="value2">.

Overrides:

printXMLStartElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLStartElement(java.lang.String, java.lang.String[][])

printXMLStartElement

public void printXMLStartElement(String name,
                                 Map<String,String> attributes)

Print the start tag of xml element. In the form <name att1="value1" att2="value2">.

Overrides:

printXMLStartElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLStartElement(java.lang.String, java.util.Map)

printXMLStartElement

public void printXMLStartElement(String name,
                                 Attributes attributes)

Print the start tag of xml element. In the form <name att1="value1" att2="value2">.

Overrides:

printXMLStartElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLStartElement(java.lang.String, org.xml.sax.Attributes)

printXMLEndElement

public void printXMLEndElement(String name)

Print the end tag of xml element. In the form </name>.

Overrides:

printXMLEndElement in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLEndElement(java.lang.String)

printXMLComment

public void printXMLComment(String content)

Print a XML comment. Note that the content that you pass must be valid XML comment, ie not have -- characters (or - if it's the last character). If you're not sure what the comment content will be use XMLWikiPrinter.printXMLComment(String, boolean) instead, passing true for the second parameter.

Overrides:

printXMLComment in class XMLWikiPrinter

Parameters:

content - the comment content

See Also:

XMLWikiPrinter.printXMLComment(java.lang.String)

printXMLComment

public void printXMLComment(String content,
                            boolean escape)

Print a XML comment.

Overrides:

printXMLComment in class XMLWikiPrinter

Parameters:

content - the comment content

escape - indicate if comment content has to be escaped. XML content does not support -- and - (when it's the last character). Escaping is based on backslash. "- --\ -" give "- \-\-\\ \-\ ".

See Also:

XMLWikiPrinter.printXMLComment(java.lang.String, boolean)

printXMLStartCData

public void printXMLStartCData()

Start a CDATA section.

Overrides:

printXMLStartCData in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLStartCData()

printXMLEndCData

public void printXMLEndCData()

End a CDATA section.

Overrides:

printXMLEndCData in class XMLWikiPrinter

See Also:

XMLWikiPrinter.printXMLEndCData()

printSpace

public void printSpace()

This method should be used to print a space rather than calling printXML(" ").

printRaw

public void printRaw(String raw)

Print some text without escaping anything, it's supposed to be XML or at least contains only valid characters in XML text node.

Overrides:

printRaw in class XMLWikiPrinter

Parameters:

raw - the content

See Also:

XMLWikiPrinter.printRaw(java.lang.String)