/******************************************************************************
* Copyright (c) 2006 Remy Suen. All rights reserved. This program and the
* accompanying materials are made available under the terms of the Eclipse
* Public License v1.0, which accompanies this distribution and is available at
* http://www.eclipse.org/legal/epl-v10.html, and also the MIT license, which
* also accompanies this distribution. This dual licensing scheme allows a
* developer to choose either license for use when developing applications with
* this code.
*
* Contributors:
* Remy Suen <remy.suen@gmail.com> - initial API and implementation
******************************************************************************/
package org.eclipse.bittorrent;
/**
* This listener monitors problems that arise such as tracker errors and
* downloaded pieces which fail hash checks.
*/
public interface ITorrentErrorListener {
/**
* This method is called when the tracker returns an error.
*
* @param message
* the failure reason provided by the tracker
*/
public void trackerError(String message);
/**
* This method is called when a piece has failed the integrity hash check
* and has to be downloaded again.
*
* @param piece
* the number of the piece that failed the hash check
* @param pieceLength
* the length of the piece indicating the amount of data that has
* been discarded
*/
public void pieceDiscarded(int piece, int pieceLength);
}