You are here

interface ExecutionContextInterface in Plug 7

Same name in this branch
  1. 7 lib/Symfony/validator/Symfony/Component/Validator/ExecutionContextInterface.php \Symfony\Component\Validator\ExecutionContextInterface
  2. 7 lib/Symfony/validator/Symfony/Component/Validator/Context/ExecutionContextInterface.php \Symfony\Component\Validator\Context\ExecutionContextInterface

The context of a validation run.

The context collects all violations generated during the validation. By default, validators execute all validations in a new context:

$violations = $validator->validate($object);

When you make another call to the validator, while the validation is in progress, the violations will be isolated from each other:

public function validate($value, Constraint $constraint) { $validator = $this->context->getValidator();

// The violations are not added to $this->context $violations = $validator->validate($value); }

However, if you want to add the violations to the current context, use the {@link ValidatorInterface::inContext()} method:

public function validate($value, Constraint $constraint) { $validator = $this->context->getValidator();

// The violations are added to $this->context $validator ->inContext($this->context) ->validate($value) ; }

Additionally, the context provides information about the current state of the validator, such as the currently validated class, the name of the currently validated property and more. These values change over time, so you cannot store a context and expect that the methods still return the same results later on.

@since 2.5 @author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

Expanded class hierarchy of ExecutionContextInterface

All classes that implement ExecutionContextInterface

9 files declare their use of ExecutionContextInterface
Abstract2Dot5ApiTest.php in lib/Symfony/validator/Symfony/Component/Validator/Tests/Validator/Abstract2Dot5ApiTest.php
AbstractConstraintValidatorTest.php in lib/Symfony/validator/Symfony/Component/Validator/Tests/Constraints/AbstractConstraintValidatorTest.php
AllValidator.php in lib/Symfony/validator/Symfony/Component/Validator/Constraints/AllValidator.php
CollectionValidator.php in lib/Symfony/validator/Symfony/Component/Validator/Constraints/CollectionValidator.php
ConstraintValidator.php in lib/Symfony/validator/Symfony/Component/Validator/ConstraintValidator.php

... See full list

File

lib/Symfony/validator/Symfony/Component/Validator/Context/ExecutionContextInterface.php, line 62

Namespace

Symfony\Component\Validator\Context
View source
interface ExecutionContextInterface extends LegacyExecutionContextInterface {

  /**
   * Returns a builder for adding a violation with extended information.
   *
   * Call {@link ConstraintViolationBuilderInterface::addViolation()} to
   * add the violation when you're done with the configuration:
   *
   *     $context->buildViolation('Please enter a number between %min% and %max%.')
   *         ->setParameter('%min%', 3)
   *         ->setParameter('%max%', 10)
   *         ->setTranslationDomain('number_validation')
   *         ->addViolation();
   *
   * @param string $message    The error message
   * @param array  $parameters The parameters substituted in the error message
   *
   * @return ConstraintViolationBuilderInterface The violation builder
   */
  public function buildViolation($message, array $parameters = array());

  /**
   * Returns the validator.
   *
   * Useful if you want to validate additional constraints:
   *
   *     public function validate($value, Constraint $constraint)
   *     {
   *         $validator = $this->context->getValidator();
   *
   *         $violations = $validator->validateValue($value, new Length(array('min' => 3)));
   *
   *         if (count($violations) > 0) {
   *             // ...
   *         }
   *     }
   *
   * @return ValidatorInterface
   */
  public function getValidator();

  /**
   * Returns the currently validated object.
   *
   * If the validator is currently validating a class constraint, the
   * object of that class is returned. If it is a validating a property or
   * getter constraint, the object that the property/getter belongs to is
   * returned.
   *
   * In other cases, null is returned.
   *
   * @return object|null The currently validated object or null.
   */
  public function getObject();

  /**
   * Sets the currently validated value.
   *
   * @param mixed                  $value        The validated value
   * @param object|null            $object       The currently validated object
   * @param MetadataInterface|null $metadata     The validation metadata
   * @param string                 $propertyPath The property path to the current value
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function setNode($value, $object, MetadataInterface $metadata = null, $propertyPath);

  /**
   * Sets the currently validated group.
   *
   * @param string|null $group The validated group
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function setGroup($group);

  /**
   * Sets the currently validated constraint.
   *
   * @param Constraint $constraint The validated constraint
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function setConstraint(Constraint $constraint);

  /**
   * Marks an object as validated in a specific validation group.
   *
   * @param string $cacheKey  The hash of the object
   * @param string $groupHash The group's name or hash, if it is group
   *                          sequence
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function markGroupAsValidated($cacheKey, $groupHash);

  /**
   * Returns whether an object was validated in a specific validation group.
   *
   * @param string $cacheKey  The hash of the object
   * @param string $groupHash The group's name or hash, if it is group
   *                          sequence
   *
   * @return bool Whether the object was already validated for that
   *              group
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function isGroupValidated($cacheKey, $groupHash);

  /**
   * Marks a constraint as validated for an object.
   *
   * @param string $cacheKey       The hash of the object
   * @param string $constraintHash The hash of the constraint
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function markConstraintAsValidated($cacheKey, $constraintHash);

  /**
   * Returns whether a constraint was validated for an object.
   *
   * @param string $cacheKey       The hash of the object
   * @param string $constraintHash The hash of the constraint
   *
   * @return bool Whether the constraint was already validated
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   */
  public function isConstraintValidated($cacheKey, $constraintHash);

  /**
   * Marks that an object was initialized.
   *
   * @param string $cacheKey The hash of the object
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   *
   * @see ObjectInitializerInterface
   */
  public function markObjectAsInitialized($cacheKey);

  /**
   * Returns whether an object was initialized.
   *
   * @param string $cacheKey The hash of the object
   *
   * @return bool Whether the object was already initialized
   *
   * @internal Used by the validator engine. Should not be called by user
   *           code.
   *
   * @see ObjectInitializerInterface
   */
  public function isObjectInitialized($cacheKey);

}

Members

Namesort descending Modifiers Type Description Overrides
ExecutionContextInterface::addViolation public function Adds a violation at the current node of the validation graph. 2
ExecutionContextInterface::addViolationAt Deprecated public function Adds a violation at the validation graph node with the given property path relative to the current property path. 2
ExecutionContextInterface::buildViolation public function Returns a builder for adding a violation with extended information. 1
ExecutionContextInterface::getClassName public function Returns the class name of the current node. 2
ExecutionContextInterface::getGroup public function Returns the validation group that is currently being validated. 2
ExecutionContextInterface::getMetadata public function Returns the metadata for the currently validated value. 2
ExecutionContextInterface::getMetadataFactory Deprecated public function Returns the used metadata factory. 2
ExecutionContextInterface::getObject public function Returns the currently validated object. 1
ExecutionContextInterface::getPropertyName public function Returns the property name of the current node. 2
ExecutionContextInterface::getPropertyPath public function Returns the property path to the value that the validator is currently validating. 2
ExecutionContextInterface::getRoot public function Returns the value at which validation was started in the object graph. 2
ExecutionContextInterface::getValidator public function Returns the validator. 1
ExecutionContextInterface::getValue public function Returns the value that the validator is currently validating. 2
ExecutionContextInterface::getViolations public function Returns the violations generated by the validator so far. 2
ExecutionContextInterface::isConstraintValidated public function Returns whether a constraint was validated for an object. 1
ExecutionContextInterface::isGroupValidated public function Returns whether an object was validated in a specific validation group. 1
ExecutionContextInterface::isObjectInitialized public function Returns whether an object was initialized. 1
ExecutionContextInterface::markConstraintAsValidated public function Marks a constraint as validated for an object. 1
ExecutionContextInterface::markGroupAsValidated public function Marks an object as validated in a specific validation group. 1
ExecutionContextInterface::markObjectAsInitialized public function Marks that an object was initialized. 1
ExecutionContextInterface::setConstraint public function Sets the currently validated constraint. 1
ExecutionContextInterface::setGroup public function Sets the currently validated group. 1
ExecutionContextInterface::setNode public function Sets the currently validated value. 1
ExecutionContextInterface::validate Deprecated public function Validates the given value within the scope of the current validation. 2
ExecutionContextInterface::validateValue Deprecated public function Validates a value against a constraint. 2