public class UNICAST extends Protocol implements AckSenderWindow.RetransmitCommand, AgeOutCache.Handler<Address>
This
layer is used to reliably transmit point-to-point messages, that is, either messages sent to a
single receiver (vs. messages multicast to a group) or for example replies to a multicast message. The
sender uses an AckSenderWindow
which retransmits messages for which it hasn't received
an ACK, the receiver uses AckReceiverWindow
which keeps track of the lowest seqno
received so far, and keeps messages in order.
Messages in both AckSenderWindows and AckReceiverWindows will be removed. A message will be removed from AckSenderWindow when an ACK has been received for it and messages will be removed from AckReceiverWindow whenever a message is received: the new message is added and then we try to remove as many messages as possible (until we stop at a gap, or there are no more messages).
Modifier and Type | Class and Description |
---|---|
protected class |
UNICAST.ConnectionReaper |
static class |
UNICAST.UnicastHeader
The following types and fields are serialized:
|
Modifier and Type | Field and Description |
---|---|
protected long |
conn_expiry_timeout |
protected Future<?> |
connection_reaper |
static long |
DEFAULT_FIRST_SEQNO |
protected long |
max_retransmit_time |
protected ReentrantLock |
recv_table_lock |
protected int |
segment_capacity |
Constructor and Description |
---|
UNICAST() |
Modifier and Type | Method and Description |
---|---|
Object |
down(Event evt)
An event is to be sent down the stack.
|
Map<String,Object> |
dumpStats() |
void |
expired(Address key)
Called by AgeOutCache, to removed expired connections
|
AgeOutCache<Address> |
getAgeOutCache() |
int |
getAgeOutCacheSize() |
String |
getLocalAddress() |
long |
getMaxRetransmitTime() |
String |
getMembers() |
long |
getNumAcksReceived() |
long |
getNumAcksSent() |
int |
getNumberOfMessagesInReceiveWindows() |
long |
getNumberOfRetransmissions() |
int |
getNumberOfUnackedMessages()
The number of messages in all Entry.sent_msgs tables (haven't received an ACK yet)
|
long |
getNumBytesReceived() |
long |
getNumBytesSent() |
int |
getNumConnections() |
long |
getNumMessagesReceived() |
long |
getNumMessagesSent() |
int |
getNumReceiveConnections() |
int |
getNumSendConnections() |
int[] |
getTimeout() |
protected void |
handleDataReceived(Address sender,
long seqno,
long conn_id,
boolean first,
Message msg,
Event evt)
Check whether the hashtable contains an entry e for
sender (create if not). |
boolean |
isConnectionReaperRunning() |
String |
printAgeOutCache() |
String |
printConnections() |
String |
printUnackedMessages() |
void |
reapIdleConnections() |
void |
removeAllConnections()
This method is public only so it can be invoked by unit testing, but should not otherwise be used !
|
void |
removeConnection(Address mbr)
Removes and resets from connection table (which is already locked).
|
void |
removeReceiveConnection(Address mbr) |
void |
removeSendConnection(Address mbr) |
void |
resetStats() |
void |
retransmit(long seqno,
Message msg)
Called by AckSenderWindow to resend messages for which no ACK has been received yet
|
void |
setMaxMessageBatchSize(int size) |
void |
setMaxRetransmitTime(long max_retransmit_time) |
void |
setTimeout(int[] val) |
void |
start()
This method is called on a
Channel.connect(String) . |
protected void |
startConnectionReaper() |
void |
stop()
This method is called on a
Channel.disconnect() . |
protected void |
stopConnectionReaper() |
Object |
up(Event evt)
An event was received from the layer below.
|
destroy, enableStats, getConfigurableObjects, getDownProtocol, getId, getLevel, getName, getProtocolStack, getSocketFactory, getThreadFactory, getTransport, getUpProtocol, getValue, init, isErgonomics, printStats, providedDownServices, providedUpServices, requiredDownServices, requiredUpServices, resetStatistics, setDownProtocol, setErgonomics, setId, setLevel, setProtocolStack, setSocketFactory, setUpProtocol, setValue, setValues, statsEnabled
public static final long DEFAULT_FIRST_SEQNO
protected long conn_expiry_timeout
protected int segment_capacity
protected final ReentrantLock recv_table_lock
protected long max_retransmit_time
protected Future<?> connection_reaper
public int[] getTimeout()
public void setTimeout(int[] val)
public void setMaxMessageBatchSize(int size)
public String getLocalAddress()
public String getMembers()
public boolean isConnectionReaperRunning()
public int getNumSendConnections()
public int getNumReceiveConnections()
public int getNumConnections()
public String printConnections()
public long getNumMessagesSent()
public long getNumMessagesReceived()
public long getNumBytesSent()
public long getNumBytesReceived()
public long getNumAcksSent()
public long getNumAcksReceived()
public long getNumberOfRetransmissions()
public long getMaxRetransmitTime()
public void setMaxRetransmitTime(long max_retransmit_time)
public int getAgeOutCacheSize()
public String printAgeOutCache()
public AgeOutCache<Address> getAgeOutCache()
public int getNumberOfUnackedMessages()
public String printUnackedMessages()
public int getNumberOfMessagesInReceiveWindows()
public void resetStats()
resetStats
in class Protocol
public void start() throws Exception
Protocol
Channel.connect(String)
. Starts work.
Protocols are connected and queues are ready to receive events.
Will be called from bottom to top. This call will replace
the START and START_OK events.start
in class Protocol
Exception
- Thrown if protocol cannot be started successfully. This will cause the ProtocolStack
to fail, so Channel.connect(String)
will throw an exceptionpublic void stop()
Protocol
Channel.disconnect()
. Stops work (e.g. by closing multicast socket).
Will be called from top to bottom. This means that at the time of the method invocation the
neighbor protocol below is still working. This method will replace the
STOP, STOP_OK, CLEANUP and CLEANUP_OK events. The ProtocolStack guarantees that
when this method is called all messages in the down queue will have been flushedpublic Object up(Event evt)
Protocol
down_prot.down()
or c) the event (or another event) is sent up
the stack using up_prot.up()
.public Object down(Event evt)
Protocol
down_prot.down()
. In case of a GET_ADDRESS event (which tries to
retrieve the stack's address from one of the bottom layers), the layer may need to send
a new response event back up the stack using up_prot.up()
.public void removeConnection(Address mbr)
public void removeSendConnection(Address mbr)
public void removeReceiveConnection(Address mbr)
public void removeAllConnections()
public void retransmit(long seqno, Message msg)
retransmit
in interface AckSenderWindow.RetransmitCommand
public void expired(Address key)
expired
in interface AgeOutCache.Handler<Address>
key
- protected void handleDataReceived(Address sender, long seqno, long conn_id, boolean first, Message msg, Event evt)
sender
(create if not). If
e.received_msgs is null and first
is true: create a new AckReceiverWindow(seqno) and
add message. Set e.received_msgs to the new window. Else just add the message.protected void startConnectionReaper()
protected void stopConnectionReaper()
public void reapIdleConnections()
Copyright © 2012 JBoss by Red Hat. All Rights Reserved.