public interface XMLStreamWriter2 extends TypedXMLStreamWriter, Validatable
XMLStreamWriter
,
as well as to configure individual instances.
It also adds limited number of methods that are important for
efficient pass-through processing (such as one needed when routing
SOAP-messages).
Since version 3.0, stream writer will also implement "Typed Access API" on output side.
Modifier and Type | Method and Description |
---|---|
void |
closeCompletely()
Method similar to
XMLStreamWriter.close() ,
except that this method also does close the underlying output
destination (stream) if it has not yet been closed. |
void |
copyEventFromReader(XMLStreamReader2 r,
boolean preserveEventData)
Method that essentially copies
event that the specified reader has just read.
|
String |
getEncoding()
Method that can be called to get information about encoding that
this writer is using (or at least claims is using).
|
XMLStreamLocation2 |
getLocation()
Method that should return current output location, if the writer
keeps track of it; null if it does not.
|
boolean |
isPropertySupported(String name)
Method similar to
XMLOutputFactory.isPropertySupported(java.lang.String) , used
to determine whether a property is supported by the Writer
instance. |
boolean |
setProperty(String name,
Object value)
Method that can be used to set per-writer properties; a subset of
properties one can set via matching
XMLOutputFactory2
instance. |
void |
writeCData(char[] text,
int start,
int len) |
void |
writeDTD(String rootName,
String systemId,
String publicId,
String internalSubset) |
void |
writeFullEndElement()
Method similar to
XMLStreamWriter.writeEndElement() , but that will always
write the full end element, instead of empty element. |
void |
writeRaw(char[] text,
int offset,
int length)
Method that writes specified content as is, without encoding or
deciphering it in any way.
|
void |
writeRaw(String text)
Method that writes specified content as is, without encoding or
deciphering it in any way.
|
void |
writeRaw(String text,
int offset,
int length)
Method that writes specified content as is, without encoding or
deciphering it in any way.
|
void |
writeSpace(char[] text,
int offset,
int length)
Method that can be called to write whitespace-only content.
|
void |
writeSpace(String text)
Method that can be called to write whitespace-only content.
|
void |
writeStartDocument(String version,
String encoding,
boolean standAlone) |
writeBinary, writeBinary, writeBinaryAttribute, writeBinaryAttribute, writeBoolean, writeBooleanAttribute, writeDecimal, writeDecimalAttribute, writeDouble, writeDoubleArray, writeDoubleArrayAttribute, writeDoubleAttribute, writeFloat, writeFloatArray, writeFloatArrayAttribute, writeFloatAttribute, writeInt, writeIntArray, writeIntArrayAttribute, writeIntAttribute, writeInteger, writeIntegerAttribute, writeLong, writeLongArray, writeLongArrayAttribute, writeLongAttribute, writeQName, writeQNameAttribute
close, flush, getNamespaceContext, getPrefix, getProperty, setDefaultNamespace, setNamespaceContext, setPrefix, writeAttribute, writeAttribute, writeAttribute, writeCData, writeCharacters, writeCharacters, writeComment, writeDefaultNamespace, writeDTD, writeEmptyElement, writeEmptyElement, writeEmptyElement, writeEndDocument, writeEndElement, writeEntityRef, writeNamespace, writeProcessingInstruction, writeProcessingInstruction, writeStartDocument, writeStartDocument, writeStartDocument, writeStartElement, writeStartElement, writeStartElement
setValidationProblemHandler, stopValidatingAgainst, stopValidatingAgainst, validateAgainst
boolean isPropertySupported(String name)
XMLOutputFactory.isPropertySupported(java.lang.String)
, used
to determine whether a property is supported by the Writer
instance. This means that this method may return false
for some properties that the output factory does support: specifically,
it should only return true if the value is mutable on per-instance
basis. False means that either the property is not recognized, or
is not mutable via writer instance.boolean setProperty(String name, Object value)
XMLOutputFactory2
instance. Exactly which methods are mutable is implementation
specific.name
- Name of the property to setvalue
- Value to set property to.InvalidArgumentException
- if the property is not supported
(or recognized) by the stream writer implementationXMLStreamLocation2 getLocation()
String getEncoding()
XMLOutputFactory
writeStartDocument
method (explicitly
or implicity; latter in cases where defaults are imposed
by Stax specification)
void writeCData(char[] text, int start, int len) throws XMLStreamException
XMLStreamException
void writeDTD(String rootName, String systemId, String publicId, String internalSubset) throws XMLStreamException
XMLStreamException
void writeFullEndElement() throws XMLStreamException
XMLStreamWriter.writeEndElement()
, but that will always
write the full end element, instead of empty element. This only
matters for cases where the element itself has no content, and
if writer is allowed to write empty elements when it encounters
such start/end element write pairs.XMLStreamException
void writeStartDocument(String version, String encoding, boolean standAlone) throws XMLStreamException
XMLStreamException
void writeSpace(String text) throws XMLStreamException
This method is useful for things like outputting indentation.
XMLStreamException
void writeSpace(char[] text, int offset, int length) throws XMLStreamException
This method is useful for things like outputting indentation.
XMLStreamException
void writeRaw(String text) throws XMLStreamException
Method is usually used when encapsulating output from another writer as a sub-tree, or when passing through XML fragments.
NOTE: since text to be written may be anything, including markup, it can not be reliably validated. Because of this, validator(s) attached to the writer will NOT be informed about writes.
XMLStreamException
void writeRaw(String text, int offset, int length) throws XMLStreamException
Method is usually used when encapsulating output from another writer as a sub-tree, or when passing through XML fragments.
NOTE: since text to be written may be anything, including markup, it can not be reliably validated. Because of this, validator(s) attached to the writer will NOT be informed about writes.
XMLStreamException
void writeRaw(char[] text, int offset, int length) throws XMLStreamException
Method is usually used when encapsulating output from another writer as a sub-tree, or when passing through XML fragments.
NOTE: since text to be written may be anything, including markup, it can not be reliably validated. Because of this, validator(s) attached to the writer will NOT be informed about writes.
XMLStreamException
void copyEventFromReader(XMLStreamReader2 r, boolean preserveEventData) throws XMLStreamException
r
- Reader to use for accessing event to copypreserveEventData
- If true, writer is not allowed to change
the state of the reader (so that all the data associated with the
current event has to be preserved); if false, writer is allowed
to use methods that may cause some data to be discarded. Setting
this to false may improve the performance, since it may allow
full no-copy streaming of data, especially textual contents.XMLStreamException
void closeCompletely() throws XMLStreamException
XMLStreamWriter.close()
,
except that this method also does close the underlying output
destination (stream) if it has not yet been closed.
It is specifically necessary to call this method if the parsing ends
in an exception to ensure that the output destination does get
properly closed, even if the stream writer would otherwise close
it (as is the case for destinations it manages where calling
application has no access)XMLStreamException
Copyright © 2012-2015 fasterxml.com. All Rights Reserved.