kform/tech.ostack.kform/LocatedValidationFailure

LocatedValidationFailure

@Serializable

@SerialName(value = "failure")

class LocatedValidationFailure : LocatedValidationIssue(source)

Validation error emitted by a manager containing location information when a validation fails to run (throws an exception while being executed). The code of this validation error is ValidationFailure.CODE.

The validation error data contains entries with keys "validation", "exception", and "stackTrace" containing information on the name of the validation that caused the exception as well as information about the exception itself. These data properties are also accessible via properties of the class with the same name.

Properties

code

open override val code: String

Code representing the issue.

data

open override val data: ValidationIssueData

Additional issue data. This additional data can be used, for example, to help write a user-friendly message associated with the issue.

dependencies

open override val dependencies: Set<AbsolutePath>

Paths of values that the validation that produced this issue depends on.

dependsOnDescendants

open override val dependsOnDescendants: Boolean = false

Whether the validation that produced this issue depends on the descendants of the validated value.

exception

val exception: String?

Exception that occurred (name and message).

externalContextDependencies

open override val externalContextDependencies: Set<String>

External contexts that the validation that produced this issue depends on.

path

open override val path: AbsolutePath

Path of the value containing the issue.

severity

val severity: ValidationIssueSeverity

Severity of the located validation issue.

stackTrace

val stackTrace: String

Exception stack trace.

validation

val validation: String

Name of the validation where the exception occurred.

Functions

contains

fun contains(issue: LocatedValidationIssue): Boolean

Whether this located validation issue "contains" issue.

convertTableRowIndicesToIds

suspend fun <T> LocatedValidationIssue.convertTableRowIndicesToIds(formSchema: Schema<T>, formValue: T): LocatedValidationIssue

Utility function which converts the paths of a LocatedValidationIssue where table rows are indexed by their index into paths where said rows are indexed by their id in the corresponding table within the provided form value formValue (with schema formSchema).

equals

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

hashCode

open override fun hashCode(): Int

toString

open override fun toString(): String