[
https://issues.apache.org/jira/browse/SLING-12816?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17956113#comment-17956113
]
Konrad Windszus edited comment on SLING-12816 at 6/4/25 1:45 PM:
-----------------------------------------------------------------
I am wondering which exceptions are potentially temporary (i.e. the API
consumer may trigger a retry). From a JCR point of view this is
https://developer.adobe.com/experience-manager/reference-materials/spec/jsr170/javadocs/jcr-2.0/javax/jcr/InvalidItemStateException.html
which may succeed after refreshing the resource resolver. If we don't document
this it is much harder to write resilient code against the JCR resource
resolver.
was (Author: kwin):
I am wondering which exceptions are potentially temporary (i.e. the API
consumer may trigger a retry). From a JCR point of view this is
https://developer.adobe.com/experience-manager/reference-materials/spec/jsr170/javadocs/jcr-2.0/javax/jcr/InvalidItemStateException.html
which may succeed after refreshing the resource resolver. If we don't document
this it is much harder to write robust code against the JCR resource resolver.
> Clarify exceptions thrown from methods of
> o.a.s.a.r.ValueMap/ModifiableValueMap
> -------------------------------------------------------------------------------
>
> Key: SLING-12816
> URL: https://issues.apache.org/jira/browse/SLING-12816
> Project: Sling
> Issue Type: Improvement
> Reporter: Konrad Windszus
> Priority: Major
>
> Currently neither the javadoc of
> https://github.com/apache/sling-org-apache-sling-api/blob/master/src/main/java/org/apache/sling/api/resource/ValueMap.java
> nor of
> https://github.com/apache/sling-org-apache-sling-api/blob/master/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java
> explain which exceptions can be expected in case either read or write fails
> in the underlying resource provider. This should be formalized.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
