Class UnsynchronizedByteArrayOutputStream
- java.lang.Object
-
- java.io.OutputStream
-
- org.apache.xml.security.stax.impl.util.UnsynchronizedByteArrayOutputStream
-
- All Implemented Interfaces:
Closeable
,Flushable
,AutoCloseable
public class UnsynchronizedByteArrayOutputStream extends OutputStream
-
-
Constructor Summary
Constructors Constructor Description UnsynchronizedByteArrayOutputStream()
Constructs a new ByteArrayOutputStream with a default size of 32 bytes.UnsynchronizedByteArrayOutputStream(int size)
Constructs a newByteArrayOutputStream
with a default size ofsize
bytes.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
reset()
Resets this stream to the beginning of the underlying byte array.int
size()
Returns the total number of bytes written to this stream so far.byte[]
toByteArray()
Returns the contents of this ByteArrayOutputStream as a byte array.String
toString()
Returns the contents of this ByteArrayOutputStream as a string.String
toString(String enc)
Returns the contents of this ByteArrayOutputStream as a string converted according to the encoding declared inenc
.void
write(byte[] buffer, int offset, int len)
Writescount
bytes from the byte arraybuffer
starting at offsetindex
to this stream.void
write(int oneByte)
Writes the specified byteoneByte
to the OutputStream.void
writeTo(OutputStream out)
Takes the contents of this stream and writes it to the output streamout
.-
Methods inherited from class java.io.OutputStream
close, flush, nullOutputStream, write
-
-
-
-
Constructor Detail
-
UnsynchronizedByteArrayOutputStream
public UnsynchronizedByteArrayOutputStream()
Constructs a new ByteArrayOutputStream with a default size of 32 bytes. If more than 32 bytes are written to this instance, the underlying byte array will expand.
-
UnsynchronizedByteArrayOutputStream
public UnsynchronizedByteArrayOutputStream(int size)
Constructs a newByteArrayOutputStream
with a default size ofsize
bytes. If more thansize
bytes are written to this instance, the underlying byte array will expand.- Parameters:
size
- initial size for the underlying byte array, must be non-negative.- Throws:
IllegalArgumentException
- ifsize
< 0.
-
-
Method Detail
-
reset
public void reset()
Resets this stream to the beginning of the underlying byte array. All subsequent writes will overwrite any bytes previously stored in this stream.
-
size
public int size()
Returns the total number of bytes written to this stream so far.- Returns:
- the number of bytes written to this stream.
-
toByteArray
public byte[] toByteArray()
Returns the contents of this ByteArrayOutputStream as a byte array. Any changes made to the receiver after returning will not be reflected in the byte array returned to the caller.- Returns:
- this stream's current contents as a byte array.
-
toString
public String toString()
Returns the contents of this ByteArrayOutputStream as a string. Any changes made to the receiver after returning will not be reflected in the string returned to the caller.
-
toString
public String toString(String enc) throws UnsupportedEncodingException
Returns the contents of this ByteArrayOutputStream as a string converted according to the encoding declared inenc
.- Parameters:
enc
- a string representing the encoding to use when translating this stream to a string.- Returns:
- this stream's current contents as an encoded string.
- Throws:
UnsupportedEncodingException
- if the provided encoding is not supported.
-
write
public void write(byte[] buffer, int offset, int len)
Writescount
bytes from the byte arraybuffer
starting at offsetindex
to this stream.- Overrides:
write
in classOutputStream
- Parameters:
buffer
- the buffer to be written.offset
- the initial position inbuffer
to retrieve bytes.len
- the number of bytes ofbuffer
to write.- Throws:
NullPointerException
- ifbuffer
isnull
.IndexOutOfBoundsException
- ifoffset < 0
orlen < 0
, or ifoffset + len
is greater than the length ofbuffer
.
-
write
public void write(int oneByte)
Writes the specified byteoneByte
to the OutputStream. Only the low order byte ofoneByte
is written.- Specified by:
write
in classOutputStream
- Parameters:
oneByte
- the byte to be written.
-
writeTo
public void writeTo(OutputStream out) throws IOException
Takes the contents of this stream and writes it to the output streamout
.- Parameters:
out
- an OutputStream on which to write the contents of this stream.- Throws:
IOException
- if an error occurs while writing toout
.
-
-