Creates a random access file stream to read from, and optionally
to write to, a file with the specified name. A new
FileDescriptor object is created to represent the
connection to the file.
The mode argument specifies the access mode with which the
file is to be opened. The permitted values and their meanings are as
specified for the RandomAccessFile(File,String) constructor.
If there is a security manager, its checkRead method
is called with the name argument
as its argument to see if read access to the file is allowed.
If the mode allows writing, the security manager's
checkWrite method
is also called with the name argument
as its argument to see if write access to the file is allowed.
name | the system-dependent filename | |
mode | the access mode |
IllegalArgumentException | if the mode argument is not equal
to one of "r", "rw", "rws", or
"rwd" | |
FileNotFoundException
| if the mode is "r" but the given string does not
denote an existing regular file, or if the mode begins with
"rw" but the given string does not denote an
existing, writable regular file and a new regular file of
that name cannot be created, or if some other error occurs
while opening or creating the file | |
SecurityException | if a security manager exists and its
checkRead method denies read access to the file
or the mode is "rw" and the security manager's
checkWrite method denies write access to the file |
java.lang.SecurityException, java.lang.SecurityManager.checkRead(java.lang.String), java.lang.SecurityManager.checkWrite(java.lang.String)
@revised 1.4
@spec JSR-51
Diagram: File