Package convex.peer

Class TransactionHandler

java.lang.Object

convex.peer.AThreadedComponent

convex.peer.TransactionHandler

public class TransactionHandler
extends AThreadedComponent

Server component for handling client transactions and producing Blocks Main loop for this component handles client transaction messages, validates them and prepares them for inclusion in a Block

Field Summary

Fields

Modifier and Type	Field	Description
long	clientTransactionCount
protected long	lastBlockPublishedTime	Time at which last Block was published by this Peer
long	receivedTransactionCount
protected final ArrayBlockingQueue<Message>	txMessageQueue	Queue for incoming (unverified) transaction messages

Fields inherited from class convex.peer.AThreadedComponent

server, thread

Constructor Summary

Constructors

Constructor	Description
TransactionHandler(Server server)

Method Summary

Modifier and Type	Method	Description
void	close()	Close this threaded component, including interrupting any running thread(s).
int	countInterests()
protected String	getThreadName()
boolean	isAwaitingResults()
protected void	loop()	Loops for handling incoming client transactions
protected SignedData<Block>	maybeGenerateBlock(Peer peer)	Checks for pending transactions, and if found propose them as a new Block.
SignedData<Block>	maybeGetBlock()	Gets the next Block for publication, or null if not yet ready
void	maybeReportTransactions(Peer peer)
boolean	offerTransaction(Message m)	Offer a transaction for handling
protected void	processMessage(Message m)
void	setRequestObserver(Consumer<SignedData<ATransaction>> observer)	Sets a request observer, which will be called whenever the Peer processes a valid client transaction request
void	setResponseObserver(BiConsumer<SignedData<ATransaction>,Result> observer)	Sets a request observer, which will be called whenever the Peer processes a valid client transaction request
void	start()	Start the threaded component

Methods inherited from class convex.peer.AThreadedComponent

finalize, getLoad

Methods inherited from class java.lang.Object

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

Field Details

txMessageQueue

protected final ArrayBlockingQueue<Message> txMessageQueue

Queue for incoming (unverified) transaction messages

clientTransactionCount

public long clientTransactionCount

receivedTransactionCount

public long receivedTransactionCount

lastBlockPublishedTime

protected long lastBlockPublishedTime

Time at which last Block was published by this Peer

Constructor Details

TransactionHandler

public TransactionHandler(Server server)

Method Details

offerTransaction

public boolean offerTransaction(Message m)

Offer a transaction for handling

Parameters:

m - Message offered

Returns:

True if queued for handling, false otherwise

processMessage

protected void processMessage(Message m)

setRequestObserver

public void setRequestObserver(Consumer<SignedData<ATransaction>> observer)

Sets a request observer, which will be called whenever the Peer processes a valid client transaction request

Parameters:

observer - Consumer to receive observed transaction

maybeReportTransactions

public void maybeReportTransactions(Peer peer)

setResponseObserver

public void setResponseObserver(BiConsumer<SignedData<ATransaction>,Result> observer)

Sets a request observer, which will be called whenever the Peer processes a valid client transaction request

Parameters:

observer - Consumer to receive observed transaction

maybeGenerateBlock

protected SignedData<Block> maybeGenerateBlock(Peer peer)

Checks for pending transactions, and if found propose them as a new Block.

Returns:

New signed Block, or null if nothing to publish yet

maybeGetBlock

public SignedData<Block> maybeGetBlock()

Gets the next Block for publication, or null if not yet ready

Returns:

New Block, or null if not yet produced

close

public void close()

Description copied from class: AThreadedComponent

Close this threaded component, including interrupting any running thread(s). Subclasses may override, but should call `super.close()` to close the main thread

Overrides:

close in class AThreadedComponent

start

public void start()

Description copied from class: AThreadedComponent

Start the threaded component

Overrides:

start in class AThreadedComponent

isAwaitingResults

public boolean isAwaitingResults()

countInterests

public int countInterests()

loop

protected void loop()
             throws InterruptedException

Loops for handling incoming client transactions

Specified by:

loop in class AThreadedComponent

Throws:

InterruptedException

getThreadName

protected String getThreadName()

Specified by:

getThreadName in class AThreadedComponent