use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\ORM\Mapping as ORM;
-use Symfony\Component\Validator\Constraints as Assert;
use Hateoas\Configuration\Annotation as Hateoas;
+use JMS\Serializer\Annotation\Exclude;
+use JMS\Serializer\Annotation\Groups;
+use JMS\Serializer\Annotation\SerializedName;
+use JMS\Serializer\Annotation\VirtualProperty;
use JMS\Serializer\Annotation\XmlRoot;
+use Symfony\Component\Validator\Constraints as Assert;
+use Wallabag\AnnotationBundle\Entity\Annotation;
+use Wallabag\CoreBundle\Helper\EntityTimestampsTrait;
+use Wallabag\UserBundle\Entity\User;
/**
- * Entry
+ * Entry.
*
* @XmlRoot("entry")
* @ORM\Entity(repositoryClass="Wallabag\CoreBundle\Repository\EntryRepository")
- * @ORM\Table
+ * @ORM\Table(
+ * name="`entry`",
+ * options={"collate"="utf8mb4_unicode_ci", "charset"="utf8mb4"},
+ * indexes={
+ * @ORM\Index(name="created_at", columns={"created_at"}),
+ * @ORM\Index(name="uid", columns={"uid"})
+ * }
+ * )
* @ORM\HasLifecycleCallbacks()
* @Hateoas\Relation("self", href = "expr('/api/entries/' ~ object.getId())")
*/
class Entry
{
+ use EntityTimestampsTrait;
+
/** @Serializer\XmlAttribute */
/**
- * @var integer
+ * @var int
*
* @ORM\Column(name="id", type="integer")
* @ORM\Id
* @ORM\GeneratedValue(strategy="AUTO")
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $id;
+ /**
+ * @var string
+ *
+ * @ORM\Column(name="uid", type="string", length=23, nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $uid;
+
/**
* @var string
*
* @ORM\Column(name="title", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $title;
*
* @Assert\NotBlank()
* @ORM\Column(name="url", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $url;
/**
- * @var boolean
+ * @var bool
+ *
+ * @Exclude
*
* @ORM\Column(name="is_archived", type="boolean")
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $isArchived = false;
/**
- * @var boolean
+ * @var bool
+ *
+ * @Exclude
*
* @ORM\Column(name="is_starred", type="boolean")
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $isStarred = false;
* @var string
*
* @ORM\Column(name="content", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $content;
/**
- * @var date
+ * @var \DateTime
*
* @ORM\Column(name="created_at", type="datetime")
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $createdAt;
/**
- * @var date
+ * @var \DateTime
*
* @ORM\Column(name="updated_at", type="datetime")
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $updatedAt;
/**
- * @var string
+ * @var \DateTime
+ *
+ * @ORM\Column(name="published_at", type="datetime", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $publishedAt;
+
+ /**
+ * @var array
+ *
+ * @ORM\Column(name="published_by", type="array", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $publishedBy;
+
+ /**
+ * @var \DateTime
+ *
+ * @ORM\Column(name="starred_at", type="datetime", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $starredAt = null;
+
+ /**
+ * @ORM\OneToMany(targetEntity="Wallabag\AnnotationBundle\Entity\Annotation", mappedBy="entry", cascade={"persist", "remove"})
+ * @ORM\JoinTable
*
- * @ORM\Column(name="comments", type="text", nullable=true)
+ * @Groups({"entries_for_user", "export_all"})
*/
- private $comments;
+ private $annotations;
/**
* @var string
*
* @ORM\Column(name="mimetype", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $mimetype;
/**
- * @var integer
+ * @var string
+ *
+ * @ORM\Column(name="language", type="text", nullable=true)
*
- * @ORM\Column(name="reading_type", type="integer", nullable=true)
+ * @Groups({"entries_for_user", "export_all"})
*/
- private $readingTime;
+ private $language;
+
+ /**
+ * @var int
+ *
+ * @ORM\Column(name="reading_time", type="integer", nullable=false)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $readingTime = 0;
/**
* @var string
*
* @ORM\Column(name="domain_name", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
*/
private $domainName;
/**
- * @var boolean
+ * @var string
+ *
+ * @ORM\Column(name="preview_picture", type="text", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $previewPicture;
+
+ /**
+ * @var string
+ *
+ * @ORM\Column(name="http_status", type="string", length=3, nullable=true)
*
- * @ORM\Column(name="is_public", type="boolean", nullable=true, options={"default" = false})
+ * @Groups({"entries_for_user", "export_all"})
*/
- private $isPublic;
+ private $httpStatus;
/**
- * @ORM\ManyToOne(targetEntity="User", inversedBy="entries")
+ * @var array
+ *
+ * @ORM\Column(name="headers", type="array", nullable=true)
+ *
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ private $headers;
+
+ /**
+ * @Exclude
+ *
+ * @ORM\ManyToOne(targetEntity="Wallabag\UserBundle\Entity\User", inversedBy="entries")
+ *
+ * @Groups({"export_all"})
*/
private $user;
/**
* @ORM\ManyToMany(targetEntity="Tag", inversedBy="entries", cascade={"persist"})
- * @ORM\JoinTable
+ * @ORM\JoinTable(
+ * name="entry_tag",
+ * joinColumns={
+ * @ORM\JoinColumn(name="entry_id", referencedColumnName="id", onDelete="cascade")
+ * },
+ * inverseJoinColumns={
+ * @ORM\JoinColumn(name="tag_id", referencedColumnName="id", onDelete="cascade")
+ * }
+ * )
*/
private $tags;
}
/**
- * Get id
+ * Get id.
*
- * @return integer
+ * @return int
*/
public function getId()
{
}
/**
- * Set title
+ * Set title.
+ *
+ * @param string $title
*
- * @param string $title
* @return Entry
*/
public function setTitle($title)
}
/**
- * Get title
+ * Get title.
*
* @return string
*/
}
/**
- * Set url
+ * Set url.
+ *
+ * @param string $url
*
- * @param string $url
* @return Entry
*/
public function setUrl($url)
}
/**
- * Get url
+ * Get url.
*
* @return string
*/
}
/**
- * Set isArchived
+ * Set isArchived.
+ *
+ * @param bool $isArchived
*
- * @param string $isArchived
* @return Entry
*/
public function setArchived($isArchived)
}
/**
- * Get isArchived
+ * Get isArchived.
*
- * @return string
+ * @return bool
*/
public function isArchived()
{
return $this->isArchived;
}
+ /**
+ * @VirtualProperty
+ * @SerializedName("is_archived")
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ public function is_Archived()
+ {
+ return (int) $this->isArchived();
+ }
+
public function toggleArchive()
{
$this->isArchived = $this->isArchived() ^ 1;
}
/**
- * Set isStarred
+ * Set isStarred.
+ *
+ * @param bool $isStarred
*
- * @param string $isStarred
* @return Entry
*/
public function setStarred($isStarred)
}
/**
- * Get isStarred
+ * Get isStarred.
*
- * @return string
+ * @return bool
*/
public function isStarred()
{
return $this->isStarred;
}
+ /**
+ * @VirtualProperty
+ * @SerializedName("is_starred")
+ * @Groups({"entries_for_user", "export_all"})
+ */
+ public function is_Starred()
+ {
+ return (int) $this->isStarred();
+ }
+
public function toggleStar()
{
$this->isStarred = $this->isStarred() ^ 1;
}
/**
- * Set content
+ * Set content.
+ *
+ * @param string $content
*
- * @param string $content
* @return Entry
*/
public function setContent($content)
}
/**
- * Get content
+ * Get content.
*
* @return string
*/
}
/**
- * @return string
+ * @VirtualProperty
+ * @SerializedName("user_name")
+ */
+ public function getUserName()
+ {
+ return $this->user->getUserName();
+ }
+
+ /**
+ * @VirtualProperty
+ * @SerializedName("user_email")
+ */
+ public function getUserEmail()
+ {
+ return $this->user->getEmail();
+ }
+
+ /**
+ * @VirtualProperty
+ * @SerializedName("user_id")
+ */
+ public function getUserId()
+ {
+ return $this->user->getId();
+ }
+
+ /**
+ * Set created_at.
+ * Only used when importing data from an other service.
+ *
+ * @param \DateTime $createdAt
+ *
+ * @return Entry
+ */
+ public function setCreatedAt(\DateTime $createdAt)
+ {
+ $this->createdAt = $createdAt;
+
+ return $this;
+ }
+
+ /**
+ * @return \DateTime
*/
public function getCreatedAt()
{
}
/**
- * @return string
+ * @return \DateTime
*/
public function getUpdatedAt()
{
}
/**
- * @ORM\PrePersist
- * @ORM\PreUpdate
+ * @return \DateTime|null
+ */
+ public function getStarredAt()
+ {
+ return $this->starredAt;
+ }
+
+ /**
+ * @param \DateTime|null $starredAt
+ *
+ * @return Entry
+ */
+ public function setStarredAt($starredAt = null)
+ {
+ $this->starredAt = $starredAt;
+
+ return $this;
+ }
+
+ /**
+ * update isStarred and starred_at fields.
+ *
+ * @param bool $isStarred
+ *
+ * @return Entry
*/
- public function timestamps()
+ public function updateStar($isStarred = false)
{
- if (is_null($this->createdAt)) {
- $this->createdAt = new \DateTime();
+ $this->setStarred($isStarred);
+ $this->setStarredAt(null);
+ if ($this->isStarred()) {
+ $this->setStarredAt(new \DateTime());
}
- $this->updatedAt = new \DateTime();
+ return $this;
}
/**
- * @return string
+ * @return ArrayCollection<Annotation>
*/
- public function getComments()
+ public function getAnnotations()
{
- return $this->comments;
+ return $this->annotations;
}
/**
- * @param string $comments
+ * @param Annotation $annotation
*/
- public function setComments($comments)
+ public function setAnnotation(Annotation $annotation)
{
- $this->comments = $comments;
+ $this->annotations[] = $annotation;
}
/**
}
/**
- * @return boolean
+ * @return ArrayCollection
*/
- public function isPublic()
+ public function getTags()
{
- return $this->isPublic;
+ return $this->tags;
}
/**
- * @param boolean $isPublic
+ * @VirtualProperty
+ * @SerializedName("tags")
+ * @Groups({"entries_for_user", "export_all"})
*/
- public function setPublic($isPublic)
+ public function getSerializedTags()
{
- $this->isPublic = $isPublic;
- }
+ $data = [];
+ foreach ($this->tags as $tag) {
+ $data[] = $tag->getLabel();
+ }
- /**
- * @return ArrayCollection<Tag>
- */
- public function getTags()
- {
- return $this->tags;
+ return $data;
}
/**
*/
public function addTag(Tag $tag)
{
- $this->tags[] = $tag;
+ if ($this->tags->contains($tag)) {
+ return;
+ }
+
+ // check if tag already exist but has not yet be persisted
+ // it seems that the previous condition with `contains()` doesn't check that case
+ foreach ($this->tags as $existingTag) {
+ if ($existingTag->getLabel() === $tag->getLabel()) {
+ return;
+ }
+ }
+
+ $this->tags->add($tag);
$tag->addEntry($this);
}
+ /**
+ * Remove the given tag from the entry (if the tag is associated).
+ *
+ * @param Tag $tag
+ */
public function removeTag(Tag $tag)
{
+ if (!$this->tags->contains($tag)) {
+ return;
+ }
+
$this->tags->removeElement($tag);
+ $tag->removeEntry($this);
+ }
+
+ /**
+ * Remove all assigned tags from the entry.
+ */
+ public function removeAllTags()
+ {
+ foreach ($this->tags as $tag) {
+ $this->tags->removeElement($tag);
+ $tag->removeEntry($this);
+ }
+ }
+
+ /**
+ * Set previewPicture.
+ *
+ * @param string $previewPicture
+ *
+ * @return Entry
+ */
+ public function setPreviewPicture($previewPicture)
+ {
+ $this->previewPicture = $previewPicture;
+
+ return $this;
+ }
+
+ /**
+ * Get previewPicture.
+ *
+ * @return string
+ */
+ public function getPreviewPicture()
+ {
+ return $this->previewPicture;
+ }
+
+ /**
+ * Set language.
+ *
+ * @param string $language
+ *
+ * @return Entry
+ */
+ public function setLanguage($language)
+ {
+ $this->language = $language;
+
+ return $this;
+ }
+
+ /**
+ * Get language.
+ *
+ * @return string
+ */
+ public function getLanguage()
+ {
+ return $this->language;
+ }
+
+ /**
+ * @return string
+ */
+ public function getUid()
+ {
+ return $this->uid;
+ }
+
+ /**
+ * @param string $uid
+ *
+ * @return Entry
+ */
+ public function setUid($uid)
+ {
+ $this->uid = $uid;
+
+ return $this;
+ }
+
+ public function generateUid()
+ {
+ if (null === $this->uid) {
+ // @see http://blog.kevingomez.fr/til/2015/07/26/why-is-uniqid-slow/ for true parameter
+ $this->uid = uniqid('', true);
+ }
+ }
+
+ public function cleanUid()
+ {
+ $this->uid = null;
+ }
+
+ /**
+ * Used in the entries filter so it's more explicit for the end user than the uid.
+ * Also used in the API.
+ *
+ * @VirtualProperty
+ * @SerializedName("is_public")
+ * @Groups({"entries_for_user"})
+ *
+ * @return bool
+ */
+ public function isPublic()
+ {
+ return null !== $this->uid;
+ }
+
+ /**
+ * @return string
+ */
+ public function getHttpStatus()
+ {
+ return $this->httpStatus;
+ }
+
+ /**
+ * @param string $httpStatus
+ *
+ * @return Entry
+ */
+ public function setHttpStatus($httpStatus)
+ {
+ $this->httpStatus = $httpStatus;
+
+ return $this;
+ }
+
+ /**
+ * @return \Datetime
+ */
+ public function getPublishedAt()
+ {
+ return $this->publishedAt;
+ }
+
+ /**
+ * @param \Datetime $publishedAt
+ *
+ * @return Entry
+ */
+ public function setPublishedAt(\Datetime $publishedAt)
+ {
+ $this->publishedAt = $publishedAt;
+
+ return $this;
+ }
+
+ /**
+ * @return array
+ */
+ public function getPublishedBy()
+ {
+ return $this->publishedBy;
+ }
+
+ /**
+ * @param array $publishedBy
+ *
+ * @return Entry
+ */
+ public function setPublishedBy($publishedBy)
+ {
+ $this->publishedBy = $publishedBy;
+
+ return $this;
+ }
+
+ /**
+ * @return array
+ */
+ public function getHeaders()
+ {
+ return $this->headers;
+ }
+
+ /**
+ * @param array $headers
+ *
+ * @return Entry
+ */
+ public function setHeaders($headers)
+ {
+ $this->headers = $headers;
+
+ return $this;
}
}