form-engine/org.octavius.form.component/FormHandler

FormHandler

class FormHandler(formSchemaBuilder: FormSchemaBuilder, val formDataManager: FormDataManager, val formValidator: FormValidator = FormValidator(), val payload: Map<String, Any?> = emptyMap(), val handlerScope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)) : FormActionTrigger

Klasa obsługująca cykl życia formularza - główny koordynator systemu formularzy.

FormHandler koordynuje pracę wszystkich komponentów formularza:

FormSchema - definicja struktury i kontrolek formularza
FormState - reaktywne zarządzanie stanem wszystkich kontrolek
FormDataManager - ładowanie danych z bazy i przetwarzanie wyników
FormValidator - walidacja pól i reguł biznesowych

Cykl życia:

Inicjalizacja komponentów i ustawienie referencji między nimi
Ładowanie danych (dla edycji) lub ustawienie wartości domyślnych (nowy rekord)
Obsługa akcji użytkownika (walidacja + wykonanie akcji)

Handler nie wie nic o nawigacji ani o tym, co dzieje się po akcji - oddaje tylko true/false z triggerAction. Decyzję "zapis zamyka ekran" podejmuje lambda przycisku w schema builderze.

Parameters

formSchemaBuilder

Builder dostarczający definicję struktury formularza.

formDataManager

Manager odpowiedzialny za operacje na danych.

formValidator

Validator do sprawdzania poprawności danych.

payload

Dodatkowe dane przekazane do formularza (np. ID rodzica).

handlerScope

CoroutineScope do operacji asynchronicznych.

Constructors

FormHandler

constructor(formSchemaBuilder: FormSchemaBuilder, formDataManager: FormDataManager, formValidator: FormValidator = FormValidator(), payload: Map<String, Any?> = emptyMap(), handlerScope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO))