Class FastInfosetStreamWriterOutput
- All Implemented Interfaces:
XmlOutput
XmlOutput
for StAXDocumentSerializer
.
This class is responsible for managing the indexing of elements, attributes and local names that are known to JAXB by way of the JAXBContext (generated from JAXB beans or schema). The pre-encoded UTF-8 representations of known local names are also utilized.
The lookup of elements, attributes and local names with respect to a context is very efficient. It relies on an incrementing base line so that look up is performed in O(1) time and only uses static memory. When the base line reaches a point where integer overflow will occur the arrays and base line are reset (such an event is rare and will have little impact on performance).
A weak map of JAXB contexts to optimized tables for attributes, elements and local names is utilized and stored on the LowLevel StAX serializer. Thus, optimized serializing can work other multiple serializing of JAXB beans using the same LowLevel StAX serializer instance. This approach works best when JAXB contexts are only created once per schema or JAXB beans (which is the recommended practice as the creation JAXB contexts are expensive, they are thread safe and can be reused).
- Author:
- [email protected]
-
Field Summary
Fields inherited from class com.sun.xml.bind.v2.runtime.output.XMLStreamWriterOutput
buf
Fields inherited from class com.sun.xml.bind.v2.runtime.output.XmlOutputAbstractImpl
nsContext, nsUriIndex2prefixIndex, serializer
-
Constructor Summary
ConstructorDescription -
Method Summary
Modifier and TypeMethodDescriptionvoid
void
void
beginStartTag
(int prefix, String localName) void
beginStartTag
(Name name) Writes a start tag.void
void
endDocument
(boolean fragment) Called at the very end.void
void
void
void
startDocument
(XMLSerializer serializer, boolean fragment, int[] nsUriIndex2prefixIndex, NamespaceContextImpl nsContext) Called at the very beginning.void
Writes XML text with character escaping, if necessary.void
Writes XML text with character escaping, if necessary.Methods inherited from class com.sun.xml.bind.v2.runtime.output.XMLStreamWriterOutput
create
-
Constructor Details
-
FastInfosetStreamWriterOutput
-
-
Method Details
-
startDocument
public void startDocument(XMLSerializer serializer, boolean fragment, int[] nsUriIndex2prefixIndex, NamespaceContextImpl nsContext) throws IOException, SAXException, XMLStreamException Description copied from class:XmlOutputAbstractImpl
Called at the very beginning.- Specified by:
startDocument
in interfaceXmlOutput
- Overrides:
startDocument
in classXMLStreamWriterOutput
- Parameters:
serializer
- theXMLSerializer
that coordinates this whole marshalling episode.fragment
- true if we are marshalling a fragment.- Throws:
IOException
SAXException
XMLStreamException
-
endDocument
Description copied from class:XmlOutputAbstractImpl
Called at the very end.- Specified by:
endDocument
in interfaceXmlOutput
- Overrides:
endDocument
in classXMLStreamWriterOutput
- Parameters:
fragment
- false if we are writing the whole document.- Throws:
IOException
SAXException
XMLStreamException
-
beginStartTag
Description copied from class:XmlOutputAbstractImpl
Writes a start tag.At this point
XmlOutputAbstractImpl.nsContext
holds namespace declarations needed for this new element.This method is used for writing tags that are indexed.
- Specified by:
beginStartTag
in interfaceXmlOutput
- Overrides:
beginStartTag
in classXmlOutputAbstractImpl
- Throws:
IOException
-
beginStartTagWithNamespaces
- Throws:
IOException
-
attribute
- Specified by:
attribute
in interfaceXmlOutput
- Overrides:
attribute
in classXmlOutputAbstractImpl
- Throws:
IOException
-
endStartTag
- Specified by:
endStartTag
in interfaceXmlOutput
- Overrides:
endStartTag
in classXMLStreamWriterOutput
- Throws:
IOException
-
endTag
- Specified by:
endTag
in interfaceXmlOutput
- Overrides:
endTag
in classXmlOutputAbstractImpl
- Throws:
IOException
-
endTag
- Specified by:
endTag
in interfaceXmlOutput
- Overrides:
endTag
in classXMLStreamWriterOutput
- Throws:
IOException
-
text
Description copied from interface:XmlOutput
Writes XML text with character escaping, if necessary.- Specified by:
text
in interfaceXmlOutput
- Overrides:
text
in classXMLStreamWriterOutput
- Parameters:
value
- this string can contain characters that might need escaping (such as'&' or '>'
)- Throws:
IOException
-
text
Description copied from interface:XmlOutput
Writes XML text with character escaping, if necessary.- Specified by:
text
in interfaceXmlOutput
- Overrides:
text
in classXMLStreamWriterOutput
- Parameters:
value
- this string can contain characters that might need escaping (such as'&' or '>'
)- Throws:
IOException
-
beginStartTag
- Specified by:
beginStartTag
in interfaceXmlOutput
- Overrides:
beginStartTag
in classXMLStreamWriterOutput
- Throws:
IOException
-
attribute
- Specified by:
attribute
in interfaceXmlOutput
- Overrides:
attribute
in classXMLStreamWriterOutput
- Parameters:
prefix
- -1 if this attribute does not have a prefix (this handling differs from that of elements.)- Throws:
IOException
-