first commit

lib/pkp/classes/submission/ReviewFilesDAO.php

@@ -0,0 +1,98 @@
+<?php
+
+/**
+ * @file classes/submission/ReviewFilesDAO.php
+ *
+ * Copyright (c) 2014-2021 Simon Fraser University
+ * Copyright (c) 2003-2021 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class ReviewFilesDAO
+ *
+ * @ingroup submission
+ *
+ * @brief Operations for managing review round / submission file associations.
+ * These control which files are available for download by reviewers during review.
+ */
+
+namespace PKP\submission;
+
+use Illuminate\Support\Facades\DB;
+
+class ReviewFilesDAO extends \PKP\db\DAO
+{
+    /**
+     * Grant a review file to a review.
+     *
+     * @param int $reviewId Review assignment ID
+     * @param int $submissionFileId Submission file ID
+     */
+    public function grant($reviewId, $submissionFileId)
+    {
+        $this->update(
+            'INSERT INTO review_files
+			(review_id, submission_file_id)
+			VALUES
+			(?, ?)',
+            [(int) $reviewId, (int) $submissionFileId]
+        );
+    }
+
+    /**
+     * Revoke a review's association with a review file.
+     *
+     * @param int $reviewId Review assignment ID.
+     * @param int $fileId Review file ID.
+     */
+    public function revoke($reviewId, $fileId)
+    {
+        $this->update(
+            'DELETE FROM review_files WHERE review_id = ? AND file_id = ?',
+            [(int) $reviewId, (int) $fileId]
+        );
+    }
+
+    /**
+     * Revoke a review's association with all submission files.
+     *
+     * @param int $reviewId Review assignment ID.
+     */
+    public function revokeByReviewId($reviewId)
+    {
+        $this->update(
+            'DELETE FROM review_files WHERE review_id = ?',
+            [(int) $reviewId]
+        );
+    }
+
+    /**
+     * Revoke a review's association based on submission file id.
+     */
+    public function revokeBySubmissionFileId(int $submissionFileId)
+    {
+        $this->update(
+            'DELETE FROM review_files WHERE submission_file_id = ?',
+            [(int) $submissionFileId]
+        );
+    }
+
+    /**
+     * Check review file availability
+     *
+     * @param int $reviewId
+     * @param int $submissionFileId
+     *
+     * @return bool
+     */
+    public function check($reviewId, $submissionFileId)
+    {
+        return DB::table('review_files')
+            ->where('review_id', (int) $reviewId)
+            ->where('submission_file_id', (int) $submissionFileId)
+            ->exists();
+    }
+}
+
+if (!PKP_STRICT_MODE) {
+    class_alias('\PKP\submission\ReviewFilesDAO', '\ReviewFilesDAO');
+}