diff --git a/src/java.base/share/classes/java/nio/file/Files.java b/src/java.base/share/classes/java/nio/file/Files.java index 80c771f53068c..3f1d6fae4e4d9 100644 --- a/src/java.base/share/classes/java/nio/file/Files.java +++ b/src/java.base/share/classes/java/nio/file/Files.java @@ -203,7 +203,7 @@ public static InputStream newInputStream(Path path, OpenOption... options) * @throws UnsupportedOperationException * if an unsupported option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * (optional specific exception) * @throws IOException @@ -340,7 +340,7 @@ public static OutputStream newOutputStream(Path path, OpenOption... options) * if an unsupported open option is specified or the array contains * attributes that cannot be set atomically when creating the file * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * and the file is being opened for writing (optional specific * exception) @@ -377,7 +377,7 @@ public static SeekableByteChannel newByteChannel(Path path, * @throws UnsupportedOperationException * if an unsupported open option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * and the file is being opened for writing (optional specific * exception) @@ -575,10 +575,11 @@ public static DirectoryStream newDirectoryStream(Path dir, Set.of(StandardOpenOption.CREATE_NEW, StandardOpenOption.WRITE); /** - * Creates a new and empty file, failing if the file already exists. The - * check for the existence of the file and the creation of the new file if - * it does not exist are a single operation that is atomic with respect to - * all other filesystem activities that might affect the directory. + * Creates a new and empty file, failing if {@code path} locates an existing + * file. The check for the existence of the file and the creation of the new + * file if it does not exist are a single operation that is atomic with + * respect to all other filesystem activities that might affect the + * directory. * *

The {@code attrs} parameter is optional {@link FileAttribute * file-attributes} to set atomically when creating the file. Each attribute @@ -598,7 +599,7 @@ public static DirectoryStream newDirectoryStream(Path dir, * if the array contains an attribute that cannot be set atomically * when creating the file * @throws FileAlreadyExistsException - * If a file of that name already exists + * if {@code path} locates an existing file * (optional specific exception) * @throws IOException * if an I/O error occurs or the parent directory does not exist @@ -611,7 +612,8 @@ public static Path createFile(Path path, FileAttribute... attrs) } /** - * Creates a new directory. The check for the existence of the file and the + * Creates a new directory, failing if {@code dir} locates an existing + * file. The check for the existence of the file and the * creation of the directory if it does not exist are a single operation * that is atomic with respect to all other filesystem activities that might * affect the directory. The {@link #createDirectories createDirectories} @@ -636,8 +638,8 @@ public static Path createFile(Path path, FileAttribute... attrs) * if the array contains an attribute that cannot be set atomically * when creating the directory * @throws FileAlreadyExistsException - * if a directory could not otherwise be created because a file of - * that name already exists (optional specific exception) + * if {@code dir} locates an existing file + * (optional specific exception) * @throws IOException * if an I/O error occurs or the parent directory does not exist */ @@ -676,8 +678,8 @@ public static Path createDirectory(Path dir, FileAttribute... attrs) * if the array contains an attribute that cannot be set atomically * when creating the directory * @throws FileAlreadyExistsException - * if {@code dir} exists but is not a directory (optional specific - * exception) + * if {@code dir} locates an existing file that is not a directory + * (optional specific exception) * @throws IOException * if an I/O error occurs */ @@ -930,7 +932,8 @@ public static Path createTempDirectory(String prefix, } /** - * Creates a symbolic link to a target (optional operation). + * Creates a symbolic link to a target, failing if {@code link} locates an + * existing file (optional operation). * *

The {@code target} parameter is the target of the link. It may be an * {@link Path#isAbsolute absolute} or relative path and may not exist. When @@ -964,8 +967,8 @@ public static Path createTempDirectory(String prefix, * array contains an attribute that cannot be set atomically when * creating the symbolic link * @throws FileAlreadyExistsException - * if a file with the name already exists (optional specific - * exception) + * if {@code link} locates an existing file + * (optional specific exception) * @throws IOException * if an I/O error occurs */ @@ -978,7 +981,8 @@ public static Path createSymbolicLink(Path link, Path target, } /** - * Creates a new link (directory entry) for an existing file (optional + * Creates a new link (directory entry) for an existing file, + * failing if {@code link} locates an existing file (optional * operation). * *

The {@code link} parameter locates the directory entry to create. @@ -1007,8 +1011,8 @@ public static Path createSymbolicLink(Path link, Path target, * if the implementation does not support adding an existing file * to a directory * @throws FileAlreadyExistsException - * if the entry could not otherwise be created because a file of - * that name already exists (optional specific exception) + * if {@code link} locates an existing file + * (optional specific exception) * @throws IOException * if an I/O error occurs */ @@ -2711,7 +2715,7 @@ public static BufferedReader newBufferedReader(Path path) throws IOException { * @throws UnsupportedOperationException * if an unsupported option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * (optional specific exception) * @@ -2754,7 +2758,7 @@ public static BufferedWriter newBufferedWriter(Path path, Charset cs, * @throws UnsupportedOperationException * if an unsupported option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * (optional specific exception) * @@ -3161,7 +3165,7 @@ public static List readAllLines(Path path) throws IOException { * @throws UnsupportedOperationException * if an unsupported option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * (optional specific exception) */ @@ -3222,7 +3226,7 @@ public static Path write(Path path, byte[] bytes, OpenOption... options) * @throws UnsupportedOperationException * if an unsupported option is specified * @throws FileAlreadyExistsException - * If a file of that name already exists and the {@link + * If the path locates an existing file and the {@link * StandardOpenOption#CREATE_NEW CREATE_NEW} option is specified * (optional specific exception) */