comparison src/org/tmatesoft/hg/core/HgChangesetHandler.java @ 215:41a778e3fd31

Issue 5: Facilities for progress and cancellation. More specific exceptions. Exceptions from callbacks as RuntimeException
author Artem Tikhomirov <tikhomirov.artem@gmail.com>
date Tue, 17 May 2011 00:56:54 +0200
parents ffc5f6d59f7e
children f9f3e9b67ccc
comparison
equal deleted inserted replaced
214:4252faa556cd 215:41a778e3fd31
20 * Callback to process {@link HgChangeset changesets}. 20 * Callback to process {@link HgChangeset changesets}.
21 * 21 *
22 * @author Artem Tikhomirov 22 * @author Artem Tikhomirov
23 * @author TMate Software Ltd. 23 * @author TMate Software Ltd.
24 */ 24 */
25 public interface HgChangesetHandler { 25 public interface HgChangesetHandler/*XXX perhaps, shall parameterize with exception clients can throw, like: <E extends Exception>*/ {
26 /** 26 /**
27 * @param changeset not necessarily a distinct instance each time, {@link HgChangeset#clone() clone()} if need a copy. 27 * @param changeset not necessarily a distinct instance each time, {@link HgChangeset#clone() clone()} if need a copy.
28 * @throws RuntimeException or any subclass thereof to indicate error. General contract is that RuntimeExceptions
29 * will be re-thrown wrapped into {@link HgCallbackTargetException}.
28 */ 30 */
29 void next(HgChangeset changeset); 31 void next(HgChangeset changeset)/* throws E*/;
30 } 32 }