Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.jgroups.protocols
Class VIEW_SYNC  view VIEW_SYNC download VIEW_SYNC.java

java.lang.Object
  extended byorg.jgroups.stack.Protocol
      extended byorg.jgroups.protocols.VIEW_SYNC

public class VIEW_SYNC
extends org.jgroups.stack.Protocol

Periodically sends the view to the group. When a view is received which is greater than the current view, we install it. Otherwise we simply discard it. This is used to solve the problem for unreliable view dissemination outlined in JGroups/doc/ReliableViewInstallation.txt. This protocol is supposed to be just below GMS.

Version:
$Id: VIEW_SYNC.java,v 1.4 2005/10/27 08:30:14 belaban Exp $

Nested Class Summary
private  class VIEW_SYNC.ViewSendTask
          Periodically multicasts a View_SYNC message
static class VIEW_SYNC.ViewSyncHeader
           
 
Field Summary
(package private)  long avg_send_interval
          Sends a VIEW_SYNC message to the group every 20 seconds on average.
(package private)  org.jgroups.Address local_addr
           
(package private)  java.util.Vector mbrs
           
(package private)  org.jgroups.ViewId my_vid
           
(package private)  org.jgroups.View my_view
           
(package private) static java.lang.String name
           
private  int num_views_adjusted
           
private  int num_views_sent
           
(package private)  org.jgroups.util.TimeScheduler timer
           
(package private)  VIEW_SYNC.ViewSendTask view_send_task
           
(package private)  java.lang.Object view_send_task_mutex
           
 
Fields inherited from class org.jgroups.stack.Protocol
down_handler, down_prot, down_queue, down_thread, down_thread_prio, log, observer, props, stack, stats, trace, up_handler, up_prot, up_queue, up_thread, up_thread_prio, warn
 
Constructor Summary
VIEW_SYNC()
           
 
Method Summary
 void down(org.jgroups.Event evt)
          An event is to be sent down the stack.
 long getAverageSendInterval()
           
 java.lang.String getName()
           
 int getNumViewsAdjusted()
           
 int getNumViewsSent()
           
private  void handleView(org.jgroups.View v, org.jgroups.Address sender)
           
private  void handleViewChange(org.jgroups.View view)
           
 void resetStats()
           
private  void sendView()
           
 void sendViewRequest()
          Sends a VIEW_SYNC_REQ to all members, every member replies with a VIEW multicast
 void setAverageSendInterval(long gossip_interval)
           
 boolean setProperties(java.util.Properties props)
          Configures the protocol initially.
 void start()
          This method is called on a Channel.connect(String)>Channel.connect(String) 55 .
(package private)  void startViewSender()
           
 void stop()
          This method is called on a Channel.disconnect()>Channel.disconnect() 55 .
(package private)  void stopViewSender()
           
 void up(org.jgroups.Event evt)
          An event was received from the layer below.
 
Methods inherited from class org.jgroups.stack.Protocol
destroy, downThreadEnabled, dumpStats, enableStats, getDownProtocol, getDownQueue, getProperties, getUpProtocol, getUpQueue, handleSpecialDownEvent, init, isTrace, isWarn, passDown, passUp, printStats, providedDownServices, providedUpServices, receiveDownEvent, receiveUpEvent, requiredDownServices, requiredUpServices, setDownProtocol, setObserver, setPropertiesInternal, setProtocolStack, setTrace, setUpProtocol, setWarn, startDownHandler, startUpHandler, statsEnabled, stopInternal, upThreadEnabled
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

local_addr

org.jgroups.Address local_addr

mbrs

final java.util.Vector mbrs

my_view

org.jgroups.View my_view

my_vid

org.jgroups.ViewId my_vid

avg_send_interval

long avg_send_interval
Sends a VIEW_SYNC message to the group every 20 seconds on average. 0 disables sending of VIEW_SYNC messages


num_views_sent

private int num_views_sent

num_views_adjusted

private int num_views_adjusted

view_send_task

VIEW_SYNC.ViewSendTask view_send_task

view_send_task_mutex

final java.lang.Object view_send_task_mutex

timer

org.jgroups.util.TimeScheduler timer

name

static final java.lang.String name
See Also:
Constant Field Values
Constructor Detail

VIEW_SYNC

public VIEW_SYNC()
Method Detail

getName

public java.lang.String getName()

getAverageSendInterval

public long getAverageSendInterval()

setAverageSendInterval

public void setAverageSendInterval(long gossip_interval)

getNumViewsSent

public int getNumViewsSent()

getNumViewsAdjusted

public int getNumViewsAdjusted()

resetStats

public void resetStats()

setProperties

public boolean setProperties(java.util.Properties props)
Description copied from class: org.jgroups.stack.Protocol
Configures the protocol initially. A configuration string consists of name=value items, separated by a ';' (semicolon), e.g.:
 "loopback=false;unicast_inport=4444"
 


start

public void start()
           throws java.lang.Exception
Description copied from class: org.jgroups.stack.Protocol
This method is called on a Channel.connect(String)>Channel.connect(String) 55 . Starts work. Protocols are connected and queues are ready to receive events. Will be called from bottom to top. This call will replace the START and START_OK events.


stop

public void stop()
Description copied from class: org.jgroups.stack.Protocol
This method is called on a Channel.disconnect()>Channel.disconnect() 55 . Stops work (e.g. by closing multicast socket). Will be called from top to bottom. This means that at the time of the method invocation the neighbor protocol below is still working. This method will replace the STOP, STOP_OK, CLEANUP and CLEANUP_OK events. The ProtocolStack guarantees that when this method is called all messages in the down queue will have been flushed


sendViewRequest

public void sendViewRequest()
Sends a VIEW_SYNC_REQ to all members, every member replies with a VIEW multicast


up

public void up(org.jgroups.Event evt)
Description copied from class: org.jgroups.stack.Protocol
An event was received from the layer below. Usually the current layer will want to examine the event type and - depending on its type - perform some computation (e.g. removing headers from a MSG event type, or updating the internal membership list when receiving a VIEW_CHANGE event). Finally the event is either a) discarded, or b) an event is sent down the stack using passDown() or c) the event (or another event) is sent up the stack using passUp().


down

public void down(org.jgroups.Event evt)
Description copied from class: org.jgroups.stack.Protocol
An event is to be sent down the stack. The layer may want to examine its type and perform some action on it, depending on the event's type. If the event is a message MSG, then the layer may need to add a header to it (or do nothing at all) before sending it down the stack using passDown(). In case of a GET_ADDRESS event (which tries to retrieve the stack's address from one of the bottom layers), the layer may need to send a new response event back up the stack using passUp().


handleView

private void handleView(org.jgroups.View v,
                        org.jgroups.Address sender)

handleViewChange

private void handleViewChange(org.jgroups.View view)

sendView

private void sendView()

startViewSender

void startViewSender()

stopViewSender

void stopViewSender()