report-engine/org.octavius.report.component/ReportHandler

ReportHandler

class ReportHandler(reportStructureBuilder: ReportStructureBuilder, val handlerScope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO))

Główny kontroler systemu raportowania - zarządza stanem i logiką biznesową raportów.

ReportHandler jest centralnym komponentem systemu raportowania, który:

Zarządza reaktywnym stanem raportu (dane, filtrowanie, sortowanie, paginacja)
Obsługuje zdarzenia użytkownika i aktualizuje stan
Koordynuje pobieranie danych z bazy przez DataManager
Zarządza konfiguracją raportów (zapisywanie/ładowanie ustawień)

Architektura oparta na wzorcu Redux:

UI wysyła zdarzenia (ReportEvent) do handlera
Handler redukuje stan na podstawie zdarzenia
Jeśli potrzeba, wysyła żądanie pobrania danych
UI automatycznie się przerysowuje na podstawie nowego stanu

Parameters

reportStructureBuilder

Builder definicji struktury raportu (kolumny, zapytania, akcje).

handlerScope

opcjonalny CoroutineScope

Constructors

ReportHandler

constructor(reportStructureBuilder: ReportStructureBuilder, handlerScope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO))

Properties

_state

private val _state: MutableStateFlow<ReportState>

configManager

private val configManager: ReportConfigurationManager

dataFetchJob

private var dataFetchJob: Job?

dataManager

private val dataManager: ReportDataManager

handlerScope

private val handlerScope: CoroutineScope

reportStructure

val reportStructure: ReportStructure

state

val state: StateFlow<ReportState>

Functions

addSortColumn

fun addSortColumn(columnKey: String): Boolean

applyConfiguration

private fun applyConfiguration(state: ReportState, configuration: ReportConfiguration): ReportState

cancelJobs

fun cancelJobs()

fetchData

private fun fetchData(state: ReportState)

loadDefaultConfiguration

private fun loadDefaultConfiguration()

onEvent

fun onEvent(event: ReportEvent)

Główna metoda obsługi zdarzeń użytkownika.

reduceState

private fun reduceState(currentState: ReportState, event: ReportEvent): ReportState

removeSortColumn

fun removeSortColumn(columnKey: String)

reorderColumns

fun reorderColumns(fromIndex: Int, toIndex: Int)

reorderSortColumns

fun reorderSortColumns(fromIndex: Int, toIndex: Int)

toggleColumnVisibility

fun toggleColumnVisibility(columnKey: String, isVisible: Boolean)

updateSortDirection

fun updateSortDirection(columnKey: String, newDirection: SortDirection)