Module org.refcodes.p2p

Package org.refcodes.p2p

Interface P2PTail<LOCATOR>

Type Parameters:

LOCATOR - Defines the type of the locators identifying a peer.

All Superinterfaces:

HopsAccessor<LOCATOR>, org.refcodes.mixin.SourceAccessor<LOCATOR>

All Known Implementing Classes:

AbstractP2PTail

public interface P2PTail<LOCATOR>
extends org.refcodes.mixin.SourceAccessor<LOCATOR>, HopsAccessor<LOCATOR>

The P2PTail describes the dynamic attributes required during dispatch of a P2PMessage (a tail is modified during dispatch by having the visited hops appended).

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.p2p.HopsAccessor

HopsAccessor.HopsBuilder<LOCATOR,B extends HopsAccessor.HopsBuilder<LOCATOR,B>>, HopsAccessor.HopsMutator<LOCATOR>, HopsAccessor.HopsProperty<LOCATOR>

Nested classes/interfaces inherited from interface org.refcodes.mixin.SourceAccessor

org.refcodes.mixin.SourceAccessor.SourceMutator<SRC extends Object>, org.refcodes.mixin.SourceAccessor.SourceProperty<SRC extends Object>

Method Summary

Modifier and Type	Method	Description
void	appendHop(LOCATOR aLocator)	Adds a stop-over peer, being the peer which received the message for dispatching to the next peer.
default boolean	containsHop(LOCATOR aLocator)	Tests whether the providing P2PMessage has already stopped over the given Peer.
LOCATOR[]	getHops()	Retrieves the trail of peers already passed.

Methods inherited from interface org.refcodes.mixin.SourceAccessor

getSource

Method Details

getHops

LOCATOR[] getHops()

Retrieves the trail of peers already passed.

Specified by:

getHops in interface HopsAccessor<LOCATOR>

Returns:

The trail of peers already passed (in order to avoid turning circles when determining the hop count).

appendHop

void appendHop(LOCATOR aLocator)

Adds a stop-over peer, being the peer which received the message for dispatching to the next peer. The stop-over will be prepended to the trail of peers.

Parameters:

aLocator - the stop-over peer while dispatching the message.

containsHop

default boolean containsHop(LOCATOR aLocator)

Tests whether the providing P2PMessage has already stopped over the given Peer.

Parameters:

aLocator - The locator of the Peer in question.

Returns:

True in case the according P2PMessage has already stopped over the Peer in question.