Class SymbolRegistryService

java.lang.Object

com.bluebell.greenhouse.radicle.services.symbol.SymbolRegistryService

@Service
public class SymbolRegistryService
extends Object

Service-layer abstraction for reading and writing symbol registry data on disk.

Version:

3.0.6

Author:

Stephen Prizio

Constructor Summary

Constructors

Constructor	Description
SymbolRegistryService(com.fasterxml.jackson.databind.ObjectMapper objectMapper, Path symbolRegistryPath)	Creates a service backed by the configured on-disk symbol registry.

Method Summary

Modifier and Type	Method	Description
SymbolRegistryAliasEntry	addAliasToEntry(String ticker, String exchangeMic, SymbolType type, SymbolRegistryAliasEntry alias)	Adds an alias to the existing SymbolRegistryEntry matching the given symbol identity.
SymbolRegistryEntry	createEntry(SymbolRegistryEntry entry)	Creates a new SymbolRegistryEntry in the symbol registry.
SymbolRegistryAliasEntry	deleteAliasFromEntry(String ticker, String exchangeMic, SymbolType type, SymbolRegistryAliasEntry alias)	Deletes an alias from the existing SymbolRegistryEntry matching the given symbol identity.
SymbolRegistryEntry	deleteEntryById(String id)	Deletes the existing SymbolRegistryEntry for the given UUID.
SymbolRegistryEntry	deleteEntryByTicker(String ticker)	Deletes the existing SymbolRegistryEntry for the given ticker.
byte[]	exportSymbolRegistry()	Exports the raw symbol registry JSON file as stored on disk.
List<SymbolRegistryAliasEntry>	getAliasesForEntry(String ticker, String exchangeMic, SymbolType type)	Returns the aliases for the existing SymbolRegistryEntry matching the given symbol identity.
List<SymbolRegistryEntry>	getEntriesForCategory(String category)	Returns a List of SymbolRegistryEntrys for the given category.
SymbolRegistryEntry	getEntryById(String id)	Returns a SymbolRegistryEntry for the given UUID.
SymbolRegistryEntry	getEntryByTicker(String ticker)	Returns a SymbolRegistryEntry for the given ticker.
SymbolRegistryEntry	getEntryByTicker(String ticker, String exchangeMic, SymbolType type)	Returns a SymbolRegistryEntry for the given composite symbol identity.
List<SymbolRegistryAliasEntry>	replaceAliasesForEntry(String ticker, String exchangeMic, SymbolType type, List<SymbolRegistryAliasEntry> aliases)	Replaces the aliases for the existing SymbolRegistryEntry matching the given symbol identity.
List<SymbolRegistryEntry>	replaceEntriesForCategory(String category, List<SymbolRegistryEntry> entries)	Replaces all entries for the given category.
final void	resolveDuplicates(List<SymbolRegistryEntry> entries)	Resolves duplicate registry entries using curated cleanup rules.
List<SymbolRegistryEntry>	searchEntries(SymbolRegistryEntryFilter filter, SymbolRegistryEntrySortField sortField, org.springframework.data.domain.Sort.Direction direction)	Returns a filtered and sorted List of SymbolRegistryEntrys.
SymbolRegistryAliasEntry	updateAliasForEntry(String ticker, String exchangeMic, SymbolType type, SymbolRegistryAliasEntry existingAlias, SymbolRegistryAliasEntry replacementAlias)	Updates an alias on the existing SymbolRegistryEntry matching the given symbol identity.
SymbolRegistryEntry	updateEntry(String ticker, SymbolRegistryEntry entry)	Updates the existing SymbolRegistryEntry for the given ticker.
SymbolRegistryEntry	updateEntryById(String id, SymbolRegistryEntry entry)	Updates the existing SymbolRegistryEntry for the given UUID.

Methods inherited from class Object

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

Constructor Details

SymbolRegistryService

@Autowired
public SymbolRegistryService(com.fasterxml.jackson.databind.ObjectMapper objectMapper,
 @Qualifier("symbolRegistryPath")
 Path symbolRegistryPath)

Creates a service backed by the configured on-disk symbol registry.

Parameters:

objectMapper - shared ObjectMapper

symbolRegistryPath - symbol registry Path

Method Details

getEntriesForCategory

public List<SymbolRegistryEntry> getEntriesForCategory(String category)

Returns a List of SymbolRegistryEntrys for the given category.

Parameters:

category - category

Returns:

List of SymbolRegistryEntrys

getEntryByTicker

public SymbolRegistryEntry getEntryByTicker(String ticker)

Returns a SymbolRegistryEntry for the given ticker.

Parameters:

ticker - ticker

Returns:

SymbolRegistryEntry

getEntryByTicker

public SymbolRegistryEntry getEntryByTicker(String ticker,
 String exchangeMic,
 SymbolType type)

Returns a SymbolRegistryEntry for the given composite symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

Returns:

SymbolRegistryEntry

getEntryById

public SymbolRegistryEntry getEntryById(String id)

Returns a SymbolRegistryEntry for the given UUID.

Parameters:

id - registry UUID

Returns:

SymbolRegistryEntry

createEntry

public SymbolRegistryEntry createEntry(SymbolRegistryEntry entry)

Creates a new SymbolRegistryEntry in the symbol registry.

Parameters:

entry - SymbolRegistryEntry

Returns:

created SymbolRegistryEntry

updateEntry

public SymbolRegistryEntry updateEntry(String ticker,
 SymbolRegistryEntry entry)

Updates the existing SymbolRegistryEntry for the given ticker.

Parameters:

ticker - ticker to update

entry - replacement SymbolRegistryEntry

Returns:

updated SymbolRegistryEntry

updateEntryById

public SymbolRegistryEntry updateEntryById(String id,
 SymbolRegistryEntry entry)

Updates the existing SymbolRegistryEntry for the given UUID.

Parameters:

id - registry UUID to update

entry - replacement SymbolRegistryEntry

Returns:

updated SymbolRegistryEntry

deleteEntryByTicker

public SymbolRegistryEntry deleteEntryByTicker(String ticker)

Deletes the existing SymbolRegistryEntry for the given ticker.

Parameters:

ticker - ticker to delete

Returns:

deleted SymbolRegistryEntry

deleteEntryById

public SymbolRegistryEntry deleteEntryById(String id)

Deletes the existing SymbolRegistryEntry for the given UUID.

Parameters:

id - registry UUID to delete

Returns:

deleted SymbolRegistryEntry

getAliasesForEntry

public List<SymbolRegistryAliasEntry> getAliasesForEntry(String ticker,
 String exchangeMic,
 SymbolType type)

Returns the aliases for the existing SymbolRegistryEntry matching the given symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

Returns:

List of SymbolRegistryAliasEntry

addAliasToEntry

public SymbolRegistryAliasEntry addAliasToEntry(String ticker,
 String exchangeMic,
 SymbolType type,
 SymbolRegistryAliasEntry alias)

Adds an alias to the existing SymbolRegistryEntry matching the given symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

alias - SymbolRegistryAliasEntry

Returns:

added SymbolRegistryAliasEntry

updateAliasForEntry

public SymbolRegistryAliasEntry updateAliasForEntry(String ticker,
 String exchangeMic,
 SymbolType type,
 SymbolRegistryAliasEntry existingAlias,
 SymbolRegistryAliasEntry replacementAlias)

Updates an alias on the existing SymbolRegistryEntry matching the given symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

existingAlias - alias to replace

replacementAlias - replacement alias

Returns:

updated SymbolRegistryAliasEntry

deleteAliasFromEntry

public SymbolRegistryAliasEntry deleteAliasFromEntry(String ticker,
 String exchangeMic,
 SymbolType type,
 SymbolRegistryAliasEntry alias)

Deletes an alias from the existing SymbolRegistryEntry matching the given symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

alias - SymbolRegistryAliasEntry

Returns:

deleted SymbolRegistryAliasEntry

replaceAliasesForEntry

public List<SymbolRegistryAliasEntry> replaceAliasesForEntry(String ticker,
 String exchangeMic,
 SymbolType type,
 List<SymbolRegistryAliasEntry> aliases)

Replaces the aliases for the existing SymbolRegistryEntry matching the given symbol identity.

Parameters:

ticker - ticker

exchangeMic - exchange MIC

type - SymbolType

aliases - replacement aliases

Returns:

normalized List of SymbolRegistryAliasEntry

replaceEntriesForCategory

public List<SymbolRegistryEntry> replaceEntriesForCategory(String category,
 List<SymbolRegistryEntry> entries)

Replaces all entries for the given category.

Parameters:

category - category

entries - replacement List of SymbolRegistryEntry

Returns:

normalized List of SymbolRegistryEntry

searchEntries

public List<SymbolRegistryEntry> searchEntries(SymbolRegistryEntryFilter filter,
 SymbolRegistryEntrySortField sortField,
 org.springframework.data.domain.Sort.Direction direction)

Returns a filtered and sorted List of SymbolRegistryEntrys.

Parameters:

filter - optional SymbolRegistryEntryFilter

sortField - optional SymbolRegistryEntrySortField

direction - optional Sort.Direction

Returns:

List of SymbolRegistryEntry

resolveDuplicates

public final void resolveDuplicates(List<SymbolRegistryEntry> entries)

Resolves duplicate registry entries using curated cleanup rules.

Parameters:

entries - duplicate entries

exportSymbolRegistry

public byte[] exportSymbolRegistry()

Exports the raw symbol registry JSON file as stored on disk.

Returns:

raw symbol registry bytes