API: Deprecate ContentFile#path API and add location API which return…

…s String (#11092)

Co-authored-by: Eduard Tudenhoefner <[email protected]>

api/src/main/java/org/apache/iceberg/ContentFile.java

@@ -51,9 +51,19 @@ default String manifestLocation() {
    */
   FileContent content();
 
-  /** Returns fully qualified path to the file, suitable for constructing a Hadoop Path. */
+  /**
+   * Returns fully qualified path to the file, suitable for constructing a Hadoop Path.
+   *
+   * @deprecated since 1.7.0, will be removed in 2.0.0; use {@link #location()} instead.
+   */
+  @Deprecated
   CharSequence path();
 
+  /** Return the fully qualified path to the file. */
+  default String location() {
+    return path().toString();
+  }
+
   /** Returns format of the file. */
   FileFormat format();