Define API endpoint for printing as a team

This endpoint can be used for `printfile` CLI submit tools, when
printing via DOMjudge has been configured.

Author: Kevinjil

webapp/src/Controller/API/PrintController.php

@@ -0,0 +1,127 @@
+<?php declare(strict_types=1);
+
+namespace App\Controller\API;
+
+use App\DataTransferObject\PrintTeam;
+use App\Service\DOMJudgeService;
+use Doctrine\ORM\EntityManagerInterface;
+use FOS\RestBundle\Controller\AbstractFOSRestController;
+use FOS\RestBundle\Controller\Annotations as Rest;
+use Nelmio\ApiDocBundle\Annotation\Model;
+use OpenApi\Attributes as OA;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+use App\Entity\Language;
+
+#[Route(path: "/printing")]
+#[OA\Tag(name: "Printing")]
+#[OA\Response(ref: "#/components/responses/Unauthenticated", response: 401)]
+#[OA\Response(ref: "#/components/responses/Unauthorized", response: 403)]
+class PrintController extends AbstractFOSRestController
+{
+    public function __construct(
+        protected readonly EntityManagerInterface $em,
+        protected readonly DOMJudgeService $dj,
+        protected readonly LoggerInterface $logger
+    ) {
+    }
+
+    /**
+     * Send a file to the system printer as a team.
+     * @return JsonResponse
+     */
+    #[IsGranted("ROLE_TEAM")]
+    #[Rest\Post("/team")]
+    #[OA\Tag(name: "Printing")]
+    #[OA\RequestBody(
+        required: true,
+        content: new OA\JsonContent(ref: new Model(type: PrintTeam::class))
+    )]
+    #[OA\Response(
+        response: 200,
+        description: "Returns the ID of the imported problem and any messages produced",
+        content: new OA\JsonContent(
+            properties: [
+                new OA\Property(
+                    property: "success",
+                    description: "Whether printing was successful",
+                    type: "boolean"
+                ),
+                new OA\Property(
+                    property: "output",
+                    description: "The print command output",
+                    type: "string"
+                ),
+            ],
+            type: "object"
+        )
+    )]
+    #[OA\Response(
+        response: 422,
+        description: "An error occurred while processing the print job",
+        content: new OA\JsonContent(
+            properties: [
+                new OA\Property(property: "errors", type: "object"),
+            ]
+        )
+    )]
+    public function printAsTeam(
+        #[MapRequestPayload(validationFailedStatusCode: Response::HTTP_BAD_REQUEST)]
+        PrintTeam $print,
+        Request $request
+    ): JsonResponse {
+        /** @var array<string,string> error messages */
+        $errors = [];
+
+        $langid = $this->em
+            ->createQueryBuilder()
+            ->from(Language::class, "l")
+            ->select("l.langid")
+            ->andWhere("l.allowSubmit = 1")
+            ->andWhere("l.name = :name")
+            ->setParameter("name", $print->language)
+            ->getQuery()
+            ->getScalarResult();
+        if (empty($langid)) {
+            $errors[] = "Programming language not found";
+        }
+
+        if (!($tempFilename = tempnam($this->dj->getDomjudgeTmpDir(), "printfile-"))) {
+            throw new ServiceUnavailableHttpException(null, "Could not create temporary file.");
+        }
+
+        if (file_put_contents($tempFilename, base64_decode($print->fileContents)) === false) {
+            throw new ServiceUnavailableHttpException(
+                null,
+                sprintf("Could not write printfile to temporary file '%s'.", $tempFilename)
+            );
+        }
+
+        // Handle validation errors
+        if (!empty($errors)) {
+            unlink($tempFilename);
+            return new JsonResponse(
+                ["errors" => $errors],
+                Response::HTTP_UNPROCESSABLE_ENTITY
+            );
+        }
+
+        $ret = $this->dj->printUserFile($tempFilename, $print->originalName, "c", true);
+        unlink($tempFilename);
+
+        $status = Response::HTTP_OK;
+        if (!$ret[0]) {
+            $status = Response::HTTP_SERVICE_UNAVAILABLE;
+        }
+        return new JsonResponse(
+            ["success" => $ret[0], "output" => $ret[1]],
+            $status
+        );
+    }
+}

webapp/src/DataTransferObject/PrintTeam.php

@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject;
+
+use JMS\Serializer\Annotation as Serializer;
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(required: ['name'])]
+class PrintTeam
+{
+    public function __construct(
+        #[OA\Property(description: 'The original name of the file')]
+        public readonly string $originalName,
+        #[OA\Property(description: 'The programming language of the file contents')]
+        public readonly string $language,
+        #[OA\Property(description: 'The (base64-encoded) contents of the source file', format: 'binary')]
+        public readonly string $fileContents,
+    ) {}
+}