eu.bandm.tools.util2

Class ContentPrinter

java.lang.Object

eu.bandm.tools.util.DefaultContentHandler

eu.bandm.tools.util2.ContentPrinter

All Implemented Interfaces:

ContentHandler, LexicalHandler

public class ContentPrinter
extends DefaultContentHandler

Converts SAX events into textual representation, not supporting name spaces. Supports a subset of ContentHandler and LexicalHandler.
Can be parametrized w.r.t

• target of output (normally a PrintStream or sim.
• encoding
• format of output (indenting, compressed, debug only)
• whether to include doctype and/or xmltype declaration

Character data is transformed, using the standard character entities "quot" "amp" "lt" "gt". ("apos" should not be used, for old html handlers.)
CData sections and disable output escaping are not supported.

CHECK NOETIG !?!?!? Korrekte übersetzung nicht automatisch bei PrintWriter !?!?
Surrogate pairs are translated to Numeric character references, BUT ONLY IN CDATA/PCDATA, not in Element names, attribute names, pi targets, etc.
FIXME: currently PrintWriter is only needed for "println()".
This COULD be replaced by a Writer and "append( System property "line.separator", PLUS an additional method to alter this explicitly!

Field Summary

Fields

Modifier and Type	Field and Description
protected int	attcol
protected boolean	beforeFirstElement
protected boolean	declareXml
protected XMLDocumentIdentifier	dtdDocId
protected int	indent
protected int	maxwidth
static String	newAttLineIndent
static int	newAttLineIndentLen
protected boolean	noendtags Only for compact debugging output: endtags are omitted and reflected by indentation only.
protected Set<NamespaceName>	noindent
protected boolean	openTagPending
protected PrintWriter	out
protected boolean	pretty
protected boolean	reindent
protected String	selectedEncoding
static String	surrogateErrorIndication
static String	xml_version

Constructor Summary

Constructors

Constructor and Description
ContentPrinter(OutputStream out, String selectedEncoding) Insert an encoder with the given encoding name between the output and the selected drain.
ContentPrinter(OutputStream out, String selectedEncoding, boolean pretty)
ContentPrinter(OutputStream out, String selectedEncoding, boolean pretty, boolean noend) Creates a ContentPrinter which can omit all end tags.
ContentPrinter(OutputStream out, String selectedEncoding, Set<NamespaceName> noindent) Creates a ContentPrinter which inserts indentation ONLY inside of elements which do not have mixed contents.
ContentPrinter(PrintWriter out)
ContentPrinter(PrintWriter out, boolean pretty)
ContentPrinter(PrintWriter out, boolean pretty, boolean noend)
ContentPrinter(PrintWriter out, Set<NamespaceName> noindent) Creates a ContentPrinter which inserts indentation ONLY inside of elements which do not have mixed contents.

Method Summary

Modifier and Type	Method and Description
void	characters(char[] ch, int start, int length)
void	comment(char[] ch, int start, int length) Print comment to output; assume no double dashes and no trailing dash are contained [XSLT 1.0:7.4] FIXME indentation etc.
void	comment(String s)
void	comment(String s, boolean linefeed)
protected void	doWrite(char[] ch, int start, int length, boolean inAtt, boolean replaceDoubleQuote) Prints character data in text contents (ie.
void	endDocument()
void	endElement(String namespaceURI, String localName, String qName)
void	endPrefixMapping(String prefix)
void	flush()
protected void	flushPending() close the open tag of an element.
void	ignorableWhitespace(char[] ch, int start, int length)
protected void	indent() Start a new line and advance to the column given by indent, the current identation depth, reflecting open and close element events.
protected void	printAtt(String name, String v)
void	processingInstruction(String target, String data)
ContentPrinter	setDeclareXml(boolean declareXml) Whether an XML type declaration shall be printed at the start of the generaterd output.
ContentPrinter	setDtdDocId(XMLDocumentIdentifier dtdDocId) The dtd adress of the doctype declaration which will be printed inserted in the generated output, iff !=null
ContentPrinter	setLineWidth(int maxwidth)
void	skippedEntity(String name)
void	startDocument()
void	startElement(String namespaceURI, String localName, String qName, Attributes atts)
void	startPrefixMapping(String prefix, String uri)

Methods inherited from class eu.bandm.tools.util.DefaultContentHandler

endCDATA, endDTD, endEntity, setDocumentLocator, startCDATA, startDTD, startEntity

Methods inherited from class java.lang.Object

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

Field Detail

out

protected PrintWriter out

pretty

protected boolean pretty

noendtags

protected boolean noendtags

Only for compact debugging output: endtags are omitted and reflected by indentation only.

noindent

protected Set<NamespaceName> noindent

selectedEncoding

protected String selectedEncoding

declareXml

protected transient boolean declareXml

dtdDocId

protected transient XMLDocumentIdentifier dtdDocId

maxwidth

protected transient int maxwidth

xml_version

public static final String xml_version

See Also:

Constant Field Values

surrogateErrorIndication

public static final String surrogateErrorIndication

See Also:

Constant Field Values

newAttLineIndent

public static final String newAttLineIndent

See Also:

Constant Field Values

newAttLineIndentLen

public static final int newAttLineIndentLen

beforeFirstElement

protected transient boolean beforeFirstElement

reindent

protected transient boolean reindent

indent

protected transient int indent

attcol

protected transient int attcol

openTagPending

protected transient boolean openTagPending

Constructor Detail

ContentPrinter

public ContentPrinter(OutputStream out,
                      String selectedEncoding)
               throws UnsupportedEncodingException

Insert an encoder with the given encoding name between the output and the selected drain. Causes an XML declaration with a document type declaration. The XML type is currently fixed to "XML 1.0"

Throws:

UnsupportedEncodingException

ContentPrinter

public ContentPrinter(OutputStream out,
                      String selectedEncoding,
                      boolean pretty)
               throws UnsupportedEncodingException

Parameters:

out - where to print the output to

selectedEncoding -

pretty - whether to insert indentations

Throws:

UnsupportedEncodingException

ContentPrinter

public ContentPrinter(OutputStream out,
                      String selectedEncoding,
                      boolean pretty,
                      boolean noend)
               throws UnsupportedEncodingException

Creates a ContentPrinter which can omit all end tags. This is useful only with pretty==true, as a more compact rendering for human readers, e.g. for debugging.

Parameters:

out - where to print the output to

selectedEncoding -

pretty - whether to insert indentations (always or-ed with "noend")

noend - whether to leave out the end tag

Throws:

UnsupportedEncodingException

ContentPrinter

public ContentPrinter(OutputStream out,
                      String selectedEncoding,
                      Set<NamespaceName> noindent)
               throws UnsupportedEncodingException

Creates a ContentPrinter which inserts indentation ONLY inside of elements which do not have mixed contents. (In these, whitespace may have some significance.) The set of mixed contents elements is given by a set of NamespaceNames.

Parameters:

out - where to print the output to

selectedEncoding -

noindent - elements in which no identation may happen

Throws:

UnsupportedEncodingException

ContentPrinter

public ContentPrinter(PrintWriter out)

ContentPrinter

public ContentPrinter(PrintWriter out,
                      boolean pretty)

ContentPrinter

public ContentPrinter(PrintWriter out,
                      boolean pretty,
                      boolean noend)

ContentPrinter

public ContentPrinter(PrintWriter out,
                      Set<NamespaceName> noindent)
               throws UnsupportedEncodingException

Creates a ContentPrinter which inserts indentation ONLY inside of elements which do not have mixed contents. (In these, whitespace may have some significance.) The set of mixed contents elements is given by a set of NamespaceNames.

Parameters:

out - where to print the output to

noindent - elements in which no identation may happen

Throws:

UnsupportedEncodingException

Method Detail

setDeclareXml

public ContentPrinter setDeclareXml(boolean declareXml)

Whether an XML type declaration shall be printed at the start of the generaterd output.

setDtdDocId

public ContentPrinter setDtdDocId(XMLDocumentIdentifier dtdDocId)

The dtd adress of the doctype declaration which will be printed inserted in the generated output, iff !=null

setLineWidth

public ContentPrinter setLineWidth(int maxwidth)

doWrite

protected void doWrite(char[] ch,
                       int start,
                       int length,
                       boolean inAtt,
                       boolean replaceDoubleQuote)

Prints character data in text contents (ie. cdata sax events) and attribute nodes.
Prints some characters as named character references, according to [XML 1.0:XXX]. (Not all these rules are sensible, see our whitepaper.)
Additionally, newlines \n, if in Attribute value.
Prints surrogate pairs as XML numeric character reference "&#x...;".
ATTENTION assume surrogate pairs are completely contained in the character range. In cases of errors with surrogate pairs, an error indicating text surrogateErrorIndication is inserted in the outout.

comment

public void comment(char[] ch,
                    int start,
                    int length)
             throws SAXException

Print comment to output; assume no double dashes and no trailing dash are contained [XSLT 1.0:7.4]
FIXME indentation etc.

Specified by:

comment in interface LexicalHandler

Overrides:

comment in class DefaultContentHandler

Throws:

SAXException

comment

public void comment(String s,
                    boolean linefeed)
             throws SAXException

Throws:

SAXException

comment

public void comment(String s)
             throws SAXException

Throws:

SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException

Specified by:

ignorableWhitespace in interface ContentHandler

Overrides:

ignorableWhitespace in class DefaultContentHandler

Throws:

SAXException

characters

public void characters(char[] ch,
                       int start,
                       int length)

Specified by:

characters in interface ContentHandler

Overrides:

characters in class DefaultContentHandler

endElement

public void endElement(String namespaceURI,
                       String localName,
                       String qName)

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultContentHandler

processingInstruction

public void processingInstruction(String target,
                                  String data)

Specified by:

processingInstruction in interface ContentHandler

Overrides:

processingInstruction in class DefaultContentHandler

skippedEntity

public void skippedEntity(String name)

Specified by:

skippedEntity in interface ContentHandler

Overrides:

skippedEntity in class DefaultContentHandler

startDocument

public void startDocument()

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class DefaultContentHandler

startElement

public void startElement(String namespaceURI,
                         String localName,
                         String qName,
                         Attributes atts)

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultContentHandler

printAtt

protected void printAtt(String name,
                        String v)

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String uri)

Specified by:

startPrefixMapping in interface ContentHandler

Overrides:

startPrefixMapping in class DefaultContentHandler

endPrefixMapping

public void endPrefixMapping(String prefix)

Specified by:

endPrefixMapping in interface ContentHandler

Overrides:

endPrefixMapping in class DefaultContentHandler

flushPending

protected void flushPending()

close the open tag of an element. (is kept open for the case that the end tag arrives without intervening contents, and an empty tag can be created instead.

flush

public void flush()

endDocument

public void endDocument()

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class DefaultContentHandler

indent

protected void indent()

Start a new line and advance to the column given by indent, the current identation depth, reflecting open and close element events. reindent is cleared. (If pretty==false, no output is generated.)