(sling-org-apache-sling-api) branch master updated: Javadoc: Clarify asynchronous nature of ResourceChangeListeners

[kwin]

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

kwin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-api.git


The following commit(s) were added to refs/heads/master by this push:
     new 07a6881  Javadoc: Clarify asynchronous nature of 
ResourceChangeListeners
07a6881 is described below

commit 07a6881a77af938579003095cdef7ca8eb1fddd8
Author: Konrad Windszus <k...@apache.org>
AuthorDate: Fri Jun 27 17:19:19 2025 +0200

    Javadoc: Clarify asynchronous nature of ResourceChangeListeners
---
 .../api/resource/observation/ExternalResourceChangeListener.java      | 1 +
 .../apache/sling/api/resource/observation/ResourceChangeListener.java | 4 +++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git 
a/src/main/java/org/apache/sling/api/resource/observation/ExternalResourceChangeListener.java
 
b/src/main/java/org/apache/sling/api/resource/observation/ExternalResourceChangeListener.java
index 03998b8..7cb7372 100644
--- 
a/src/main/java/org/apache/sling/api/resource/observation/ExternalResourceChangeListener.java
+++ 
b/src/main/java/org/apache/sling/api/resource/observation/ExternalResourceChangeListener.java
@@ -24,6 +24,7 @@ import org.osgi.annotation.versioning.ConsumerType;
  * This is a marker interface to receive external events.
  *
  * @since 1.0.0 (Sling API Bundle 2.11.0)
+ * @see ResourceChangeListener
  */
 @ConsumerType
 public interface ExternalResourceChangeListener {
diff --git 
a/src/main/java/org/apache/sling/api/resource/observation/ResourceChangeListener.java
 
b/src/main/java/org/apache/sling/api/resource/observation/ResourceChangeListener.java
index 3be8295..116fada 100644
--- 
a/src/main/java/org/apache/sling/api/resource/observation/ResourceChangeListener.java
+++ 
b/src/main/java/org/apache/sling/api/resource/observation/ResourceChangeListener.java
@@ -20,11 +20,13 @@ package org.apache.sling.api.resource.observation;
 
 import java.util.List;
 
+import org.apache.sling.api.resource.ResourceResolver;
 import org.jetbrains.annotations.NotNull;
 import org.osgi.annotation.versioning.ConsumerType;
 
 /**
- * Listener for resource change events.
+ * Listener for resource change events. Event listeners are notified 
asynchronously, and see events after they occur and the transaction is committed
+ * (which means the changes may already be visible to {@link ResourceResolver} 
objects before they are being processed by listeners).
  *
  * <p>
  * {@code ResourceChangeListener} objects are registered with the Framework 
service