class.assAnswerMatchingTerm.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\FromNormalized;
use ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\ToNormalized;
use ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations;
use ILIAS\TestQuestionPool\ExportImport\Normalize\Envelopes\QuestionImage;
 
class assAnswerMatchingTerm implements ToNormalized, FromNormalized
{
    protected string $text;
    protected string $picture;
    protected int $identifier;
 
    public function __construct(string $text = "", string $picture = "", int $identifier = 0)
    {
        $this->text = $text;
        $this->picture = $picture;
 
        $this->identifier = ($identifier !== 0) ? $identifier : $this->createIdentifier();
    }
 
    protected function createIdentifier(): int
    {
        $id = random_int(1, 100000);
        return $id;
    }
 
    public function getText(): string
    {
        return $this->text;
    }
    public function withText(string $text): self
    {
        $clone = clone $this;
        $clone->text = $text;
        return $clone;
    }
 
    public function getPicture(): string
    {
        return $this->picture;
    }
    public function withPicture(string $picture): self
    {
        $clone = clone $this;
        $clone->picture = $picture;
        return $clone;
    }
 
    public function getIdentifier(): int
    {
        return $this->identifier;
    }
    public function withIdentifier(int $identifier): self
    {
        $clone = clone $this;
        $clone->identifier = $identifier;
        return $clone;
    }
 
    #[\Override]
    public function toNormalized(
        Transformations $transformations,
        array $context = []
    ): array|float|bool|int|string|null
    {
        return [
            'text' => $this->text,
            'picture' => $this->picture
                ? $transformations->normalize(new QuestionImage($this->picture, $context['question_id'] ?? null))
                : null,
            'identifier' => $this->identifier,
        ];
    }
 
    #[\Override]
    public function fromNormalized(
        array $normalized,
        Transformations $transformations
    ): self
    {
        return $this->withText($transformations->string($normalized['text']))
            ->withPicture($transformations->denormalize($normalized['picture'], QuestionImage::class)?->getFilename() ?? '')
            ->withIdentifier($transformations->int($normalized['identifier']));
    }
}