Class Files.FileByteSource
- Enclosing class:
Files
-
Nested Class Summary
Nested classes/interfaces inherited from class com.google.common.io.ByteSource
ByteSource.AsCharSource -
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionOpens a newInputStreamfor reading from this source.byte[]read()Reads the full contents of this byte source as a byte array.longsize()Returns the size of this source in bytes, even if doing so requires opening and traversing an entire stream.Returns the size of this source in bytes, if the size can be easily determined without actually opening the data stream.toString()Methods inherited from class com.google.common.io.ByteSource
asCharSource, concat, concat, concat, contentEquals, copyTo, copyTo, empty, hash, isEmpty, openBufferedStream, read, slice, wrap
-
Field Details
-
file
-
-
Constructor Details
-
FileByteSource
-
-
Method Details
-
openStream
Description copied from class:ByteSourceOpens a newInputStreamfor 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.
- Specified by:
openStreamin classByteSource- Throws:
IOException- if an I/O error occurs while opening the stream
-
sizeIfKnown
Description copied from class:ByteSourceReturns the size of this source in bytes, if the size can be easily determined without actually opening the data stream.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.
- Overrides:
sizeIfKnownin classByteSource
-
size
Description copied from class:ByteSourceReturns the size of this source in bytes, even if doing so requires opening and traversing an entire stream. To avoid a potentially expensive operation, seeByteSource.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 (orskip, 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.
- Overrides:
sizein classByteSource- Throws:
IOException- if an I/O error occurs while reading the size of this source
-
read
Description copied from class:ByteSourceReads the full contents of this byte source as a byte array.- Overrides:
readin classByteSource- Throws:
IOException- if an I/O error occurs while reading from this source
-
toString
-