Package org.apache.commons.httpclient

Class ChunkedOutputStream

java.lang.Object

java.io.OutputStream

org.apache.commons.httpclient.ChunkedOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

@Deprecated
public class ChunkedOutputStream
extends OutputStream

Deprecated.

Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.

Implements HTTP chunking support. Writes are buffered to an internal buffer (2048 default size). Chunks are guaranteed to be at least as large as the buffer size (except for the last chunk).

Constructor Summary

Constructors

Constructor	Description
ChunkedOutputStream(OutputStream stream)	Deprecated. Wraps a stream and chunks the output.
ChunkedOutputStream(OutputStream stream, int bufferSize)	Deprecated. Wraps a stream and chunks the output.

Method Summary

Modifier and Type	Method	Description
void	close()	Deprecated. Finishes writing to the underlying stream, but does NOT close the underlying stream.
void	finish()	Deprecated. Must be called to ensure the internal cache is flushed and the closing chunk is written.
void	flush()	Deprecated. Flushes the underlying stream, but leaves the internal buffer alone.
void	write(byte[] b)	Deprecated. Writes the array.
void	write(byte[] src, int off, int len)	Deprecated.
void	write(int b)	Deprecated. Write the specified byte to our output stream.

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Constructor Detail

ChunkedOutputStream

public ChunkedOutputStream(OutputStream stream,
                           int bufferSize)
                    throws IOException

Deprecated.

Wraps a stream and chunks the output.

Parameters:

stream - to wrap

bufferSize - minimum chunk size (excluding last chunk)

Throws:

IOException

Since:

3.0

ChunkedOutputStream

public ChunkedOutputStream(OutputStream stream)
                    throws IOException

Deprecated.

Wraps a stream and chunks the output. The default buffer size of 2048 was chosen because the chunk overhead is less than 0.5%

Parameters:

stream -

Throws:

IOException

Method Detail

finish

public void finish()
            throws IOException

Deprecated.

Must be called to ensure the internal cache is flushed and the closing chunk is written.

Throws:

IOException

Since:

3.0

write

public void write(int b)
           throws IOException

Deprecated.

Write the specified byte to our output stream. Note: Avoid this method as it will cause an inefficient single byte chunk. Use write (byte[], int, int) instead.

Specified by:

write in class OutputStream

Parameters:

b - The byte to be written

Throws:

IOException - if an input/output error occurs

write

public void write(byte[] b)
           throws IOException

Deprecated.

Writes the array. If the array does not fit within the buffer, it is not split, but rather written out as one large chunk.

Overrides:

write in class OutputStream

Parameters:

b -

Throws:

IOException

Since:

3.0

write

public void write(byte[] src,
                  int off,
                  int len)
           throws IOException

Deprecated.

Overrides:

write in class OutputStream

Throws:

IOException

flush

public void flush()
           throws IOException

Deprecated.

Flushes the underlying stream, but leaves the internal buffer alone.

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException

close

public void close()
           throws IOException

Deprecated.

Finishes writing to the underlying stream, but does NOT close the underlying stream.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream

Throws:

IOException