com.beowulfchain.beowulfj.communication

Class CommunicationHandler

java.lang.Object

com.beowulfchain.beowulfj.communication.CommunicationHandler

public class CommunicationHandler
extends Object

Constructor Summary

Constructors

Constructor and Description
CommunicationHandler() Initialize the Connection Handler.
CommunicationHandler(BeowulfJConfig config) Initialize the Connection Handler.

Method Summary

Modifier and Type	Method and Description
static com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper() Get a preconfigured Jackson Object Mapper instance.
void	initializeNewClient(BeowulfJConfig config) Initialize a new client by selecting one of the configured endpoints.
<T> List<T>	performRequest(JsonRPCRequest requestObject, Class<T> targetClass) Perform a request to the web socket API whose response will automatically get transformed into the given object.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommunicationHandler

public CommunicationHandler()
                     throws BeowulfCommunicationException

Initialize the Connection Handler.

Throws:

BeowulfCommunicationException - If no connection to the Beowulf Node could be established.

CommunicationHandler

public CommunicationHandler(BeowulfJConfig config)
                     throws BeowulfCommunicationException

Initialize the Connection Handler.

Parameters:

config - The config of beowulf blockchain.

Throws:

BeowulfCommunicationException - If no connection to the Beowulf Node could be established.

Method Detail

getObjectMapper

public static com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()

Get a preconfigured Jackson Object Mapper instance.

Returns:

The object mapper.

initializeNewClient

public void initializeNewClient(BeowulfJConfig config)
                         throws BeowulfCommunicationException

Initialize a new client by selecting one of the configured endpoints.

Parameters:

config - The config of beowulf blockchain.

Throws:

BeowulfCommunicationException - If no AbstractClient implementation for the given schema is available.

performRequest

public <T> List<T> performRequest(JsonRPCRequest requestObject,
                                  Class<T> targetClass)
                           throws BeowulfCommunicationException,
                                  BeowulfResponseException

Perform a request to the web socket API whose response will automatically get transformed into the given object.

Type Parameters:

T - The type that should be returned.

Parameters:

requestObject - A request object that contains all needed parameters.

targetClass - The type the response should be transformed to.

Returns:

The server response transformed into a list of given objects.

Throws:

BeowulfTimeoutException - If the server was not able to answer the request in the given time (@see setResponseTimeout())

BeowulfCommunicationException - If there is a connection problem.

BeowulfTransformationException - If the BeowulfJ is unable to transform the JSON response into a Java object.

BeowulfResponseException - If the Server returned an error object.