interface ValidationVisitorInterface

Validates values against constraints defined in {@link MetadataInterface} instances.

This interface is an implementation of the Visitor design pattern. A value is validated by first passing it to the {@link validate} method. That method will determine the matching {@link MetadataInterface} for validating the value. It then calls the {@link MetadataInterface::accept} method of that metadata. <tt>accept()</tt> does two things:

<ol> <li>It calls {@link visit} to validate the value against the constraints of the metadata.</li> <li>It calls <tt>accept()</tt> on all nested metadata instances with the corresponding values extracted from the current value. For example, if the current metadata represents a class and the current value is an object of that class, the metadata contains nested instances for each property of that class. It forwards the call to these nested metadata with the values of the corresponding properties in the original object.</li> </ol>

@author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

Expanded class hierarchy of ValidationVisitorInterface

All classes that implement ValidationVisitorInterface

4 files declare their use of ValidationVisitorInterface
ClassMetadata.php in drupal/core/vendor/symfony/validator/Symfony/Component/Validator/Mapping/ClassMetadata.php
MemberMetadata.php in drupal/core/vendor/symfony/validator/Symfony/Component/Validator/Mapping/MemberMetadata.php
Metadata.php in drupal/core/lib/Drupal/Core/TypedData/Validation/Metadata.php
Contains \Drupal\Core\TypedData\Validation\Metadata.
PropertyContainerMetadata.php in drupal/core/lib/Drupal/Core/TypedData/Validation/PropertyContainerMetadata.php
Contains \Drupal\Core\TypedData\Validation\PropertyContainerMetadata.

File

drupal/core/vendor/symfony/validator/Symfony/Component/Validator/ValidationVisitorInterface.php, line 37

Namespace

Symfony\Component\Validator
View source
interface ValidationVisitorInterface {

  /**
   * Validates a value.
   *
   * If the value is an array or a traversable object, you can set the
   * parameter <tt>$traverse</tt> to <tt>true</tt> in order to run through
   * the collection and validate each element. If these elements can be
   * collections again and you want to traverse them recursively, set the
   * parameter <tt>$deep</tt> to <tt>true</tt> as well.
   *
   * If you set <tt>$traversable</tt> to <tt>true</tt>, the visitor will
   * nevertheless try to find metadata for the collection and validate its
   * constraints. If no such metadata is found, the visitor ignores that and
   * only iterates the collection.
   *
   * If you don't set <tt>$traversable</tt> to <tt>true</tt> and the visitor
   * does not find metadata for the given value, it will fail with an
   * exception.
   *
   * @param mixed   $value        The value to validate.
   * @param string  $group        The validation group to validate.
   * @param string  $propertyPath The current property path in the validation graph.
   * @param Boolean $traverse     Whether to traverse the value if it is traversable.
   * @param Boolean $deep         Whether to traverse nested traversable values recursively.
   *
   * @throws Exception\NoSuchMetadataException If no metadata can be found for
   *                                           the given value.
   */
  public function validate($value, $group, $propertyPath, $traverse = false, $deep = false);

  /**
   * Validates a value against the constraints defined in some metadata.
   *
   * This method implements the Visitor design pattern. See also
   * {@link ValidationVisitorInterface}.
   *
   * @param MetadataInterface $metadata     The metadata holding the constraints.
   * @param mixed             $value        The value to validate.
   * @param string            $group        The validation group to validate.
   * @param string            $propertyPath The current property path in the validation graph.
   */
  public function visit(MetadataInterface $metadata, $value, $group, $propertyPath);

}

Members

Namesort descending Modifiers Type Description Overrides
ValidationVisitorInterface::validate public function Validates a value. 1
ValidationVisitorInterface::visit public function Validates a value against the constraints defined in some metadata. 1