com.scalar.dl.ledger.contract

Class ContractManager

java.lang.Object

com.scalar.dl.ledger.contract.ContractManager

@ThreadSafe
public class ContractManager
extends java.lang.Object

A manager to store ContractEntrys in a ContractRegistry, retrieve ContractEntrys, instantiate ContractMachines from their ids, and also validate contracts (i.e. check if the contract is registered with the correct signature).

Constructor Summary

Constructors

Constructor and Description
ContractManager(ContractRegistry registry, ContractLoader loader, ClientKeyValidator clientKeyValidator)
ContractManager(ContractRegistry registry, ContractLoader loader, ClientKeyValidator clientKeyValidator, com.google.common.cache.Cache<ContractEntry.Key,java.lang.Object> recentlyValidated)

Method Summary

Modifier and Type	Method and Description
ContractEntry	get(ContractEntry.Key key) Returns a ContractEntry.
ContractMachine	getInstance(ContractEntry entry) Instantiates a ContractMachine from the specified contract entry.
void	register(ContractEntry entry) Stores a ContractEntry in a ContractRegistry.
java.util.List<ContractEntry>	scan(java.lang.String entityId, int keyVersion) Returns a list of all the ContractEntrys of a specific version registered by a specified entity id.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContractManager

@Inject
public ContractManager(ContractRegistry registry,
                               ContractLoader loader,
                               ClientKeyValidator clientKeyValidator)

ContractManager

public ContractManager(ContractRegistry registry,
                       ContractLoader loader,
                       ClientKeyValidator clientKeyValidator,
                       com.google.common.cache.Cache<ContractEntry.Key,java.lang.Object> recentlyValidated)

Method Detail

register

public void register(ContractEntry entry)

Stores a ContractEntry in a ContractRegistry. It will first check if the ContractEntry is stored in the ContractRegistry, and if so, throw a DatabaseException and fail. Otherwise, it will store it in the ContractRegistry.

Parameters:

entry - a ContractEntry

get

public ContractEntry get(ContractEntry.Key key)

Returns a ContractEntry. It will retrieve it from the ContractRegistry.

Parameters:

key - the key of the ContractEntry to retrieve

Returns:

a ContractEntry

scan

public java.util.List<ContractEntry> scan(java.lang.String entityId,
                                          int keyVersion)

Returns a list of all the ContractEntrys of a specific version registered by a specified entity id.

Parameters:

entityId - an entity ID.

keyVersion - the version of a key (certificate or HMAC secret key)

Returns:

a list of ContractEntrys

getInstance

public ContractMachine getInstance(ContractEntry entry)

Instantiates a ContractMachine from the specified contract entry.

Parameters:

entry - the entry of the ContractMachine to retrieve

Returns:

a ContractMachine