[
https://issues.apache.org/jira/browse/JDO-623?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12683428#action_12683428
]
Andy Jefferson commented on JDO-623:
------------------------------------
Suggested spec updates :-
11.1
Add "Query Timeout" (bold heading)
<spec>
If the query timeout is specified the implementation will use the supplied
value as a timeout for any queries where the underlying datastore supports it.
The timeout is in milliseconds. If it is not specified then the implementation
won't set any timeout (unless specified on a query-by-query basis).
</spec>
11.1.1
Add
"javax.jdo.option.QueryTimeoutInMillis"
14.6
Add
"Timeout/Cancel" (bold heading)
void setTimeoutMillis(int interval);
This method sets the timeout for this query (in milliseconds) where the
underlying datastore supports it. If the datastore doesn't support timeouts
then a JDOQueryTimeoutException is thrown. This overrides the
PersistenceManagerFactory property value (see 11.1)
void cancel();
This method allows the current query to be cancelled (if executing). If the
implementation does not support this operation (maybe due to lack of support in
the underlying datastore) then JDOUnsupportedOptionException is thrown.
> Query cancel and timeout support
> --------------------------------
>
> Key: JDO-623
> URL: https://issues.apache.org/jira/browse/JDO-623
> Project: JDO
> Issue Type: New Feature
> Components: api2, tck2
> Reporter: Andy Jefferson
> Assignee: Andy Jefferson
> Fix For: JDO 2 maintenance release 3
>
> Attachments: query_timeout.patch
>
>
> JDO doesn't have a mechanism to stop queries from overrunning. JPA2 now
> allows
> a persistence property to allow timing them out, and most JDO implementations
> have allowed this as an extension since JDO1. It would make sense for JDO
> (2.3) to have the same or a variation. I propose having the following
> Simple PMF property "javax.jdo.option.queryTimeout" to specify the number of
> millisecs (or secs) before any query is timed out. Throw a
> QueryTimeoutException (extends JDOException) when the timeout happens.
> Add methods Query.setTimeout(int), Query.getTimeout() to allow
> setting/retrieving the timeout interval on a per-query basis.
> Add method Query.cancel() to cancel any running query. If an implementation
> doesn't support cancelling of queries then it should throw a
> JDOUnsupportedOptionException. Any query execute() that is cancelled will
> throw a QueryInterruptedException (extends JDOUserException).
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
