com.fasterxml.aalto.out
Class CharXmlWriter

java.lang.Object
  com.fasterxml.aalto.out.WNameFactory
      com.fasterxml.aalto.out.XmlWriter
          com.fasterxml.aalto.out.CharXmlWriter

public final class CharXmlWriter
extends XmlWriter

This is the generic implementation of XmlWriter, used if the destination is a character based, like a Writer.

Field Summary

protected java.io.Writer	_out Actual Writer to use for outputting buffered data as appropriate.
protected char[]	_outputBuffer
protected int	_outputBufferLen
protected int	_outputPtr
protected int	mSmallWriteSize This is the threshold used to check what is considered a "small" write; small writes will be buffered until resulting size will be above the threshold.

Fields inherited from class com.fasterxml.aalto.out.XmlWriter

ATTR_MIN_ARRAYCOPY, DEFAULT_COPYBUFFER_LEN, mCfgNsAware, mCheckContent, mCheckNames, MIN_ARRAYCOPY, mLocPastChars, mLocRowNr, mLocRowStartOffset, mXml11, SURR1_FIRST, SURR1_LAST, SURR2_FIRST, SURR2_LAST

Constructor Summary

CharXmlWriter(WriterConfig cfg, java.io.Writer out)

Method Summary

void	_closeTarget(boolean doClose)
void	_releaseBuffers()
WName	constructName(java.lang.String localName)
WName	constructName(java.lang.String prefix, java.lang.String localName)
void	flush()
int	getHighestEncodable() Method called by error reporting code, to figure out if a given character is encodable (without using character entities) with the current encoding or not.
protected int	getOutputPtr()
protected int	verifyCDataContent(char[] c, int start, int end)
protected int	verifyCDataContent(java.lang.String content)
protected int	verifyCommentContent(java.lang.String content)
protected void	writeAsEntity(int c)
void	writeAttribute(WName name, org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
void	writeAttribute(WName name, char[] value, int offset, int vlen)
void	writeAttribute(WName name, java.lang.String value) Note: can throw XMLStreamException, if name checking is enabled, and name is invalid (name check has to be in this writer, not caller, since it depends not only on xml limitations, but also on encoding limitations)
int	writeCData(char[] cbuf, int offset, int len)
int	writeCData(java.lang.String data)
void	writeCDataEnd()
void	writeCDataStart()
void	writeCharacters(char[] cbuf, int offset, int len)
void	writeCharacters(java.lang.String text)
int	writeComment(java.lang.String data) Method that will try to output the content as specified.
void	writeCommentEnd()
void	writeCommentStart()
void	writeDTD(java.lang.String data) Older "legacy" output method for outputting DOCTYPE declaration.
void	writeDTD(WName rootName, java.lang.String systemId, java.lang.String publicId, java.lang.String internalSubset)
void	writeEndTag(WName name)
void	writeEntityReference(WName name)
protected void	writeName(WName name)
int	writePI(WName target, java.lang.String data)
void	writeRaw(char[] cbuf, int offset, int len)
void	writeRaw(java.lang.String str, int offset, int len)
protected void	writeSegmentedCData(char[] c, int start, int len, int index)
protected void	writeSegmentedCData(java.lang.String content, int index)
protected void	writeSegmentedComment(java.lang.String content, int index)
void	writeSpace(char[] cbuf, int offset, int len)
void	writeSpace(java.lang.String data)
void	writeStartTagEmptyEnd()
void	writeStartTagEnd()
void	writeStartTagStart(WName name) Note: can throw XMLStreamException, if name checking is enabled, and name is invalid (name check has to be in this writer, not caller, since it depends not only on xml limitations, but also on encoding limitations)
void	writeTypedValue(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
void	writeXmlDeclaration(java.lang.String version, java.lang.String encoding, java.lang.String standalone)

Methods inherited from class com.fasterxml.aalto.out.XmlWriter

close, enableXml11, getAbsOffset, getColumn, getRow, guessEncodingBitSize, reportFailedEscaping, reportInvalidChar, reportInvalidEmptyName, reportNwfContent, reportNwfContent, reportNwfName, reportNwfName, throwOutputError, throwOutputError

Methods inherited from class java.lang.Object

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

Field Detail

mSmallWriteSize

protected final int mSmallWriteSize

This is the threshold used to check what is considered a "small" write; small writes will be buffered until resulting size will be above the threshold.

_out

protected java.io.Writer _out

Actual Writer to use for outputting buffered data as appropriate. During active usage, remains as the writer initially set; set to null when this writer is closed.

_outputBuffer

protected char[] _outputBuffer

_outputPtr

protected int _outputPtr

_outputBufferLen

protected final int _outputBufferLen

Constructor Detail

CharXmlWriter

public CharXmlWriter(WriterConfig cfg,
                     java.io.Writer out)

Method Detail

getOutputPtr

protected int getOutputPtr()

Specified by:

getOutputPtr in class XmlWriter

getHighestEncodable

public int getHighestEncodable()

Description copied from class: XmlWriter

Method called by error reporting code, to figure out if a given character is encodable (without using character entities) with the current encoding or not.

Specified by:

getHighestEncodable in class XmlWriter

Returns:

Character code of the highest character that can be natively encoded.

constructName

public WName constructName(java.lang.String localName)

Specified by:

constructName in class XmlWriter

constructName

public WName constructName(java.lang.String prefix,
                           java.lang.String localName)

Specified by:

constructName in class XmlWriter

_releaseBuffers

public void _releaseBuffers()

Overrides:

_releaseBuffers in class XmlWriter

_closeTarget

public void _closeTarget(boolean doClose)
                  throws java.io.IOException

Specified by:

_closeTarget in class XmlWriter

Throws:

java.io.IOException

flush

public final void flush()
                 throws java.io.IOException

Specified by:

flush in class XmlWriter

Throws:

java.io.IOException

writeRaw

public void writeRaw(char[] cbuf,
                     int offset,
                     int len)
              throws java.io.IOException

Specified by:

writeRaw in class XmlWriter

Throws:

java.io.IOException

writeRaw

public void writeRaw(java.lang.String str,
                     int offset,
                     int len)
              throws java.io.IOException

Specified by:

writeRaw in class XmlWriter

Throws:

java.io.IOException

writeCDataStart

public final void writeCDataStart()
                           throws java.io.IOException

Throws:

java.io.IOException

writeCDataEnd

public final void writeCDataEnd()
                         throws java.io.IOException

Throws:

java.io.IOException

writeCommentStart

public final void writeCommentStart()
                             throws java.io.IOException

Throws:

java.io.IOException

writeCommentEnd

public final void writeCommentEnd()
                           throws java.io.IOException

Throws:

java.io.IOException

writeCData

public int writeCData(java.lang.String data)
               throws java.io.IOException,
                      javax.xml.stream.XMLStreamException

Specified by:

writeCData in class XmlWriter

Parameters:

data - Contents of the CDATA section to write out

Returns:

-1 to indicate succesful write, or index of the problematic character in input (first ']' from "]]>" sequence, in non-fixing mode)

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeCData

public int writeCData(char[] cbuf,
                      int offset,
                      int len)
               throws java.io.IOException,
                      javax.xml.stream.XMLStreamException

Specified by:

writeCData in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeCharacters

public void writeCharacters(java.lang.String text)
                     throws java.io.IOException,
                            javax.xml.stream.XMLStreamException

Specified by:

writeCharacters in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeCharacters

public void writeCharacters(char[] cbuf,
                            int offset,
                            int len)
                     throws java.io.IOException,
                            javax.xml.stream.XMLStreamException

Specified by:

writeCharacters in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeSpace

public void writeSpace(java.lang.String data)
                throws java.io.IOException,
                       javax.xml.stream.XMLStreamException

Specified by:

writeSpace in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeSpace

public void writeSpace(char[] cbuf,
                       int offset,
                       int len)
                throws java.io.IOException,
                       javax.xml.stream.XMLStreamException

Specified by:

writeSpace in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeComment

public int writeComment(java.lang.String data)
                 throws java.io.IOException,
                        javax.xml.stream.XMLStreamException

Method that will try to output the content as specified. If the content passed in has embedded "--" in it, it will either add an intervening space between consequtive hyphens (if content fixing is enabled), or return the offset of the first hyphen in multi-hyphen sequence.

Specified by:

writeComment in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeDTD

public void writeDTD(java.lang.String data)
              throws java.io.IOException,
                     javax.xml.stream.XMLStreamException

Description copied from class: XmlWriter

Older "legacy" output method for outputting DOCTYPE declaration. Assumes that the passed-in String contains a complete DOCTYPE declaration properly quoted.

Specified by:

writeDTD in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeDTD

public void writeDTD(WName rootName,
                     java.lang.String systemId,
                     java.lang.String publicId,
                     java.lang.String internalSubset)
              throws java.io.IOException,
                     javax.xml.stream.XMLStreamException

Specified by:

writeDTD in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeEntityReference

public void writeEntityReference(WName name)
                          throws java.io.IOException,
                                 javax.xml.stream.XMLStreamException

Specified by:

writeEntityReference in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeXmlDeclaration

public void writeXmlDeclaration(java.lang.String version,
                                java.lang.String encoding,
                                java.lang.String standalone)
                         throws java.io.IOException,
                                javax.xml.stream.XMLStreamException

Specified by:

writeXmlDeclaration in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writePI

public int writePI(WName target,
                   java.lang.String data)
            throws java.io.IOException,
                   javax.xml.stream.XMLStreamException

Specified by:

writePI in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeStartTagStart

public void writeStartTagStart(WName name)
                        throws java.io.IOException,
                               javax.xml.stream.XMLStreamException

Description copied from class: XmlWriter

Note: can throw XMLStreamException, if name checking is enabled, and name is invalid (name check has to be in this writer, not caller, since it depends not only on xml limitations, but also on encoding limitations)

Specified by:

writeStartTagStart in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeStartTagEnd

public void writeStartTagEnd()
                      throws java.io.IOException,
                             javax.xml.stream.XMLStreamException

Specified by:

writeStartTagEnd in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeStartTagEmptyEnd

public void writeStartTagEmptyEnd()
                           throws java.io.IOException

Specified by:

writeStartTagEmptyEnd in class XmlWriter

Throws:

java.io.IOException

writeEndTag

public void writeEndTag(WName name)
                 throws java.io.IOException,
                        javax.xml.stream.XMLStreamException

Specified by:

writeEndTag in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeAttribute

public void writeAttribute(WName name,
                           java.lang.String value)
                    throws java.io.IOException,
                           javax.xml.stream.XMLStreamException

Description copied from class: XmlWriter

Note: can throw XMLStreamException, if name checking is enabled, and name is invalid (name check has to be in this writer, not caller, since it depends not only on xml limitations, but also on encoding limitations)

Specified by:

writeAttribute in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeAttribute

public void writeAttribute(WName name,
                           char[] value,
                           int offset,
                           int vlen)
                    throws java.io.IOException,
                           javax.xml.stream.XMLStreamException

Specified by:

writeAttribute in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeTypedValue

public void writeTypedValue(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
                     throws java.io.IOException,
                            javax.xml.stream.XMLStreamException

Specified by:

writeTypedValue in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeAttribute

public final void writeAttribute(WName name,
                                 org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
                          throws java.io.IOException,
                                 javax.xml.stream.XMLStreamException

Specified by:

writeAttribute in class XmlWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

writeName

protected final void writeName(WName name)
                        throws java.io.IOException

Throws:

java.io.IOException

verifyCDataContent

protected int verifyCDataContent(java.lang.String content)

Returns:

Index at which a problem was found, if any; -1 if there's no problem.

verifyCDataContent

protected int verifyCDataContent(char[] c,
                                 int start,
                                 int end)

verifyCommentContent

protected int verifyCommentContent(java.lang.String content)

writeSegmentedCData

protected void writeSegmentedCData(java.lang.String content,
                                   int index)
                            throws java.io.IOException

Throws:

java.io.IOException

writeSegmentedCData

protected void writeSegmentedCData(char[] c,
                                   int start,
                                   int len,
                                   int index)
                            throws java.io.IOException

Throws:

java.io.IOException

writeSegmentedComment

protected void writeSegmentedComment(java.lang.String content,
                                     int index)
                              throws java.io.IOException

Throws:

java.io.IOException

writeAsEntity

protected final void writeAsEntity(int c)
                            throws java.io.IOException

Throws:

java.io.IOException