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