Interface EconomyRepository

public interface EconomyRepository

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Double>	applyDelta(UUID player, String currencyId, double delta, double defaultBalance)	Atomically applies delta to the player's balance and returns the resulting balance.
CompletableFuture<Double>	getBalance(UUID player, String currencyId, double defaultBalance)
CompletableFuture<List<EconomyTransactionLog>>	history(UUID player, int limit)
CompletableFuture<Void>	logTransaction(EconomyTransactionLog log)
CompletableFuture<Void>	setBalance(UUID player, String currencyId, double amount)
CompletableFuture<List<EconomyService.BalanceEntry>>	top(String currencyId, int offset, int limit)

Method Details

getBalance

CompletableFuture<Double> getBalance(UUID player,
 String currencyId,
 double defaultBalance)

applyDelta

CompletableFuture<Double> applyDelta(UUID player,
 String currencyId,
 double delta,
 double defaultBalance)

Atomically applies delta to the player's balance and returns the resulting balance. Backends must serialize this per-(player, currencyId) pair (row-level lock / CAS loop / single-writer actor - the implementation's choice) so concurrent deposits/withdrawals for the same player can never race.

setBalance

CompletableFuture<Void> setBalance(UUID player,
 String currencyId,
 double amount)

top

CompletableFuture<List<EconomyService.BalanceEntry>> top(String currencyId,
 int offset,
 int limit)

logTransaction

CompletableFuture<Void> logTransaction(EconomyTransactionLog log)

history

CompletableFuture<List<EconomyTransactionLog>> history(UUID player,
 int limit)