class.ilDatabaseUpdateStepsMetricsCollectedObjective.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\Setup\Metrics\CollectedObjective;
use ILIAS\Setup\Environment;
use ILIAS\Setup\Metrics\Metric;
use ILIAS\Setup\Metrics\Storage;
 
class ilDatabaseUpdateStepsMetricsCollectedObjective extends CollectedObjective
{
    public const STEP_METHOD_PREFIX = "step_";
 
    protected string $step_class;
 
    public function __construct(Storage $storage, ilDatabaseUpdateSteps $steps)
    {
        parent::__construct($storage);
        $this->step_class = $steps::class;
    }
 
    protected function collectFrom(Environment $environment, Storage $storage): void
    {
        $execution_log = $environment->getResource(ilDatabaseUpdateStepExecutionLog::class);
        $step_reader = $environment->getResource(ilDBStepReader::class);
 
        $version = new Metric(
            Metric::STABILITY_STABLE,
            Metric::TYPE_TEXT,
            (string) ($execution_log->getLastFinishedStep($this->step_class))
        );
 
        $available_version = new Metric(
            Metric::STABILITY_STABLE,
            Metric::TYPE_TEXT,
            (string) $step_reader->getLatestStepNumber($this->step_class, self::STEP_METHOD_PREFIX)
        );
 
        $update_required = new Metric(
            Metric::STABILITY_STABLE,
            Metric::TYPE_BOOL,
            $execution_log->getLastFinishedStep($this->step_class) !== $step_reader->getLatestStepNumber(
                $this->step_class,
                self::STEP_METHOD_PREFIX
            )
        );
 
        $collection = new Metric(
            Metric::STABILITY_STABLE,
            Metric::TYPE_COLLECTION,
            [
                "version" => $version,
                "available_version" => $available_version,
                "update_required" => $update_required
            ]
        );
 
        $storage->store($this->step_class, $collection);
    }
 
    protected function getTentativePreconditions(Environment $environment): array
    {
        return [
            new ilDatabaseInitializedObjective(),
            new ilDBStepExecutionDBExistsObjective(),
            new ilDBStepReaderExistsObjective()
        ];
    }
 
    #[\Override]
    public function getHash(): string
    {
        return hash("sha256", static::class . $this->step_class);
    }
 
    #[\Override]
    public function getLabel(): string
    {
        return "Status of database update steps in " . $this->step_class;
    }
}