view src/org/tmatesoft/hg/core/HgStatusHandler.java @ 495:abfbe81154b5

Do not use exception when only metadata processing is needed. For hg4j repo, status 0:-1 changed from 500 to 60 ms
author Artem Tikhomirov <tikhomirov.artem@gmail.com>
date Fri, 19 Oct 2012 16:03:21 +0200
parents 36fd1fd06492
children
line wrap: on
line source
/*
 * Copyright (c) 2011-2012 TMate Software Ltd
 *  
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 2 of the License.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * For information on how to redistribute this software under
 * the terms of a license other than GNU General Public License
 * contact TMate Software at support@hg4j.com
 */
package org.tmatesoft.hg.core;

import org.tmatesoft.hg.internal.Callback;
import org.tmatesoft.hg.util.Path;
import org.tmatesoft.hg.util.Outcome;

/**
 * Callback to process {@link HgStatus} objects.
 * @author Artem Tikhomirov
 * @author TMate Software Ltd.
 */
@Callback
public interface HgStatusHandler {

	/**
	 * Report status of the next file
	 * 
	 * @param s file status descriptor 
	 * @throws HgCallbackTargetException wrapper for any exception user code may produce
	 */
	void status(HgStatus s) throws HgCallbackTargetException;

	/**
	 * Report non-critical error processing single file during status operation
	 * 
	 * @param file name of the file that caused the trouble
	 * @param s error description object
	 * @throws HgCallbackTargetException wrapper for any exception user code may produce
	 */
	void error(Path file, Outcome s) throws HgCallbackTargetException;
}