(sling-org-apache-sling-api) branch master updated: SLING-12978 Clarify RESOLUTION_PATH and RESOLUTION_PATH_INFO for non existing resources

[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 61ef259  SLING-12978 Clarify RESOLUTION_PATH and RESOLUTION_PATH_INFO 
for non existing resources
61ef259 is described below

commit 61ef2599dd0a023956ae7bb1e459b3fdadf360ad
Author: Konrad Windszus <k...@apache.org>
AuthorDate: Fri Nov 28 13:57:03 2025 +0100

    SLING-12978 Clarify RESOLUTION_PATH and RESOLUTION_PATH_INFO for non
    existing resources
---
 src/main/java/org/apache/sling/api/resource/ResourceMetadata.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/sling/api/resource/ResourceMetadata.java 
b/src/main/java/org/apache/sling/api/resource/ResourceMetadata.java
index eb13051..2da0f83 100644
--- a/src/main/java/org/apache/sling/api/resource/ResourceMetadata.java
+++ b/src/main/java/org/apache/sling/api/resource/ResourceMetadata.java
@@ -53,6 +53,7 @@ public class ResourceMetadata extends HashMap<String, Object> 
{
      * The name of the required property providing the part of the request URI
      * which was used to the resolve the resource to which the meta data
      * instance belongs (value is "sling.resolutionPath").
+     * For non-existing resources this is the full request URI.
      */
     public static final String RESOLUTION_PATH = "sling.resolutionPath";
 
@@ -62,7 +63,9 @@ public class ResourceMetadata extends HashMap<String, Object> 
{
      * instance belongs (value is "sling.resolutionPathInfo"). The value of 
this
      * property concatenated to the value of the
      * {@link #RESOLUTION_PATH sling.resolutionPath} property returns the
-     * original request URI leading to the resource.
+     * original request URI leading to the resource (but only for 
<strong>existing resources</strong>).
+     * For <strong>non-existing resources</strong> this is the part after the 
first dot of the full request URI
+     * which is also the part after the first dot of {@link #RESOLUTION_PATH}.
      * <p>
      * This property is optional. If missing, it should be assumed equal to an
      * empty string.