cloud.metaapi.sdk.meta_api

Class MemoryHistoryStorage

java.lang.Object

cloud.metaapi.sdk.clients.meta_api.SynchronizationListener

cloud.metaapi.sdk.meta_api.HistoryStorage

cloud.metaapi.sdk.meta_api.MemoryHistoryStorage

public class MemoryHistoryStorage
extends HistoryStorage

History storage which stores MetaTrader history in RAM

Nested Class Summary

Nested classes/interfaces inherited from class cloud.metaapi.sdk.clients.meta_api.SynchronizationListener

SynchronizationListener.HealthStatus

Field Summary

Fields inherited from class cloud.metaapi.sdk.meta_api.HistoryStorage

dealSynchronizationFinished, orderSynchronizationFinished

Constructor Summary

Constructors

Constructor and Description
MemoryHistoryStorage(String accountId) Constructs the in-memory history store instance with default parameters
MemoryHistoryStorage(String accountId, String application) Constructs the in-memory history store instance

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	clear() Clears the storage and deletes persistent data
List<MetatraderDeal>	getDeals() Returns all deals stored in history storage
List<MetatraderOrder>	getHistoryOrders() Returns all history orders stored in history storage
CompletableFuture<cloud.metaapi.sdk.clients.models.IsoTime>	getLastDealTime(Integer instanceNumber) Returns the time of the last history deal record stored in the history storage
Map<String,Long>	getLastDealTimeByInstanceIndex() Returns times of last deals by instance indices
CompletableFuture<cloud.metaapi.sdk.clients.models.IsoTime>	getLastHistoryOrderTime(Integer instanceNumber) Returns the time of the last history order record stored in the history storage
Map<String,Long>	getLastHistoryOrderTimeByInstanceIndex() Returns times of last history orders by instance indices
CompletableFuture<Void>	initialize() Initializes the storage and loads required data from a persistent storage
CompletableFuture<Void>	loadData() Loads history data from the file manager
CompletableFuture<Void>	loadDataFromDisk() Loads history data from the file manager.
CompletableFuture<Void>	onDealAdded(String instanceIndex, MetatraderDeal deal) Invoked when a new MetaTrader history deal is added
CompletableFuture<Void>	onDealSynchronizationFinished(String instanceIndex, String synchronizationId) Invoked when a synchronization of history deals on a MetaTrader account have finished
CompletableFuture<Void>	onHistoryOrderAdded(String instanceIndex, MetatraderOrder historyOrder) Invoked when a new MetaTrader history order is added
CompletableFuture<Void>	updateDiskStorage() Saves unsaved history items to disk storage.
CompletableFuture<Void>	updateStorage() Saves unsaved history items to storage

Methods inherited from class cloud.metaapi.sdk.meta_api.HistoryStorage

getLastDealTime, getLastHistoryOrderTime, isDealSynchronizationFinished, isOrderSynchronizationFinished, onConnected, onOrderSynchronizationFinished

Methods inherited from class cloud.metaapi.sdk.clients.meta_api.SynchronizationListener

getHostName, getInstanceNumber, onAccountInformationUpdated, onBooksUpdated, onBrokerConnectionStatusChanged, onCandlesUpdated, onDisconnected, onHealthStatus, onOrderCompleted, onOrdersReplaced, onOrderUpdated, onPositionRemoved, onPositionsReplaced, onPositionUpdated, onStreamClosed, onSubscriptionDowngraded, onSymbolPricesUpdated, onSymbolPriceUpdated, onSymbolSpecificationRemoved, onSymbolSpecificationsUpdated, onSymbolSpecificationUpdated, onSynchronizationStarted, onTicksUpdated

Methods inherited from class java.lang.Object

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

Constructor Detail

MemoryHistoryStorage

public MemoryHistoryStorage(String accountId)

Constructs the in-memory history store instance with default parameters

Parameters:

accountId - account id

MemoryHistoryStorage

public MemoryHistoryStorage(String accountId,
                            String application)

Constructs the in-memory history store instance

Parameters:

accountId - account id

application - id, or null. By default is MetaApi

Method Detail

initialize

public CompletableFuture<Void> initialize()

Description copied from class: HistoryStorage

Initializes the storage and loads required data from a persistent storage

Specified by:

initialize in class HistoryStorage

Returns:

completable future completed when the storage initialized

getDeals

public List<MetatraderDeal> getDeals()

Description copied from class: HistoryStorage

Returns all deals stored in history storage

Specified by:

getDeals in class HistoryStorage

Returns:

all deals stored in history storage

getHistoryOrders

public List<MetatraderOrder> getHistoryOrders()

Description copied from class: HistoryStorage

Returns all history orders stored in history storage

Specified by:

getHistoryOrders in class HistoryStorage

Returns:

all history orders stored in history storage

getLastDealTimeByInstanceIndex

public Map<String,Long> getLastDealTimeByInstanceIndex()

Description copied from class: HistoryStorage

Returns times of last deals by instance indices

Specified by:

getLastDealTimeByInstanceIndex in class HistoryStorage

Returns:

map of last deal times by instance indices

getLastHistoryOrderTimeByInstanceIndex

public Map<String,Long> getLastHistoryOrderTimeByInstanceIndex()

Description copied from class: HistoryStorage

Returns times of last history orders by instance indices

Specified by:

getLastHistoryOrderTimeByInstanceIndex in class HistoryStorage

Returns:

map of last history orders times by instance indices

clear

public CompletableFuture<Void> clear()

Description copied from class: HistoryStorage

Clears the storage and deletes persistent data

Specified by:

clear in class HistoryStorage

Returns:

completable future completed when the storage cleared

loadData

public CompletableFuture<Void> loadData()

Description copied from class: HistoryStorage

Loads history data from the file manager

Specified by:

loadData in class HistoryStorage

Returns:

completable future which resolves when the history is loaded

loadDataFromDisk

public CompletableFuture<Void> loadDataFromDisk()

Loads history data from the file manager. This method is an alias of loadData().

Returns:

completable future which resolves when the history is loaded

updateStorage

public CompletableFuture<Void> updateStorage()

Description copied from class: HistoryStorage

Saves unsaved history items to storage

Specified by:

updateStorage in class HistoryStorage

Returns:

completable future which resolves when storage is updated

updateDiskStorage

public CompletableFuture<Void> updateDiskStorage()

Saves unsaved history items to disk storage. This method is an alias of updateStorage().

Returns:

completable future which resolves when disk storage is updated

getLastHistoryOrderTime

public CompletableFuture<cloud.metaapi.sdk.clients.models.IsoTime> getLastHistoryOrderTime(Integer instanceNumber)

Description copied from class: HistoryStorage

Returns the time of the last history order record stored in the history storage

Specified by:

getLastHistoryOrderTime in class HistoryStorage

Parameters:

instanceNumber - index of an account instance connected, or null

Returns:

the time of the last history order record stored in the history storage

getLastDealTime

public CompletableFuture<cloud.metaapi.sdk.clients.models.IsoTime> getLastDealTime(Integer instanceNumber)

Description copied from class: HistoryStorage

Returns the time of the last history deal record stored in the history storage

Specified by:

getLastDealTime in class HistoryStorage

Parameters:

instanceNumber - index of an account instance connected, or null

Returns:

the time of the last history deal record stored in the history storage

onHistoryOrderAdded

public CompletableFuture<Void> onHistoryOrderAdded(String instanceIndex,
                                                   MetatraderOrder historyOrder)

Description copied from class: SynchronizationListener

Invoked when a new MetaTrader history order is added

Specified by:

onHistoryOrderAdded in class HistoryStorage

Parameters:

instanceIndex - index of an account instance connected

historyOrder - new MetaTrader history order

Returns:

completable future which resolves when the asynchronous event is processed

onDealAdded

public CompletableFuture<Void> onDealAdded(String instanceIndex,
                                           MetatraderDeal deal)

Description copied from class: SynchronizationListener

Invoked when a new MetaTrader history deal is added

Specified by:

onDealAdded in class HistoryStorage

Parameters:

instanceIndex - index of an account instance connected

deal - new MetaTrader history deal

Returns:

completable future which resolves when the asynchronous event is processed

onDealSynchronizationFinished

public CompletableFuture<Void> onDealSynchronizationFinished(String instanceIndex,
                                                             String synchronizationId)

Description copied from class: SynchronizationListener

Invoked when a synchronization of history deals on a MetaTrader account have finished

Overrides:

onDealSynchronizationFinished in class HistoryStorage

Parameters:

instanceIndex - index of an account instance connected

synchronizationId - synchronization request id

Returns:

completable future which resolves when the asynchronous event is processed