Index (Frames) | Index (No Frames) | Package | Package Tree | Tree
java.io

Class Writer

java.lang.Object
|
+--java.io.Writer


public abstract class Writer

extends Object

This abstract class forms the base of the hierarchy of classes that write output as a stream of chars. It provides a common set of methods for writing chars to stream. Subclasses implement and/or extend these methods to write chars in a particular manner or to a particular destination such as a file on disk or network connection.

Authors:

Field Summary

java.lang.Objectlock

This is the object used to synchronize criticial code sections for thread safety.

Constructor Summary

Writer()

This is the default no-argument constructor for this class.
Writer(java.lang.Object lock)

This method initializes a Writer that will synchronize on the specified Object.

Method Summary

voidclose()

This method closes the stream.
voidflush()

This method forces any data that may have been buffered to be written to the underlying output device.
voidwrite(int b)

This method writes a single char to the output stream.
voidwrite(char[] buf)

This method all the writes char from the passed array to the output stream.
voidwrite(char[] buf, int offset, int len)

This method writes len char from the specified array buf starting at index offset into the array.
voidwrite(java.lang.String str)

This method writes all the characters in a String to the output.
voidwrite(java.lang.String str, int offset, int len)

This method writes len chars from the String starting at position offset.

Field Details

lock

protected Object lock

This is the object used to synchronize criticial code sections for thread safety. Subclasses should use this field instead of using synchronized methods or explicity synchronizations on this


Constructor Details

Writer

protected Writer()

This is the default no-argument constructor for this class. This method will set up the class to synchronize criticial sections on itself.


Writer

protected Writer(java.lang.Object lock)

This method initializes a Writer that will synchronize on the specified Object.

Parameters:


Method Details

close

public void close()

This method closes the stream. Any internal or native resources associated with this stream are freed. Any subsequent attempt to access the stream might throw an exception.

This method in this class does nothing.

Throws:


flush

public void flush()

This method forces any data that may have been buffered to be written to the underlying output device. Please note that the host environment might perform its own buffering unbeknowst to Java. In that case, a write made (for example, to a disk drive) might be cached in OS buffers instead of actually being written to disk.

Throws:


write

public void write(char[] buf)

This method all the writes char from the passed array to the output stream. This method is equivalent to write(buf, 0, buf.length) which is exactly how it is implemented in this class.

Parameters:

Throws:


write

public void write(char[] buf, int offset, int len)

This method writes len char from the specified array buf starting at index offset into the array.

Subclasses must provide an implementation of this abstract method.

Parameters:

Throws:


write

public void write(int b)

This method writes a single char to the output stream.

Parameters:

Throws:


write

public void write(java.lang.String str)

This method writes all the characters in a String to the output.

Parameters:


write

public void write(java.lang.String str, int offset, int len)

This method writes len chars from the String starting at position offset.

Parameters:

Throws: