org.jgroups.tests

Class RpcDispatcherBlocking

java.lang.Object

org.jgroups.tests.RpcDispatcherBlocking

All Implemented Interfaces:

MembershipListener

public class RpcDispatcherBlocking
extends Object
implements MembershipListener

Tests synchronous group RPCs. 2 main test cases:

1. Member crashes during invocation of sync group RPC: start 3 instances (A, B,C), set the timeout to be 30 seconds. Then invoke a sync group RPC by A (press 's' in A's window). A,B and C should receive the RPC. Now kill C. After some time, A's method call should return and show A's and B's reply to be valid, while showing C's response marked as suspected.
2. Member joins group during synchronous group RPC: start A and B with timeout=30000. Invoke a sync group RPC on A. Start C. A and B should not receive the view change before the group RPC has returned with A's and B's results. Therefore A and B should not wait for C's response, which would never be received because C never got the RPC in the first place. This would block A forever.

Author:

bela Dec 19, 2002

Constructor Summary

Constructors

Constructor and Description
RpcDispatcherBlocking(String props, long timeout)

Method Summary

Modifier and Type	Method and Description
void	block() Block sending and receiving of messages until viewAccepted() is called
static void	main(String[] args)
void	print(int i)
void	start()
void	suspect(Address suspected_mbr) Called when a member is suspected
void	unblock() Called after the FLUSH protocol has unblocked previously blocked senders, and messages can be sent again.
void	viewAccepted(View new_view) Called when a change in membership has occurred.

Methods inherited from class java.lang.Object

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

Constructor Detail

RpcDispatcherBlocking

public RpcDispatcherBlocking(String props,
                             long timeout)

Method Detail

print

public void print(int i)
           throws Exception

Throws:

Exception

viewAccepted

public void viewAccepted(View new_view)

Description copied from interface: MembershipListener

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

suspect

public void suspect(Address suspected_mbr)

Called when a member is suspected

Specified by:

suspect in interface MembershipListener

block

public void block()

Block sending and receiving of messages until viewAccepted() is called

Specified by:

block in interface MembershipListener

unblock

public void unblock()

Description copied from interface: MembershipListener

Called after the FLUSH protocol has unblocked previously blocked senders, and messages can be sent again. This callback only needs to be implemented if we require a notification of that.

Note that during new view installation we provide guarantee that unblock invocation strictly follows view installation at some node A belonging to that view . However, some other message M may squeeze in between view and unblock callbacks. For more details see https://jira.jboss.org/jira/browse/JGRP-986

Specified by:

unblock in interface MembershipListener

start

public void start()
           throws Exception

Throws:

Exception

main

public static void main(String[] args)