1 /* 2 * File : DownloadTrackerListener.java 3 * Created : 11-Jan-2004 4 * By : parg 5 * 6 * Azureus - a Java Bittorrent client 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License as published by 10 * the Free Software Foundation; either version 2 of the License, or 11 * (at your option) any later version. 12 * 13 * This program is distributed in the hope that it will be useful, 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of 15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 * GNU General Public License for more details ( see the LICENSE file ). 17 * 18 * You should have received a copy of the GNU General Public License 19 * along with this program; if not, write to the Free Software 20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 21 */ 22 23 package org.gudy.azureus2.plugins.download; 24 25 /** 26 * A listener that will be informed when the latest announce/scrape results 27 * change. See {@link org.gudy.azureus2.plugins.download#addTrackerListener} 28 * 29 * @author parg 30 * @author TuxPaper 2005/Oct/01: JavaDocs & reformat to Java Conventions w/Tabs 31 */ 32 public interface DownloadTrackerListener { 33 /** 34 * A scrape result has been returned from a tracker 35 * 36 * @param result Information about the scrape 37 * 38 * @since 2.0.7.0 39 * 40 * @note If an announce result is returned from the tracker contains 41 * seed and non-seed (peer) counts, a new DownloadScrapeResult will be 42 * created with the new information, and a scrapeResult will be 43 * triggered. 44 * <p> 45 * The DownloadScrapeResult isn't always information from the currently 46 * selected tracker. Compare result.getURL() with 47 * getDownload().getTorrent().getAnnounceURL() to determine if it's 48 * from the currently selected tracker. 49 */ scrapeResult(DownloadScrapeResult result)50 public void scrapeResult(DownloadScrapeResult result); 51 52 /** 53 * An announce result has been returned from the tracker 54 * 55 * @param result Information about the announce 56 * 57 * @since 2.0.7.0 58 */ announceResult(DownloadAnnounceResult result)59 public void announceResult(DownloadAnnounceResult result); 60 } 61