You are viewing a plain text version of this content. The canonical link for it is here.

Posted to jdo-dev@db.apache.org by "Craig L Russell (JIRA)" <ji...@apache.org> on 2017/03/16 17:59:41 UTC

[jira] [Comment Edited] (JDO-759) Spec update to clarify whether methods that are documented to be hints must not throw exceptions

    [ 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 5:58 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 must 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 should 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)