org.codehaus.staxmate.out
Class SMRootFragment

java.lang.Object
  org.codehaus.staxmate.out.SMOutputtable
      org.codehaus.staxmate.out.SMOutputContainer
          org.codehaus.staxmate.out.SMRootFragment

Direct Known Subclasses:

SMOutputDocument

public class SMRootFragment
extends SMOutputContainer

Concrete non-buffered fragment (== container) class used as the root level output container. Root-level does not necessarily have to mean XML root level; it may also be a child context of a stream writer in which StaxMate is only used to output specific sub-trees. This class is also used as the base for the outputter that models a complete document.

Field Summary

protected boolean

mActive Simple state flag; children can only be added when root container is still active.

Fields inherited from class org.codehaus.staxmate.out.SMOutputtable

mNext

Constructor Summary

SMRootFragment(SMOutputContext ctxt)

Method Summary

boolean	canOutputNewChild() Method called to figure out if we can just output a newly added child, without any buffering.
protected void	childReleased(SMOutputtable child) Method called by a child, when it is released and neither is or contains any buffered entities.
void	closeRoot() Method that HAS to be called when all additions have been done via StaxMate API.
protected boolean	doOutput(SMOutputContext ctxt, boolean canClose) Method called to request that the entity output itself; either as much as it can without closing, or as much as it can if it is to get closed.
protected void	forceOutput(SMOutputContext ctxt) Method similar to SMOutputtable.doOutput(org.codehaus.staxmate.out.SMOutputContext, boolean), except that this method will always succeed in doing the output.
void	getPath(java.lang.StringBuilder sb)

Methods inherited from class org.codehaus.staxmate.out.SMOutputContainer

addAndReleaseBuffered, addBuffered, addCData, addCData, addCharacters, addCharacters, addCharacters, addComment, addElement, addElement, addEntityRef, addProcessingInstruction, closeAllButLastChild, closeAndOutputChildren, createBufferedElement, createBufferedFragment, forceChildOutput, getContext, getNamespace, getNamespace, getParent, getPath, linkNewChild, setIndentation, throwBuffered, throwClosed, throwRelinking

Methods inherited from class org.codehaus.staxmate.out.SMOutputtable

getNext, linkNext

Methods inherited from class java.lang.Object

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

Field Detail

mActive

protected boolean mActive

Simple state flag; children can only be added when root container is still active.

Constructor Detail

SMRootFragment

public SMRootFragment(SMOutputContext ctxt)

Method Detail

doOutput

protected boolean doOutput(SMOutputContext ctxt,
                           boolean canClose)
                    throws javax.xml.stream.XMLStreamException

Description copied from class: SMOutputtable

Method called to request that the entity output itself; either as much as it can without closing, or as much as it can if it is to get closed. In both cases output can fail or be only a partial one: buffered nodes will not be output at all, and nodes with buffered children can only be partially output.

Specified by:

doOutput in class SMOutputContainer

Parameters:

ctxt - Output context to use for outputting this node (and its contents)

canClose - If true, indicates that the node can (and should) be fully closed if possible. This (passing true) is usually done when a new sibling is added after a node (element/fragment); if so, current one should be recursively closed. If false, should only try to output as much as can be done without forcing closures.

Returns:

True if the whole node could be output, ie. neither it nor its children are buffered.

Throws:

javax.xml.stream.XMLStreamException

forceOutput

protected void forceOutput(SMOutputContext ctxt)
                    throws javax.xml.stream.XMLStreamException

Description copied from class: SMOutputtable

Method similar to SMOutputtable.doOutput(org.codehaus.staxmate.out.SMOutputContext, boolean), except that this method will always succeed in doing the output. Specifically, it will force all buffered nodes to be unbuffered, and then output.

Specified by:

forceOutput in class SMOutputContainer

Throws:

javax.xml.stream.XMLStreamException

childReleased

protected void childReleased(SMOutputtable child)
                      throws javax.xml.stream.XMLStreamException

Description copied from class: SMOutputContainer

Method called by a child, when it is released and neither is or contains any buffered entities. This should indicate that it can be output unless one of its parents or preceding siblings is buffered. Container is expected to update its own state, and then inform its own parent (if necesary) about release; this may cascade output from parents up the container stack.

Specified by:

childReleased in class SMOutputContainer

Parameters:

child - Child node that now neither is nor contains any buffered nodes.

Throws:

javax.xml.stream.XMLStreamException

canOutputNewChild

public boolean canOutputNewChild()
                          throws javax.xml.stream.XMLStreamException

Description copied from class: SMOutputContainer

Method called to figure out if we can just output a newly added child, without any buffering. It will request container to close and output all non-buffered children it has, if any; and indicate whether it was fully succesful or not.

Specified by:

canOutputNewChild in class SMOutputContainer

Returns:

True if all children (if any) were completely output; false if there was at least one buffered child that couldn't be output.

Throws:

javax.xml.stream.XMLStreamException

getPath

public void getPath(java.lang.StringBuilder sb)

Specified by:

getPath in class SMOutputContainer

closeRoot

public void closeRoot()
               throws javax.xml.stream.XMLStreamException

Method that HAS to be called when all additions have been done via StaxMate API. Since it is possible that the underlying stream writer may be buffering some parts, it needs to be informed of the closure.

Throws:

javax.xml.stream.XMLStreamException