public class SQLQueryCancelledException extends SQLQueryException
This exception might be thrown because a query build has been explictly cancelled, or because the current Thread has been interrupted. When catching, the Thread's interrupt flag will indicate if it was the latter (and the calling code can behave accordingly if it is Thread aware).
This is separate to CancelledException
because it needs to fit within the SQLQueryBuilder framework and its use
of SQLQueryException (rather than DBException). When a SQLQueryBuilder
exposes a throws to any generic db api code (e.g. property building) it
can translate it in to a CancelledException. Clients of SQLQueryBuilder
itself can deal with SQLQueryCancelledException, but only need do so
specifically if they make the building cancellable (e.g. in a progress
bar).
Constructor and Description |
---|
SQLQueryCancelledException(SQLQuery query)
Constructs a new exception to indicate that the declarative build of
the given query has been cancelled.
|
append, getAllMessages, getMessage, getNextException, getObject, getRelatedObjects, setNextException, setRelatedObjects
public SQLQueryCancelledException(SQLQuery query)
query
- the query object that is not built because it was
cancelled.