sun.net.www.http

Class PosterOutputStream

java.lang.Object

java.io.OutputStream

java.io.ByteArrayOutputStream

sun.net.www.http.PosterOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class PosterOutputStream
extends ByteArrayOutputStream

Instances of this class are returned to applications for the purpose of sending user data for a HTTP POST or PUT request. This class is used when the content-length will be specified in the header of the request. The semantics of ByteArrayOutputStream are extended so that when close() is called, it is no longer possible to write additional data to the stream. From this point the content length of the request is fixed and cannot change.

Author:

Michael McMahon

Field Summary

Fields inherited from class java.io.ByteArrayOutputStream

buf, count

Constructor Summary

Constructors

Constructor and Description
PosterOutputStream() Creates a new output stream for POST user data

Method Summary

Modifier and Type	Method and Description
void	close() After close() has been called, it is no longer possible to write to this stream.
void	reset() Resets the count field of this output stream to zero, so that all currently accumulated output in the ouput stream is discarded.
void	write(byte[] b, int off, int len) Writes len bytes from the specified byte array starting at offset off to this output stream.
void	write(int b) Writes the specified byte to this output stream.

Methods inherited from class java.io.ByteArrayOutputStream

size, toByteArray, toString, writeTo

Methods inherited from class java.io.OutputStream

flush, write

Methods inherited from class java.lang.Object

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

Constructor Detail

PosterOutputStream

public PosterOutputStream()

Creates a new output stream for POST user data

Method Detail

close

public void close()
           throws IOException

After close() has been called, it is no longer possible to write to this stream. Further calls to write will have no effect.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class ByteArrayOutputStream

Throws:

IOException - if an I/O error occurs.

reset

public void reset()

Resets the count field of this output stream to zero, so that all currently accumulated output in the ouput stream is discarded. The output stream can be used again, reusing the already allocated buffer space. If the output stream has been closed, then this method has no effect.

Overrides:

reset in class ByteArrayOutputStream

See Also:

ByteArrayInputStream.count

write

public void write(byte[] b,
                  int off,
                  int len)

Writes len bytes from the specified byte array starting at offset off to this output stream.

Overrides:

write in class ByteArrayOutputStream

Parameters:

b - the data.

off - the start offset in the data.

len - the number of bytes to write.

write

public void write(int b)

Writes the specified byte to this output stream.

Overrides:

write in class ByteArrayOutputStream

Parameters:

b - the byte to be written.