MemberMetadata.php in Zircon Profile 8

Namespace

Symfony\Component\Validator\Mapping

File

vendor/symfony/validator/Mapping/MemberMetadata.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <[e-mail]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Symfony\Component\Validator\Mapping;

use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\Exception\ConstraintDefinitionException;
use Symfony\Component\Validator\ValidationVisitorInterface;

/**
 * Stores all metadata needed for validating a class property.
 *
 * The method of accessing the property's value must be specified by subclasses
 * by implementing the {@link newReflectionMember()} method.
 *
 * This class supports serialization and cloning.
 *
 * @author Bernhard Schussek <[e-mail]>
 *
 * @see PropertyMetadataInterface
 */
abstract class MemberMetadata extends ElementMetadata implements PropertyMetadataInterface {

  /**
   * @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 $class;

  /**
   * @var string
   *
   * @internal This property is public in order to reduce the size of the
   *           class' serialized representation. Do not access it. Use
   *           {@link getName()} 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 getPropertyName()} instead.
   */
  public $property;

  /**
   * @var \ReflectionMethod[]|\ReflectionProperty[]
   */
  private $reflMember = array();

  /**
   * Constructor.
   *
   * @param string $class    The name of the class this member is defined on
   * @param string $name     The name of the member
   * @param string $property The property the member belongs to
   */
  public function __construct($class, $name, $property) {
    $this->class = $class;
    $this->name = $name;
    $this->property = $property;
  }

  /**
   * {@inheritdoc}
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   */
  public function accept(ValidationVisitorInterface $visitor, $value, $group, $propertyPath, $propagatedGroup = null) {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.5 and will be removed in 3.0.', E_USER_DEPRECATED);
    $visitor
      ->visit($this, $value, $group, $propertyPath);
    if ($this
      ->isCascaded()) {
      $visitor
        ->validate($value, $propagatedGroup ?: $group, $propertyPath, $this
        ->isCollectionCascaded(), $this
        ->isCollectionCascadedDeeply());
    }
  }

  /**
   * {@inheritdoc}
   */
  public function addConstraint(Constraint $constraint) {
    if (!in_array(Constraint::PROPERTY_CONSTRAINT, (array) $constraint
      ->getTargets())) {
      throw new ConstraintDefinitionException(sprintf('The constraint %s cannot be put on properties or getters', get_class($constraint)));
    }
    parent::addConstraint($constraint);
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function __sleep() {
    return array_merge(parent::__sleep(), array(
      'class',
      'name',
      'property',
    ));
  }

  /**
   * Returns the name of the member.
   *
   * @return string
   */
  public function getName() {
    return $this->name;
  }

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

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

  /**
   * Returns whether this member is public.
   *
   * @param object|string $objectOrClassName The object or the class name
   *
   * @return bool
   */
  public function isPublic($objectOrClassName) {
    return $this
      ->getReflectionMember($objectOrClassName)
      ->isPublic();
  }

  /**
   * Returns whether this member is protected.
   *
   * @param object|string $objectOrClassName The object or the class name
   *
   * @return bool
   */
  public function isProtected($objectOrClassName) {
    return $this
      ->getReflectionMember($objectOrClassName)
      ->isProtected();
  }

  /**
   * Returns whether this member is private.
   *
   * @param object|string $objectOrClassName The object or the class name
   *
   * @return bool
   */
  public function isPrivate($objectOrClassName) {
    return $this
      ->getReflectionMember($objectOrClassName)
      ->isPrivate();
  }

  /**
   * Returns whether objects stored in this member should be validated.
   *
   * @return bool
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   *             Use {@link getCascadingStrategy()} instead.
   */
  public function isCascaded() {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.5 and will be removed in 3.0. Use the getCascadingStrategy() method instead.', E_USER_DEPRECATED);
    return (bool) ($this->cascadingStrategy & CascadingStrategy::CASCADE);
  }

  /**
   * Returns whether arrays or traversable objects stored in this member
   * should be traversed and validated in each entry.
   *
   * @return bool
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   *             Use {@link getTraversalStrategy()} instead.
   */
  public function isCollectionCascaded() {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.5 and will be removed in 3.0. Use the getTraversalStrategy() method instead.', E_USER_DEPRECATED);
    return (bool) ($this->traversalStrategy & (TraversalStrategy::IMPLICIT | TraversalStrategy::TRAVERSE));
  }

  /**
   * Returns whether arrays or traversable objects stored in this member
   * should be traversed recursively for inner arrays/traversable objects.
   *
   * @return bool
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   *             Use {@link getTraversalStrategy()} instead.
   */
  public function isCollectionCascadedDeeply() {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.5 and will be removed in 3.0. Use the getTraversalStrategy() method instead.', E_USER_DEPRECATED);
    return !($this->traversalStrategy & TraversalStrategy::STOP_RECURSION);
  }

  /**
   * Returns the reflection instance for accessing the member's value.
   *
   * @param object|string $objectOrClassName The object or the class name
   *
   * @return \ReflectionMethod|\ReflectionProperty The reflection instance
   */
  public function getReflectionMember($objectOrClassName) {
    $className = is_string($objectOrClassName) ? $objectOrClassName : get_class($objectOrClassName);
    if (!isset($this->reflMember[$className])) {
      $this->reflMember[$className] = $this
        ->newReflectionMember($objectOrClassName);
    }
    return $this->reflMember[$className];
  }

  /**
   * Creates a new reflection instance for accessing the member's value.
   *
   * Must be implemented by subclasses.
   *
   * @param object|string $objectOrClassName The object or the class name
   *
   * @return \ReflectionMethod|\ReflectionProperty The reflection instance
   */
  protected abstract function newReflectionMember($objectOrClassName);

}

Classes

Name	Description
MemberMetadata	Stores all metadata needed for validating a class property.