You are here

class GenericMetadata in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/symfony/validator/Mapping/GenericMetadata.php \Symfony\Component\Validator\Mapping\GenericMetadata

A generic container of {@link Constraint} objects.

This class supports serialization and cloning.

@since 2.5

@author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

Expanded class hierarchy of GenericMetadata

1 file declares its use of GenericMetadata
RecursiveContextualValidator.php in vendor/symfony/validator/Validator/RecursiveContextualValidator.php

File

vendor/symfony/validator/Mapping/GenericMetadata.php, line 30

Namespace

Symfony\Component\Validator\Mapping
View source
class GenericMetadata implements MetadataInterface {

  /**
   * @var Constraint[]
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link getConstraints()} and {@link findConstraints()} instead.
   */
  public $constraints = array();

  /**
   * @var array
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link findConstraints()} instead.
   */
  public $constraintsByGroup = array();

  /**
   * The strategy for cascading objects.
   *
   * By default, objects are not cascaded.
   *
   * @var int
   *
   * @see CascadingStrategy
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link getCascadingStrategy()} instead.
   */
  public $cascadingStrategy = CascadingStrategy::NONE;

  /**
   * The strategy for traversing traversable objects.
   *
   * By default, traversable objects are not traversed.
   *
   * @var int
   *
   * @see TraversalStrategy
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link getTraversalStrategy()} instead.
   */
  public $traversalStrategy = TraversalStrategy::NONE;

  /**
   * Returns the names of the properties that should be serialized.
   *
   * @return string[]
   */
  public function __sleep() {
    return array(
      'constraints',
      'constraintsByGroup',
      'cascadingStrategy',
      'traversalStrategy',
    );
  }

  /**
   * Clones this object.
   */
  public function __clone() {
    $constraints = $this->constraints;
    $this->constraints = array();
    $this->constraintsByGroup = array();
    foreach ($constraints as $constraint) {
      $this
        ->addConstraint(clone $constraint);
    }
  }

  /**
   * Adds a constraint.
   *
   * If the constraint {@link Valid} is added, the cascading strategy will be
   * changed to {@link CascadingStrategy::CASCADE}. Depending on the
   * properties $traverse and $deep of that constraint, the traversal strategy
   * will be set to one of the following:
   *
   *  - {@link TraversalStrategy::IMPLICIT} if $traverse is enabled and $deep
   *    is enabled
   *  - {@link TraversalStrategy::IMPLICIT} | {@link TraversalStrategy::STOP_RECURSION}
   *    if $traverse is enabled, but $deep is disabled
   *  - {@link TraversalStrategy::NONE} if $traverse is disabled
   *
   * @param Constraint $constraint The constraint to add
   *
   * @return GenericMetadata This object
   *
   * @throws ConstraintDefinitionException When trying to add the
   *                                       {@link Traverse} constraint
   */
  public function addConstraint(Constraint $constraint) {
    if ($constraint instanceof Traverse) {
      throw new ConstraintDefinitionException(sprintf('The constraint "%s" can only be put on classes. Please use ' . '"Symfony\\Component\\Validator\\Constraints\\Valid" instead.', get_class($constraint)));
    }
    if ($constraint instanceof Valid) {
      $this->cascadingStrategy = CascadingStrategy::CASCADE;
      if ($constraint->traverse) {

        // Traverse unless the value is not traversable
        $this->traversalStrategy = TraversalStrategy::IMPLICIT;
        if (!$constraint->deep) {
          $this->traversalStrategy |= TraversalStrategy::STOP_RECURSION;
        }
      }
      else {
        $this->traversalStrategy = TraversalStrategy::NONE;
      }
      return $this;
    }
    $this->constraints[] = $constraint;
    foreach ($constraint->groups as $group) {
      $this->constraintsByGroup[$group][] = $constraint;
    }
    return $this;
  }

  /**
   * Adds an list of constraints.
   *
   * @param Constraint[] $constraints The constraints to add
   *
   * @return GenericMetadata This object
   */
  public function addConstraints(array $constraints) {
    foreach ($constraints as $constraint) {
      $this
        ->addConstraint($constraint);
    }
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function getConstraints() {
    return $this->constraints;
  }

  /**
   * Returns whether this element has any constraints.
   *
   * @return bool
   */
  public function hasConstraints() {
    return count($this->constraints) > 0;
  }

  /**
   * {@inheritdoc}
   *
   * Aware of the global group (* group).
   */
  public function findConstraints($group) {
    return isset($this->constraintsByGroup[$group]) ? $this->constraintsByGroup[$group] : array();
  }

  /**
   * {@inheritdoc}
   */
  public function getCascadingStrategy() {
    return $this->cascadingStrategy;
  }

  /**
   * {@inheritdoc}
   */
  public function getTraversalStrategy() {
    return $this->traversalStrategy;
  }

  /**
   * Exists for compatibility with the deprecated
   * {@link Symfony\Component\Validator\MetadataInterface}.
   *
   * Should not be used.
   *
   * Implemented for backward compatibility with Symfony < 2.5.
   *
   * @throws BadMethodCallException
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   */
  public function accept(ValidationVisitorInterface $visitor, $value, $group, $propertyPath) {
    throw new BadMethodCallException('Not supported.');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
GenericMetadata::$cascadingStrategy public property The strategy for cascading objects.
GenericMetadata::$constraints public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getConstraints()} and {@link findConstraints()} instead.
GenericMetadata::$constraintsByGroup public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link findConstraints()} instead.
GenericMetadata::$traversalStrategy public property The strategy for traversing traversable objects. 1
GenericMetadata::accept Deprecated public function Exists for compatibility with the deprecated {@link Symfony\Component\Validator\MetadataInterface}. Overrides MetadataInterface::accept 2
GenericMetadata::addConstraint public function Adds a constraint. 2
GenericMetadata::addConstraints public function Adds an list of constraints.
GenericMetadata::findConstraints public function Aware of the global group (* group). Overrides MetadataInterface::findConstraints
GenericMetadata::getCascadingStrategy public function Returns the strategy for cascading objects. Overrides MetadataInterface::getCascadingStrategy 1
GenericMetadata::getConstraints public function Returns all constraints of this element. Overrides MetadataInterface::getConstraints
GenericMetadata::getTraversalStrategy public function Returns the strategy for traversing traversable objects. Overrides MetadataInterface::getTraversalStrategy
GenericMetadata::hasConstraints public function Returns whether this element has any constraints.
GenericMetadata::__clone public function Clones this object.
GenericMetadata::__sleep public function Returns the names of the properties that should be serialized. 2