forked from symfony/validator
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ValidationVisitorInterface.php
80 lines (76 loc) · 3.46 KB
/
ValidationVisitorInterface.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <[email protected]>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Component\Validator;
/**
* Validates values against constraints defined in {@link MetadataInterface}
* instances.
*
* This interface is an implementation of the Visitor design pattern. A value
* is validated by first passing it to the {@link validate} method. That method
* will determine the matching {@link MetadataInterface} for validating the
* value. It then calls the {@link MetadataInterface::accept} method of that
* metadata. <tt>accept()</tt> does two things:
*
* <ol>
* <li>It calls {@link visit} to validate the value against the constraints of
* the metadata.</li>
* <li>It calls <tt>accept()</tt> on all nested metadata instances with the
* corresponding values extracted from the current value. For example, if the
* current metadata represents a class and the current value is an object of
* that class, the metadata contains nested instances for each property of that
* class. It forwards the call to these nested metadata with the values of the
* corresponding properties in the original object.</li>
* </ol>
*
* @author Bernhard Schussek <[email protected]>
*/
interface ValidationVisitorInterface
{
/**
* Validates a value.
*
* If the value is an array or a traversable object, you can set the
* parameter <tt>$traverse</tt> to <tt>true</tt> in order to run through
* the collection and validate each element. If these elements can be
* collections again and you want to traverse them recursively, set the
* parameter <tt>$deep</tt> to <tt>true</tt> as well.
*
* If you set <tt>$traversable</tt> to <tt>true</tt>, the visitor will
* nevertheless try to find metadata for the collection and validate its
* constraints. If no such metadata is found, the visitor ignores that and
* only iterates the collection.
*
* If you don't set <tt>$traversable</tt> to <tt>true</tt> and the visitor
* does not find metadata for the given value, it will fail with an
* exception.
*
* @param mixed $value The value to validate.
* @param string $group The validation group to validate.
* @param string $propertyPath The current property path in the validation graph.
* @param Boolean $traverse Whether to traverse the value if it is traversable.
* @param Boolean $deep Whether to traverse nested traversable values recursively.
*
* @throws Exception\NoSuchMetadataException If no metadata can be found for
* the given value.
*/
public function validate($value, $group, $propertyPath, $traverse = false, $deep = false);
/**
* Validates a value against the constraints defined in some metadata.
*
* This method implements the Visitor design pattern. See also
* {@link ValidationVisitorInterface}.
*
* @param MetadataInterface $metadata The metadata holding the constraints.
* @param mixed $value The value to validate.
* @param string $group The validation group to validate.
* @param string $propertyPath The current property path in the validation graph.
*/
public function visit(MetadataInterface $metadata, $value, $group, $propertyPath);
}