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

["Tilmann Zäschke (JIRA)" <ji...@apache.org>]

    [ 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)