Mercurial > hg4j
diff src/org/tmatesoft/hg/core/HgChangesetTreeHandler.java @ 366:189dc6dc1c3e
Use exceptions to expose errors reading mercurial data
| author | Artem Tikhomirov <tikhomirov.artem@gmail.com> | 
|---|---|
| date | Fri, 16 Dec 2011 04:43:18 +0100 | 
| parents | a674b8590362 | 
| children | a2341e761609 | 
line wrap: on
 line diff
--- a/src/org/tmatesoft/hg/core/HgChangesetTreeHandler.java Sun Dec 11 00:39:07 2011 +0100 +++ b/src/org/tmatesoft/hg/core/HgChangesetTreeHandler.java Fri Dec 16 04:43:18 2011 +0100 @@ -40,10 +40,12 @@ * @return revision of the revlog being iterated. */ public Nodeid fileRevision(); + /** * @return changeset associated with the current revision + * @throws HgException indicates failure dealing with Mercurial data */ - public HgChangeset changeset(); + public HgChangeset changeset() throws HgException; /** * Lightweight alternative to {@link #changeset()}, identifies changeset in which current file node has been modified @@ -54,8 +56,9 @@ /** * Node, these are not necessarily in direct relation to parents of changeset from {@link #changeset()} * @return changesets that correspond to parents of the current file node, either pair element may be <code>null</code>. + * @throws HgException indicates failure dealing with Mercurial data */ - public Pair<HgChangeset, HgChangeset> parents(); + public Pair<HgChangeset, HgChangeset> parents() throws HgException; /** * Lightweight alternative to {@link #parents()}, give {@link Nodeid nodeids} only @@ -63,7 +66,12 @@ */ public Pair<Nodeid, Nodeid> parentRevisions(); - public Collection<HgChangeset> children(); + /** + * Changes that originate from the given change and bear it as their parent. + * @return collection (possibly empty) of immediate children of the change + * @throws HgException indicates failure dealing with Mercurial data + */ + public Collection<HgChangeset> children() throws HgException; /** * Lightweight alternative to {@link #children()}.
