Update error message

Author: zoewangg

core/sdk-core/src/main/java/software/amazon/awssdk/core/FileTransformerConfiguration.java

@@ -105,7 +105,7 @@ public static Builder builder() {
      * <p>
      * Always create a new file. If the file already exists, {@link FileAlreadyExistsException} will be thrown.
      * In the event of an error, the SDK will attempt to delete the file (whatever has been written to it so far).
-     * The parent directory must already exist; the SDK will not auto-create it.
+     * The file's parent directories must already exist; the SDK will not auto-create them.
      */
     public static FileTransformerConfiguration defaultCreateNew() {
         return builder().fileWriteOption(FileWriteOption.CREATE_NEW)
@@ -118,7 +118,7 @@ public static FileTransformerConfiguration defaultCreateNew() {
      * <p>
      * Create a new file if it doesn't exist, otherwise replace the existing file.
      * In the event of an error, the SDK will NOT attempt to delete the file, leaving it as-is.
-     * The parent directory must already exist; the SDK will not auto-create it.
+     * The file's parent directories must already exist; the SDK will not auto-create them.
      */
     public static FileTransformerConfiguration defaultCreateOrReplaceExisting() {
         return builder().fileWriteOption(FileWriteOption.CREATE_OR_REPLACE_EXISTING)
@@ -131,7 +131,7 @@ public static FileTransformerConfiguration defaultCreateOrReplaceExisting() {
      * <p>
      * Create a new file if it doesn't exist, otherwise append to the existing file.
      * In the event of an error, the SDK will NOT attempt to delete the file, leaving it as-is.
-     * The parent directory must already exist; the SDK will not auto-create it.
+     * The file's parent directories must already exist; the SDK will not auto-create them.
      */
     public static FileTransformerConfiguration defaultCreateOrAppend() {
         return builder().fileWriteOption(FileWriteOption.CREATE_OR_APPEND_TO_EXISTING)
@@ -182,19 +182,19 @@ public int hashCode() {
     public enum FileWriteOption {
         /**
          * Always create a new file. If the file already exists, {@link FileAlreadyExistsException} will be thrown.
-         * The parent directory must already exist; the SDK will not auto-create it.
+         * The file's parent directories must already exist; the SDK will not auto-create them.
          */
         CREATE_NEW,
 
         /**
          * Create a new file if it doesn't exist, otherwise replace the existing file.
-         * The parent directory must already exist; the SDK will not auto-create it.
+         * The file's parent directories must already exist; the SDK will not auto-create them.
          */
         CREATE_OR_REPLACE_EXISTING,
 
         /**
          * Create a new file if it doesn't exist, otherwise append to the existing file.
-         * The parent directory must already exist; the SDK will not auto-create it.
+         * The file's parent directories must already exist; the SDK will not auto-create them.
          */
         CREATE_OR_APPEND_TO_EXISTING,
 

core/sdk-core/src/main/java/software/amazon/awssdk/core/async/AsyncResponseTransformer.java

@@ -177,7 +177,7 @@ default String name() {
      * SDK will attempt to delete the file (whatever has been written to it so far). If the file already exists, an exception will
      * be thrown.
      *
-     * <p>The parent directory must already exist. The SDK will not auto-create parent directories, and a
+     * <p>The file's parent directories must already exist. The SDK will not auto-create directories, and a
      * {@link java.nio.file.NoSuchFileException} will be thrown if they are missing.
      *
      * @param path        Path to file to write to.
@@ -193,7 +193,7 @@ static <ResponseT> AsyncResponseTransformer<ResponseT, ResponseT> toFile(Path pa
      * Creates an {@link AsyncResponseTransformer} that writes all the content to the given file with the specified
      * {@link FileTransformerConfiguration}.
      *
-     * <p>The parent directory must already exist. The SDK will not auto-create parent directories, and a
+     * <p>The file's parent directories must already exist. The SDK will not auto-create directories, and a
      * {@link java.nio.file.NoSuchFileException} will be thrown if they are missing.
      *
      * @param path        Path to file to write to.
@@ -223,7 +223,7 @@ static <ResponseT> AsyncResponseTransformer<ResponseT, ResponseT> toFile(
      * SDK will attempt to delete the file (whatever has been written to it so far). If the file already exists, an exception will
      * be thrown.
      *
-     * <p>The parent directory must already exist. The SDK will not auto-create parent directories, and a
+     * <p>The file's parent directories must already exist. The SDK will not auto-create directories, and a
      * {@link java.nio.file.NoSuchFileException} will be thrown if they are missing.
      *
      * @param file        File to write to.

core/sdk-core/src/main/java/software/amazon/awssdk/core/internal/async/FileAsyncResponseTransformer.java

@@ -133,7 +133,7 @@ private AsynchronousFileChannel createChannel(Path path) throws IOException {
                 throw e;
             }
             throw new NoSuchFileException(e.getFile(), e.getOtherFile(),
-                                          "Verify that the parent directory exists. The SDK will not auto-create it.");
+                                          "Verify that the file's parent directories exist. The SDK will not auto-create them.");
         }
     }
 

core/sdk-core/src/main/java/software/amazon/awssdk/core/sync/ResponseTransformer.java

@@ -111,7 +111,7 @@ default String name() {
      * Creates a response transformer that writes all response content to the specified file. If the file already exists
      * then a {@link FileAlreadyExistsException} will be thrown.
      *
-     * <p>The parent directory must already exist. The SDK will not auto-create parent directories, and a
+     * <p>The file's parent directories must already exist. The SDK will not auto-create directories, and a
      * {@link NoSuchFileException} will be thrown if they are missing.
      *
      * @param path        Path to file to write to.
@@ -173,8 +173,8 @@ static boolean shouldThrowIOException(IOException copyException) {
     static String copyErrorMessage(Path path, IOException copyException) {
         String baseMessage = "Failed to read response into file: " + path;
         if (copyException instanceof NoSuchFileException) {
-            return baseMessage + ". Verify that the parent directory exists."
-                   + " The SDK will not auto-create it.";
+            return baseMessage + ". Verify that the file's parent directories exist."
+                   + " The SDK will not auto-create them.";
         }
         return baseMessage;
     }
@@ -183,7 +183,7 @@ static String copyErrorMessage(Path path, IOException copyException) {
      * Creates a response transformer that writes all response content to the specified file. If the file already exists
      * then a {@link FileAlreadyExistsException} will be thrown.
      *
-     * <p>The parent directory must already exist. The SDK will not auto-create parent directories, and a
+     * <p>The file's parent directories must already exist. The SDK will not auto-create directories, and a
      * {@link NoSuchFileException} will be thrown if they are missing.
      *
      * @param file        File to write to.

core/sdk-core/src/test/java/software/amazon/awssdk/core/internal/async/FileAsyncResponseTransformerTest.java

@@ -339,8 +339,8 @@ void parentDirectoryDoesNotExist_throwsWithHelpfulMessage(FileTransformerConfigu
         assertThat(future).failsWithin(1, TimeUnit.SECONDS)
                           .withThrowableOfType(ExecutionException.class)
                           .withCauseInstanceOf(NoSuchFileException.class)
-                          .withMessageContaining("Verify that the parent directory exists")
-                          .withMessageContaining("The SDK will not auto-create it");
+                          .withMessageContaining("Verify that the file's parent directories exist")
+                          .withMessageContaining("The SDK will not auto-create them");
     }
 
     @Test

core/sdk-core/src/test/java/software/amazon/awssdk/core/sync/ResponseTransformerToFileTest.java

@@ -43,8 +43,8 @@ void toFile_parentDirectoryDoesNotExist_throwsWithHelpfulMessage() throws Except
 
         assertThatThrownBy(() -> transformer.transform("response", inputStream))
             .isInstanceOf(IOException.class)
-            .hasMessageContaining("Verify that the parent directory exists")
-            .hasMessageContaining("The SDK will not auto-create it")
+            .hasMessageContaining("Verify that the file's parent directories exist")
+            .hasMessageContaining("The SDK will not auto-create them")
             .hasCauseInstanceOf(NoSuchFileException.class);
     }
 }