com.exonum.binding.service

Interface Node

All Known Implementing Classes:

NodeFake, NodeProxy

public interface Node

An Exonum node context. Allows to add transactions to Exonum network and get a snapshot of the database state.

Method Summary

Modifier and Type	Method and Description
byte[]	getPublicKey() Returns the public key of this node.
void	submitTransaction(Transaction transaction) Submits a transaction into Exonum network.
<ResultT> ResultT	withSnapshot(java.util.function.Function<Snapshot,ResultT> snapshotFunction) Performs a given function with a snapshot of the current database state.

Method Detail

submitTransaction

void submitTransaction(Transaction transaction)
                throws InvalidTransactionException,
                       InternalServerError

Submits a transaction into Exonum network. This node does not execute the transaction immediately, but verifies it and, if it is valid, broadcasts it to all the nodes in the network. Then each node adds the transaction to a pool of unconfirmed transactions. The transaction is executed later asynchronously.

Parameters:

transaction - a transaction to send

Throws:

InvalidTransactionException - if the transaction is not valid

InternalServerError - if this node failed to process the transaction

java.lang.NullPointerException - if the transaction is null

withSnapshot

<ResultT> ResultT withSnapshot(java.util.function.Function<Snapshot,ResultT> snapshotFunction)

Performs a given function with a snapshot of the current database state.

Type Parameters:

ResultT - a type the function returns

Parameters:

snapshotFunction - a function to execute

Returns:

the result of applying the given function to the database state

getPublicKey

byte[] getPublicKey()

Returns the public key of this node.

Throws:

java.lang.IllegalStateException - if the node proxy is closed