DetailDataBindingService

Detail data binding service for extracting and formatting child row data. Handles all three data binding modes and provides unified interface.

Methods

The following table outlines the methods for the DetailDataBindingService:

NameParametersReturnsDescription
cancelAllPendingRequests
-
void

Cancel all pending async requests. Called during component cleanup or application shutdown. Ensures no orphaned promises or API calls continue.

cancelPendingRequest
  • requestKey

    : string
  • boolean

    Cancel pending async data loading request. Called when detail grid is collapsed or destroyed. Prevents callbacks from executing after grid removal.


    Params:
  • requestKey: Request key to cancel
  • executeAsyncCallback
  • params

    : GetDetailRowDataParams<T, CT>
  • requestKey

    : string
  • Promise<void>

    Execute data retrieval callback for async data loading. Wraps callback execution with timeout and error handling. Automatically cancels request if detail grid is destroyed.


    Params:
  • params: Callback parameters with data, childDataSource, mappingID, and callbacks
  • requestKey: Unique key for tracking this async request
  • extractData
    -
    CT[] | null

    Extract child data using flexible data binding. Automatically detects and handles all three binding modes. Priority: Mode 1 (Nested) > Mode 2 (Mapping) > Mode 3 (Async)

    extractMappedData
  • parentData

    : T
  • mappingID

    : string
  • childDataSource

    : CT[]
  • CT[]

    Extract child data using foreign key mapping. Implements Mode 2: Mapping Data binding with mappingID. Filters childDataSource by matching mappingID values.


    Params:
  • parentData: Parent row object containing mappingID value
  • mappingID: Property name used as foreign key
  • childDataSource: Complete child dataset to filter
  • extractNestedData
  • parentData

    : unknown
  • childPropertyPath

    : string
  • CT[]

    Extract child data from nested property in parent row. Implements Mode 1: Nested Data binding. Child data exists as property on parent row object.


    Params:
  • parentData: Parent row object
  • childPropertyPath: Property name or dot-notation path to child data
  • generateRequestKey
    -
    string

    Get unique request key for tracking async operations. Combines parent data identifier with operation type. Ensures unique key per detail grid expansion.

    getStats
    -
    Object

    Get statistics on pending async requests. Useful for debugging and monitoring detail grid performance.

    reset
    -
    void

    Reset service state by clearing all pending requests. Used for testing or complete cleanup.