com.ctc.wstx.sw

Class RestrictedCharsAwareBufferingXmlWriter

java.lang.Object

com.ctc.wstx.sw.XmlWriter

com.ctc.wstx.sw.RestrictedCharsAwareBufferingXmlWriter

All Implemented Interfaces:

XMLStreamConstants

public final class RestrictedCharsAwareBufferingXmlWriter
extends com.ctc.wstx.sw.XmlWriter
implements XMLStreamConstants

Concrete implementation of XmlWriter that will dispatch writes to another writer (of type Writer, and will NOT handle encoding. It will, however, do basic buffering such that the underlying Writer need (and thus, should) not do buffering.

One design goal for this class is to avoid unnecessary buffering: since there will be another Writer doing the actual encoding, amount of buffering needed should still be limited. To this end, a threshold is used to define what's the threshold of writes that we do want to coalesce, ie. buffer. Writes bigger than this should in general proceed without buffering.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	HIGHEST_ENCODABLE_ATTR_CHAR Highest valued character that may need to be encoded (minus charset encoding requirements) when writing attribute values.
protected static int	HIGHEST_ENCODABLE_TEXT_CHAR Highest valued character that may need to be encoded (minus charset encoding requirements) when writing attribute values.
protected Writer	mOut Actual Writer to use for outputting buffered data as appropriate.
protected char[]	mOutputBuffer
protected int	mOutputBufLen
protected int	mOutputPtr
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.
protected OutputStream	mUnderlyingStream Actual physical stream that the writer is using, if known.

Fields inherited from class com.ctc.wstx.sw.XmlWriter

DEFAULT_QUOTE_CHAR, mAttrValueWriter, mAutoCloseOutput, mCheckContent, mCheckNames, mCheckStructure, mConfig, mEncoding, mFixContent, mLocPastChars, mLocRowNr, mLocRowStartOffset, mNsAware, mRawWrapper, mTextWrapper, mTextWriter, mXml11, SURR1_FIRST, SURR1_LAST, SURR2_FIRST, SURR2_LAST

Fields inherited from interface javax.xml.stream.XMLStreamConstants

ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT

Constructor Summary

Constructors

Constructor and Description
RestrictedCharsAwareBufferingXmlWriter(Writer out, com.ctc.wstx.api.WriterConfig cfg, String enc, boolean autoclose, OutputStream outs, int bitsize)

Method Summary

Methods

Modifier and Type	Method and Description
void	close(boolean forceRealClose)
void	flush()
protected int	getOutputPtr()
protected OutputStream	getOutputStream()
protected Writer	getWriter()
static int	guessEncodingBitSize(String enc) Method used to figure out which part of the Unicode char set the encoding can natively support.
static boolean	isRestricted(int character)
protected int	verifyCDataContent(char[] c, int start, int end)
protected int	verifyCDataContent(String content)
protected int	verifyCommentContent(String content)
protected void	writeAsEntity(int c)
void	writeAttribute(String localName, char[] value, int offset, int vlen)
void	writeAttribute(String localName, String value)
void	writeAttribute(String prefix, String localName, char[] value, int offset, int vlen)
void	writeAttribute(String prefix, String localName, String value)
int	writeCData(char[] cbuf, int offset, int len)
int	writeCData(String data)
void	writeCDataEnd()
void	writeCDataStart()
void	writeCharacters(char[] cbuf, int offset, int len)
void	writeCharacters(String text)
int	writeComment(String data) Method that will try to output the content as specified.
void	writeCommentEnd()
void	writeCommentStart()
void	writeDTD(String data)
void	writeDTD(String rootName, String systemId, String publicId, String internalSubset)
void	writeEndTag(String localName)
void	writeEndTag(String prefix, String localName)
void	writeEntityReference(String name)
int	writePI(String target, String data)
void	writePIEnd()
void	writePIStart(String target, boolean addSpace)
protected void	writePrefixedName(String prefix, String localName)
void	writeRaw(char[] cbuf, int offset, int len)
void	writeRaw(String str)
void	writeRaw(String str, int offset, int len)
void	writeRawAscii(char[] cbuf, int offset, int len) Method called to output typed values (int, long, double, float etc) that are known not to contain any escapable characters, or anything else beyond 7-bit ascii range.
protected void	writeSegmentedCData(char[] c, int start, int len, int index)
protected void	writeSegmentedCData(String content, int index)
protected void	writeSegmentedComment(String content, int index)
void	writeStartTagEmptyEnd()
void	writeStartTagEnd()
void	writeStartTagStart(String localName)
void	writeStartTagStart(String prefix, String localName)
void	writeTypedAttribute(String localName, org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
void	writeTypedAttribute(String prefix, String localName, org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
void	writeTypedAttribute(String prefix, String localName, String nsURI, org.codehaus.stax2.ri.typed.AsciiValueEncoder enc, org.codehaus.stax2.validation.XMLValidator validator, char[] copyBuffer)
void	writeTypedElement(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
void	writeTypedElement(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc, org.codehaus.stax2.validation.XMLValidator validator, char[] copyBuffer)
void	writeXmlDeclaration(String version, String encoding, String standalone)

Methods inherited from class com.ctc.wstx.sw.XmlWriter

enableXml11, getAbsOffset, getColumn, getRow, handleInvalidChar, reportNwfContent, reportNwfName, reportNwfName, throwOutputError, throwOutputError, verifyNameValidity, wrapAsRawWriter, wrapAsTextWriter

Methods inherited from class java.lang.Object

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

Field Detail

HIGHEST_ENCODABLE_ATTR_CHAR

protected static final int HIGHEST_ENCODABLE_ATTR_CHAR

Highest valued character that may need to be encoded (minus charset encoding requirements) when writing attribute values.

See Also:

Constant Field Values

HIGHEST_ENCODABLE_TEXT_CHAR

protected static final int HIGHEST_ENCODABLE_TEXT_CHAR

Highest valued character that may need to be encoded (minus charset encoding requirements) when writing attribute values.

See Also:

Constant Field Values

mOut

protected final Writer mOut

Actual Writer to use for outputting buffered data as appropriate.

mOutputBuffer

protected char[] mOutputBuffer

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.

mOutputPtr

protected int mOutputPtr

mOutputBufLen

protected int mOutputBufLen

mUnderlyingStream

protected final OutputStream mUnderlyingStream

Actual physical stream that the writer is using, if known. Not used for actual output, only needed so that calling application may (try to) figure out the original source.

Constructor Detail

RestrictedCharsAwareBufferingXmlWriter

public RestrictedCharsAwareBufferingXmlWriter(Writer out,
                                      com.ctc.wstx.api.WriterConfig cfg,
                                      String enc,
                                      boolean autoclose,
                                      OutputStream outs,
                                      int bitsize)
                                       throws IOException

Parameters:

outs - Underlying OutputStream that the writer (out) is using, if known. Needed to support (optional) access to the underlying stream

Throws:

IOException

Method Detail

getOutputPtr

protected int getOutputPtr()

Specified by:

getOutputPtr in class com.ctc.wstx.sw.XmlWriter

getOutputStream

protected final OutputStream getOutputStream()

Specified by:

getOutputStream in class com.ctc.wstx.sw.XmlWriter

getWriter

protected final Writer getWriter()

Specified by:

getWriter in class com.ctc.wstx.sw.XmlWriter

close

public void close(boolean forceRealClose)
           throws IOException

Specified by:

close in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

flush

public final void flush()
                 throws IOException

Specified by:

flush in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeRaw

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

Specified by:

writeRaw in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeRawAscii

public final void writeRawAscii(char[] cbuf,
                 int offset,
                 int len)
                         throws IOException

Method called to output typed values (int, long, double, float etc) that are known not to contain any escapable characters, or anything else beyond 7-bit ascii range.

Specified by:

writeRawAscii in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeRaw

public void writeRaw(String str)
              throws IOException

Overrides:

writeRaw in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeRaw

public void writeRaw(String str,
            int offset,
            int len)
              throws IOException

Specified by:

writeRaw in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCDataStart

public final void writeCDataStart()
                           throws IOException

Specified by:

writeCDataStart in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCDataEnd

public final void writeCDataEnd()
                         throws IOException

Specified by:

writeCDataEnd in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCommentStart

public final void writeCommentStart()
                             throws IOException

Specified by:

writeCommentStart in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCommentEnd

public final void writeCommentEnd()
                           throws IOException

Specified by:

writeCommentEnd in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writePIStart

public final void writePIStart(String target,
                boolean addSpace)
                        throws IOException

Specified by:

writePIStart in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writePIEnd

public final void writePIEnd()
                      throws IOException

Specified by:

writePIEnd in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCData

public int writeCData(String data)
               throws IOException

Specified by:

writeCData in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCData

public int writeCData(char[] cbuf,
             int offset,
             int len)
               throws IOException

Specified by:

writeCData in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCharacters

public void writeCharacters(String text)
                     throws IOException

Specified by:

writeCharacters in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeCharacters

public void writeCharacters(char[] cbuf,
                   int offset,
                   int len)
                     throws IOException

Specified by:

writeCharacters in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeComment

public int writeComment(String data)
                 throws IOException

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 com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeDTD

public void writeDTD(String data)
              throws IOException

Specified by:

writeDTD in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeDTD

public void writeDTD(String rootName,
            String systemId,
            String publicId,
            String internalSubset)
              throws IOException,
                     XMLStreamException

Specified by:

writeDTD in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeEntityReference

public void writeEntityReference(String name)
                          throws IOException,
                                 XMLStreamException

Specified by:

writeEntityReference in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeXmlDeclaration

public void writeXmlDeclaration(String version,
                       String encoding,
                       String standalone)
                         throws IOException

Specified by:

writeXmlDeclaration in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writePI

public int writePI(String target,
          String data)
            throws IOException,
                   XMLStreamException

Specified by:

writePI in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeStartTagStart

public void writeStartTagStart(String localName)
                        throws IOException,
                               XMLStreamException

Specified by:

writeStartTagStart in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeStartTagStart

public void writeStartTagStart(String prefix,
                      String localName)
                        throws IOException,
                               XMLStreamException

Specified by:

writeStartTagStart in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeStartTagEnd

public void writeStartTagEnd()
                      throws IOException

Specified by:

writeStartTagEnd in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeStartTagEmptyEnd

public void writeStartTagEmptyEnd()
                           throws IOException

Specified by:

writeStartTagEmptyEnd in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeEndTag

public void writeEndTag(String localName)
                 throws IOException

Specified by:

writeEndTag in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeEndTag

public void writeEndTag(String prefix,
               String localName)
                 throws IOException

Specified by:

writeEndTag in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeAttribute

public void writeAttribute(String localName,
                  String value)
                    throws IOException,
                           XMLStreamException

Specified by:

writeAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeAttribute

public void writeAttribute(String localName,
                  char[] value,
                  int offset,
                  int vlen)
                    throws IOException,
                           XMLStreamException

Specified by:

writeAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeAttribute

public void writeAttribute(String prefix,
                  String localName,
                  String value)
                    throws IOException,
                           XMLStreamException

Specified by:

writeAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeAttribute

public void writeAttribute(String prefix,
                  String localName,
                  char[] value,
                  int offset,
                  int vlen)
                    throws IOException,
                           XMLStreamException

Specified by:

writeAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeTypedElement

public final void writeTypedElement(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
                             throws IOException

Specified by:

writeTypedElement in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

writeTypedElement

public final void writeTypedElement(org.codehaus.stax2.ri.typed.AsciiValueEncoder enc,
                     org.codehaus.stax2.validation.XMLValidator validator,
                     char[] copyBuffer)
                             throws IOException,
                                    XMLStreamException

Specified by:

writeTypedElement in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeTypedAttribute

public void writeTypedAttribute(String localName,
                       org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
                         throws IOException,
                                XMLStreamException

Specified by:

writeTypedAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeTypedAttribute

public void writeTypedAttribute(String prefix,
                       String localName,
                       org.codehaus.stax2.ri.typed.AsciiValueEncoder enc)
                         throws IOException,
                                XMLStreamException

Specified by:

writeTypedAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writeTypedAttribute

public void writeTypedAttribute(String prefix,
                       String localName,
                       String nsURI,
                       org.codehaus.stax2.ri.typed.AsciiValueEncoder enc,
                       org.codehaus.stax2.validation.XMLValidator validator,
                       char[] copyBuffer)
                         throws IOException,
                                XMLStreamException

Specified by:

writeTypedAttribute in class com.ctc.wstx.sw.XmlWriter

Throws:

IOException

XMLStreamException

writePrefixedName

protected final void writePrefixedName(String prefix,
                     String localName)
                                throws IOException

Throws:

IOException

verifyCDataContent

protected int verifyCDataContent(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(String content)

writeSegmentedCData

protected void writeSegmentedCData(String content,
                       int index)
                            throws IOException

Throws:

IOException

writeSegmentedCData

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

Throws:

IOException

writeSegmentedComment

protected void writeSegmentedComment(String content,
                         int index)
                              throws IOException

Throws:

IOException

guessEncodingBitSize

public static int guessEncodingBitSize(String enc)

Method used to figure out which part of the Unicode char set the encoding can natively support. Values returned are 7, 8 and 16, to indicate (respectively) "ascii", "ISO-Latin" and "native Unicode". These just best guesses, but should work ok for the most common encodings.

writeAsEntity

protected final void writeAsEntity(int c)
                            throws IOException

Throws:

IOException

isRestricted

public static boolean isRestricted(int character)