/* * Created on Oct 17, 2004 * Created by Alon Rohter * Copyright (C) 2004, 2005, 2006 Aelitis, All Rights Reserved. * * 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; either version 2 * of the License, or (at your option) any later version. * 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. * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * * AELITIS, SAS au capital de 46,603.30 euros * 8 Allee Lenotre, La Grille Royale, 78600 Le Mesnil le Roi, France. * */ package com.aelitis.azureus.core.networkmanager; import java.io.IOException; import com.aelitis.azureus.core.peermanager.messaging.*; /** * Inbound peer message queue. */ public interface IncomingMessageQueue { /** * Set the message stream decoder that will be used to decode incoming messages. * @param new_stream_decoder to use */ public void setDecoder( MessageStreamDecoder new_stream_decoder ); public MessageStreamDecoder getDecoder(); /** * Get the percentage of the current message that has already been received. * @return percentage complete (0-99), or -1 if no message is currently being received */ public int getPercentDoneOfCurrentMessage(); /** * Receive (read) message(s) data from the underlying transport. * @param max_bytes to read * @return number of bytes received * @throws IOException on receive error */ public int receiveFromTransport( int max_bytes ) throws IOException; /** * Notifty the queue (and its listeners) of a message received externally on the queue's behalf. * @param message received externally */ public void notifyOfExternallyReceivedMessage( Message message ); /** * Manually resume processing (reading) incoming messages. * NOTE: Allows us to resume docoding externally, in case it was auto-paused internally. */ public void resumeQueueProcessing(); /** * Add a listener to be notified of queue events. * @param listener */ public void registerQueueListener( MessageQueueListener listener ); /** * Cancel queue event notification listener. * @param listener */ public void cancelQueueListener( MessageQueueListener listener ); /** * Destroy this queue. */ public void destroy(); /** * For notification of queue events. */ public interface MessageQueueListener { /** * A message has been read from the connection. * @param message recevied * @return true if this message was accepted, false if not handled */ public boolean messageReceived( Message message ); /** * The given number of protocol (overhead) bytes read from the connection. * @param byte_count number of protocol bytes */ public void protocolBytesReceived( int byte_count ); /** * The given number of (piece) data bytes read from the connection. * @param byte_count number of data bytes */ public void dataBytesReceived( int byte_count ); } }