merged branch bschussek/move-existence-constraints (PR #7701)

This PR was merged into the master branch.

Discussion
----------

[Validator] Moved constraints Optional and Required to the Constraints\ namespace

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | yes
| Tests pass?   | yes
| Fixed tickets | -
| License       | MIT
| Doc PR        | symfony/symfony-docs#2512

Commits
-------

a868048 [Validator] Moved constraints Optional and Required to the Constraints\ namespace

Author: fabpot

CHANGELOG.md

@@ -1,6 +1,13 @@
 CHANGELOG
 =========
 
+2.3.0
+-----
+
+ * copied the constraints `Optional` and `Required` to the
+   `Symfony\Component\Validator\Constraints\` namespace and deprecated the original
+   classes.
+
 2.2.0
 -----
 

Constraints/All.php

@@ -17,6 +17,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class All extends Constraint

Constraints/Blank.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Blank extends Constraint

Constraints/Callback.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Callback extends Constraint

Constraints/Choice.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Choice extends Constraint

Constraints/Collection.php

@@ -12,13 +12,15 @@
 namespace Symfony\Component\Validator\Constraints;
 
 use Symfony\Component\Validator\Constraint;
-use Symfony\Component\Validator\Constraints\Collection\Required;
-use Symfony\Component\Validator\Constraints\Collection\Optional;
+use Symfony\Component\Validator\Constraints\Required;
+use Symfony\Component\Validator\Constraints\Optional;
 use Symfony\Component\Validator\Exception\ConstraintDefinitionException;
 
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Collection extends Constraint

Constraints/Collection/Optional.php

@@ -11,17 +11,16 @@
 
 namespace Symfony\Component\Validator\Constraints\Collection;
 
-use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Constraints\Optional as BaseOptional;
 
 /**
  * @Annotation
+ *
+ * @author Bernhard Schussek <[email protected]>
+ *
+ * @deprecated Deprecated in 2.3, to be removed in 3.0. Use
+ *             {@link \Symfony\Component\Validator\Constraints\Optional} instead.
  */
-class Optional extends Constraint
+class Optional extends BaseOptional
 {
-    public $constraints = array();
-
-    public function getDefaultOption()
-    {
-        return 'constraints';
-    }
 }

Constraints/Collection/Required.php

@@ -11,17 +11,16 @@
 
 namespace Symfony\Component\Validator\Constraints\Collection;
 
-use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Constraints\Required as BaseRequired;
 
 /**
  * @Annotation
+ *
+ * @author Bernhard Schussek <[email protected]>
+ *
+ * @deprecated Deprecated in 2.3, to be removed in 3.0. Use
+ *             {@link \Symfony\Component\Validator\Constraints\Required} instead.
  */
-class Required extends Constraint
+class Required extends BaseRequired
 {
-    public $constraints = array();
-
-    public function getDefaultOption()
-    {
-        return 'constraints';
-    }
 }

Constraints/CollectionValidator.php

@@ -14,7 +14,7 @@
 use Symfony\Component\Validator\Constraint;
 use Symfony\Component\Validator\ConstraintValidator;
 use Symfony\Component\Validator\Exception\UnexpectedTypeException;
-use Symfony\Component\Validator\Constraints\Collection\Optional;
+use Symfony\Component\Validator\Constraints\Optional;
 
 /**
  * @author Bernhard Schussek <[email protected]>

Constraints/Count.php

@@ -17,6 +17,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Count extends Constraint

Constraints/Country.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Country extends Constraint

Constraints/Date.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Date extends Constraint

Constraints/DateTime.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class DateTime extends Constraint

Constraints/Email.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Email extends Constraint

Constraints/Existence.php

@@ -0,0 +1,27 @@
+<?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\Constraints;
+
+use Symfony\Component\Validator\Constraint;
+
+/**
+ * @author Bernhard Schussek <[email protected]>
+ */
+abstract class Existence extends Constraint
+{
+    public $constraints = array();
+
+    public function getDefaultOption()
+    {
+        return 'constraints';
+    }
+}

Constraints/False.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class False extends Constraint

Constraints/File.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class File extends Constraint

Constraints/GroupSequence.php

@@ -15,6 +15,7 @@
  * Annotation for group sequences
  *
  * @Annotation
+ *
  * @author Bernhard Schussek <[email protected]>
  *
  * @api

Constraints/Ip.php

@@ -18,6 +18,7 @@
  * Validates that a value is a valid IP address
  *
  * @Annotation
+ *
  * @author Bernhard Schussek <[email protected]>
  * @author Joseph Bielawski <[email protected]>
  *

Constraints/Language.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Language extends Constraint

Constraints/Length.php

@@ -17,6 +17,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Length extends Constraint

Constraints/Locale.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Locale extends Constraint

Constraints/NotBlank.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class NotBlank extends Constraint

Constraints/NotBlankValidator.php

@@ -15,6 +15,8 @@
 use Symfony\Component\Validator\ConstraintValidator;
 
 /**
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @author Bernhard Schussek <[email protected]>
  *
  * @api

Constraints/NotNull.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class NotNull extends Constraint

Constraints/Null.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Null extends Constraint

Constraints/Optional.php

@@ -0,0 +1,21 @@
+<?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\Constraints;
+
+/**
+ * @Annotation
+ *
+ * @author Bernhard Schussek <[email protected]>
+ */
+class Optional extends Existence
+{
+}

Constraints/Range.php

@@ -17,6 +17,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Range extends Constraint

Constraints/Regex.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Regex extends Constraint

Constraints/Required.php

@@ -0,0 +1,21 @@
+<?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\Constraints;
+
+/**
+ * @Annotation
+ *
+ * @author Bernhard Schussek <[email protected]>
+ */
+class Required extends Existence
+{
+}

Constraints/Time.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Time extends Constraint

Constraints/True.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class True extends Constraint

Constraints/Type.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Type extends Constraint

Constraints/Url.php

@@ -16,6 +16,8 @@
 /**
  * @Annotation
  *
+ * @author Bernhard Schussek <[email protected]>
+ *
  * @api
  */
 class Url extends Constraint