(iceberg) branch main updated: API: Deprecate ContentFile#path API and add location API which returns String (#11092)

[amoghj]

This is an automated email from the ASF dual-hosted git repository.

amoghj pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg.git


The following commit(s) were added to refs/heads/main by this push:
     new 257bad29d7 API: Deprecate ContentFile#path API and add location API 
which returns String (#11092)
257bad29d7 is described below

commit 257bad29d7db09f3f9c89663b7c34f8caca3014b
Author: Amogh Jahagirdar <amo...@apache.org>
AuthorDate: Mon Sep 23 14:21:38 2024 -0600

    API: Deprecate ContentFile#path API and add location API which returns 
String (#11092)
    
    Co-authored-by: Eduard Tudenhoefner <etudenhoef...@gmail.com>
---
 api/src/main/java/org/apache/iceberg/ContentFile.java | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/api/src/main/java/org/apache/iceberg/ContentFile.java 
b/api/src/main/java/org/apache/iceberg/ContentFile.java
index 9db19f41eb..a4d97fa93f 100644
--- a/api/src/main/java/org/apache/iceberg/ContentFile.java
+++ b/api/src/main/java/org/apache/iceberg/ContentFile.java
@@ -51,9 +51,19 @@ public interface ContentFile<F> {
    */
   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();