Mercurial > jhg

comparison src/org/tmatesoft/hg/core/HgManifestHandler.java @ 628:6526d8adbc0f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Explicit HgRuntimeException to facilitate easy switch from runtime to checked exceptions
author Artem Tikhomirov <tikhomirov.artem@gmail.com>
date Wed, 22 May 2013 15:52:31 +0200
parents 31a89587eb04
children
comparison
equal deleted inserted replaced
627:5153eb73b18d 628:6526d8adbc0f
15 * contact TMate Software at support@hg4j.com 15 * contact TMate Software at support@hg4j.com
16 */ 16 */
17 package org.tmatesoft.hg.core; 17 package org.tmatesoft.hg.core;
18 18
19 import org.tmatesoft.hg.internal.Callback; 19 import org.tmatesoft.hg.internal.Callback;
20 import org.tmatesoft.hg.repo.HgRuntimeException;
20 import org.tmatesoft.hg.util.Path; 21 import org.tmatesoft.hg.util.Path;
21 22
22 /** 23 /**
23 * Callback to walk file/directory tree of a revision 24 * Callback to walk file/directory tree of a revision
24 * 25 *
31 * Indicates start of manifest revision. Subsequent {@link #file(HgFileRevision)} and {@link #dir(Path)} come 32 * Indicates start of manifest revision. Subsequent {@link #file(HgFileRevision)} and {@link #dir(Path)} come
32 * from the specified manifest revision until {@link #end(Nodeid)} with the matching revision is invoked. 33 * from the specified manifest revision until {@link #end(Nodeid)} with the matching revision is invoked.
33 * 34 *
34 * @param manifestRevision unique identifier of the manifest revision 35 * @param manifestRevision unique identifier of the manifest revision
35 * @throws HgCallbackTargetException wrapper for any exception user code may produce 36 * @throws HgCallbackTargetException wrapper for any exception user code may produce
37 * @throws HgRuntimeException propagates library issues. <em>Runtime exception</em>
36 */ 38 */
37 void begin(Nodeid manifestRevision) throws HgCallbackTargetException; 39 void begin(Nodeid manifestRevision) throws HgCallbackTargetException, HgRuntimeException;
38 40
39 /** 41 /**
40 * If walker is configured to spit out directories, indicates files from specified directories are about to be reported. 42 * If walker is configured to spit out directories, indicates files from specified directories are about to be reported.
41 * Comes prior to any files from this directory and subdirectories 43 * Comes prior to any files from this directory and subdirectories
42 * 44 *
43 * @param path directory known in the manifest 45 * @param path directory known in the manifest
44 * @throws HgCallbackTargetException wrapper for any exception user code may produce 46 * @throws HgCallbackTargetException wrapper for any exception user code may produce
47 * @throws HgRuntimeException propagates library issues. <em>Runtime exception</em>
45 */ 48 */
46 void dir(Path path) throws HgCallbackTargetException; 49 void dir(Path path) throws HgCallbackTargetException, HgRuntimeException;
47 50
48 /** 51 /**
49 * Reports a file revision entry in the manifest 52 * Reports a file revision entry in the manifest
50 * 53 *
51 * @param fileRevision description of the file revision 54 * @param fileRevision description of the file revision
52 * @throws HgCallbackTargetException wrapper for any exception user code may produce 55 * @throws HgCallbackTargetException wrapper for any exception user code may produce
56 * @throws HgRuntimeException propagates library issues. <em>Runtime exception</em>
53 */ 57 */
54 void file(HgFileRevision fileRevision) throws HgCallbackTargetException; 58 void file(HgFileRevision fileRevision) throws HgCallbackTargetException, HgRuntimeException;
55 59
56 /** 60 /**
57 * Indicates all files from the manifest revision have been reported. 61 * Indicates all files from the manifest revision have been reported.
58 * Closes {@link #begin(Nodeid)} with the same revision that came before. 62 * Closes {@link #begin(Nodeid)} with the same revision that came before.
59 * 63 *
60 * @param manifestRevision unique identifier of the manifest revision 64 * @param manifestRevision unique identifier of the manifest revision
61 * @throws HgCallbackTargetException wrapper for any exception user code may produce 65 * @throws HgCallbackTargetException wrapper for any exception user code may produce
66 * @throws HgRuntimeException propagates library issues. <em>Runtime exception</em>
62 */ 67 */
63 void end(Nodeid manifestRevision) throws HgCallbackTargetException; 68 void end(Nodeid manifestRevision) throws HgCallbackTargetException, HgRuntimeException;
64 } 69 }