Class BufferingXmlWriter

java.lang.Object
com.ctc.wstx.sw.XmlWriter
com.ctc.wstx.sw.BufferingXmlWriter
All Implemented Interfaces:
XMLStreamConstants

public final class BufferingXmlWriter extends XmlWriter implements XMLStreamConstants
Concrete implementation of XmlWriter that will dispatch writes to another writer (of type Writer, and will NOT handle encoding. It will, however, do basic buffering such that the underlying Writer need (and thus, should) not do buffering.

One design goal for this class is to avoid unnecessary buffering: since there will be another Writer doing the actual encoding, amount of buffering needed should still be limited. To this end, a threshold is used to define what's the threshold of writes that we do want to coalesce, ie. buffer. Writes bigger than this should in general proceed without buffering.