kform/tech.ostack.kform.validations/MaxLength

MaxLength

open class MaxLength @JvmOverloads constructor(val maxLength: Int, val code: String = DEFAULT_CODE, val severity: ValidationIssueSeverity = ValidationIssueSeverity.Error) : Validation<CharSequence> (source)

Validation that checks that a string's length is at most a given maxLength.

When the length of the string being validated is greater than maxLength, then an issue is emitted with the provided code (defaults to DEFAULT_CODE). This issue contains a length data property with the length of the string that was validated and a maxLength data property with the value of maxLength.

Example values accepted by schema StringSchema(MaxLength(4)):

"ab"
"abcd"
""

Example values rejected by schema StringSchema(MaxLength(4)):

"abcde"
"abcdefgh"

Constructors

MaxLength

@JvmOverloads

constructor(maxLength: Int, code: String = DEFAULT_CODE, severity: ValidationIssueSeverity = ValidationIssueSeverity.Error)

Types

Companion

object Companion

Properties

code

val code: String

Issue code to use when the string's length is greater than maxLength.

dependencies

open override val dependencies: Map<String, DependencyInfo>

Dependencies of the validation. Mapping of keys to the paths this validation depends on. Keys can be used within a ValidationContext to access the value of the dependencies.

dependsOnDescendants

open val dependsOnDescendants: Boolean

Whether the form manager should reevaluate this validation whenever a descendant of the value being validated changes. This is false by default.

externalContextDependencies

open override val externalContextDependencies: Set<String>

Set of external context dependencies of the validation.

maxLength

val maxLength: Int

Maximum length allowed (must be >= 0).

severity

val severity: ValidationIssueSeverity

Severity of the issue emitted when the string's length is greater than maxLength.

Functions

toString

open override fun toString(): String

validate

open override fun ValidationContext.validate(): Flow<ValidationIssue>

Runs the validation within a ValidationContext containing the value being validated and the value of all declared dependencies. Returns a flow over all found issues.