. // }}} namespace Component\Subscription\Entity; use App\Core\Entity; use App\Entity\Actor; use App\Entity\LocalUser; use Component\Group\Entity\LocalGroup; use DateTimeInterface; /** * Entity for subscription * * @category DB * @package GNUsocial * * @author Zach Copley * @copyright 2010 StatusNet Inc. * @author Mikael Nordfeldth * @copyright 2009-2014 Free Software Foundation, Inc http://www.fsf.org * @author Hugo Sales * @copyright 2020-2021 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ class ActorSubscription extends Entity { // {{{ Autocode // @codeCoverageIgnoreStart private int $subscriber_id; private int $subscribed_id; private DateTimeInterface $created; private DateTimeInterface $modified; public function setSubscriberId(int $subscriber_id): self { $this->subscriber_id = $subscriber_id; return $this; } public function getSubscriberId(): int { return $this->subscriber_id; } public function setSubscribedId(int $subscribed_id): self { $this->subscribed_id = $subscribed_id; return $this; } public function getSubscribedId(): int { return $this->subscribed_id; } public function setCreated(DateTimeInterface $created): self { $this->created = $created; return $this; } public function getCreated(): DateTimeInterface { return $this->created; } public function setModified(DateTimeInterface $modified): self { $this->modified = $modified; return $this; } public function getModified(): DateTimeInterface { return $this->modified; } // @codeCoverageIgnoreEnd // }}} Autocode public function getSubscriber(): Actor { return Actor::getById($this->getSubscriberId()); } public function getSubscribed(): Actor { return Actor::getById($this->getSubscribedId()); } public static function cacheKeys(LocalUser|LocalGroup|Actor $subject, LocalUser|LocalGroup|Actor $target): array { return [ 'subscribed' => "subscription-{$subject->getId()}-{$target->getId()}", ]; } /** * @see Entity->getNotificationTargetIds */ public function getNotificationTargetIds(array $ids_already_known = [], ?int $sender_id = null, bool $include_additional = true): array { if (!\array_key_exists('object', $ids_already_known)) { $target_ids = [$this->getSubscribedId()]; // The object of any subscription is the one subscribed (or unsubscribed) } else { $target_ids = $ids_already_known['object']; } // Additional actors that should know about this if ($include_additional && \array_key_exists('additional', $ids_already_known)) { array_push($target_ids, ...$ids_already_known['additional']); } else { return $target_ids; } return array_unique($target_ids); } public static function schemaDef(): array { return [ 'name' => 'actor_subscription', 'fields' => [ 'subscriber_id' => ['type' => 'int', 'foreign key' => true, 'target' => 'Actor.id', 'multiplicity' => 'one to one', 'name' => 'subscription_subscriber_fkey', 'not null' => true, 'description' => 'actor listening'], 'subscribed_id' => ['type' => 'int', 'foreign key' => true, 'target' => 'Actor.id', 'multiplicity' => 'one to one', 'name' => 'subscription_subscribed_fkey', 'not null' => true, 'description' => 'actor being listened to'], 'created' => ['type' => 'datetime', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was created'], 'modified' => ['type' => 'timestamp', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was modified'], ], 'primary key' => ['subscriber_id', 'subscribed_id'], 'indexes' => [ 'subscription_subscriber_idx' => ['subscriber_id', 'created'], 'subscription_subscribed_idx' => ['subscribed_id', 'created'], ], ]; } }