Adding version validation for shadow assignments.

Author: Martin Krulis

app/V1Module/presenters/ShadowAssignmentsPresenter.php

@@ -105,6 +105,28 @@ public function actionDetail(string $id) {
     $this->sendSuccessResponse($this->shadowAssignmentViewFactory->getAssignment($assignment));
   }
 
+  public function checkValidate(string $id) {
+    $assignment = $this->shadowAssignments->findOrThrow($id);
+    if (!$this->shadowAssignmentAcl->canUpdate($assignment)) {
+      throw new ForbiddenRequestException("You cannot access this shadow assignment.");
+    }
+  }
+
+  /**
+   * Check if the version of the shadow assignment is up-to-date.
+   * @POST
+   * @Param(type="post", name="version", validation="numericint", description="Version of the shadow assignment.")
+   * @param string $id Identifier of the shadow assignment
+   * @throws ForbiddenRequestException
+   */
+  public function actionValidate($id) {
+    $assignment = $this->shadowAssignments->findOrThrow($id);
+    $version = intval($this->getHttpRequest()->getPost("version"));
+    $this->sendSuccessResponse([
+      "versionIsUpToDate" => $assignment->getVersion() === $version
+    ]);
+  }
+
   public function checkUpdateDetail(string $id) {
     $assignment = $this->shadowAssignments->findOrThrow($id);
     if (!$this->shadowAssignmentAcl->canUpdate($assignment)) {

app/V1Module/router/RouterFactory.php

@@ -455,6 +455,7 @@ private static function createShadowAssignmentsRoutes(string $prefix): RouteList
     $router[] = new PostRoute("$prefix/<id>", "ShadowAssignments:updateDetail");
     $router[] = new PostRoute("$prefix", "ShadowAssignments:create");
     $router[] = new DeleteRoute("$prefix/<id>", "ShadowAssignments:remove");
+    $router[] = new PostRoute("$prefix/<id>/validate", "ShadowAssignments:validate");
     $router[] = new GetRoute("$prefix/<id>/points", "ShadowAssignments:pointsList");
     $router[] = new PostRoute("$prefix/<id>/points", "ShadowAssignments:createPoints");
     $router[] = new GetRoute("$prefix/points/<pointsId>", "ShadowAssignments:points");