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

FXAudioItem

@Serializable(with = ObservableAudioItemSerializer::class)

class FXAudioItem : ObservableAudioItem, Comparable<ObservableAudioItem> , ReactiveEntityBase<Int, ObservableAudioItem>

JavaFX implementation of ObservableAudioItem with lirp-fx scalar properties.

Each mutable metadata field is exposed as a lirp-fx property (fxString, fxObject, fxInteger, fxFloat) that serves as the single source of truth for its JavaFX value. Reactive mutation events are published via mutateAndPublish so lastDateModified is updated and subscribers are notified on every state change, both when properties are set directly and when they are mutated through the lirp-fx JavaFX property.

Side-effect logic (updating artistsInvolvedProperty) is registered as change listeners on titleProperty, artistProperty, and albumProperty via syncArtistsInvolved.

lastDateModifiedProperty is updated automatically by ReactiveEntityBase after each successful mutation.

Properties

album

open override var album: Album

albumProperty

@Transient

open override val albumProperty: ObjectProperty<Album>

artist

open override var artist: Artist

artistProperty

@Transient

open override val artistProperty: ObjectProperty<Artist>

artistsInvolved

open override val artistsInvolved: Set<Artist>

artistsInvolvedProperty

@Transient

open override val artistsInvolvedProperty: ReadOnlySetProperty<Artist>

bitRate

@Serializable

open override val bitRate: Int

bpm

open override var bpm: Float?

bpmProperty

@Transient

open override val bpmProperty: FloatProperty

changes

open val changes: SharedFlow<MutationEvent<Int, ObservableAudioItem>>

comments

open override var comments: String?

commentsProperty

@Transient

open override val commentsProperty: StringProperty

coverImageBytes

open override var coverImageBytes: ByteArray?

coverImageProperty

@Transient

open override val coverImageProperty: ReadOnlyObjectProperty<Optional<Image>>

dateOfCreation

@Serializable

open override val dateOfCreation: LocalDateTime

dateOfCreationProperty

@Transient

open override val dateOfCreationProperty: ReadOnlyObjectProperty<LocalDateTime>

discNumber

open override var discNumber: Short?

discNumberProperty

@Transient

open override val discNumberProperty: IntegerProperty

duration

open override val duration: Duration

encoder

@Serializable

open override val encoder: String?

encoding

@Serializable

open override val encoding: String?

extension

open override val extension: String

fileName

open override val fileName: String

genres

open override var genres: Set<Genre>

genresProperty

@Transient

open override val genresProperty: ObjectProperty<Set<Genre>>

open override val id: Int

isClosed

open val isClosed: Boolean

lastDateModified

@Serializable

open override var lastDateModified: LocalDateTime

lastDateModifiedProperty

@Transient

open override val lastDateModifiedProperty: ReadOnlyObjectProperty<LocalDateTime>

length

open override val length: Long

path

open override val path: Path

playCount

@Serializable

open override val playCount: Short

playCountProperty

@Transient

open override val playCountProperty: ReadOnlyIntegerProperty

title

open override var title: String

titleProperty

@Transient

open override val titleProperty: StringProperty

trackNumber

open override var trackNumber: Short?

trackNumberProperty

@Transient

open override val trackNumberProperty: IntegerProperty

uniqueId

open override val uniqueId: String

Functions

asJsonKeyValue

open fun asJsonKeyValue(): String

asJsonValue

open fun asJsonValue(): String

clone

open override fun clone(): FXAudioItem

open override fun close()

compareTo

open operator override fun compareTo(other: ObservableAudioItem): Int

emitAsync

open fun emitAsync(event: MutationEvent<Int, ObservableAudioItem>)

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

setPlayCount

open override fun setPlayCount(count: Short)

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

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

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

open fun subscribe(vararg eventTypes: MutationEvent.Type, action: Consumer<in MutationEvent<Int, ObservableAudioItem>>): LirpEventSubscription<in ObservableAudioItem, MutationEvent.Type, MutationEvent<Int, ObservableAudioItem>>

toString

open override fun toString(): String

withEventsDisabled

open fun <T> withEventsDisabled(action: () -> T): T

withEventsDisabledForClone

fun <T> withEventsDisabledForClone(action: () -> T): T

writeMetadata

open override fun writeMetadata(): Job