oracle.adfnmc.java.io
Class Writer

java.lang.Object
  java.io.Writer
      oracle.adfnmc.java.io.Writer

All Implemented Interfaces:

Closeable, Flushable

Direct Known Subclasses:

PrintWriter, StringWriter

public abstract class Writer
extends java.io.Writer
implements Closeable, Flushable

Writer is an Abstract class for writing Character Streams. Subclasses of writer must implement the methods write(char[], int, int), close() and flush().

See Also:

Reader

Field Summary

protected java.lang.Object

lock The object used to synchronize access to the writer.

Constructor Summary

protected	Writer() Constructs a new character stream Writer using this as the Object to synchronize critical regions around.
protected	Writer(java.lang.Object lock) Constructs a new character stream Writer using lock as the Object to synchronize critical regions around.

Method Summary

Writer	append(char c) Append a char cto the Writer.
abstract void	close() Close this Writer.
abstract void	flush() Flush this Writer.
void	write(char[] buf) Writes the entire character buffer buf to this Writer.
abstract void	write(char[] buf, int offset, int count) Writes count characters starting at offset in buf to this Writer.
void	write(int oneChar) Writes the specified character oneChar to this Writer.
void	write(java.lang.String str) Writes the characters from the String str to this Writer.
void	write(java.lang.String str, int offset, int count) Writes count number of characters starting at offset from the String str to this Writer.

Methods inherited from class java.lang.Object

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

Field Detail

lock

protected java.lang.Object lock

The object used to synchronize access to the writer.

Constructor Detail

Writer

protected Writer()

Constructs a new character stream Writer using this as the Object to synchronize critical regions around.

Writer

protected Writer(java.lang.Object lock)

Constructs a new character stream Writer using lock as the Object to synchronize critical regions around.

Parameters:

lock - the Object to synchronize critical regions around.

Method Detail

close

public abstract void close()
                    throws java.io.IOException

Close this Writer. This must be implemented by any concrete subclasses. The implementation should free any resources associated with the Writer.

Specified by:

close in interface Closeable

Specified by:

close in class java.io.Writer

Throws:

java.io.IOException - If an error occurs attempting to close this Writer.

flush

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

Flush this Writer. This must be implemented by any concrete subclasses. The implementation should ensure all buffered characters are written out.

Specified by:

flush in interface Flushable

Specified by:

flush in class java.io.Writer

Throws:

java.io.IOException - If an error occurs attempting to flush this Writer.

write

public void write(char[] buf)
           throws java.io.IOException

Writes the entire character buffer buf to this Writer.

Overrides:

write in class java.io.Writer

Parameters:

buf - the non-null array containing characters to write.

Throws:

java.io.IOException - If this Writer has already been closed or some other IOException occurs.

write

public abstract void write(char[] buf,
                           int offset,
                           int count)
                    throws java.io.IOException

Writes count characters starting at offset in buf to this Writer. This abstract method must be implemented by concrete subclasses.

Specified by:

write in class java.io.Writer

Parameters:

buf - the non-null array containing characters to write.

offset - offset in buf to retrieve characters

count - maximum number of characters to write

Throws:

java.io.IOException - If this Writer has already been closed or some other IOException occurs.

java.lang.ArrayIndexOutOfBoundsException - If offset or count are outside of bounds.

write

public void write(int oneChar)
           throws java.io.IOException

Writes the specified character oneChar to this Writer. This implementation writes the low order two bytes of oneChar to the Stream.

Overrides:

write in class java.io.Writer

Parameters:

oneChar - The character to write

Throws:

java.io.IOException - If this Writer has already been closed or some other IOException occurs.

write

public void write(java.lang.String str)
           throws java.io.IOException

Writes the characters from the String str to this Writer.

Overrides:

write in class java.io.Writer

Parameters:

str - the non-null String containing the characters to write.

Throws:

java.io.IOException - If this Writer has already been closed or some other IOException occurs.

write

public void write(java.lang.String str,
                  int offset,
                  int count)
           throws java.io.IOException

Writes count number of characters starting at offset from the String str to this Writer.

Overrides:

write in class java.io.Writer

Parameters:

str - the non-null String containing the characters to write.

offset - the starting point to retrieve characters.

count - the number of characters to retrieve and write.

Throws:

java.io.IOException - If this Writer has already been closed or some other IOException occurs.

java.lang.ArrayIndexOutOfBoundsException - If offset or count are outside of bounds.

append

public Writer append(char c)
              throws java.io.IOException

Append a char cto the Writer. The Writer.append(c) works the same as Writer.write( c).

Parameters:

c - The character appended to the Writer.

Returns:

The Writer.

Throws:

java.io.IOException - If any IOException raises during the procedure.