de.ruedigermoeller.fastcast.remoting

Class FCTopicService

java.lang.Object

de.ruedigermoeller.fastcast.remoting.FCTopicService

Direct Known Subclasses:

FCBinaryTopicService, FCEmptyService, FCMembership

public class FCTopicService
extends Object

for each network topic (ordered stream of messages) exactly one service exists.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	nodeId
protected FCRemoting	remoting
protected String	topicName
protected int	topicNum

Constructor Summary

Constructors

Constructor and Description
FCTopicService()

Method Summary

Methods

Modifier and Type	Method and Description
void	droppedFromReceiving() signaled if this service could not keep up with send rate and requested retransmission of a packet which is already removed from the senders history.
String	getNodeId()
FCRemoting	getRemoting()
String	getTopicName()
int	getTopicNum() get unique number of this topic
void	init() override to do init and stuff
protected boolean	invoke(int methodIndex, Method m, de.ruedigermoeller.serialization.FSTObjectInput in, Class[] types) called right before decoding, return true to consume the call.
protected int	readAndFilter(int methodId, de.ruedigermoeller.heapoff.bytez.Bytez bytez, int offset) allows to filter out messages before they are decoded by reading a user provided header (see writeFilterBytes).
void	receiveBinary(de.ruedigermoeller.heapoff.bytez.Bytez bytes, int offset, int length) called is pure binary content has been sent, bypass of remoting layer
void	replyToSender() next remote call goes to sender of current method.

Methods inherited from class java.lang.Object

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

Field Detail

nodeId

protected String nodeId

remoting

protected FCRemoting remoting

topicName

protected String topicName

topicNum

protected int topicNum

Constructor Detail

FCTopicService

public FCTopicService()

Method Detail

getTopicNum

public int getTopicNum()

get unique number of this topic

Returns:

invoke

protected boolean invoke(int methodIndex,
             Method m,
             de.ruedigermoeller.serialization.FSTObjectInput in,
             Class[] types)

called right before decoding, return true to consume the call. If you read from the object stream, you need to consume or rewind the stream to its original position.

Parameters:

methodIndex -

m -

in -

types -

Returns:

getNodeId

public String getNodeId()

Returns:

the cluster unique id of this process

getRemoting

public FCRemoting getRemoting()

Returns:

the remoting instance. Allows access to other services etc.

getTopicName

public String getTopicName()

Returns:

unque name of this topic

droppedFromReceiving

public void droppedFromReceiving()

signaled if this service could not keep up with send rate and requested retransmission of a packet which is already removed from the senders history. Reasons are: 1) history buffer of sender is too small 2) network congestions/overload 3) (most frequent) receiver is slow or has long GC pauses after this message, no further messages will be received until receivers reconnects.

init

public void init()

override to do init and stuff

receiveBinary

public void receiveBinary(de.ruedigermoeller.heapoff.bytez.Bytez bytes,
                 int offset,
                 int length)

called is pure binary content has been sent, bypass of remoting layer

Parameters:

bytes -

offset -

length -

replyToSender

public void replyToSender()

next remote call goes to sender of current method.

readAndFilter

protected int readAndFilter(int methodId,
                de.ruedigermoeller.heapoff.bytez.Bytez bytez,
                int offset)

allows to filter out messages before they are decoded by reading a user provided header (see writeFilterBytes). return -1 to ignore the message or the size of the application provided header.

Parameters:

bytez -

offset -

Returns: