java.io
Class OutputStream

java.lang.Object
  java.io.OutputStream

All Implemented Interfaces:

Closeable, Flushable

Direct Known Subclasses:

ByteArrayOutputStream, ChunkedOutputStream, ContentLengthOutputStream, FileHandler.MeasureOutputStream, FileOutputStream, FilterOutputStream, IdentityOutputStream, JarVerifier.VerifierEntry, LocalSocketImpl.SocketOutputStream, ObjectOutputStream, PipedOutputStream, WriterOutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

OutputStream is an abstract class for all byte output streams. It provides basic method implementations for writing bytes to a stream.

See Also:

InputStream

Constructor Summary

OutputStream()
Default constructor.

Method Summary

void	close() Close this OutputStream.
void	flush() Flush this OutputStream.
void	write(byte[] buffer) Writes the entire contents of the byte array buffer to this OutputStream.
void	write(byte[] buffer, int offset, int count) Writes count bytes from the byte array buffer starting at offset to this OutputStream.
abstract void	write(int oneByte) Writes the specified byte oneByte to this OutputStream.

Methods inherited from class java.lang.Object

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

Constructor Detail

OutputStream

public OutputStream()

Default constructor.

Method Detail

close

public void close()
           throws IOException

Close this OutputStream. Concrete implementations of this class should free any resources during close. This implementation does nothing.

Specified by:

close in interface Closeable

Throws:

IOException - If an error occurs attempting to close this OutputStream.

flush

public void flush()
           throws IOException

Flush this OutputStream. Concrete implementations of this class should ensure any pending writes to the underlying stream are written out when this method is envoked. This implementation does nothing.

Specified by:

flush in interface Flushable

Throws:

IOException - If an error occurs attempting to flush this OutputStream.

write

public void write(byte[] buffer)
           throws IOException

Writes the entire contents of the byte array buffer to this OutputStream.

Parameters:

buffer - the buffer to be written

Throws:

IOException - If an error occurs attempting to write to this OutputStream.

write

public void write(byte[] buffer,
                  int offset,
                  int count)
           throws IOException

Writes count bytes from the byte array buffer starting at offset to this OutputStream.

Parameters:

buffer - the buffer to be written

offset - offset in buffer to get bytes

count - number of bytes in buffer to write

Throws:

IOException - If an error occurs attempting to write to this OutputStream.

IndexOutOfBoundsException - If offset or count are outside of bounds.

write

public abstract void write(int oneByte)
                    throws IOException

Writes the specified byte oneByte to this OutputStream. Only the low order byte of oneByte is written.

Parameters:

oneByte - the byte to be written

Throws:

IOException - If an error occurs attempting to write to this OutputStream.