org.nustaq.fastcast.api

Interface FCSubscriber

All Known Implementing Classes:

ByteArraySubscriber, ObjectSubscriber

public interface FCSubscriber

interface to be implemented by a subscriber to a topic. Note there is a serialization based util implementation ObjectSubscriber. Created by ruedi on 29.11.2014.

Method Summary

Modifier and Type	Method and Description
boolean	dropped() called in case the receiver was too slow in processing messages and therefore got dropped (unrecoverable message loss).
void	messageReceived(String sender, long sequence, org.nustaq.offheap.bytez.Bytez b, long off, int len) a message has been defragmented and received.
void	senderBootstrapped(String receivesFrom, long seqNo) called upon the first message regulary received from a sender
void	senderTerminated(String senderNodeId) a sender stopped sending or terminated

Method Detail

messageReceived

void messageReceived(String sender,
                     long sequence,
                     org.nustaq.offheap.bytez.Bytez b,
                     long off,
                     int len)

a message has been defragmented and received. This method is called directly in the packet receiving thread, so processing should be delegated to a worker or be extremely quick. else packet loss might occur. one can use 'Bytez.getArr(off, tmpBuf, 0, len);' to copy the message contents to a byte array 'tmpBuf'.

Parameters:

sender - - nodeId of sending process

sequence - - internal sequence number (of interest for unreliable variants)

b - - bytesource containing the message at off and with len

off - - offset of message

len - - len of message

dropped

boolean dropped()

called in case the receiver was too slow in processing messages and therefore got dropped (unrecoverable message loss). return true in order to let fast-cast automatically reconnect and resync

senderTerminated

void senderTerminated(String senderNodeId)

a sender stopped sending or terminated

Parameters:

senderNodeId -

senderBootstrapped

void senderBootstrapped(String receivesFrom,
                        long seqNo)

called upon the first message regulary received from a sender

Parameters:

receivesFrom -

seqNo -