Package org.apache.commons.io.output
Class UnsynchronizedByteArrayOutputStream
java.lang.Object
java.io.OutputStream
org.apache.commons.io.output.AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
org.apache.commons.io.output.UnsynchronizedByteArrayOutputStream
- All Implemented Interfaces:
- Closeable,- Flushable,- AutoCloseable
public final class UnsynchronizedByteArrayOutputStream
extends AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
Implements a version of 
AbstractByteArrayOutputStream without any concurrent thread safety.
 
 To build an instance, use UnsynchronizedByteArrayOutputStream.Builder.
 
- Since:
- 2.7
- See Also:
- 
Nested Class SummaryNested ClassesNested classes/interfaces inherited from class org.apache.commons.io.output.AbstractByteArrayOutputStreamAbstractByteArrayOutputStream.InputStreamConstructor<T extends InputStream>
- 
Field SummaryFields inherited from class org.apache.commons.io.output.AbstractByteArrayOutputStreamcount
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionbuilder()Constructs a newUnsynchronizedByteArrayOutputStream.Builder.voidreset()intsize()Returns the current size of the byte array.static InputStreamtoBufferedInputStream(InputStream input) Fetches entire contents of anInputStreamand represent same data as result InputStream.static InputStreamtoBufferedInputStream(InputStream input, int size) Fetches entire contents of anInputStreamand represent same data as result InputStream.byte[]Gets the current contents of this byte stream as a byte array.Gets the current contents of this byte stream as an Input Stream.voidwrite(byte[] b, int off, int len) voidwrite(int b) intwrite(InputStream in) Writes the entire contents of the specified input stream to this byte stream.voidwriteTo(OutputStream out) Writes the entire contents of this byte stream to the specified output stream.Methods inherited from class org.apache.commons.io.output.AbstractByteArrayOutputStreamasThis, close, needNewBuffer, resetImpl, toByteArrayImpl, toInputStream, toString, toString, toString, write, write, writeImpl, writeImpl, writeImpl, writeToImplMethods inherited from class java.io.OutputStreamflush
- 
Constructor Details- 
UnsynchronizedByteArrayOutputStreamDeprecated.Constructs a new byte array output stream. The buffer capacity is initially 1024 bytes, though its size increases if necessary.
- 
UnsynchronizedByteArrayOutputStreamDeprecated.Usebuilder(),UnsynchronizedByteArrayOutputStream.Builder, andUnsynchronizedByteArrayOutputStream.Builder.get(). Will be private in 3.0.0.Constructs a new byte array output stream, with a buffer capacity of the specified size, in bytes.- Parameters:
- size- the initial size
- Throws:
- IllegalArgumentException- if size is negative
 
 
- 
- 
Method Details- 
builderConstructs a newUnsynchronizedByteArrayOutputStream.Builder.- Returns:
- a new UnsynchronizedByteArrayOutputStream.Builder.
 
- 
toBufferedInputStreamFetches entire contents of anInputStreamand represent same data as result InputStream.This method is useful where, - Source InputStream is slow.
- It has network resources associated, so we cannot keep it open for long time.
- It has network timeout associated.
 toByteArray(), since it avoids unnecessary allocation and copy of byte[].
 This method buffers the input internally, so there is no need to use aBufferedInputStream.- Parameters:
- input- Stream to be fully buffered.
- Returns:
- A fully buffered stream.
- Throws:
- IOException- if an I/O error occurs.
 
- 
toBufferedInputStreamFetches entire contents of anInputStreamand represent same data as result InputStream.This method is useful where, - Source InputStream is slow.
- It has network resources associated, so we cannot keep it open for long time.
- It has network timeout associated.
 toByteArray(), since it avoids unnecessary allocation and copy of byte[].
 This method buffers the input internally, so there is no need to use aBufferedInputStream.- Parameters:
- input- Stream to be fully buffered.
- size- the initial buffer size
- Returns:
- A fully buffered stream.
- Throws:
- IOException- if an I/O error occurs.
 
- 
resetDescription copied from class:AbstractByteArrayOutputStream- Specified by:
- resetin class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- See Also:
 
- 
sizeDescription copied from class:AbstractByteArrayOutputStreamReturns the current size of the byte array.- Specified by:
- sizein class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- Returns:
- the current size of the byte array
 
- 
toByteArrayDescription copied from class:AbstractByteArrayOutputStreamGets the current contents of this byte stream as a byte array. The result is independent of this stream.- Specified by:
- toByteArrayin class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- Returns:
- the current contents of this output stream, as a byte array
- See Also:
 
- 
toInputStreamDescription copied from class:AbstractByteArrayOutputStreamGets the current contents of this byte stream as an Input Stream. The returned stream is backed by buffers ofthisstream, avoiding memory allocation and copy, thus saving space and time.- Specified by:
- toInputStreamin class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- Returns:
- the current contents of this output stream.
- See Also:
 
- 
write- Specified by:
- writein class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
 
- 
writeDescription copied from class:AbstractByteArrayOutputStreamWrites the entire contents of the specified input stream to this byte stream. Bytes from the input stream are read directly into the internal buffer of this stream.- Specified by:
- writein class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- Parameters:
- in- the input stream to read from
- Returns:
- total number of bytes read from the input stream (and written to this stream)
- Throws:
- IOException- if an I/O error occurs while reading the input stream
 
- 
write- Specified by:
- writein class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
 
- 
writeToDescription copied from class:AbstractByteArrayOutputStreamWrites the entire contents of this byte stream to the specified output stream.- Specified by:
- writeToin class- AbstractByteArrayOutputStream<UnsynchronizedByteArrayOutputStream>
- Parameters:
- out- the output stream to write to
- Throws:
- IOException- if an I/O error occurs, such as if the stream is closed
- See Also:
 
 
- 
builder(),UnsynchronizedByteArrayOutputStream.Builder, andUnsynchronizedByteArrayOutputStream.Builder.get().