Merge pull request #2444 from malarzm/type-autoconfigure-final-touches-mm

Final touches for type autoconfiguration

Author: malarzm

docs/en/reference/basic-mapping.rst

@@ -203,6 +203,9 @@ This list explains some of the less obvious mapping types:
 PHP Types Mapping
 _________________
 
+.. note::
+    Doctrine will skip type autoconfiguration if settings are provided explicitly.
+
 Since version 2.4 Doctrine can determine usable defaults from property types
 on document classes. Doctrine will map PHP types to ``type`` attribute as
 follows:
@@ -215,11 +218,16 @@ follows:
 - ``int``: ``int``
 - ``string``: ``string``
 
-Doctrine will also autoconfigure any backed ``enum`` it encounters: ``type``
+Doctrine can also autoconfigure any backed ``enum`` it encounters: ``type``
 will be set to ``string`` or ``int``, depending on the enum's backing type,
 and ``enumType`` to the enum's |FQCN|.
 
-Please note that at this time, due to backward compatibility reasons, nullable type does not imply `nullable` mapping.
+.. note::
+    Nullable type does not imply ``nullable`` mapping option. You need to manually
+    set ``nullable=true`` to have ``null`` values saved to the database.
+
+Additionally Doctrine can determine ``collectionClass`` for ``ReferenceMany`` and
+``EmbedMany`` collections from property's type.
 
 Property Mapping
 ----------------

lib/Doctrine/ODM/MongoDB/Mapping/ClassMetadata.php

@@ -1563,6 +1563,7 @@ public function mapManyEmbedded(array $mapping): void
     {
         $mapping['embedded'] = true;
         $mapping['type']     = self::MANY;
+
         $this->mapField($mapping);
     }
 
@@ -1588,6 +1589,7 @@ public function mapManyReference(array $mapping): void
     {
         $mapping['reference'] = true;
         $mapping['type']      = self::MANY;
+
         $this->mapField($mapping);
     }
 
@@ -2120,7 +2122,7 @@ public function getAssociationTargetClass($assocName): ?string
             throw new InvalidArgumentException("Association name expected, '" . $assocName . "' is not an association.");
         }
 
-        return $this->associationMappings[$assocName]['targetDocument'];
+        return $this->associationMappings[$assocName]['targetDocument'] ?? null;
     }
 
     /**
@@ -2170,6 +2172,14 @@ public function mapField(array $mapping): array
             $mapping['fieldName'] = $mapping['name'];
         }
 
+        if ($this->isTypedProperty($mapping['fieldName'])) {
+            $mapping = $this->validateAndCompleteTypedFieldMapping($mapping);
+
+            if (isset($mapping['type']) && $mapping['type'] === self::MANY) {
+                $mapping = $this->validateAndCompleteTypedManyAssociationMapping($mapping);
+            }
+        }
+
         if (! isset($mapping['fieldName']) || ! is_string($mapping['fieldName'])) {
             throw MappingException::missingFieldName($this->name);
         }
@@ -2242,14 +2252,6 @@ public function mapField(array $mapping): array
             unset($this->generatorOptions['type']);
         }
 
-        if ($this->isTypedProperty($mapping['fieldName'])) {
-            $mapping = $this->validateAndCompleteTypedFieldMapping($mapping);
-
-            if (isset($mapping['type']) && ($mapping['type'] === self::ONE || $mapping['type'] === self::MANY)) {
-                $mapping = $this->validateAndCompleteTypedAssociationMapping($mapping);
-            }
-        }
-
         if (! isset($mapping['type'])) {
             // Default to string
             $mapping['type'] = Type::STRING;
@@ -2653,19 +2655,15 @@ private function validateAndCompleteTypedFieldMapping(array $mapping): array
      *
      * @return FieldMappingConfig
      */
-    private function validateAndCompleteTypedAssociationMapping(array $mapping): array
+    private function validateAndCompleteTypedManyAssociationMapping(array $mapping): array
     {
         $type = $this->reflClass->getProperty($mapping['fieldName'])->getType();
 
         if (! $type instanceof ReflectionNamedType) {
             return $mapping;
         }
 
-        if (
-            ! isset($mapping['collectionClass'])
-            && $mapping['type'] === self::MANY
-            && class_exists($type->getName())
-        ) {
+        if (! isset($mapping['collectionClass']) && class_exists($type->getName())) {
             $mapping['collectionClass'] = $type->getName();
         }