2 * Copyright (C) 2007, Robin Rosenberg <robin.rosenberg@dewire.com>
3 * Copyright (C) 2008, Shawn O. Pearce <spearce@spearce.org>
7 * Redistribution and use in source and binary forms, with or
8 * without modification, are permitted provided that the following
11 * - Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
14 * - Redistributions in binary form must reproduce the above
15 * copyright notice, this list of conditions and the following
16 * disclaimer in the documentation and/or other materials provided
17 * with the distribution.
19 * - Neither the name of the Git Development Community nor the
20 * names of its contributors may be used to endorse or promote
21 * products derived from this software without specific prior
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
25 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
26 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
27 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
29 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
31 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
32 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
33 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
34 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
36 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 package org
.spearce
.jgit
.lib
;
41 /** A progress reporting interface. */
42 public interface ProgressMonitor
{
43 /** Constant indicating the total work units cannot be predicted. */
44 public static final int UNKNOWN
= 0;
47 * Advise the monitor of the total number of subtasks.
49 * This should be invoked at most once per progress monitor interface.
52 * the total number of tasks the caller will need to complete
55 void start(int totalTasks
);
58 * Begin processing a single task.
61 * title to describe the task. Callers should publish these as
62 * stable string constants that implementations could match
63 * against for translation support.
65 * total number of work units the application will perform;
66 * {@link #UNKNOWN} if it cannot be predicted in advance.
68 void beginTask(String title
, int totalWork
);
71 * Denote that some work units have been completed.
73 * This is an incremental update; if invoked once per work unit the correct
74 * value for our argument is <code>1</code>, to indicate a single unit of
75 * work has been finished by the caller.
78 * the number of work units completed since the last call.
80 void update(int completed
);
82 /** Finish the current task, so the next can begin. */
86 * Check for user task cancellation.
88 * @return true if the user asked the process to stop working.
90 boolean isCancelled();