Skip to content

module Athena::Validator::ExecutionContextInterface #

Stores contextual data related to the current validation run.

This includes the violations generated so far, the current constraint, value being validated, etc.

Adding Violations#

As mentioned in the AVD::ConstraintValidatorInterface documentation, violations are not returned from the AVD::ConstraintValidatorInterface#validate method. Instead they are added to the AVD::ConstraintValidatorInterface#context instance.

The simplest way to do so is via the #add_violation method, which accepts the violation message, and any parameters that should be used to render the message. Additional overloads exist to make adding a value with a specific message, and code, or message, code, and {{ value }} placeholder value easier.

Building violations#

In some cases you may wish to add additional data to the AVD::Violation::ConstraintViolationInterface before adding it to self. To do this, you can also use the #build_violation method, which returns an AVD::Violation::ConstraintViolationBuilderInterface that can be used to construct a violation, with an easier API.

Direct including types

Athena::Validator::ExecutionContext(Root)

Methods#

abstract #add_violation(message : String, code : String, value : _) : Nil #

Adds a violation with the provided message, and code, value parameter.

The provided value is added to the violations' parameters as "{{ value }}".

View source

abstract #add_violation(message : String, parameters : Hash(String, String) = {} of String => String) : Nil #

Adds a violation with the provided message, and optionally parameters based on the node currently being validated.

View source

abstract #add_violation(message : String, code : String) : Nil #

Adds a violation with the provided message and code

View source

abstract #build_violation(message : String, code : String, value : _) : AVD::Violation::ConstraintViolationBuilderInterface #

Returns an AVD::Violation::ConstraintViolationBuilderInterface with the provided message, and code, and value.

The provided value is added to the violations' parameters as "{{ value }}".

View source

abstract #build_violation(message : String, parameters : Hash(String, String) = {} of String => String) : AVD::Violation::ConstraintViolationBuilderInterface #

Returns an AVD::Violation::ConstraintViolationBuilderInterface with the provided message.

Can be used to add additional information to the AVD::Violation::ConstraintViolationInterface being adding it to self.

View source

abstract #build_violation(message : String, code : String) : AVD::Violation::ConstraintViolationBuilderInterface #

Returns an AVD::Violation::ConstraintViolationBuilderInterface with the provided message, and code.

View source

abstract #class_name #

Returns the class that is currently being validated.

View source

abstract #constraint : AVD::Constraint? #

Returns the AVD::Constraint that is currently being validated, if any.

View source

abstract #group : String? #

Returns the group that is currently being validated, if any.

View source

abstract #metadata : AVD::Metadata::MetadataInterface? #

Returns an AVD::Metadata::MetadataInterface object for the value currently being validated.

This would be an AVD::Metadata::PropertyMetadataInterface if the current value is an object, an AVD::Metadata::GenericMetadata if the current value is a plain value, and an AVD::Metadata::ClassMetadata if the current value value is an entire class.

View source

abstract #object #

Returns the object that is currently being validated.

View source

abstract #property_name : String? #

Returns the property name of the node currently being validated.

View source

abstract #property_path : String #

Returns the path to the property that is currently being validated.

For example, given a Person object that has an Address property; the property path would be empty initially. When the address property is being validated the property_path would be address. When the street property of the related Address object is being validated the property_path would be address.street.

This also works for collections of objects. If the Person object had multiple addresses, the property path when validating the first street of the first address would be addresses[0].street.

View source

abstract #root #

Returns the object initially passed to AVD::Validator::ValidatorInterface#validate.

View source

abstract #validator : AVD::Validator::ValidatorInterface #

Returns a reference to an AVD::Validator::ValidatorInterface that can be used to validate additional constraints as part of another constraint.

View source

abstract #value #

Returns the value that is currently being validated.

View source

abstract #violations : AVD::Violation::ConstraintViolationListInterface #

Returns the AVD::Violation::ConstraintViolationInterface instances generated by the validator thus far.

View source