1/*-
2 * See the file LICENSE for redistribution information.
3 *
4 * Copyright (c) 1997,2008 Oracle.  All rights reserved.
5 *
6 * $Id: FeedbackHandler.java,v 12.7 2008/01/17 05:04:53 mjc Exp $
7 */
8package com.sleepycat.db;
9
10/**
11An interface specifying a function to be called to provide feedback.
12*/
13public interface FeedbackHandler {
14    /**
15    A function called with progress information when the database environment is being recovered.
16    <p>
17    It is up to this function to display this information in an appropriate manner.
18    <p>
19    @param environment
20    A reference to the enclosing database environment.
21    <p>
22    @param percent
23    The percent of the operation completed, specified as an integer value between 0 and 100.
24    */
25    void recoveryFeedback(Environment environment, int percent);
26
27    /**
28    A function called with progress information when the database is being upgraded.
29    <p>
30    It is up to this function to display this information in an appropriate manner.
31    <p>
32    @param database
33    A reference to the enclosing database.
34    <p>
35    @param percent
36    The percent of the operation completed, specified as an integer value between 0 and 100.
37    */
38    void upgradeFeedback(Database database, int percent);
39
40    /**
41    A function called with progress information when the database is being verified.
42    <p>
43    It is up to this function to display this information in an appropriate manner.
44    <p>
45    @param database
46    A reference to the enclosing database.
47    <p>
48    @param percent
49    The percent of the operation completed, specified as an integer value between 0 and 100.
50    */
51    void verifyFeedback(Database database, int percent);
52}
53