Creates a new empty file in the specified directory, using the given prefix and suffix strings to generate its name. If this method returns successfully then it is guaranteed that:
deleteOnExit method.
The prefix argument must be at least three characters
long. It is recommended that the prefix be a short, meaningful string
such as "hjb" or "mail". The
suffix argument may be null, in which case the
suffix ".tmp" will be used.
To create the new file, the prefix and the suffix may first be
adjusted to fit the limitations of the underlying platform. If the
prefix is too long then it will be truncated, but its first three
characters will always be preserved. If the suffix is too long then it
too will be truncated, but if it begins with a period character
('.') then the period and the first three characters
following it will always be preserved. Once these adjustments have been
made the name of the new file will be generated by concatenating the
prefix, five or more internally-generated characters, and the suffix.
If the directory argument is null then the
system-dependent default temporary-file directory will be used. The
default temporary-file directory is specified by the system property
java.io.tmpdir. On UNIX systems the default value of this
property is typically "/tmp" or "/var/tmp"; on
Microsoft Windows systems it is typically "C:\\WINNT\\TEMP". A different
value may be given to this system property when the Java virtual machine
is invoked, but programmatic changes to this property are not guaranteed
to have any effect upon the temporary directory used by this method.
prefix | The prefix string to be used in generating the file's name; must be at least three characters long | |
suffix | The suffix string to be used in generating the file's
name; may be null, in which case the
suffix ".tmp" will be used | |
directory | The directory in which the file is to be created, or
null if the default temporary-file
directory is to be used |
IllegalArgumentException
| If the prefix argument contains fewer than three
characters | |
IOException | If a file could not be created | |
SecurityException
| If a security manager exists and its java.lang.SecurityManager.checkWrite(java.lang.String)
method does not allow a file to be created |
Diagram: File