From c12502c53f2461b4fccbfee64c04deeb8274a58e Mon Sep 17 00:00:00 2001
From: Piotr Findeisen <piotr.findeisen@gmail.com>
Date: Fri, 14 Jun 2024 17:28:03 +0200
Subject: [PATCH] Document ContentCache.invalidate blocking nature

---
 core/src/main/java/org/apache/iceberg/io/ContentCache.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/core/src/main/java/org/apache/iceberg/io/ContentCache.java b/core/src/main/java/org/apache/iceberg/io/ContentCache.java
index 9d3cfb2471eb..4436d7b92258 100644
--- a/core/src/main/java/org/apache/iceberg/io/ContentCache.java
+++ b/core/src/main/java/org/apache/iceberg/io/ContentCache.java
@@ -147,6 +147,12 @@ public InputFile tryCache(InputFile input) {
     return input;
   }
 
+  /**
+   * Invalidate the cache entry for the given key.
+   *
+   * <p>Note: if there is ongoing load, this is a blocking operation, i.e. it will wait for the load
+   * to complete before invalidating the entry.
+   */
   public void invalidate(String key) {
     cache.invalidate(key);
   }