music-commons-fx/net.transgressoft.commons.fx.music.audio/ObservableAudioLibrary

ObservableAudioLibrary

interface ObservableAudioLibrary : ReactiveAudioLibrary<ObservableAudioItem, ObservableArtistCatalog>

JavaFX-compatible audio library interface exposing collections as observable properties for UI binding.

Extends ReactiveAudioLibrary with concrete JavaFX-observable type parameters and adds JavaFX properties for direct binding to UI components, enabling reactive table views, list views, and other JavaFX controls without manual synchronization.

Properties

albumCountProperty

abstract val albumCountProperty: ReadOnlyIntegerProperty

Observable count of distinct albums in the library.

albumsProperty

abstract val albumsProperty: ReadOnlySetProperty<Album>

Observable set of all albums across all artists in the library.

artistCatalogPublisher

abstract val artistCatalogPublisher: LirpEventPublisher<CrudEvent.Type, CrudEvent<Artist, ObservableArtistCatalog>>

artistCatalogsProperty

abstract val artistCatalogsProperty: ReadOnlySetProperty<ObservableArtistCatalog>

Observable set of all artist catalogs, each grouping albums and items by artist.

artistsProperty

abstract val artistsProperty: ReadOnlySetProperty<Artist>

Observable set of all distinct artists in the library.

audioItemsProperty

abstract val audioItemsProperty: ReadOnlyListProperty<ObservableAudioItem>

Observable list of all audio items in the library, suitable for direct JavaFX binding.

changes

abstract val changes: SharedFlow<CrudEvent<Int, ObservableAudioItem>>

emptyLibraryProperty

abstract val emptyLibraryProperty: ReadOnlyBooleanProperty

Boolean property that is true when the library contains no audio items.

isClosed

abstract val isClosed: Boolean

isEmpty

abstract val isEmpty: Boolean

playerSubscriber

abstract val playerSubscriber: Flow.Subscriber<AudioItemPlayerEvent>

subscriberCount

abstract val subscriberCount: Int

Functions

activateEvents

abstract fun activateEvents(vararg types: CrudEvent.Type)

add

abstract fun add(entity: ObservableAudioItem): Boolean

clear

abstract fun clear()

abstract override fun close()

contains

abstract fun contains(id: Int): Boolean

abstract fun contains(predicate: Predicate<in ObservableAudioItem>): Boolean

containsAudioItemWithArtist

abstract fun containsAudioItemWithArtist(artistName: String): Boolean

createAudioItem

abstract fun createAudioItem(factory: (id: Int) -> ObservableAudioItem): ObservableAudioItem

createFromFile

abstract fun createFromFile(audioItemPath: Path): ObservableAudioItem

createFromFileBatchAsync

open fun createFromFileBatchAsync(audioItemPaths: Collection<Path>, batchSize: Int): CompletableFuture<List<ObservableAudioItem>>

open fun createFromFileBatchAsync(audioItemPaths: Collection<Path>, executor: Executor, batchSize: Int): CompletableFuture<List<ObservableAudioItem>>

open fun createFromFileBatchAsync(audioItemPaths: Collection<Path>, dispatcher: CoroutineDispatcher, batchSize: Int): CompletableFuture<List<ObservableAudioItem>>

disableEvents

abstract fun disableEvents(vararg types: CrudEvent.Type)

emitAsync

abstract fun emitAsync(event: CrudEvent<Int, ObservableAudioItem>)

findAlbumAudioItems

abstract fun findAlbumAudioItems(artist: Artist, albumName: String): Set<ObservableAudioItem>

findById

abstract fun findById(id: Int): Optional<out ObservableAudioItem>

findByIndex

abstract fun findByIndex(indexName: String, value: Any): Set<ObservableAudioItem>

findByUniqueId

abstract fun findByUniqueId(uniqueId: String): Optional<out ObservableAudioItem>

findFirst

abstract fun findFirst(predicate: Predicate<in ObservableAudioItem>): Optional<out ObservableAudioItem>

findFirstByIndex

abstract fun findFirstByIndex(indexName: String, value: Any): Optional<out ObservableAudioItem>

getArtistCatalog

abstract fun getArtistCatalog(artistName: String): Optional<out ObservableArtistCatalog>

abstract fun getArtistCatalog(artist: Artist): Optional<out ObservableArtistCatalog>

getRandomAudioItemsFromArtist

abstract fun getRandomAudioItemsFromArtist(artist: Artist, size: Short): List<ObservableAudioItem>

iterator

abstract operator fun iterator(): Iterator<ObservableAudioItem>

lazySearch

abstract fun lazySearch(predicate: Predicate<in ObservableAudioItem>): Sequence<ObservableAudioItem>

minus

open operator fun minus(entity: ObservableAudioItem): Boolean

open operator fun minus(entities: Collection<ObservableAudioItem>): Boolean

remove

abstract fun remove(entity: ObservableAudioItem): Boolean

removeAll

abstract fun removeAll(entities: Collection<ObservableAudioItem>): Boolean

abstract fun search(predicate: Predicate<in ObservableAudioItem>): Set<ObservableAudioItem>

abstract fun search(size: Int, predicate: Predicate<in ObservableAudioItem>): Set<ObservableAudioItem>

searchStream

abstract fun searchStream(predicate: Predicate<in ObservableAudioItem>): Stream<ObservableAudioItem>

size

abstract fun size(): Int

abstract fun subscribe(p0: Flow.Subscriber<in CrudEvent<Int, ObservableAudioItem>?>?)

open fun subscribe(action: Consumer<in CrudEvent<Int, ObservableAudioItem>>): LirpEventSubscription<in LirpEntity, CrudEvent.Type, CrudEvent<Int, ObservableAudioItem>>

abstract fun subscribe(action: suspend (CrudEvent<Int, ObservableAudioItem>) -> Unit): LirpEventSubscription<in LirpEntity, CrudEvent.Type, CrudEvent<Int, ObservableAudioItem>>

abstract fun subscribe(vararg eventTypes: CrudEvent.Type, action: suspend (CrudEvent<Int, ObservableAudioItem>) -> Unit): LirpEventSubscription<in LirpEntity, CrudEvent.Type, CrudEvent<Int, ObservableAudioItem>>