This is an automated email from the ASF dual-hosted git repository. kwin pushed a commit to branch feature/improve-javadoc-resourcechangelistener in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-api.git
commit 0b32a7bbcd6c9a7b6aa260eec554bd8b92c17c86 Author: Konrad Windszus <[email protected]> AuthorDate: Fri Jun 27 17:19:19 2025 +0200 Javadoc: Clarify asynchronous nature of ResourceChangeListeners --- .../sling/api/resource/observation/ExternalResourceChangeListener.java | 1 + .../apache/sling/api/resource/observation/ResourceChangeListener.java | 3 ++- 2 files changed, 3 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..234bdc1 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 @@ -24,7 +24,8 @@ 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 ResourceResolver objects before they are being processed through listeners). * * <p> * {@code ResourceChangeListener} objects are registered with the Framework service
