01: /*
02: * ====================================================================
03: * Copyright (c) 2004-2008 TMate Software Ltd. All rights reserved.
04: *
05: * This software is licensed as described in the file COPYING, which
06: * you should have received as part of this distribution. The terms
07: * are also available at http://svnkit.com/license.html
08: * If newer versions of this license are posted there, you may use a
09: * newer version instead, at your option.
10: * ====================================================================
11: */
12: package org.tmatesoft.svn.core.wc;
13:
14: import org.tmatesoft.svn.core.SVNException;
15:
16: /**
17: * The <b>ISVNStatusHandler</b> interface should be implemented in order to
18: * be further provided to some of <b>SVNStatusClient</b>'s doStatus() methods
19: * to handle status information of Working Copy items.
20: *
21: * <p>
22: * When running a status operation using a status handler an
23: * <b>SVNStatusClient</b>'s doStatus() method generates an <b>SVNStatus</b>
24: * object per each interesting WC entry and dispatches that object to the
25: * status handler where it's up to a developer to retrieve status detailes
26: * from the <b>SVNStatus</b> object and interprete them in a desired way.
27: *
28: * <p>
29: * All calls to a <b>handleStatus()</b> method are synchronous - that is the
30: * caller is blocked till the method finishes.
31: *
32: * @version 1.1.1
33: * @author TMate Software Ltd.
34: * @see SVNStatusClient
35: * @see SVNStatus
36: * @see <a target="_top" href="http://svnkit.com/kb/examples/">Examples</a>
37: *
38: */
39: public interface ISVNStatusHandler {
40: /**
41: * Handles WC item's status information using an <b>SVNStatus</b> object.
42: *
43: * @param status an object that contains per item status information
44: * @throws SVNException
45: */
46: public void handleStatus(SVNStatus status) throws SVNException;
47: }
|