[WIP] Nullable embedded objects.

lib/Doctrine/ORM/Mapping/ClassMetadataFactory.php

@@ -483,6 +483,7 @@ private function addNestedEmbeddedClasses(ClassMetadata $subClass, ClassMetadata
             $parentClass->mapEmbedded(array(
                 'fieldName' => $prefix . '.' . $property,
                 'class' => $embeddableMetadata->name,
+                'nullable' => $embeddableClass['nullable'],
                 'columnPrefix' => $embeddableClass['columnPrefix'],
                 'declaredField' => $embeddableClass['declaredField']
                         ? $prefix . '.' . $embeddableClass['declaredField']

lib/Doctrine/ORM/Mapping/ClassMetadataInfo.php

@@ -3216,6 +3216,7 @@ public function mapEmbedded(array $mapping)
         $this->embeddedClasses[$mapping['fieldName']] = array(
             'class' => $this->fullyQualifiedClassName($mapping['class']),
             'columnPrefix' => $mapping['columnPrefix'],
+            'nullable' => isset($mapping['nullable']) ? $mapping['nullable'] : null,
             'declaredField' => isset($mapping['declaredField']) ? $mapping['declaredField'] : null,
             'originalField' => isset($mapping['originalField']) ? $mapping['originalField'] : null,
         );
@@ -3241,6 +3242,10 @@ public function inlineEmbeddable($property, ClassMetadataInfo $embeddable)
                 : $fieldMapping['fieldName'];
             $fieldMapping['fieldName'] = $property . "." . $fieldMapping['fieldName'];
 
+            if ($this->embeddedClasses[$property]['nullable'] === true) {
+                $fieldMapping['nullable'] = $this->embeddedClasses[$property]['nullable'];
+            }
+
             if (! empty($this->embeddedClasses[$property]['columnPrefix'])) {
                 $fieldMapping['columnName'] = $this->embeddedClasses[$property]['columnPrefix'] . $fieldMapping['columnName'];
             } elseif ($this->embeddedClasses[$property]['columnPrefix'] !== false) {
@@ -3313,4 +3318,42 @@ public function getSequencePrefix(AbstractPlatform $platform)
 
         return $sequencePrefix;
     }
+
+    /**
+     * Configures the entity with the data values according with the class configuration
+     *
+     * @param object $entity
+     * @param array $data
+     */
+    public function populateEntity($entity, array $data)
+    {
+        foreach ($data as $field => $value) {
+            if ($this->shouldUseData($field, $value)) {
+                $this->reflFields[$field]->setValue($entity, $value);
+            }
+        }
+    }
+
+    /**
+     * Returns if the data should be used to populate the entity
+     *
+     * @param string $field
+     * @param string $value
+     * @return boolean
+     */
+    private function shouldUseData($field, $value)
+    {
+        if ( ! isset($this->fieldMappings[$field])) {
+            return false;
+        }
+
+        if ($value !== null) {
+            return true;
+        }
+
+        return isset(
+            $this->fieldMappings[$field]['declaredField'],
+            $this->embeddedClasses[$name = $this->fieldMappings[$field]['declaredField']]
+        ) && $this->embeddedClasses[$name]['nullable'] !== true;
+    }
 }

lib/Doctrine/ORM/Mapping/Driver/AnnotationDriver.php

@@ -394,6 +394,7 @@ public function loadMetadataForClass($className, ClassMetadata $metadata)
             } else if ($embeddedAnnot = $this->reader->getPropertyAnnotation($property, 'Doctrine\ORM\Mapping\Embedded')) {
                 $mapping['class'] = $embeddedAnnot->class;
                 $mapping['columnPrefix'] = $embeddedAnnot->columnPrefix;
+                $mapping['nullable'] = $embeddedAnnot->nullable;
                 $metadata->mapEmbedded($mapping);
             }
 

lib/Doctrine/ORM/Mapping/Driver/XmlDriver.php

@@ -263,9 +263,14 @@ public function loadMetadataForClass($className, ClassMetadata $metadata)
                     ? $this->evaluateBoolean($embeddedMapping['use-column-prefix'])
                     : true;
 
+                $nullable = isset($embeddedMapping['nullable'])
+                    ? $this->evaluateBoolean($embeddedMapping['nullable'])
+                    : null;
+
                 $mapping = array(
                     'fieldName' => (string) $embeddedMapping['name'],
                     'class' => (string) $embeddedMapping['class'],
+                    'nullable' => $nullable,
                     'columnPrefix' => $useColumnPrefix ? $columnPrefix : false
                 );
 

lib/Doctrine/ORM/Mapping/Driver/YamlDriver.php

@@ -334,6 +334,7 @@ public function loadMetadataForClass($className, ClassMetadata $metadata)
                 $mapping = array(
                     'fieldName' => $name,
                     'class' => $embeddedMapping['class'],
+                    'nullable' => isset($embeddedMapping['nullable']) ? $embeddedMapping['nullable'] : null,
                     'columnPrefix' => isset($embeddedMapping['columnPrefix']) ? $embeddedMapping['columnPrefix'] : null,
                 );
                 $metadata->mapEmbedded($mapping);

lib/Doctrine/ORM/Mapping/Embedded.php

@@ -35,4 +35,9 @@ final class Embedded implements Annotation
      * @var mixed
      */
     public $columnPrefix;
+
+    /**
+     * @var boolean
+     */
+    public $nullable;
 }

lib/Doctrine/ORM/UnitOfWork.php

@@ -2576,11 +2576,7 @@ public function createEntity($className, array $data, &$hints = array())
             return $entity;
         }
 
-        foreach ($data as $field => $value) {
-            if (isset($class->fieldMappings[$field])) {
-                $class->reflFields[$field]->setValue($entity, $value);
-            }
-        }
+        $class->populateEntity($entity, $data);
 
         // Loading the entity right here, if its in the eager loading map get rid of it there.
         unset($this->eagerLoadingEntities[$class->rootEntityName][$idHash]);

tests/Doctrine/Tests/ORM/Functional/ValueObjectsTest.php

@@ -19,6 +19,7 @@ public function setUp()
                 $this->_em->getClassMetadata(__NAMESPACE__ . '\DDC93Car'),
                 $this->_em->getClassMetadata(__NAMESPACE__ . '\DDC3027Animal'),
                 $this->_em->getClassMetadata(__NAMESPACE__ . '\DDC3027Dog'),
+                $this->_em->getClassMetadata(__NAMESPACE__ . '\DDC3529Event'),
             ));
         } catch(\Exception $e) {
         }
@@ -242,6 +243,69 @@ public function testThrowsExceptionOnInfiniteEmbeddableNesting($embeddableClassN
         ));
     }
 
+    public function testNoErrorsShouldHappenWhenPersistingAnEntityWithNullableEmbedded()
+    {
+        $event = new DDC3529Event();
+        $event->name = 'PHP Conference';
+        $event->period = new DDC3529DateInterval(new \DateTime('2015-01-20 08:00:00'), new \DateTime('2015-01-23 19:00:00'));
+
+        $this->_em->persist($event);
+        $this->_em->flush();
+
+        return $event;
+    }
+
+    /**
+     * @depends testNoErrorsShouldHappenWhenPersistingAnEntityWithNullableEmbedded
+     * @param DDC3529Event $event
+     */
+    public function testEmbeddedObjectShouldNotBeCreatedWhenIsNullableAndHaveNoData(DDC3529Event $event)
+    {
+        $event = $this->_em->find(DDC3529Event::CLASSNAME, $event->id);
+
+        $this->assertEquals('PHP Conference', $event->name);
+        $this->assertEquals('2015-01-20 08:00:00', $event->period->begin->format('Y-m-d H:i:s'));
+        $this->assertEquals('2015-01-23 19:00:00', $event->period->end->format('Y-m-d H:i:s'));
+        $this->assertNull($event->submissions);
+
+        return $event;
+    }
+
+    /**
+     * @depends testEmbeddedObjectShouldNotBeCreatedWhenIsNullableAndHaveNoData
+     * @param DDC3529Event $event
+     */
+    public function testEmbeddedObjectShouldBeCreatedWhenIsNullableButHaveData(DDC3529Event $event)
+    {
+        $event->submissions = new DDC3529DateInterval(new \DateTime('2014-11-20 08:00:00'), new \DateTime('2014-12-23 19:00:00'));
+
+        $this->_em->persist($event);
+        $this->_em->flush();
+        $this->_em->clear();
+
+        $event = $this->_em->find(DDC3529Event::CLASSNAME, $event->id);
+
+        $this->assertEquals('2014-11-20 08:00:00', $event->submissions->begin->format('Y-m-d H:i:s'));
+        $this->assertEquals('2014-12-23 19:00:00', $event->submissions->end->format('Y-m-d H:i:s'));
+
+        return $event;
+    }
+
+    /**
+     * @depends testEmbeddedObjectShouldBeCreatedWhenIsNullableButHaveData
+     * @param DDC3529Event $event
+     */
+    public function testFindShouldReturnNullAfterTheObjectWasRemoved(DDC3529Event $event)
+    {
+        $eventId = $event->id;
+
+        $event = $this->_em->find(DDC3529Event::CLASSNAME, $eventId);
+        $this->_em->remove($event);
+        $this->_em->flush();
+
+        $this->assertNull($this->_em->find(DDC3529Event::CLASSNAME, $eventId));
+    }
+
     public function getInfiniteEmbeddableNestingData()
     {
         return array(
@@ -279,6 +343,44 @@ public function __construct($name = null, DDC93Address $address = null)
     }
 }
 
+/**
+ * @Embeddable
+ */
+class DDC3529DateInterval
+{
+    /** @Column(type = "datetime") */
+    public $begin;
+
+    /** @Column(type = "datetime") */
+    public $end;
+
+    public function __construct(\DateTime $begin, \DateTime $end)
+    {
+        $this->begin = $begin;
+        $this->end = $end;
+    }
+}
+
+/**
+ * @Entity
+ */
+class DDC3529Event
+{
+    const CLASSNAME = __CLASS__;
+
+    /** @Id @GeneratedValue @Column(type="integer") */
+    public $id;
+
+    /** @Column(type = "string") */
+    public $name;
+
+    /** @Embedded(class = "DDC3529DateInterval") */
+    public $period;
+
+    /** @Embedded(class = "DDC3529DateInterval", nullable = true) */
+    public $submissions;
+}
+
 /**
  * @Embeddable
  */

tests/Doctrine/Tests/ORM/Mapping/ClassMetadataBuilderTest.php

@@ -73,6 +73,7 @@ public function testAddEmbeddedWithOnlyRequiredParams()
                 'columnPrefix' => null,
                 'declaredField' => null,
                 'originalField' => null,
+                'nullable' => null
             )
         ), $this->cm->embeddedClasses);
     }
@@ -93,6 +94,7 @@ public function testAddEmbeddedWithPrefix()
                 'columnPrefix' => 'nm_',
                 'declaredField' => null,
                 'originalField' => null,
+                'nullable' => null
             )
         ), $this->cm->embeddedClasses);
     }
@@ -110,7 +112,8 @@ public function testCreateEmbeddedWithoutExtraParams()
                 'class' => 'Doctrine\Tests\Models\ValueObjects\Name',
                 'columnPrefix' => null,
                 'declaredField' => null,
-                'originalField' => null
+                'originalField' => null,
+                'nullable' => null
             ),
             $this->cm->embeddedClasses['name']
         );
@@ -129,7 +132,8 @@ public function testCreateEmbeddedWithColumnPrefix()
                 'class' => 'Doctrine\Tests\Models\ValueObjects\Name',
                 'columnPrefix' => 'nm_',
                 'declaredField' => null,
-                'originalField' => null
+                'originalField' => null,
+                'nullable' => null
             ),
             $this->cm->embeddedClasses['name']
         );

tests/Doctrine/Tests/ORM/Mapping/XmlMappingDriverTest.php

@@ -109,6 +109,7 @@ public function testEmbeddedMapping()
                     'columnPrefix' => 'nm_',
                     'declaredField' => null,
                     'originalField' => null,
+                    'nullable' => null,
                 )
             ),
             $class->embeddedClasses