Package convex.peer

Class BeliefPropagator

java.lang.Object

convex.peer.AThreadedComponent

convex.peer.BeliefPropagator

public class BeliefPropagator
extends AThreadedComponent

Component class to handle propagation of new Beliefs from a Peer Overall logic: 1. We want to propagate a new Belief delta as fast as possible once one is received 2. We want to pause to ensure that as many peers as possible have received the delta

Field Summary

Fields

Modifier and Type	Field	Description
static final int	BELIEF_BROADCAST_DELAY	Minimum delay between successive Belief broadcasts
static final int	BELIEF_BROADCAST_POLL_TIME	Polling period for Belief propagator loop
static final int	BELIEF_FULL_BROADCAST_DELAY	Time between full Belief broadcasts
static final int	BELIEF_REBROADCAST_DELAY

Fields inherited from class convex.peer.AThreadedComponent

server, thread

Constructor Summary

Constructors

Constructor	Description
BeliefPropagator(Server server)

Method Summary

Modifier and Type	Method	Description
long	getBeliefBroadcastCount()
Belief	getLastBroadcastBelief()
protected String	getThreadName()
boolean	isRebroadcastDue()	Check if the propagator wants the latest Belief for rebroadcast
protected void	loop()
protected boolean	maybeMergeBeliefs(Belief... newBeliefs)	Checks for mergeable remote beliefs, and if found merge and update own belief.
protected boolean	maybeUpdateBelief(Belief newBelief)	Handle general Belief update, taking belief registered in newBeliefs
protected boolean	mergeBeliefMessage(HashMap<AccountKey,SignedData<Order>> orders, Message m)
boolean	queueBelief(Message beliefMessage)	Queues a Belief Message for broadcast
void	setBeliefUpdateObserver(Consumer<Belief> observer)	Sets the observer for belief updates
void	setOrderUpdateObserver(Consumer<SignedData<Order>> orderUpdateObserver)	Sets the observer for order updates
void	start()	Start the threaded component

Methods inherited from class convex.peer.AThreadedComponent

close, finalize, getLoad

Methods inherited from class java.lang.Object

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

Field Details

BELIEF_REBROADCAST_DELAY

public static final int BELIEF_REBROADCAST_DELAY

See Also:

• Constant Field Values

BELIEF_FULL_BROADCAST_DELAY

public static final int BELIEF_FULL_BROADCAST_DELAY

Time between full Belief broadcasts

See Also:

• Constant Field Values

BELIEF_BROADCAST_DELAY

public static final int BELIEF_BROADCAST_DELAY

Minimum delay between successive Belief broadcasts

See Also:

• Constant Field Values

BELIEF_BROADCAST_POLL_TIME

public static final int BELIEF_BROADCAST_POLL_TIME

Polling period for Belief propagator loop

See Also:

• Constant Field Values

Constructor Details

BeliefPropagator

public BeliefPropagator(Server server)

Method Details

isRebroadcastDue

public boolean isRebroadcastDue()

Check if the propagator wants the latest Belief for rebroadcast

Returns:

True is rebroadcast is due

getBeliefBroadcastCount

public long getBeliefBroadcastCount()

queueBelief

public boolean queueBelief(Message beliefMessage)

Queues a Belief Message for broadcast

Parameters:

beliefMessage - Belief Message to queue

Returns:

True if Belief is queued successfully

loop

protected void loop()
             throws InterruptedException

Specified by:

loop in class AThreadedComponent

Throws:

InterruptedException

start

public void start()

Description copied from class: AThreadedComponent

Start the threaded component

Overrides:

start in class AThreadedComponent

maybeUpdateBelief

protected boolean maybeUpdateBelief(Belief newBelief)
                             throws InterruptedException

Handle general Belief update, taking belief registered in newBeliefs

Returns:

true if Peer Belief changed, false otherwise

Throws:

InterruptedException

maybeMergeBeliefs

protected boolean maybeMergeBeliefs(Belief... newBeliefs)

Checks for mergeable remote beliefs, and if found merge and update own belief.

Parameters:

newBelief -

Returns:

True if Peer Belief Order was changed, false otherwise.

mergeBeliefMessage

protected boolean mergeBeliefMessage(HashMap<AccountKey,SignedData<Order>> orders,
 Message m)

getLastBroadcastBelief

public Belief getLastBroadcastBelief()

getThreadName

protected String getThreadName()

Specified by:

getThreadName in class AThreadedComponent

setOrderUpdateObserver

public void setOrderUpdateObserver(Consumer<SignedData<Order>> orderUpdateObserver)

Sets the observer for order updates

Parameters:

orderUpdateObserver - New Observer for ORder updates

setBeliefUpdateObserver

public void setBeliefUpdateObserver(Consumer<Belief> observer)

Sets the observer for belief updates

Parameters:

observer - New Observer for Belief updates