|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.sun.xml.bind.v2.runtime.output.XmlOutputAbstractImpl
com.sun.xml.bind.v2.runtime.output.XMLStreamWriterOutput
com.sun.xml.bind.v2.runtime.output.FastInfosetStreamWriterOutput
public final class FastInfosetStreamWriterOutput
XmlOutput for LowLevelStAXDocumentSerializer.
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).
| 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 | |
|---|---|
FastInfosetStreamWriterOutput(StAXDocumentSerializer out,
JAXBContextImpl context)
|
|
| Method Summary | |
|---|---|
void |
attribute(int prefix,
String localName,
String value)
|
void |
attribute(Name name,
String value)
|
void |
beginStartTag(int prefix,
String localName)
|
void |
beginStartTag(Name name)
Writes a start tag. |
void |
beginStartTagWithNamespaces(Name name)
|
void |
endDocument(boolean fragment)
Called at the very end. |
void |
endStartTag()
|
void |
endTag(int prefix,
String localName)
|
void |
endTag(Name name)
|
void |
startDocument(XMLSerializer serializer,
boolean fragment,
int[] nsUriIndex2prefixIndex,
NamespaceContextImpl nsContext)
Called at the very beginning. |
void |
text(Pcdata value,
boolean needsSeparatingWhitespace)
Writes XML text with character escaping, if necessary. |
void |
text(String value,
boolean needsSeparatingWhitespace)
Writes XML text with character escaping, if necessary. |
| Methods inherited from class com.sun.xml.bind.v2.runtime.output.XMLStreamWriterOutput |
|---|
create |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public FastInfosetStreamWriterOutput(StAXDocumentSerializer out,
JAXBContextImpl context)
| Method Detail |
|---|
public void startDocument(XMLSerializer serializer,
boolean fragment,
int[] nsUriIndex2prefixIndex,
NamespaceContextImpl nsContext)
throws IOException,
SAXException,
XMLStreamException
XmlOutputAbstractImpl
startDocument in interface XmlOutputstartDocument in class XMLStreamWriterOutputserializer - the XMLSerializer that coordinates this whole marshalling episode.fragment - true if we are marshalling a fragment.
IOException
SAXException
XMLStreamException
public void endDocument(boolean fragment)
throws IOException,
SAXException,
XMLStreamException
XmlOutputAbstractImpl
endDocument in interface XmlOutputendDocument in class XMLStreamWriterOutputfragment - false if we are writing the whole document.
IOException
SAXException
XMLStreamException
public void beginStartTag(Name name)
throws IOException
XmlOutputAbstractImpl
At this point XmlOutputAbstractImpl.nsContext holds namespace declarations needed for this
new element.
This method is used for writing tags that are indexed.
beginStartTag in interface XmlOutputbeginStartTag in class XmlOutputAbstractImplIOException
public void beginStartTagWithNamespaces(Name name)
throws IOException
IOException
public void attribute(Name name,
String value)
throws IOException
attribute in interface XmlOutputattribute in class XmlOutputAbstractImplIOException
public void endStartTag()
throws IOException
endStartTag in interface XmlOutputendStartTag in class XMLStreamWriterOutputIOException
public void endTag(Name name)
throws IOException
endTag in interface XmlOutputendTag in class XmlOutputAbstractImplIOException
public void endTag(int prefix,
String localName)
throws IOException
endTag in interface XmlOutputendTag in class XMLStreamWriterOutputIOException
public void text(Pcdata value,
boolean needsSeparatingWhitespace)
throws IOException
XmlOutput
text in interface XmlOutputtext in class XMLStreamWriterOutputvalue - this string can contain characters that might need escaping
(such as '&' or '>')
IOException
public void text(String value,
boolean needsSeparatingWhitespace)
throws IOException
XmlOutput
text in interface XmlOutputtext in class XMLStreamWriterOutputvalue - this string can contain characters that might need escaping
(such as '&' or '>')
IOException
public void beginStartTag(int prefix,
String localName)
throws IOException
beginStartTag in interface XmlOutputbeginStartTag in class XMLStreamWriterOutputIOException
public void attribute(int prefix,
String localName,
String value)
throws IOException
attribute in interface XmlOutputattribute in class XMLStreamWriterOutputprefix - -1 if this attribute does not have a prefix
(this handling differs from that of elements.)
IOException
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||