one.block.eosiojava.implementations

Class ABIProviderImpl

java.lang.Object

one.block.eosiojava.implementations.ABIProviderImpl

All Implemented Interfaces:

IABIProvider

public class ABIProviderImpl
extends java.lang.Object
implements IABIProvider

Default ABI Provider implementation, providing in memory caching of previously fetched ABI's as well as fetching of ABI's using the provided RPC provider.

Constructor Summary

Constructors

Constructor and Description
ABIProviderImpl(@NotNull IRPCProvider rpcProvider, @NotNull ISerializationProvider serializationProvider) Initialize a new ABI Provider, passing the necessary RPC provider to fetch ABI's if they are not found in the cache.

Method Summary

Modifier and Type	Method and Description
@NotNull java.lang.String	getAbi(@NotNull java.lang.String chainId, @NotNull EOSIOName account) Return an ABI given the chain id and account name desired.
@NotNull java.util.Map<java.lang.String,java.lang.String>	getAbis(@NotNull java.lang.String chainId, @NotNull java.util.List<EOSIOName> accounts) Return a map of ABIs given the chain id and account names desired.

Methods inherited from class java.lang.Object

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

Constructor Detail

ABIProviderImpl

public ABIProviderImpl(@NotNull
                       @NotNull IRPCProvider rpcProvider,
                       @NotNull
                       @NotNull ISerializationProvider serializationProvider)

Initialize a new ABI Provider, passing the necessary RPC provider to fetch ABI's if they are not found in the cache.

Parameters:

rpcProvider - RPC provider implementation to use to fetch ABIs if they are not in the cache.

serializationProvider - Serialization provider implementation to use to deserialize the ABIs for return and storage in the cache.

Method Detail

getAbis

@NotNull
public @NotNull java.util.Map<java.lang.String,java.lang.String> getAbis(@NotNull
                                                                                  @NotNull java.lang.String chainId,
                                                                                  @NotNull
                                                                                  @NotNull java.util.List<EOSIOName> accounts)
                                                                           throws GetAbiError

Return a map of ABIs given the chain id and account names desired. The in-memory cache will be checked first and any missing ABIs will be fetched via the RPC provider and placed in the cache. This call is synchronous. Developers should wrap it in an asynchronous mechanism to avoid blocking if necessary.

Specified by:

getAbis in interface IABIProvider

Parameters:

chainId - the chain id

accounts - the accounts - duplicate names will be removed

Returns:

Map of ABIs keyed by the account

Throws:

GetAbiError - If there is an error retrieving or deserializing any of the ABIs

getAbi

@NotNull
public @NotNull java.lang.String getAbi(@NotNull
                                                 @NotNull java.lang.String chainId,
                                                 @NotNull
                                                 @NotNull EOSIOName account)
                                          throws GetAbiError

Return an ABI given the chain id and account name desired. The in-memory cache will be checked first and if missing the ABI will be fetched via the RPC provider and placed in the cache. This call is synchronous. Developers should wrap it in an asynchronous mechanism to avoid blocking if necessary.

Specified by:

getAbi in interface IABIProvider

Parameters:

chainId - the chain id

account - the account

Returns:

abiJsonString - the deserialized JSON string for the requested ABI

Throws:

GetAbiError - If there is an error retrieving or deserializing the ABI.