org.nustaq.fastcast.api.util

Class ByteArraySubscriber

java.lang.Object

org.nustaq.fastcast.api.util.ByteArraySubscriber

All Implemented Interfaces:

FCSubscriber

Direct Known Subclasses:

ObjectSubscriber

public abstract class ByteArraySubscriber
extends Object
implements FCSubscriber

Created by ruedi on 14.12.2014. subscriber implementation that handles conversion to byte array and by default provides a dedicated thread for message processing. Note this is *not* allocation free, so not well suited for low latency stuff.

Field Summary

Fields

Modifier and Type	Field and Description
protected Executor	executor
protected byte[]	tmpBuf

Constructor Summary

Constructors

Constructor and Description
ByteArraySubscriber()
ByteArraySubscriber(boolean dedicatedThread)

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).
protected abstract void	messageReceived(String sender, long sequence, byte[] msg, int off, int len)
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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

executor

protected Executor executor

tmpBuf

protected byte[] tmpBuf

Constructor Detail

ByteArraySubscriber

public ByteArraySubscriber(boolean dedicatedThread)

ByteArraySubscriber

public ByteArraySubscriber()

Method Detail

messageReceived

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

Description copied from interface: FCSubscriber

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'.

Specified by:

messageReceived in interface FCSubscriber

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

messageReceived

protected abstract void messageReceived(String sender,
                                        long sequence,
                                        byte[] msg,
                                        int off,
                                        int len)

dropped

public boolean dropped()

Description copied from interface: FCSubscriber

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

Specified by:

dropped in interface FCSubscriber

senderTerminated

public void senderTerminated(String senderNodeId)

Description copied from interface: FCSubscriber

a sender stopped sending or terminated

Specified by:

senderTerminated in interface FCSubscriber

senderBootstrapped

public void senderBootstrapped(String receivesFrom,
                               long seqNo)

Description copied from interface: FCSubscriber

called upon the first message regulary received from a sender

Specified by:

senderBootstrapped in interface FCSubscriber