class GenericMetadata in Zircon Profile 8
Same name and namespace in other branches
- 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
- class \Symfony\Component\Validator\Mapping\GenericMetadata implements MetadataInterface
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\MappingView 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
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
GenericMetadata:: |
public | property | The strategy for cascading objects. | |
GenericMetadata:: |
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:: |
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:: |
public | property | The strategy for traversing traversable objects. | 1 |
GenericMetadata:: |
public | function |
Exists for compatibility with the deprecated
{@link Symfony\Component\Validator\MetadataInterface}. Overrides MetadataInterface:: |
2 |
GenericMetadata:: |
public | function | Adds a constraint. | 2 |
GenericMetadata:: |
public | function | Adds an list of constraints. | |
GenericMetadata:: |
public | function |
Aware of the global group (* group). Overrides MetadataInterface:: |
|
GenericMetadata:: |
public | function |
Returns the strategy for cascading objects. Overrides MetadataInterface:: |
1 |
GenericMetadata:: |
public | function |
Returns all constraints of this element. Overrides MetadataInterface:: |
|
GenericMetadata:: |
public | function |
Returns the strategy for traversing traversable objects. Overrides MetadataInterface:: |
|
GenericMetadata:: |
public | function | Returns whether this element has any constraints. | |
GenericMetadata:: |
public | function | Clones this object. | |
GenericMetadata:: |
public | function | Returns the names of the properties that should be serialized. | 2 |