[
https://issues.apache.org/jira/browse/JDO-759?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15895744#comment-15895744
]
Tilmann Zäschke commented on JDO-759:
-------------------------------------
Based on the telecon on Thursday, I propose to add the following to Section 1.6:
“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 exceptions to indicate whether an error occurred, but not to indicate
that the feature is not supported.
> 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)
