Carries the state needed to process a single row of a table import, including the raw row data, the field mappings and destination fields shared across the import, and the current Hibernate session. A new RowContext is created for each row of an uploaded table and passed to the TableUploader and row processors, giving them a consistent way to read mapped field values, store per-row attributes, and suppress validation for individual columns.
Properties
| Property | Returns | Description |
|---|---|---|
| attributes | Map<String,Object> | Free-form attributes a row processor can use to carry state while processing this row. Never null. |
| destFields | List<DestFieldV2> | The destination fields available for this import, describing the columns a source row can be mapped to. |
| fieldMappings | Map<String,List<Integer>> | The field mappings for the import this row belongs to, keyed by destination field name. Delegates to the parent import context. |
| groupMan | GroupManager | The group manager for the current tenant, resolved lazily on first use. |
| importContext | ImportContextV2 | The import-wide context this row belongs to, shared across every row in the same upload. |
| line | int | The one-based line number of this row within the uploaded table, used in error messages and audit output. |
| rootFolder | RootFolder | The root folder for the tenant organisation this row is being imported into. |
| rootOrg | Organisation | The tenant organisation the table is being imported into. |
| row | List | The raw cell values for this row, in source column order, as read from the uploaded table. |
| tableProcessor | StandardTableProcessor | The processor driving this row through the standard table upload pipeline. |
Methods
findFieldValues(String fieldName) · safeRowVal(Integer col) · getRootOrg() · getTableProcessor() · getImportContext() · session() · getDestFields() · getRow() · getFieldMappings() · getLine() · getAttributes() · getGroupMan() · getRootFolder() · suppressValidation(Integer colIndex) · isSuppressedValidation(String fieldName)
findFieldValues(String fieldName)
Returns: List<Object>
Reads the values for every source column mapped to the given destination field name, in mapping order. Returns null if the field has no mapped columns.
| Parameter | Description |
|---|---|
fieldName | the destination field name to look up mapped columns for |
safeRowVal(Integer col)
Returns: Object
Reads the row's value at the given zero-based column index, returning null instead of throwing if the index is null or out of the row's bounds.
| Parameter | Description |
|---|---|
col | the zero-based column index to read |
getRootOrg()
Returns: Organisation
The tenant organisation the table is being imported into.
getTableProcessor()
Returns: StandardTableProcessor
The processor driving this row through the standard table upload pipeline.
getImportContext()
Returns: ImportContextV2
The import-wide context this row belongs to, shared across every row in the same upload.
session()
Returns: Session
The Hibernate session to use for any database access while processing this row.
getDestFields()
Returns: List<DestFieldV2>
The destination fields available for this import, describing the columns a source row can be mapped to.
getRow()
Returns: List
The raw cell values for this row, in source column order, as read from the uploaded table.
getFieldMappings()
Returns: Map<String,List<Integer>>
The field mappings for the import this row belongs to, keyed by destination field name. Delegates to the parent import context.
getLine()
Returns: int
The one-based line number of this row within the uploaded table, used in error messages and audit output.
getAttributes()
Returns: Map<String,Object>
Free-form attributes a row processor can use to carry state while processing this row. Never null.
getGroupMan()
Returns: GroupManager
The group manager for the current tenant, resolved lazily on first use.
getRootFolder()
Returns: RootFolder
The root folder for the tenant organisation this row is being imported into.
suppressValidation(Integer colIndex)
Returns: void
Marks the given source column index as exempt from validation for this row, so a row processor can suppress a validation error it has already handled itself.
| Parameter | Description |
|---|---|
colIndex | the zero-based source column index to suppress validation for |
isSuppressedValidation(String fieldName)
Returns: boolean
Checks whether any of the source columns mapped to the given destination field name have had validation suppressed for this row via suppressValidation.
| Parameter | Description |
|---|---|
fieldName | the destination field name to check |