[
https://issues.apache.org/jira/browse/JDO-759?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15896632#comment-15896632
]
Craig L Russell edited comment on JDO-759 at 3/16/17 6:02 PM:
--------------------------------------------------------------
Very minor editorial change:
“Hint” is used in the description of API methods to indicate that a JDO
implementation can be asked to perform a certain action. Implementations should
throw an exception to indicate that an error occurred, but if the method is not
supported, the implementation should ignore the method.
was (Author: clr):
Very minor editorial change:
“Hint” is used in the description of API methods to indicate that a JDO
implementation can be asked to perform a certain action. Implementations should
throw an exception to indicate that an error occurred, but if the method is not
supported, the implementation must ignore the method.
> Spec update to clarify whether methods that are documented to be hints must
> not throw exceptions
> ------------------------------------------------------------------------------------------------
>
> Key: JDO-759
> URL: https://issues.apache.org/jira/browse/JDO-759
> Project: JDO
> Issue Type: Improvement
> Components: specification
> Affects Versions: JDO 3.1
> Reporter: Michael Bouschen
> Assignee: Tilmann Zäschke
> Fix For: JDO 3.2
>
>
> If an implementation does not support the method, it should not throw an
> exception. But if the implementation supports the method, and e.g. there is
> an illegal argument, it is allowed but is not required to throw
> IllegalArgumentException. It is not allowed to throw an exception simply to
> report that the method is not supported.
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
