Merge remote-tracking branch 'origin/master' into upgrade-sf5

src/Bundle/ChillDocStoreBundle/Entity/StoredObject.php

@@ -24,6 +24,11 @@ use Symfony\Component\Serializer\Annotation as Serializer;
 /**
  * Represent a document stored in an object store.
  *
+ * StoredObjects 's content should be read and written using the @see{StoredObjectManagerInterface}.
+ *
+ * The property `$deleteAt` allow a deletion of the document after the given date. But this property should
+ * be set before the document is actually written by the StoredObjectManager.
+ *
  * @ORM\Entity
  *
  * @ORM\Table("chill_doc.stored_object")
@@ -116,6 +121,16 @@ class StoredObject implements Document, TrackCreationInterface
      */
     private int $generationTrialsCounter = 0;
 
+    /**
+     * @ORM\Column(type="datetime_immutable", nullable=true, options={"default": null})
+     */
+    private ?\DateTimeImmutable $deleteAt = null;
+
+    /**
+     * @ORM\Column(type="text", nullable=false, options={"default": ""})
+     */
+    private string $generationErrors = '';
+
     /**
      * @param StoredObject::STATUS_* $status
      */
@@ -143,6 +158,11 @@ class StoredObject implements Document, TrackCreationInterface
      */
     public function getCreationDate(): \DateTime
     {
+        if (null === $this->createdAt) {
+            // this scenario will quite never happens
+            return new \DateTime('now');
+        }
+
         return \DateTime::createFromImmutable($this->createdAt);
     }
 
@@ -302,4 +322,37 @@ class StoredObject implements Document, TrackCreationInterface
     {
         return self::STATUS_FAILURE === $this->getStatus();
     }
+
+    public function getDeleteAt(): ?\DateTimeImmutable
+    {
+        return $this->deleteAt;
+    }
+
+    public function setDeleteAt(?\DateTimeImmutable $deleteAt): StoredObject
+    {
+        $this->deleteAt = $deleteAt;
+
+        return $this;
+    }
+
+    public function getGenerationErrors(): string
+    {
+        return $this->generationErrors;
+    }
+
+    /**
+     * Adds generation errors to the stored object.
+     *
+     * The existing generation errors are not removed
+     *
+     * @param string $generationErrors the generation errors to be added
+     *
+     * @return StoredObject the modified StoredObject instance
+     */
+    public function addGenerationErrors(string $generationErrors): StoredObject
+    {
+        $this->generationErrors = $this->generationErrors.$generationErrors."\n";
+
+        return $this;
+    }
 }