FileInputStream obtains input bytes
from a file in a file system. What files
are available depends on the host environment.
FileInputStream is meant for reading streams of raw bytes
such as image data. For reading streams of characters, consider using
FileReader.
FileFileDescriptorFileOutputStreamFileInputStream by
opening a connection to an actual file,
the file named by the path name name
in the file system. A new FileDescriptor
object is created to represent this file
connection.
First, if there is a security
manager, its checkRead method
is called with the name argument
as its argument.
If the named file does not exist, is a directory rather than a regular
file, or for some other reason cannot be opened for reading then a
FileNotFoundException is thrown.
name the system-dependent file name.FileNotFoundException if the file does not exist,
is a directory rather than a regular file,
or for some other reason cannot be opened for
reading.java.lang.SecurityException if a security manager exists and its
checkRead method denies read access
to the file.java.lang.SecurityManager.checkRead(java.lang.String)FileInputStream by
opening a connection to an actual file,
the file named by the File
object file in the file system.
A new FileDescriptor object
is created to represent this file connection.
First, if there is a security manager,
its checkRead method is called
with the path represented by the file
argument as its argument.
If the named file does not exist, is a directory rather than a regular
file, or for some other reason cannot be opened for reading then a
FileNotFoundException is thrown.
file the file to be opened for reading.FileNotFoundException if the file does not exist,
is a directory rather than a regular file,
or for some other reason cannot be opened for
reading.java.lang.SecurityException if a security manager exists and its
checkRead method denies read access to the file.File.getPath()java.lang.SecurityManager.checkRead(java.lang.String)FileInputStream by using the file descriptor
fdObj, which represents an existing connection to an
actual file in the file system.
If there is a security manager, its checkRead method is
called with the file descriptor fdObj as its argument to
see if it's ok to read the file descriptor. If read access is denied
to the file descriptor a SecurityException is thrown.
If fdObj is null then a NullPointerException
is thrown.
fdObj the file descriptor to be opened for reading.java.lang.SecurityException if a security manager exists and its
checkRead method denies read access to the
file descriptor.java.lang.SecurityManager.checkRead(java.io.FileDescriptor)-1 if the end of the
file is reached.IOException if an I/O error occurs.b the data to be writtenoff the start offset in the datalen the number of bytes that are writtenIOException If an I/O error has occurred.b.length bytes of data from this input
stream into an array of bytes. This method blocks until some input
is available.
b the buffer into which the data is read.-1 if there is no more data because the end of
the file has been reached.IOException if an I/O error occurs.len bytes of data from this input stream
into an array of bytes. If len is not zero, the method
blocks until some input is available; otherwise, no
bytes are read and 0 is returned.
b the buffer into which the data is read.off the start offset in the destination array blen the maximum number of bytes read.-1 if there is no more data because the end of
the file has been reached.java.lang.NullPointerException If b is null.java.lang.IndexOutOfBoundsException If off is negative,
len is negative, or len is greater than
b.length - offIOException if an I/O error occurs.n bytes of data from the
input stream.
The skip method may, for a variety of
reasons, end up skipping over some smaller number of bytes,
possibly 0. If n is negative, an
IOException is thrown, even though the skip
method of the superclass does nothing in this case.
The actual number of bytes skipped is returned.
InputStream
This method may skip more bytes than are remaining in the backing file. This produces no exception and the number of bytes skipped may include some number of bytes that were beyond the EOF of the backing file. Attempting to read from the stream after skipping past the end will result in -1 indicating the end of the file.
n the number of bytes to be skipped.IOException if n is negative, if the stream does not
support seek, or if an I/O error occurs.In some cases, a non-blocking read (or skip) may appear to be blocked when it is merely slow, for example when reading large files over slow networks.
IOException if this file input stream has been closed by calling
close or an I/O error occurs.If this stream has an associated channel then the channel is closed as well.
IOException if an I/O error occurs.FileDescriptor
object that represents the connection to
the actual file in the file system being
used by this FileInputStream.
IOException if an I/O error occurs.FileDescriptorFileChannel
object associated with this file input stream.
The initial position of the returned channel will be equal to the
number of bytes read from the file so far. Reading bytes from this
stream will increment the channel's position. Changing the channel's
position, either explicitly or by reading, will change this stream's
file position.
close method of this file input stream is
called when there are no more references to it.
IOException if an I/O error occurs.close()