nextcloud / circles

	 * @return Circle

	 * @throws CircleDoesNotExistException

	 */

	public function forceGetCircle($circleId) {

		$qb = $this->getCirclesSelectSql();

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

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		if ($data === false || $data === null) {

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

		}

		$entry = $this->parseCirclesSelectSql($data);

		return $entry;

	}

	/**

	 * @throws CircleDoesNotExistException

	 */

	// TODO: Filters data

	public function getCircle($circleId, $userId) {

		$qb = $this->getCirclesSelectSql();

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

		$this->leftJoinUserIdAsViewer($qb, $userId);

//		$this->leftjoinOwner($qb);

//		$this->buildWithMemberLevel($qb, 'u.level', $level);

//		$this->buildWithCircleId($qb, 'c.id', $circleId);

//		$this->buildWithOrXTypes($qb, $userId, $type, $name, $circleId);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		if ($data === false || $data === null) {

			throw new CircleDoesNotExistException(

				$this->l10n->t('Circle not found')

			);

		}

		$circle = $this->parseCirclesSelectSql($data);

//		if ($circle->getUser()->getLevel)

		return $circle;

	}

	/**

	 * @return FederatedLink

	 * @throws FederatedLinkDoesNotExistException

	 */

	public function getLinkFromToken($token, $uniqueId) {

		$qb = $this->getLinksSelectSql();

		$this->limitToUniqueId($qb, (string)$uniqueId);

		$this->limitToToken($qb, (string)$token);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		if ($data === false || $data === null) {

			throw new FederatedLinkDoesNotExistException(

				$this->l10n->t('Federated Link not found')

			);

		}

		$entry = $this->parseLinksSelectSql($data);

		$cursor->closeCursor();

		return $entry;

	}

	/**

	 * @return FederatedLink

	 * @throws FederatedLinkDoesNotExistException

	 */

	public function getLinkFromId($linkId) {

		$qb = $this->getLinksSelectSql();

		$this->limitToId($qb, (string)$linkId);

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		$cursor->closeCursor();

		if ($data === false || $data === null) {

			throw new FederatedLinkDoesNotExistException(

				$this->l10n->t('Federated Link not found')

			);

		}

		$entry = $this->parseLinksSelectSql($data);

		return $entry;

	}

	/**

	 * @return Member

	 * @throws MemberDoesNotExistException

	 */

	public function forceGetGroup($circleId, $groupId) {

		$qb = $this->getGroupsSelectSql();

		$this->limitToGroupId($qb, $groupId);

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

		$cursor = $qb->execute();

		$data = $cursor->fetch();

		if ($data === false) {

			throw new MemberDoesNotExistException($this->l10n->t('This member does not exist'));

		}

		$group = Member::fromArray($this->l10n, $data);

		$cursor->closeCursor();

		return $group;

	}

	// TODO - returns data of a group from a Viewer POV