kform/tech.ostack.kform.validations/Matches

Matches

open class Matches @JvmOverloads constructor(val regex: Regex, val code: String = DEFAULT_CODE, val severity: ValidationIssueSeverity = ValidationIssueSeverity.Error) : Validation<String> (source)

Validation that checks that a string matches a given regex, when it is not empty.

When the string is not empty and does not match regex, then an issue is emitted with the provided code (defaults to DEFAULT_CODE). This issue contains a value data property with the value that was validated and a pattern data property with the pattern of the regex that should have been matched.

Inheritors

MatchesEmail

Constructors

Matches

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

constructor(pattern: String, option: RegexOption, code: String = DEFAULT_CODE, severity: ValidationIssueSeverity = ValidationIssueSeverity.Error)

constructor(pattern: String, options: Set<RegexOption>, code: String = DEFAULT_CODE, severity: ValidationIssueSeverity = ValidationIssueSeverity.Error)

@JvmOverloads

constructor(regex: Regex, code: String = DEFAULT_CODE, severity: ValidationIssueSeverity = ValidationIssueSeverity.Error)

Types

Companion

object Companion

Properties

code

val code: String

Issue code to use when the string is not empty and does not match regex.

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.

regex

val regex: Regex

Regular expression that the string must match.

severity

val severity: ValidationIssueSeverity

Severity of the issue emitted when the string is not empty and does not match regex.

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.