org.jgroups.protocols
Class FRAG

java.lang.Object
  extended by org.jgroups.stack.Protocol
      extended by org.jgroups.protocols.FRAG

public class FRAG
extends Protocol

Fragmentation layer. Fragments messages larger than FRAG_SIZE into smaller packets. Reassembles fragmented packets into bigger ones. The fragmentation number is prepended to the messages as a header (and removed at the receiving side).

Each fragment is identified by (a) the sender (part of the message to which the header is appended), (b) the fragmentation ID (which is unique per FRAG layer (monotonically increasing) and (c) the fragement ID which ranges from 0 to number_of_fragments-1.

Requirement: lossless delivery (e.g. NAK, ACK). No requirement on ordering. Works for both unicast and multicast messages.

Version:
$Id: FRAG.java,v 1.32.2.1 2007/04/27 08:03:51 belaban Exp $
Author:
Bela Ban, Filip Hanik

Field Summary
 
Fields inherited from class org.jgroups.stack.Protocol
down_handler, down_prot, down_queue, down_thread, down_thread_prio, log, observer, props, stack, stats, up_handler, up_prot, up_queue, up_thread, up_thread_prio
 
Constructor Summary
FRAG()
           
 
Method Summary
 void down(Event evt)
          Fragment a packet if larger than frag_size (add a header).
 int getFragSize()
           
 java.lang.String getName()
           
 long getNumberOfReceivedFragments()
           
 long getNumberOfReceivedMessages()
           
 long getNumberOfSentFragments()
           
 long getNumberOfSentMessages()
           
 void resetStats()
           
 void setFragSize(int s)
           
 boolean setProperties(java.util.Properties props)
          Setup the Protocol instance acording to the configuration string
 void up(Event evt)
          If event is a message, if it is fragmented, re-assemble fragments into big message and pass up the stack.
 
Methods inherited from class org.jgroups.stack.Protocol
destroy, downThreadEnabled, dumpStats, enableStats, getDownProtocol, getDownQueue, getProperties, getUpProtocol, getUpQueue, handleSpecialDownEvent, init, passDown, passUp, printStats, providedDownServices, providedUpServices, receiveDownEvent, receiveUpEvent, requiredDownServices, requiredUpServices, setDownProtocol, setObserver, setPropertiesInternal, setProtocolStack, setUpProtocol, start, startDownHandler, startUpHandler, statsEnabled, stop, stopInternal, upThreadEnabled
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FRAG

public FRAG()
Method Detail

getName

public java.lang.String getName()
Specified by:
getName in class Protocol

getFragSize

public int getFragSize()

setFragSize

public void setFragSize(int s)

getNumberOfSentMessages

public long getNumberOfSentMessages()

getNumberOfSentFragments

public long getNumberOfSentFragments()

getNumberOfReceivedMessages

public long getNumberOfReceivedMessages()

getNumberOfReceivedFragments

public long getNumberOfReceivedFragments()

setProperties

public boolean setProperties(java.util.Properties props)
Setup the Protocol instance acording to the configuration string

Overrides:
setProperties in class Protocol

resetStats

public void resetStats()
Overrides:
resetStats in class Protocol

down

public void down(Event evt)
Fragment a packet if larger than frag_size (add a header). Otherwise just pass down. Only add a header if framentation is needed !

Overrides:
down in class Protocol

up

public void up(Event evt)
If event is a message, if it is fragmented, re-assemble fragments into big message and pass up the stack.

Overrides:
up in class Protocol


Copyright ? 1998-2006 Bela Ban. All Rights Reserved.