Package org.jgroups.protocols
Class DELAY
- java.lang.Object
-
- org.jgroups.stack.Protocol
-
- org.jgroups.protocols.DELAY
-
- All Implemented Interfaces:
Lifecycle
public class DELAY extends Protocol
Delays incoming/outgoing messages by a random number of milliseconds (range between 0 and n where n is determined by the user) and nanoseconds (constant amount).Incoming messages can be delayed independently from outgoing messages (or not delayed at all).
This protocol should be inserted directly above the transport protocol (e.g. UDP).
- Author:
- Bela Ban, Sanne Grinovero, Matej Cimbora
-
-
Field Summary
Fields Modifier and Type Field Description protected boolean
constant_delay
protected org.jgroups.protocols.DELAY.DelayedMessageHandler
delayed_message_handler
protected java.util.concurrent.DelayQueue<org.jgroups.protocols.DELAY.DelayedMessage>
delayed_messages
protected int
in_delay
protected int
in_delay_nanos
protected int
out_delay
protected int
out_delay_nanos
-
Fields inherited from class org.jgroups.stack.Protocol
after_creation_hook, down_prot, ergonomics, id, local_addr, log, policies, stack, stats, up_prot
-
-
Constructor Summary
Constructors Constructor Description DELAY()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
destroy()
This method is called on aJChannel.close()
.java.lang.Object
down(Message msg)
A message is sent down the stack.int
getInDelay()
int
getInDelayNanos()
int
getOutDelay()
int
getOutDelayNanos()
void
init()
Called after a protocol has been created and before the protocol is started.void
setInDelay(int in_delay)
void
setInDelayNanos(int in_delay_nanos)
void
setOutDelay(int out_delay)
void
setOutDelayNanos(int out_delay_nanos)
java.lang.Object
up(Message msg)
A single message was received.void
up(MessageBatch batch)
Sends up a multiple messages in aMessageBatch
.-
Methods inherited from class org.jgroups.stack.Protocol
accept, addPolicy, addr, addr, afterCreationHook, down, down, enableStats, getAddress, getComponents, getDownProtocol, getDownServices, getId, getIdsAbove, getLevel, getLog, getName, getPolicies, getProtocolStack, getSocketFactory, getThreadFactory, getTransport, getUpProtocol, getUpServices, getValue, isErgonomics, level, parse, policies, providedDownServices, providedUpServices, removePolicy, requiredDownServices, requiredUpServices, resetStatistics, resetStats, setAddress, setDownProtocol, setErgonomics, setId, setLevel, setPolicies, setProtocolStack, setSocketFactory, setUpProtocol, setValue, start, statsEnabled, stop, toString, up
-
-
-
-
Field Detail
-
in_delay
protected int in_delay
-
out_delay
protected int out_delay
-
in_delay_nanos
protected int in_delay_nanos
-
out_delay_nanos
protected int out_delay_nanos
-
constant_delay
protected boolean constant_delay
-
delayed_message_handler
protected org.jgroups.protocols.DELAY.DelayedMessageHandler delayed_message_handler
-
delayed_messages
protected java.util.concurrent.DelayQueue<org.jgroups.protocols.DELAY.DelayedMessage> delayed_messages
-
-
Method Detail
-
getInDelay
public int getInDelay()
-
setInDelay
public void setInDelay(int in_delay)
-
getOutDelay
public int getOutDelay()
-
setOutDelay
public void setOutDelay(int out_delay)
-
getInDelayNanos
public int getInDelayNanos()
-
setInDelayNanos
public void setInDelayNanos(int in_delay_nanos)
-
getOutDelayNanos
public int getOutDelayNanos()
-
setOutDelayNanos
public void setOutDelayNanos(int out_delay_nanos)
-
init
public void init() throws java.lang.Exception
Description copied from class:Protocol
Called after a protocol has been created and before the protocol is started. Attributes are already set. Other protocols are not yet connected and events cannot yet be sent.
-
destroy
public void destroy()
Description copied from class:Protocol
This method is called on aJChannel.close()
. Does some cleanup; after the call, the VM will terminate
-
down
public java.lang.Object down(Message msg)
Description copied from class:Protocol
A message is sent down the stack. Protocols may examine the message and do something (e.g. add a header) with it, before passing it down.
-
up
public java.lang.Object up(Message msg)
Description copied from class:Protocol
A single message was received. Protocols may examine the message and do something (e.g. add a header) with it before passing it up.
-
up
public void up(MessageBatch batch)
Description copied from class:Protocol
Sends up a multiple messages in aMessageBatch
. The sender of the batch is always the same, and so is the destination (null == multicast messages). Messages in a batch can be OOB messages, regular messages, or mixed messages, although the transport itself will create initial MessageBatches that contain only either OOB or regular messages. The default processing below sends messages up the stack individually, based on a matching criteria (callingProtocol.accept(Message)
), and - if true - callsProtocol.up(org.jgroups.Event)
for that message and removes the message. If the batch is not empty, it is passed up, or else it is dropped. Subclasses should check if there are any messages destined for them (e.g. usingMessageBatch.iterator(Predicate)
), then possibly remove and process them and finally pass the batch up to the next protocol. Protocols can also modify messages in place, e.g. ENCRYPT could decrypt all encrypted messages in the batch, not remove them, and pass the batch up when done.
-
-