Module io.hotmoka.nodes

Package io.hotmoka.nodes

Class AbstractNode

java.lang.Object

io.hotmoka.nodes.AbstractNode

All Implemented Interfaces:

Node, AutoCloseable

public abstract class AbstractNode
extends Object
implements Node

A generic implementation of a node. The goal of this class is to provide some shared machinery that can be useful in subclasses.

Nested Class Summary

Nested classes/interfaces inherited from interface io.hotmoka.nodes.Node

Node.CodeSupplier<V extends StorageValue>, Node.JarSupplier, Node.Subscription

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Logger	logger

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractNode()	Builds an abstract node.
protected	AbstractNode(AbstractNode parent)	Builds a shallow clone of the given node.

Method Summary

Modifier and Type	Method	Description
protected final Node.CodeSupplier<StorageReference>	constructorSupplierFor(TransactionReference reference)	Yields a code supplier that polls for the outcome of a transaction that ran a constructor.
protected final Node.JarSupplier	jarSupplierFor(TransactionReference reference)	Yields a jar supplier that polls for the outcome of a transaction that installed a jar in the store of the node.
protected final Node.CodeSupplier<StorageValue>	methodSupplierFor(TransactionReference reference)	Yields a code supplier that polls for the outcome of a transaction that ran a method.
protected final void	notifyEvent(StorageReference creator, StorageReference event)	Notifies the given event to all event handlers for the given creator.
final Node.Subscription	subscribeToEvents(StorageReference creator, BiConsumer<StorageReference,StorageReference> handler)	Subscribes the given handler for events with the given creator.
protected static <T> T	wrapInCaseOfExceptionFull(Callable<T> what)	Runs a callable and wraps any exception into an TransactionRejectedException, if it is not a TransactionException nor a CodeExecutionException.
protected static <T> T	wrapInCaseOfExceptionMedium(Callable<T> what)	Runs a callable and wraps any exception into an TransactionRejectedException, if it is not a TransactionException.
protected static <T> T	wrapInCaseOfExceptionSimple(Callable<T> what)	Runs a callable and wraps any exception into an TransactionRejectedException.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.AutoCloseable

close

Methods inherited from interface io.hotmoka.nodes.Node

addConstructorCallTransaction, addGameteCreationTransaction, addInitializationTransaction, addInstanceMethodCallTransaction, addJarStoreInitialTransaction, addJarStoreTransaction, addStaticMethodCallTransaction, getClassTag, getManifest, getNameOfSignatureAlgorithmForRequests, getNodeInfo, getPolledResponse, getRequest, getResponse, getState, getTakamakaCode, postConstructorCallTransaction, postInstanceMethodCallTransaction, postJarStoreTransaction, postStaticMethodCallTransaction, runInstanceMethodCallTransaction, runStaticMethodCallTransaction

Field Details

logger

protected static final Logger logger

Constructor Details

AbstractNode

protected AbstractNode()

Builds an abstract node.

AbstractNode

protected AbstractNode(AbstractNode parent)

Builds a shallow clone of the given node.

Parameters:

parent - the node to clone

Method Details

subscribeToEvents

public final Node.Subscription subscribeToEvents(StorageReference creator,
 BiConsumer<StorageReference,StorageReference> handler)
                                          throws UnsupportedOperationException

Description copied from interface: Node

Subscribes the given handler for events with the given creator.

Specified by:

subscribeToEvents in interface Node

Parameters:

creator - the creator of the events that will be forwarded to the handler; if this is null, all events will be forwarded to the handler

handler - a handler that gets executed when an event with the given creator occurs; a handler can be subscribed to more creators; for each event, it receives its creator and the event itself

Returns:

the subscription, that can be used later to stop event handling with handler

Throws:

UnsupportedOperationException

notifyEvent

protected final void notifyEvent(StorageReference creator,
 StorageReference event)

Notifies the given event to all event handlers for the given creator.

Parameters:

creator - the creator of the event

event - the event to notify

jarSupplierFor

protected final Node.JarSupplier jarSupplierFor(TransactionReference reference)

Yields a jar supplier that polls for the outcome of a transaction that installed a jar in the store of the node.

Parameters:

reference - the reference of the request of the transaction

Returns:

the jar supplier

constructorSupplierFor

protected final Node.CodeSupplier<StorageReference> constructorSupplierFor(TransactionReference reference)

Yields a code supplier that polls for the outcome of a transaction that ran a constructor.

Parameters:

reference - the reference of the request of the transaction

Returns:

the code supplier

methodSupplierFor

protected final Node.CodeSupplier<StorageValue> methodSupplierFor(TransactionReference reference)

Yields a code supplier that polls for the outcome of a transaction that ran a method.

Parameters:

reference - the reference of the request of the transaction

Returns:

the code supplier

wrapInCaseOfExceptionSimple

protected static <T> T wrapInCaseOfExceptionSimple(Callable<T> what)
                                            throws TransactionRejectedException

Runs a callable and wraps any exception into an TransactionRejectedException.

Type Parameters:

T - the return type of the callable

Parameters:

what - the callable

Returns:

the return value of the callable

Throws:

TransactionRejectedException - the wrapped exception

wrapInCaseOfExceptionMedium

protected static <T> T wrapInCaseOfExceptionMedium(Callable<T> what)
                                            throws TransactionRejectedException,
TransactionException

Runs a callable and wraps any exception into an TransactionRejectedException, if it is not a TransactionException.

Type Parameters:

T - the return type of the callable

Parameters:

what - the callable

Returns:

the return value of the callable

Throws:

TransactionRejectedException - the wrapped exception

TransactionException - if the callable throws this

wrapInCaseOfExceptionFull

protected static <T> T wrapInCaseOfExceptionFull(Callable<T> what)
                                          throws TransactionRejectedException,
TransactionException,
CodeExecutionException

Runs a callable and wraps any exception into an TransactionRejectedException, if it is not a TransactionException nor a CodeExecutionException.

Type Parameters:

T - the return type of the callable

Parameters:

what - the callable

Returns:

the return value of the callable

Throws:

TransactionRejectedException - the wrapped exception

TransactionException - if the callable throws this

CodeExecutionException - if the callable throws this