id !== null) { throw new IllegalIDChangeException('Not allowed to assign a new internal id to a share'); } $this->id = trim($id); return $this; } /** * @inheritdoc */ public function getId() { return $this->id; } /** * @inheritdoc */ public function getFullId() { if ($this->providerId === null || $this->id === null) { throw new \UnexpectedValueException; } return $this->providerId . ':' . $this->id; } /** * @inheritdoc */ public function setProviderId($id) { if (!is_string($id)) { throw new \InvalidArgumentException('String expected.'); } if ($this->providerId !== null) { throw new IllegalIDChangeException('Not allowed to assign a new provider id to a share'); } $this->providerId = trim($id); return $this; } /** * @inheritdoc */ public function setNode(Node $node) { $this->fileId = null; $this->nodeType = null; $this->node = $node; return $this; } /** * @inheritdoc */ public function getNode() { if ($this->node === null) { if ($this->shareOwner === null || $this->fileId === null) { throw new NotFoundException(); } // for federated shares the owner can be a remote user, in this // case we use the initiator if ($this->userManager->userExists($this->shareOwner)) { $userFolder = $this->rootFolder->getUserFolder($this->shareOwner); } else { $userFolder = $this->rootFolder->getUserFolder($this->sharedBy); } $node = $userFolder->getFirstNodeById($this->fileId); if (!$node) { throw new NotFoundException('Node for share not found, fileid: ' . $this->fileId); } $this->node = $node; } return $this->node; } /** * @inheritdoc */ public function setNodeId($fileId) { $this->node = null; $this->fileId = $fileId; return $this; } /** * @inheritdoc */ public function getNodeId(): int { if ($this->fileId === null) { $this->fileId = $this->getNode()->getId(); } if ($this->fileId === null) { throw new NotFoundException('Share source not found'); } else { return $this->fileId; } } /** * @inheritdoc */ public function setNodeType($type) { if ($type !== 'file' && $type !== 'folder') { throw new \InvalidArgumentException(); } $this->nodeType = $type; return $this; } /** * @inheritdoc */ public function getNodeType() { if ($this->nodeType === null) { if ($this->getNodeCacheEntry()) { $info = $this->getNodeCacheEntry(); $this->nodeType = $info->getMimeType() === FileInfo::MIMETYPE_FOLDER ? 'folder' : 'file'; } else { $node = $this->getNode(); $this->nodeType = $node instanceof File ? 'file' : 'folder'; } } return $this->nodeType; } /** * @inheritdoc */ public function setShareType($shareType) { $this->shareType = $shareType; return $this; } /** * @inheritdoc */ public function getShareType() { return $this->shareType; } /** * @inheritdoc */ public function setSharedWith($sharedWith) { if (!is_string($sharedWith)) { throw new \InvalidArgumentException(); } $this->sharedWith = $sharedWith; return $this; } /** * @inheritdoc */ public function getSharedWith() { return $this->sharedWith; } /** * @inheritdoc */ public function setSharedWithDisplayName($displayName) { if (!is_string($displayName)) { throw new \InvalidArgumentException(); } $this->sharedWithDisplayName = $displayName; return $this; } /** * @inheritdoc */ public function getSharedWithDisplayName() { return $this->sharedWithDisplayName; } /** * @inheritdoc */ public function setSharedWithAvatar($src) { if (!is_string($src)) { throw new \InvalidArgumentException(); } $this->sharedWithAvatar = $src; return $this; } /** * @inheritdoc */ public function getSharedWithAvatar() { return $this->sharedWithAvatar; } /** * @inheritdoc */ public function setPermissions($permissions) { //TODO checks $this->permissions = $permissions; return $this; } /** * @inheritdoc */ public function getPermissions() { return $this->permissions; } /** * @inheritdoc */ public function newAttributes(): IAttributes { return new ShareAttributes(); } /** * @inheritdoc */ public function setAttributes(?IAttributes $attributes) { $this->attributes = $attributes; return $this; } /** * @inheritdoc */ public function getAttributes(): ?IAttributes { return $this->attributes; } /** * @inheritdoc */ public function setStatus(int $status): IShare { $this->status = $status; return $this; } /** * @inheritdoc */ public function getStatus(): int { return $this->status; } /** * @inheritdoc */ public function setNote($note) { $this->note = $note; return $this; } /** * @inheritdoc */ public function getNote() { if (is_string($this->note)) { return $this->note; } return ''; } /** * @inheritdoc */ public function setLabel($label) { $this->label = $label; return $this; } /** * @inheritdoc */ public function getLabel() { return $this->label; } /** * @inheritdoc */ public function setExpirationDate($expireDate) { //TODO checks $this->expireDate = $expireDate; return $this; } /** * @inheritdoc */ public function getExpirationDate() { return $this->expireDate; } /** * @inheritdoc */ public function setNoExpirationDate(bool $noExpirationDate) { $this->noExpirationDate = $noExpirationDate; return $this; } /** * @inheritdoc */ public function getNoExpirationDate(): bool { return $this->noExpirationDate; } /** * @inheritdoc */ public function isExpired() { return $this->getExpirationDate() !== null && $this->getExpirationDate() <= new \DateTime(); } /** * @inheritdoc */ public function setSharedBy($sharedBy) { if (!is_string($sharedBy)) { throw new \InvalidArgumentException(); } //TODO checks $this->sharedBy = $sharedBy; return $this; } /** * @inheritdoc */ public function getSharedBy() { //TODO check if set return $this->sharedBy; } /** * @inheritdoc */ public function setShareOwner($shareOwner) { if (!is_string($shareOwner)) { throw new \InvalidArgumentException(); } //TODO checks $this->shareOwner = $shareOwner; return $this; } /** * @inheritdoc */ public function getShareOwner() { //TODO check if set return $this->shareOwner; } /** * @inheritdoc */ public function setPassword($password) { $this->password = $password; return $this; } /** * @inheritdoc */ public function getPassword() { return $this->password; } /** * @inheritdoc */ public function setPasswordExpirationTime(?\DateTimeInterface $passwordExpirationTime = null): IShare { $this->passwordExpirationTime = $passwordExpirationTime; return $this; } /** * @inheritdoc */ public function getPasswordExpirationTime(): ?\DateTimeInterface { return $this->passwordExpirationTime; } /** * @inheritdoc */ public function setSendPasswordByTalk(bool $sendPasswordByTalk) { $this->sendPasswordByTalk = $sendPasswordByTalk; return $this; } /** * @inheritdoc */ public function getSendPasswordByTalk(): bool { return $this->sendPasswordByTalk; } /** * @inheritdoc */ public function setToken($token) { $this->token = $token; return $this; } /** * @inheritdoc */ public function getToken() { return $this->token; } /** * Set the parent of this share * * @param int $parent * @return IShare * @deprecated 12.0.0 The new shares do not have parents. This is just here for legacy reasons. */ public function setParent($parent) { $this->parent = $parent; return $this; } /** * Get the parent of this share. * * @return int * @deprecated 12.0.0 The new shares do not have parents. This is just here for legacy reasons. */ public function getParent() { return $this->parent; } /** * @inheritdoc */ public function setTarget($target) { $this->target = $target; return $this; } /** * @inheritdoc */ public function getTarget() { return $this->target; } /** * @inheritdoc */ public function setShareTime(\DateTime $shareTime) { $this->shareTime = $shareTime; return $this; } /** * @inheritdoc */ public function getShareTime() { return $this->shareTime; } /** * @inheritdoc */ public function setMailSend($mailSend) { $this->mailSend = $mailSend; return $this; } /** * @inheritdoc */ public function getMailSend() { return $this->mailSend; } /** * @inheritdoc */ public function setNodeCacheEntry(ICacheEntry $entry) { $this->nodeCacheEntry = $entry; } /** * @inheritdoc */ public function getNodeCacheEntry() { return $this->nodeCacheEntry; } public function setHideDownload(bool $hide): IShare { $this->hideDownload = $hide; return $this; } public function getHideDownload(): bool { return $this->hideDownload; } public function setReminderSent(bool $reminderSent): IShare { $this->reminderSent = $reminderSent; return $this; } public function getReminderSent(): bool { return $this->reminderSent; } }