X-Git-Url: http://www.aleph1.co.uk/gitweb/?p=yaffs-website;a=blobdiff_plain;f=vendor%2Fsymfony%2Fvalidator%2FValidationVisitorInterface.php;fp=vendor%2Fsymfony%2Fvalidator%2FValidationVisitorInterface.php;h=b6c6e9f1cb9d32803267c64fe09614ff6c113ebc;hp=0000000000000000000000000000000000000000;hb=a2bd1bf0c2c1f1a17d188f4dc0726a45494cefae;hpb=57c063afa3f66b07c4bbddc2d6129a96d90f0aad
diff --git a/vendor/symfony/validator/ValidationVisitorInterface.php b/vendor/symfony/validator/ValidationVisitorInterface.php
new file mode 100644
index 000000000..b6c6e9f1c
--- /dev/null
+++ b/vendor/symfony/validator/ValidationVisitorInterface.php
@@ -0,0 +1,82 @@
+
+ *
+ * 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. accept() does two things:
+ *
+ *
+ * - It calls {@link visit} to validate the value against the constraints of
+ * the metadata.
+ * - It calls accept() 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.
+ *
+ *
+ * @author Bernhard Schussek
+ *
+ * @deprecated since version 2.5, to be removed in 3.0.
+ */
+interface ValidationVisitorInterface
+{
+ /**
+ * Validates a value.
+ *
+ * If the value is an array or a traversable object, you can set the
+ * parameter $traverse to true 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 $deep to true as well.
+ *
+ * If you set $traversable to true, 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 $traversable to true 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 bool $traverse Whether to traverse the value if it is traversable
+ * @param bool $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);
+}