Top Description Inners Fields Constructors Methods
com.ctc.wstx.sw

public abstract Class XmlWriterWrapper

extends Writer
Class Inheritance
Known Direct Subclasses
com.ctc.wstx.sw.XmlWriterWrapper.RawWrapper, com.ctc.wstx.sw.XmlWriterWrapper.TextWrapper
Imports
java.io.*

This is a simple wrapper class, which decorates an XmlWriter to look like a Writer. This is necessary to implement a (legacy) character quoting system introduced for Woodstox 2.0, which relies on having a Writer to use for outputting.

Nested and Inner Type Summary

Modifier and TypeClass and Description
private static class
XmlWriterWrapper.RawWrapper

This wrapper directs calls to writeRaw methods.

private static class
XmlWriterWrapper.TextWrapper

This wrapper directs calls to writeCharacters methods.

Field Summary

Modifier and TypeField and Description
private char[]
protected final XmlWriter
Inherited from java.io.Writer:
lock

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public final void
close()

Implements abstract java.io.Writer.close.

Implements java.io.Closeable.close.

Closes the stream, flushing it first.

public final void
flush()

Implements abstract java.io.Writer.flush.

Implements java.io.Flushable.flush.

Flushes the stream.

public static XmlWriterWrapper
public static XmlWriterWrapper
public final void
write(char[]
Array of characters to be written
cbuf
)

Overrides java.io.Writer.write.

Writes an array of characters.

public abstract void
write(char[]
Array of characters
cbuf
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Implements abstract java.io.Writer.write.

Writes a portion of an array of characters.

public final void
write(int
int specifying a character to be written
c
)

Overrides java.io.Writer.write.

Writes a single character.

public abstract void
write(String
String to be written
str
)

Overrides java.io.Writer.write.

Writes a string.

public abstract void
write(String
A String
str
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Overrides java.io.Writer.write.

Writes a portion of a string.

Inherited from java.io.Writer:
appendappendappendnullWriter

Field Detail

mBufferback to summary
private char[] mBuffer
mWriterback to summary
protected final XmlWriter mWriter

Constructor Detail

XmlWriterWrapperback to summary
protected XmlWriterWrapper(XmlWriter writer)

Method Detail

closeback to summary
public final void close() throws IOException

Implements abstract java.io.Writer.close.

Implements java.io.Closeable.close.

Doc from java.io.Writer.close.

Closes the stream, flushing it first. Once the stream has been closed, further write() or flush() invocations will cause an IOException to be thrown. Closing a previously closed stream has no effect.

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
flushback to summary
public final void flush() throws IOException

Implements abstract java.io.Writer.flush.

Implements java.io.Flushable.flush.

Doc from java.io.Writer.flush.

Flushes the stream. If the stream has saved any characters from the various write() methods in a buffer, write them immediately to their intended destination. Then, if that destination is another character or byte stream, flush it. Thus one flush() invocation will flush all the buffers in a chain of Writers and OutputStreams.

If the intended destination of this stream is an abstraction provided by the underlying operating system, for example a file, then flushing the stream guarantees only that bytes previously written to the stream are passed to the operating system for writing; it does not guarantee that they are actually written to a physical device such as a disk drive.

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
wrapWriteCharactersback to summary
public static XmlWriterWrapper wrapWriteCharacters(XmlWriter xw)
wrapWriteRawback to summary
public static XmlWriterWrapper wrapWriteRaw(XmlWriter xw)
writeback to summary
public final void write(char[] cbuf) throws IOException

Overrides java.io.Writer.write.

Doc from java.io.Writer.write.

Writes an array of characters.

Parameters
cbuf:char[]

Array of characters to be written

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public abstract void write(char[] cbuf, int off, int len) throws IOException

Implements abstract java.io.Writer.write.

Doc from java.io.Writer.write.

Writes a portion of an array of characters.

Parameters
cbuf:char[]

Array of characters

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public final void write(int c) throws IOException

Overrides java.io.Writer.write.

Doc from java.io.Writer.write.

Writes a single character. The character to be written is contained in the 16 low-order bits of the given integer value; the 16 high-order bits are ignored.

Subclasses that intend to support efficient single-character output should override this method.

Parameters
c:int

int specifying a character to be written

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public abstract void write(String str) throws IOException

Overrides java.io.Writer.write.

Doc from java.io.Writer.write.

Writes a string.

Parameters
str:String

String to be written

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public abstract void write(String str, int off, int len) throws IOException

Overrides java.io.Writer.write.

Doc from java.io.Writer.write.

Writes a portion of a string.

Parameters
str:String

A String

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
com.ctc.wstx.sw back to summary

private final Class XmlWriterWrapper.RawWrapper

extends XmlWriterWrapper
Class Inheritance

This wrapper directs calls to writeRaw methods. Thus, it is a "vanilla" writer, and no escaping is done.

Field Summary

Inherited from com.ctc.wstx.sw.XmlWriterWrapper:
mWriter

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public void
write(char[]
Array of characters
cbuf
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a portion of an array of characters.

public void
write(String
A String
str
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a portion of a string.

public final void
write(String
String to be written
str
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a string.

Inherited from com.ctc.wstx.sw.XmlWriterWrapper:
closeflushwrapWriteCharacterswrapWriteRawwritewrite

Constructor Detail

RawWrapperback to summary
protected RawWrapper(XmlWriter writer)

Method Detail

writeback to summary
public void write(char[] cbuf, int off, int len) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a portion of an array of characters.

Parameters
cbuf:char[]

Array of characters

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public void write(String str, int off, int len) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a portion of a string.

Parameters
str:String

A String

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public final void write(String str) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a string.

Parameters
str:String

String to be written

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
com.ctc.wstx.sw back to summary

private Class XmlWriterWrapper.TextWrapper

extends XmlWriterWrapper
Class Inheritance

This wrapper directs calls to writeCharacters methods. This means that text content escaping (and, possibly, validation) is done, using default or custom escaping code.

Field Summary

Inherited from com.ctc.wstx.sw.XmlWriterWrapper:
mWriter

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public void
write(char[]
Array of characters
cbuf
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a portion of an array of characters.

public void
write(String
String to be written
str
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a string.

public void
write(String
A String
str
,
int
Offset from which to start writing characters
off
,
int
Number of characters to write
len
)

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Writes a portion of a string.

Inherited from com.ctc.wstx.sw.XmlWriterWrapper:
closeflushwrapWriteCharacterswrapWriteRawwritewrite

Constructor Detail

TextWrapperback to summary
protected TextWrapper(XmlWriter writer)

Method Detail

writeback to summary
public void write(char[] cbuf, int off, int len) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a portion of an array of characters.

Parameters
cbuf:char[]

Array of characters

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public void write(String str) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a string.

Parameters
str:String

String to be written

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs
writeback to summary
public void write(String str, int off, int len) throws IOException

Implements abstract com.ctc.wstx.sw.XmlWriterWrapper.write.

Doc from java.io.Writer.write.

Writes a portion of a string.

Parameters
str:String

A String

off:int

Offset from which to start writing characters

len:int

Number of characters to write

Annotations
@Override
Exceptions
IOException:
If an I/O error occurs