diff 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
line wrap: on
line diff
--- a/src/org/tmatesoft/hg/core/HgChangesetHandler.java	Mon May 16 21:10:36 2011 +0200
+++ b/src/org/tmatesoft/hg/core/HgChangesetHandler.java	Tue May 17 00:56:54 2011 +0200
@@ -22,9 +22,11 @@
  * @author Artem Tikhomirov
  * @author TMate Software Ltd.
  */
-public interface HgChangesetHandler {
+public interface HgChangesetHandler/*XXX perhaps, shall parameterize with exception clients can throw, like: <E extends Exception>*/ {
 	/**
 	 * @param changeset not necessarily a distinct instance each time, {@link HgChangeset#clone() clone()} if need a copy.
+	 * @throws RuntimeException or any subclass thereof to indicate error. General contract is that RuntimeExceptions 
+	 * will be re-thrown wrapped into {@link HgCallbackTargetException}.  
 	 */
-	void next(HgChangeset changeset);
+	void next(HgChangeset changeset)/* throws E*/;
 }