org.jdom2.output.support

Interface StAXStreamProcessor

All Known Implementing Classes:

AbstractStAXStreamProcessor

public interface StAXStreamProcessor

This interface provides a base support for the StAXStreamOutputter.

People who want to create a custom StAXStreamProcessor for StAXStreamOutputter are able to implement this interface.

The AbstractStAXStreamProcessor class is a full implementation of this interface and is fully customisable. People who want a custom StAXStreamOutputter are encouraged to extend the AbstractStAXStreamProcessor rather than do a full re-implementation of this interface.

Since:

JDOM2

Author:

Rolf Lear

See Also:

StAXStreamOutputter, AbstractStAXStreamProcessor

Method Summary

Modifier and Type	Method and Description
void	process(javax.xml.stream.XMLStreamWriter out, Format format, CDATA cdata) Print out a CDATA node.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, Comment comment) Print out a Comment.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, DocType doctype) Print out the DocType.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, Document doc) This will print the Document to the given XMLStreamWriter.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, Element element) Print out an Element, including its Attributes, and all contained (child) elements, etc.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, EntityRef entity) Print out a EntityRef.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, java.util.List<? extends Content> list) This will handle printing out a list of nodes.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, ProcessingInstruction pi) Print out a ProcessingInstruction.
void	process(javax.xml.stream.XMLStreamWriter out, Format format, Text text) Print out a Text node.

Method Detail

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             Document doc)
      throws javax.xml.stream.XMLStreamException

This will print the Document to the given XMLStreamWriter.

Warning: using your own XMLStreamWriter may cause the outputter's preferred character encoding to be ignored. If you use encodings other than UTF-8, we recommend using the method that takes an OutputStream instead.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

doc - Document to format.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             DocType doctype)
      throws javax.xml.stream.XMLStreamException

Print out the DocType.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

doctype - DocType to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             Element element)
      throws javax.xml.stream.XMLStreamException

Print out an Element, including its Attributes, and all contained (child) elements, etc.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

element - Element to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             java.util.List<? extends Content> list)
      throws javax.xml.stream.XMLStreamException

This will handle printing out a list of nodes. This can be useful for printing the content of an element that contains HTML, like "<description>JDOM is <b>fun>!</description>".

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

list - List of nodes.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input list is null or contains null members

java.lang.ClassCastException - if any of the list members are not Content

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             CDATA cdata)
      throws javax.xml.stream.XMLStreamException

Print out a CDATA node.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

cdata - CDATA to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             Text text)
      throws javax.xml.stream.XMLStreamException

Print out a Text node. Performs the necessary entity escaping and whitespace stripping.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

text - Text to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             Comment comment)
      throws javax.xml.stream.XMLStreamException

Print out a Comment.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

comment - Comment to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             ProcessingInstruction pi)
      throws javax.xml.stream.XMLStreamException

Print out a ProcessingInstruction.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

pi - ProcessingInstruction to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null

process

void process(javax.xml.stream.XMLStreamWriter out,
             Format format,
             EntityRef entity)
      throws javax.xml.stream.XMLStreamException

Print out a EntityRef.

Parameters:

out - XMLStreamWriter to use.

format - Format instance specifying output style

entity - EntityRef to output.

Throws:

javax.xml.stream.XMLStreamException - if there's any problem writing.

java.lang.NullPointerException - if the input content is null