[fileio] Introduce FileIO.overwriteHintFile (#5304)

Author: JingsongLi

paimon-common/src/main/java/org/apache/paimon/fs/FileIO.java

@@ -348,6 +348,15 @@ default void overwriteFileUtf8(Path path, String content) throws IOException {
         }
     }
 
+    /**
+     * Overwrite hint file by content atomically, the characteristic of Hint file is that it can not
+     * exist for a period of time, which allows some file systems to perform overwrite writing by
+     * deleting and renaming.
+     */
+    default void overwriteHintFile(Path path, String content) throws IOException {
+        overwriteFileUtf8(path, content);
+    }
+
     /**
      * Copy content of one file into another.
      *

paimon-core/src/main/java/org/apache/paimon/utils/HintFileUtils.java

@@ -109,7 +109,7 @@ public static void commitHint(FileIO fileIO, long id, String fileName, Path dir)
         int loopTime = 3;
         while (loopTime-- > 0) {
             try {
-                fileIO.overwriteFileUtf8(hintFile, String.valueOf(id));
+                fileIO.overwriteHintFile(hintFile, String.valueOf(id));
                 return;
             } catch (IOException e) {
                 try {