private static class ByteSource.ByteArrayByteSource extends ByteSource
ByteSource.AsCharSource
Modifier and Type | Field and Description |
---|---|
(package private) byte[] |
bytes |
(package private) int |
length |
(package private) int |
offset |
Constructor and Description |
---|
ByteArrayByteSource(byte[] bytes) |
ByteArrayByteSource(byte[] bytes,
int offset,
int length) |
Modifier and Type | Method and Description |
---|---|
long |
copyTo(java.io.OutputStream output)
Copies the contents of this byte source to the given
OutputStream . |
HashCode |
hash(HashFunction hashFunction)
Hashes the contents of this byte source using the given hash function.
|
boolean |
isEmpty()
Returns whether the source has zero bytes.
|
java.io.InputStream |
openBufferedStream()
Opens a new buffered
InputStream for reading from this source. |
java.io.InputStream |
openStream()
Opens a new
InputStream for reading from this source. |
byte[] |
read()
Reads the full contents of this byte source as a byte array.
|
<T> T |
read(ByteProcessor<T> processor)
Reads the contents of this byte source using the given
processor to process bytes as
they are read. |
long |
size()
Returns the size of this source in bytes, even if doing so requires opening and traversing an
entire stream.
|
Optional<java.lang.Long> |
sizeIfKnown()
Returns the size of this source in bytes, if the size can be easily determined without actually
opening the data stream.
|
ByteSource |
slice(long offset,
long length)
Returns a view of a slice of this byte source that is at most
length bytes long
starting at the given offset . |
java.lang.String |
toString() |
asCharSource, concat, concat, concat, contentEquals, copyTo, empty, wrap
ByteArrayByteSource(byte[] bytes)
ByteArrayByteSource(byte[] bytes, int offset, int length)
public java.io.InputStream openStream()
ByteSource
InputStream
for reading from this source. This method returns a new,
independent stream each time it is called.
The caller is responsible for ensuring that the returned stream is closed.
openStream
in class ByteSource
public java.io.InputStream openBufferedStream() throws java.io.IOException
ByteSource
InputStream
for reading from this source. The returned stream is
not required to be a BufferedInputStream
in order to allow implementations to simply
delegate to ByteSource.openStream()
when the stream returned by that method does not benefit from
additional buffering (for example, a ByteArrayInputStream
). This method returns a new,
independent stream each time it is called.
The caller is responsible for ensuring that the returned stream is closed.
openBufferedStream
in class ByteSource
java.io.IOException
- if an I/O error occurs while opening the streampublic boolean isEmpty()
ByteSource
ByteSource.sizeIfKnown()
, returning true if it's known to be zero and false if it's known to be non-zero.
If the size is not known, it falls back to opening a stream and checking for EOF.
Note that, in cases where sizeIfKnown
returns zero, it is possible that bytes
are actually available for reading. (For example, some special files may return a size of 0
despite actually having content when read.) This means that a source may return true
from isEmpty()
despite having readable content.
isEmpty
in class ByteSource
public long size()
ByteSource
ByteSource.sizeIfKnown()
.
The default implementation calls ByteSource.sizeIfKnown()
and returns the value if present. If
absent, it will fall back to a heavyweight operation that will open a stream, read (or skip
, if possible) to the end of the stream and return the total number
of bytes that were read.
Note that for some sources that implement ByteSource.sizeIfKnown()
to provide a more efficient
implementation, it is possible that this method will return a different number of bytes
than would be returned by reading all of the bytes (for example, some special files may return
a size of 0 despite actually having content when read).
In either case, for mutable sources such as files, a subsequent read may return a different number of bytes if the contents are changed.
size
in class ByteSource
public Optional<java.lang.Long> sizeIfKnown()
ByteSource
The default implementation returns Optional.absent()
. Some sources, such as a file,
may return a non-absent value. Note that in such cases, it is possible that this method
will return a different number of bytes than would be returned by reading all of the bytes (for
example, some special files may return a size of 0 despite actually having content when read).
Additionally, for mutable sources such as files, a subsequent read may return a different number of bytes if the contents are changed.
sizeIfKnown
in class ByteSource
public byte[] read()
ByteSource
read
in class ByteSource
public <T> T read(ByteProcessor<T> processor) throws java.io.IOException
ByteSource
processor
to process bytes as
they are read. Stops when all bytes have been read or the consumer returns false
.
Returns the result produced by the processor.read
in class ByteSource
java.io.IOException
- if an I/O error occurs while reading from this source or if processor
throws an IOException
public long copyTo(java.io.OutputStream output) throws java.io.IOException
ByteSource
OutputStream
. Does not close
output
.copyTo
in class ByteSource
java.io.IOException
- if an I/O error occurs while reading from this source or writing to output
public HashCode hash(HashFunction hashFunction) throws java.io.IOException
ByteSource
hash
in class ByteSource
java.io.IOException
- if an I/O error occurs while reading from this sourcepublic ByteSource slice(long offset, long length)
ByteSource
length
bytes long
starting at the given offset
. If offset
is greater than the size of this
source, the returned source will be empty. If offset + length
is greater than the size
of this source, the returned source will contain the slice starting at offset
and
ending at the end of this source.slice
in class ByteSource
public java.lang.String toString()
toString
in class java.lang.Object