nextcloud / circles

	 * @return FederatedLink

	 * @throws FederatedLinkDoesNotExistException

	 */

	public function getLinkFromCircle($circleUniqueId, $linkUniqueId) {

		$qb = $this->getLinksSelectSql();

		$this->limitToCircleId($qb, $circleUniqueId);

		$this->limitToUniqueId($qb, $linkUniqueId);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		$cursor->closeCursor();

		if ($data === false) {

			throw new FederatedLinkDoesNotExistException($this->l10n->t('Federated link not found'));

		}

		return $this->parseLinksSelectSql($data);

	}

	/**

	 * @return SharingFrame

	 * @throws SharingFrameDoesNotExistException

	 */

	public function getSharingFrame($circleUniqueId, $frameUniqueId) {

		$qb = $this->getSharesSelectSql();

		$this->limitToUniqueId($qb, $frameUniqueId);

		$this->limitToCircleId($qb, $circleUniqueId);

		$this->leftJoinCircle($qb);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		$cursor->closeCursor();

		if ($data === false) {

			throw new SharingFrameDoesNotExistException($this->l10n->t('Sharing Frame does not exist'));

		}

		return $this->parseSharesSelectSql($data);

	}

	/**

	 * @return SharesToken

	 * @throws TokenDoesNotExistException

	 */

	public function getTokenFromMember(string $shareId, string $circleId, string $email) {

		$qb = $this->getTokensSelectSql();

		$this->limitToShareId($qb, $shareId);

		$this->limitToUserId($qb, $email);

		$this->limitToCircleId($qb, $circleId);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		$cursor->closeCursor();

		if ($data === false) {

			throw new TokenDoesNotExistException('Unknown share token');

		}

		return $this->parseTokensSelectSql($data);

	}

	/**

	 * @return DeprecatedCircle

	 * @throws CircleDoesNotExistException

	 */

	public function getFromContactGroup(int $addressBookId, string $group): DeprecatedCircle {

		$qb = $this->getCirclesSelectSql();

		$this->limitToAddressBookId($qb, $addressBookId);

		$this->limitToContactGroup($qb, $group);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		$cursor->closeCursor();

		if ($data === false) {

			throw new CircleDoesNotExistException($this->l10n->t('Circle not found'));

		}

		return $this->parseCirclesSelectSql($data);

	}

}