org.jgroups.tests

Class LargeState

java.lang.Object

org.jgroups.ReceiverAdapter

org.jgroups.tests.LargeState

All Implemented Interfaces:

MembershipListener, MessageListener, Receiver

public class LargeState
extends ReceiverAdapter

Tests transfer of large states. Start first instance with -provider flag and -size flag (default = 1MB). The start second instance without these flags: it should acquire the state from the first instance. Possibly tracing should be turned on for FRAG to see the fragmentation taking place, e.g.:

 trace1=FRAG DEBUG STDOUT
 

Note that because fragmentation might generate a lot of small fragments at basically the same time (e.g. size1MB, FRAG.frag-size=4096 generates a lot of fragments), the send buffer of the unicast socket in UDP might be overloaded, causing it to drop some packets (default size is 8096 bytes). Therefore the send (and receive) buffers for the unicast socket have been increased (see ucast_send_buf_size and ucast_recv_buf_size below).

If we didn't do this, we would have some retransmission, slowing the state transfer down.

Author:

Bela Ban Dec 13 2001

Constructor Summary

Constructors

Constructor and Description
LargeState()

Method Summary

Modifier and Type	Method and Description
void	getState(OutputStream ostream) Allows an application to write a state through a provided OutputStream.
static void	main(String[] args)
void	receive(Message msg) Called when a message is received.
void	setState(InputStream istream) Allows an application to read a state through a provided InputStream.
void	start(boolean provider, int size, String props, boolean provider_fails, boolean requester_fails, long delay, String name)
void	viewAccepted(View new_view) Called when a change in membership has occurred.

Methods inherited from class org.jgroups.ReceiverAdapter

block, suspect, unblock

Methods inherited from class java.lang.Object

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

Constructor Detail

LargeState

public LargeState()

Method Detail

start

public void start(boolean provider,
                  int size,
                  String props,
                  boolean provider_fails,
                  boolean requester_fails,
                  long delay,
                  String name)
           throws Exception

Throws:

Exception

receive

public void receive(Message msg)

Description copied from class: ReceiverAdapter

Called when a message is received.

Specified by:

receive in interface MessageListener

Overrides:

receive in class ReceiverAdapter

viewAccepted

public void viewAccepted(View new_view)

Description copied from class: ReceiverAdapter

Called when a change in membership has occurred. No long running actions, sending of messages or anything that could block should be done in this callback. If some long running action needs to be performed, it should be done in a separate thread.

Note that on reception of the first view (a new member just joined), the channel will not yet be in the connected state. This only happens when Channel.connect(String) returns.

Specified by:

viewAccepted in interface MembershipListener

Overrides:

viewAccepted in class ReceiverAdapter

setState

public void setState(InputStream istream)
              throws Exception

Description copied from class: ReceiverAdapter

Allows an application to read a state through a provided InputStream. After the state has been read the InputStream doesn't need to be closed as stream closing is automatically done when a calling thread returns from this callback.

Specified by:

setState in interface MessageListener

Overrides:

setState in class ReceiverAdapter

Parameters:

istream - the InputStream

Throws:

Exception - if the streaming fails, any exceptions should be thrown so that the state requester can catch them and thus know what happened

See Also:

InputStream.close()

getState

public void getState(OutputStream ostream)
              throws Exception

Description copied from class: ReceiverAdapter

Allows an application to write a state through a provided OutputStream. After the state has been written the OutputStream doesn't need to be closed as stream closing is automatically done when a calling thread returns from this callback.

Specified by:

getState in interface MessageListener

Overrides:

getState in class ReceiverAdapter

Parameters:

ostream - the OutputStream

Throws:

Exception - if the streaming fails, any exceptions should be thrown so that the state requester can re-throw them and let the caller know what happened

See Also:

OutputStream.close()

main

public static void main(String[] args)