* * @author affan98 * @author John Molakvoæ (skjnldsv) * @author Jonas Rittershofer * @author Roeland Jago Douma * * @license AGPL-3.0-or-later * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * */ namespace OCA\Forms\Db; use OCP\AppFramework\Db\DoesNotExistException; use OCP\AppFramework\Db\QBMapper; use OCP\DB\QueryBuilder\IQueryBuilder; use OCP\IDBConnection; /** * @extends QBMapper */ class SubmissionMapper extends QBMapper { private $answerMapper; /** * SubmissionMapper constructor. * @param IDBConnection $db * @param AnswerMapper $answerMapper */ public function __construct(IDBConnection $db, AnswerMapper $answerMapper) { parent::__construct($db, 'forms_v2_submissions', Submission::class); $this->answerMapper = $answerMapper; } /** * @param int $formId * @throws DoesNotExistException if not found * @return Submission[] */ public function findByForm(int $formId): array { $qb = $this->db->getQueryBuilder(); $qb->select('*') ->from($this->getTableName()) ->where( $qb->expr()->eq('form_id', $qb->createNamedParameter($formId, IQueryBuilder::PARAM_INT)) ) //Newest submissions first ->orderBy('timestamp', 'DESC'); return $this->findEntities($qb); } /** * @param int $id * @return Submission * @throws \OCP\AppFramework\Db\MultipleObjectsReturnedException if more than one result * @throws \OCP\AppFramework\Db\DoesNotExistException if not found */ public function findById(int $id): Submission { $qb = $this->db->getQueryBuilder(); $qb->select('*') ->from($this->getTableName()) ->where( $qb->expr()->eq('id', $qb->createNamedParameter($id, IQueryBuilder::PARAM_INT)) ); return $this->findEntity($qb); } /** * @param int $formId * @throws DoesNotExistException if not found * @return array */ public function findParticipantsByForm(int $formId): array { $qb = $this->db->getQueryBuilder(); $qb->select('user_id') ->from($this->getTableName()) ->where( $qb->expr()->eq('form_id', $qb->createNamedParameter($formId, IQueryBuilder::PARAM_INT)) ); $submissionEntities = $this->findEntities($qb); // From array of submissionEntities produce array of userIds. $userIds = array_map(function ($submissionEntity) { return $submissionEntity->getUserId(); }, $submissionEntities); return $userIds; } /** * @throws \Exception */ public function countSubmissions(int $formId): int { $qb = $this->db->getQueryBuilder(); $qb->select($qb->func()->count('*', 'num_submissions')) ->from($this->getTableName()) ->where($qb->expr()->eq('form_id', $qb->createNamedParameter($formId, IQueryBuilder::PARAM_INT))); $result = $qb->executeQuery(); $row = $result->fetch(); $result->closeCursor(); return (int) ($row['num_submissions'] ?? 0); } /** * Delete the Submission, including answers. * @param int $id of the submission to delete */ public function deleteById(int $id): void { $qb = $this->db->getQueryBuilder(); // First delete corresponding answers. $submissionEntity = $this->findById($id); $this->answerMapper->deleteBySubmission($submissionEntity->getId()); //Delete Submission $qb->delete($this->getTableName()) ->where( $qb->expr()->eq('id', $qb->createNamedParameter($id, IQueryBuilder::PARAM_INT)) ); $qb->executeStatement(); } /** * Delete all Submissions corresponding to form, including answers. * @param int $formId */ public function deleteByForm(int $formId): void { $qb = $this->db->getQueryBuilder(); // First delete corresponding answers. $submissionEntities = $this->findByForm($formId); foreach ($submissionEntities as $submissionEntity) { $this->answerMapper->deleteBySubmission($submissionEntity->id); } //Delete Submissions $qb->delete($this->getTableName()) ->where( $qb->expr()->eq('form_id', $qb->createNamedParameter($formId, IQueryBuilder::PARAM_INT)) ); $qb->executeStatement(); } }