JavaGroups.JavaStack
Class RouterStub

java.lang.Object
  |
  +--JavaGroups.JavaStack.RouterStub

public class RouterStub

extends java.lang.Object

Constructor Summary

RouterStub(java.lang.String router_host, int router_port)
Creates a stub for a remote Router object.

Method Summary

Address	Connect() Establishes a connection to the router.
void	Disconnect() Closes the socket and the input and output streams associated with it
List	Get(java.lang.String groupname) Retrieves the membership (list of Addresses) for a given group.
static void	main(java.lang.String[] args)
Message	Receive() Receives a message from the router (blocking mode).
boolean	Reconnect() Tries to establish connection to router.
boolean	Register(java.lang.String groupname) Register this process with the routerb under groupname.
boolean	Send(Message msg) Sends a message to the router.

Methods inherited from class java.lang.Object

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

Constructor Detail

RouterStub

public RouterStub(java.lang.String router_host,
                  int router_port)

Creates a stub for a remote Router object.

Parameters:

router_host - The name of the router's host

router_port - The router's port

Method Detail

Connect

public Address Connect()

Establishes a connection to the router. The router will send my address (its peer address) back as an Address, which is subsequently returned to the caller. The reason for not using InetAddress.getLocalHost() or sock.getLocalAddress() is that this may not be permitted with certain security managers in case this code runs in an applet.

Disconnect

public void Disconnect()

Closes the socket and the input and output streams associated with it

Register

public boolean Register(java.lang.String groupname)

Register this process with the routerb under groupname.

Parameters:

groupname - The name of the group under which to register

Returns:

boolean False if connection down, true if registration successful.

Get

public List Get(java.lang.String groupname)

Retrieves the membership (list of Addresses) for a given group. This is mainly used by the PING protocol to obtain its initial membership. This is used infrequently, so don't maintain socket for the entire time, but create/delete it on demand.

Send

public boolean Send(Message msg)

Sends a message to the router. Returns false if message cannot be sent (e.g. no connection to router, true otherwise.

Receive

public Message Receive()

Receives a message from the router (blocking mode). If the connection is down, false is returned, otherwise true

Reconnect

public boolean Reconnect()

Tries to establish connection to router. Tries until router is up again.

main

public static void main(java.lang.String[] args)