com.exonum.binding.service.adapters

Class UserServiceAdapter

java.lang.Object

com.exonum.binding.service.adapters.UserServiceAdapter

public class UserServiceAdapter
extends java.lang.Object

An adapter of a user-facing interface Service to an interface with a native code.

Constructor Summary

Constructors

Constructor and Description
UserServiceAdapter(Service service, Server server, ViewFactory viewFactory)

Method Summary

Modifier and Type	Method and Description
void	close() Close this service adapter.
UserTransactionAdapter	convertTransaction(byte[] transactionMessage) Converts a transaction messages into an executable transaction of this service.
short	getId()
java.lang.String	getName()
byte[][]	getStateHashes(long snapshotHandle) Returns the state hashes of the service.
java.lang.String	initialize(long forkHandle) Returns the service initial global configuration.
void	mountPublicApiHandler(long nodeNativeHandle)

Methods inherited from class java.lang.Object

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

Constructor Detail

UserServiceAdapter

@Inject
public UserServiceAdapter(Service service,
                                  Server server,
                                  ViewFactory viewFactory)

Method Detail

getId

public short getId()

getName

public java.lang.String getName()

convertTransaction

public UserTransactionAdapter convertTransaction(byte[] transactionMessage)

Converts a transaction messages into an executable transaction of this service.

The callee must handle the declared exceptions.

Parameters:

transactionMessage - a transaction message to be converted

Returns:

an executable transaction of this service

Throws:

java.lang.NullPointerException - if transactionMessage is null, or a user service returns a null transaction

java.lang.IllegalArgumentException - if message is not a valid transaction message of this service

getStateHashes

public byte[][] getStateHashes(long snapshotHandle)

Returns the state hashes of the service.

The method does not destroy a native snapshot object corresponding to the passed handle.

Parameters:

snapshotHandle - a handle to a native snapshot object

Returns:

an array of state hashes

See Also:

Service.getStateHashes(Snapshot)

initialize

@Nullable
public java.lang.String initialize(long forkHandle)

Returns the service initial global configuration.

The method does not destroy a native fork object corresponding to the passed handle.

Parameters:

forkHandle - a handle to a native fork object

Returns:

the service global configuration as a JSON string or null if it does not have any

See Also:

Service.initialize(Fork)

mountPublicApiHandler

public void mountPublicApiHandler(long nodeNativeHandle)

close

public void close()

Close this service adapter.

Releases any resources.