currency_service Class Reference

Service for managing currencies. More...

#include <currency_service.hpp>

Collaboration diagram for currency_service:

Public Types
using	context = ores::database::context

Public Member Functions
	currency_service (context ctx)
	Constructs a currency_service with a database context.
std::vector< domain::currency >	list_currencies (std::uint32_t offset, std::uint32_t limit)
	Lists currencies with pagination support.
std::uint32_t	count_currencies ()
	Gets the total count of active currencies.
void	save_currency (const domain::currency &currency)
	Saves a currency (creates or updates).
void	save_currencies (const std::vector< domain::currency > &currencies)
	Saves a batch of currencies atomically (all or nothing).
void	delete_currency (const std::string &iso_code)
	Deletes a currency by its ISO code.
void	delete_currencies (const std::vector< std::string > &iso_codes)
	Deletes currencies by their ISO codes.
std::optional< domain::currency >	get_currency (const std::string &iso_code)
	Retrieves a single currency by its ISO code.
std::vector< domain::currency >	get_currency_history (const std::string &iso_code)
	Retrieves all historical versions of a currency.
std::optional< domain::currency_version_history >	get_currency_version_history (const std::string &iso_code)
	Retrieves currency version history with version metadata.
std::vector< domain::currency >	list_currencies_for_party (const boost::uuids::uuid &party_id, std::uint32_t offset, std::uint32_t limit)
	Lists currencies visible to a specific party, with pagination.
std::uint32_t	count_currencies_for_party (const boost::uuids::uuid &party_id)
	Gets the total count of currencies visible to a specific party.

Detailed Description

Service for managing currencies.

Provides a higher-level interface for currency operations, wrapping the underlying repository.

Constructor & Destructor Documentation

currency_service()

currency_service ( context  ctx )

explicit

Constructs a currency_service with a database context.

Parameters

ctx	The database context for operations.

Member Function Documentation

list_currencies()

std::vector< domain::currency > list_currencies	(	std::uint32_t	offset,
		std::uint32_t	limit
	)

Lists currencies with pagination support.

Parameters

offset	Number of records to skip.
limit	Maximum number of records to return.

Returns

Vector of currencies for the requested page.

count_currencies()

std::uint32_t count_currencies

(

)

Gets the total count of active currencies.

Returns

Total number of active currencies.

save_currency()

void save_currency

(

const domain::currency &

currency

)

Saves a currency (creates or updates).

Parameters

currency

The currency to save.

Exceptions

std::exception

on failure.

save_currencies()

void save_currencies

(

const std::vector< domain::currency > &

currencies

)

Saves a batch of currencies atomically (all or nothing).

Parameters

currencies

The currencies to save.

Exceptions

std::exception

on failure.

delete_currency()

void delete_currency

(

const std::string &

iso_code

)

Deletes a currency by its ISO code.

Parameters

iso_code

The ISO code of the currency to delete.

Exceptions

std::exception

on failure.

get_currency()

std::optional< domain::currency > get_currency

(

const std::string &

iso_code

)

Retrieves a single currency by its ISO code.

Parameters

iso_code

The ISO code of the currency.

Returns

The currency if found, std::nullopt otherwise.

get_currency_history()

std::vector< domain::currency > get_currency_history

(

const std::string &

iso_code

)

Retrieves all historical versions of a currency.

Parameters

iso_code

The ISO code of the currency.

Returns

Vector of all historical versions of the currency.

get_currency_version_history()

std::optional< domain::currency_version_history > get_currency_version_history

(

const std::string &

iso_code

)

Retrieves currency version history with version metadata.

Converts raw currency records to currency_version objects with version numbers, modified_by, and recorded_at metadata. Versions are ordered from newest to oldest.

Parameters

iso_code

The ISO code of the currency.

Returns

The version history, or std::nullopt if currency not found.

list_currencies_for_party()

std::vector< domain::currency > list_currencies_for_party	(	const boost::uuids::uuid &	party_id,
		std::uint32_t	offset,
		std::uint32_t	limit
	)

Lists currencies visible to a specific party, with pagination.

Uses the party_currencies junction to filter the full currency list to only those the given party is permitted to see.

Parameters

party_id	The UUID of the party.
offset	Number of records to skip.
limit	Maximum number of records to return.

Returns

Vector of visible currencies for the requested page.

count_currencies_for_party()

std::uint32_t count_currencies_for_party

(

const boost::uuids::uuid &

party_id

)

Gets the total count of currencies visible to a specific party.

Parameters

party_id

The UUID of the party.

Returns

Number of currencies the party is permitted to see.