You are here

class ClassMetadata in Plug 7

Default implementation of {@link ClassMetadataInterface}.

This class supports serialization and cloning.

@author Bernhard Schussek <bschussek@gmail.com> @author Fabien Potencier <fabien@symfony.com>

Hierarchy

Expanded class hierarchy of ClassMetadata

23 files declare their use of ClassMetadata
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
AbstractStaticMethodLoader.php in lib/Symfony/validator/Symfony/Component/Validator/Tests/Mapping/Loader/AbstractStaticMethodLoader.php
AbstractValidatorTest.php in lib/Symfony/validator/Symfony/Component/Validator/Tests/Validator/AbstractValidatorTest.php
AnnotationLoader.php in lib/Symfony/validator/Symfony/Component/Validator/Mapping/Loader/AnnotationLoader.php

... See full list

File

lib/Symfony/validator/Symfony/Component/Validator/Mapping/ClassMetadata.php, line 30

Namespace

Symfony\Component\Validator\Mapping
View source
class ClassMetadata extends ElementMetadata implements ClassMetadataInterface {

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

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

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

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

  /**
   * @var GetterMetadata[]
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link getPropertyMetadata()} instead.
   */
  public $getters = 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 getGroupSequence()} instead.
   */
  public $groupSequence = array();

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

  /**
   * The strategy for traversing traversable objects.
   *
   * By default, only instances of {@link \Traversable} are traversed.
   *
   * @var int
   *
   * @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::IMPLICIT;

  /**
   * @var \ReflectionClass
   */
  private $reflClass;

  /**
   * Constructs a metadata for the given class.
   *
   * @param string $class
   */
  public function __construct($class) {
    $this->name = $class;

    // class name without namespace
    if (false !== ($nsSep = strrpos($class, '\\'))) {
      $this->defaultGroup = substr($class, $nsSep + 1);
    }
    else {
      $this->defaultGroup = $class;
    }
  }

  /**
   * {@inheritdoc}
   *
   * @deprecated Deprecated since version 2.5, to be removed in Symfony 3.0.
   */
  public function accept(ValidationVisitorInterface $visitor, $value, $group, $propertyPath, $propagatedGroup = null) {
    if (null === $propagatedGroup && Constraint::DEFAULT_GROUP === $group && ($this
      ->hasGroupSequence() || $this
      ->isGroupSequenceProvider())) {
      if ($this
        ->hasGroupSequence()) {
        $groups = $this
          ->getGroupSequence();
      }
      else {
        $groups = $value
          ->getGroupSequence();
      }
      foreach ($groups as $group) {
        $this
          ->accept($visitor, $value, $group, $propertyPath, Constraint::DEFAULT_GROUP);
        if (count($visitor
          ->getViolations()) > 0) {
          break;
        }
      }
      return;
    }
    $visitor
      ->visit($this, $value, $group, $propertyPath);
    if (null !== $value) {
      $pathPrefix = empty($propertyPath) ? '' : $propertyPath . '.';
      foreach ($this
        ->getConstrainedProperties() as $property) {
        foreach ($this
          ->getPropertyMetadata($property) as $member) {
          $member
            ->accept($visitor, $member
            ->getPropertyValue($value), $group, $pathPrefix . $property, $propagatedGroup);
        }
      }
    }
  }

  /**
   * {@inheritdoc}
   */
  public function __sleep() {
    $parentProperties = parent::__sleep();

    // Don't store the cascading strategy. Classes never cascade.
    unset($parentProperties[array_search('cascadingStrategy', $parentProperties)]);
    return array_merge($parentProperties, array(
      'getters',
      'groupSequence',
      'groupSequenceProvider',
      'members',
      'name',
      'properties',
      'defaultGroup',
    ));
  }

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

  /**
   * Returns the name of the default group for this class.
   *
   * For each class, the group "Default" is an alias for the group
   * "<ClassName>", where <ClassName> is the non-namespaced name of the
   * class. All constraints implicitly or explicitly assigned to group
   * "Default" belong to both of these groups, unless the class defines
   * a group sequence.
   *
   * If a class defines a group sequence, validating the class in "Default"
   * will validate the group sequence. The constraints assigned to "Default"
   * can still be validated by validating the class in "<ClassName>".
   *
   * @return string The name of the default group
   */
  public function getDefaultGroup() {
    return $this->defaultGroup;
  }

  /**
   * {@inheritdoc}
   */
  public function addConstraint(Constraint $constraint) {
    if (!in_array(Constraint::CLASS_CONSTRAINT, (array) $constraint
      ->getTargets())) {
      throw new ConstraintDefinitionException(sprintf('The constraint "%s" cannot be put on classes.', get_class($constraint)));
    }
    if ($constraint instanceof Valid) {
      throw new ConstraintDefinitionException(sprintf('The constraint "%s" cannot be put on classes.', get_class($constraint)));
    }
    if ($constraint instanceof Traverse) {
      if ($constraint->traverse) {

        // If traverse is true, traversal should be explicitly enabled
        $this->traversalStrategy = TraversalStrategy::TRAVERSE;
      }
      else {

        // If traverse is false, traversal should be explicitly disabled
        $this->traversalStrategy = TraversalStrategy::NONE;
      }

      // The constraint is not added
      return $this;
    }
    $constraint
      ->addImplicitGroupName($this
      ->getDefaultGroup());
    parent::addConstraint($constraint);
    return $this;
  }

  /**
   * Adds a constraint to the given property.
   *
   * @param string     $property   The name of the property
   * @param Constraint $constraint The constraint
   *
   * @return ClassMetadata This object
   */
  public function addPropertyConstraint($property, Constraint $constraint) {
    if (!isset($this->properties[$property])) {
      $this->properties[$property] = new PropertyMetadata($this
        ->getClassName(), $property);
      $this
        ->addPropertyMetadata($this->properties[$property]);
    }
    $constraint
      ->addImplicitGroupName($this
      ->getDefaultGroup());
    $this->properties[$property]
      ->addConstraint($constraint);
    return $this;
  }

  /**
   * @param string       $property
   * @param Constraint[] $constraints
   *
   * @return ClassMetadata
   */
  public function addPropertyConstraints($property, array $constraints) {
    foreach ($constraints as $constraint) {
      $this
        ->addPropertyConstraint($property, $constraint);
    }
    return $this;
  }

  /**
   * Adds a constraint to the getter of the given property.
   *
   * The name of the getter is assumed to be the name of the property with an
   * uppercased first letter and either the prefix "get" or "is".
   *
   * @param string     $property   The name of the property
   * @param Constraint $constraint The constraint
   *
   * @return ClassMetadata This object
   */
  public function addGetterConstraint($property, Constraint $constraint) {
    if (!isset($this->getters[$property])) {
      $this->getters[$property] = new GetterMetadata($this
        ->getClassName(), $property);
      $this
        ->addPropertyMetadata($this->getters[$property]);
    }
    $constraint
      ->addImplicitGroupName($this
      ->getDefaultGroup());
    $this->getters[$property]
      ->addConstraint($constraint);
    return $this;
  }

  /**
   * @param string       $property
   * @param Constraint[] $constraints
   *
   * @return ClassMetadata
   */
  public function addGetterConstraints($property, array $constraints) {
    foreach ($constraints as $constraint) {
      $this
        ->addGetterConstraint($property, $constraint);
    }
    return $this;
  }

  /**
   * Merges the constraints of the given metadata into this object.
   *
   * @param ClassMetadata $source The source metadata
   */
  public function mergeConstraints(ClassMetadata $source) {
    foreach ($source
      ->getConstraints() as $constraint) {
      $this
        ->addConstraint(clone $constraint);
    }
    foreach ($source
      ->getConstrainedProperties() as $property) {
      foreach ($source
        ->getPropertyMetadata($property) as $member) {
        $member = clone $member;
        foreach ($member
          ->getConstraints() as $constraint) {
          $constraint
            ->addImplicitGroupName($this
            ->getDefaultGroup());
        }
        $this
          ->addPropertyMetadata($member);
        if ($member instanceof MemberMetadata && !$member
          ->isPrivate($this->name)) {
          $property = $member
            ->getPropertyName();
          if ($member instanceof PropertyMetadata && !isset($this->properties[$property])) {
            $this->properties[$property] = $member;
          }
          elseif ($member instanceof GetterMetadata && !isset($this->getters[$property])) {
            $this->getters[$property] = $member;
          }
        }
      }
    }
  }

  /**
   * Adds a member metadata.
   *
   * @param MemberMetadata $metadata
   *
   * @deprecated Deprecated since version 2.6, to be removed in 3.0.
   */
  protected function addMemberMetadata(MemberMetadata $metadata) {
    $this
      ->addPropertyMetadata($metadata);
  }

  /**
   * Returns true if metadatas of members is present for the given property.
   *
   * @param string $property The name of the property
   *
   * @return bool
   *
   * @deprecated Deprecated since version 2.6, to be removed in 3.0. Use {@link hasPropertyMetadata} instead.
   */
  public function hasMemberMetadatas($property) {
    return $this
      ->hasPropertyMetadata($property);
  }

  /**
   * Returns all metadatas of members describing the given property.
   *
   * @param string $property The name of the property
   *
   * @return MemberMetadata[] An array of MemberMetadata
   *
   * @deprecated Deprecated since version 2.6, to be removed in 3.0. Use {@link getPropertyMetadata} instead.
   */
  public function getMemberMetadatas($property) {
    return $this
      ->getPropertyMetadata($property);
  }

  /**
   * {@inheritdoc}
   */
  public function hasPropertyMetadata($property) {
    return array_key_exists($property, $this->members);
  }

  /**
   * {@inheritdoc}
   */
  public function getPropertyMetadata($property) {
    if (!isset($this->members[$property])) {
      return array();
    }
    return $this->members[$property];
  }

  /**
   * {@inheritdoc}
   */
  public function getConstrainedProperties() {
    return array_keys($this->members);
  }

  /**
   * Sets the default group sequence for this class.
   *
   * @param array $groupSequence An array of group names
   *
   * @return ClassMetadata
   *
   * @throws GroupDefinitionException
   */
  public function setGroupSequence($groupSequence) {
    if ($this
      ->isGroupSequenceProvider()) {
      throw new GroupDefinitionException('Defining a static group sequence is not allowed with a group sequence provider');
    }
    if (is_array($groupSequence)) {
      $groupSequence = new GroupSequence($groupSequence);
    }
    if (in_array(Constraint::DEFAULT_GROUP, $groupSequence->groups, true)) {
      throw new GroupDefinitionException(sprintf('The group "%s" is not allowed in group sequences', Constraint::DEFAULT_GROUP));
    }
    if (!in_array($this
      ->getDefaultGroup(), $groupSequence->groups, true)) {
      throw new GroupDefinitionException(sprintf('The group "%s" is missing in the group sequence', $this
        ->getDefaultGroup()));
    }
    $this->groupSequence = $groupSequence;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function hasGroupSequence() {
    return count($this->groupSequence) > 0;
  }

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

  /**
   * Returns a ReflectionClass instance for this class.
   *
   * @return \ReflectionClass
   */
  public function getReflectionClass() {
    if (!$this->reflClass) {
      $this->reflClass = new \ReflectionClass($this
        ->getClassName());
    }
    return $this->reflClass;
  }

  /**
   * Sets whether a group sequence provider should be used.
   *
   * @param bool $active
   *
   * @throws GroupDefinitionException
   */
  public function setGroupSequenceProvider($active) {
    if ($this
      ->hasGroupSequence()) {
      throw new GroupDefinitionException('Defining a group sequence provider is not allowed with a static group sequence');
    }
    if (!$this
      ->getReflectionClass()
      ->implementsInterface('Symfony\\Component\\Validator\\GroupSequenceProviderInterface')) {
      throw new GroupDefinitionException(sprintf('Class "%s" must implement GroupSequenceProviderInterface', $this->name));
    }
    $this->groupSequenceProvider = $active;
  }

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

  /**
   * Class nodes are never cascaded.
   *
   * {@inheritdoc}
   */
  public function getCascadingStrategy() {
    return CascadingStrategy::NONE;
  }

  /**
   * Adds a property metadata.
   *
   * @param PropertyMetadataInterface $metadata
   */
  private function addPropertyMetadata(PropertyMetadataInterface $metadata) {
    $property = $metadata
      ->getPropertyName();
    $this->members[$property][] = $metadata;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
ClassMetadata::$defaultGroup public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getDefaultGroup()} instead.
ClassMetadata::$getters public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getPropertyMetadata()} instead.
ClassMetadata::$groupSequence public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getGroupSequence()} instead.
ClassMetadata::$groupSequenceProvider public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link isGroupSequenceProvider()} instead.
ClassMetadata::$members public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getPropertyMetadata()} instead.
ClassMetadata::$name public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getClassName()} instead.
ClassMetadata::$properties public property @internal This property is public in order to reduce the size of the class' serialized representation. Do not access it. Use {@link getPropertyMetadata()} instead.
ClassMetadata::$reflClass private property
ClassMetadata::$traversalStrategy public property The strategy for traversing traversable objects. Overrides GenericMetadata::$traversalStrategy
ClassMetadata::accept Deprecated public function Overrides GenericMetadata::accept
ClassMetadata::addConstraint public function Adds a constraint. Overrides GenericMetadata::addConstraint
ClassMetadata::addGetterConstraint public function Adds a constraint to the getter of the given property.
ClassMetadata::addGetterConstraints public function
ClassMetadata::addMemberMetadata Deprecated protected function Adds a member metadata.
ClassMetadata::addPropertyConstraint public function Adds a constraint to the given property.
ClassMetadata::addPropertyConstraints public function
ClassMetadata::addPropertyMetadata private function Adds a property metadata.
ClassMetadata::getCascadingStrategy public function Class nodes are never cascaded. Overrides GenericMetadata::getCascadingStrategy
ClassMetadata::getClassName public function Returns the name of the backing PHP class. Overrides ClassBasedInterface::getClassName
ClassMetadata::getConstrainedProperties public function Returns the names of all constrained properties. Overrides ClassMetadataInterface::getConstrainedProperties
ClassMetadata::getDefaultGroup public function Returns the name of the default group for this class.
ClassMetadata::getGroupSequence public function Returns the group sequence that overrides the "Default" group for this class. Overrides ClassMetadataInterface::getGroupSequence
ClassMetadata::getMemberMetadatas Deprecated public function Returns all metadatas of members describing the given property.
ClassMetadata::getPropertyMetadata public function Returns all metadata instances for the given named property. Overrides PropertyMetadataContainerInterface::getPropertyMetadata
ClassMetadata::getReflectionClass public function Returns a ReflectionClass instance for this class.
ClassMetadata::hasGroupSequence public function Returns whether the "Default" group is overridden by a group sequence. Overrides ClassMetadataInterface::hasGroupSequence
ClassMetadata::hasMemberMetadatas Deprecated public function Returns true if metadatas of members is present for the given property.
ClassMetadata::hasPropertyMetadata public function Check if there's any metadata attached to the given named property. Overrides PropertyMetadataContainerInterface::hasPropertyMetadata
ClassMetadata::isGroupSequenceProvider public function Returns whether the "Default" group is overridden by a dynamic group sequence obtained by the validated objects. Overrides ClassMetadataInterface::isGroupSequenceProvider
ClassMetadata::mergeConstraints public function Merges the constraints of the given metadata into this object.
ClassMetadata::setGroupSequence public function Sets the default group sequence for this class.
ClassMetadata::setGroupSequenceProvider public function Sets whether a group sequence provider should be used.
ClassMetadata::__construct public function Constructs a metadata for the given class.
ClassMetadata::__sleep public function Returns the names of the properties that should be serialized. Overrides GenericMetadata::__sleep
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::addConstraints public function Adds an list of constraints.
GenericMetadata::findConstraints public function Aware of the global group (* group). Overrides MetadataInterface::findConstraints
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.