src/Symfony/Component/Messenger/Handler/Acknowledger.php - 8.2 - githubmirror/symfony

src/Symfony/Component/Messenger/Handler/Acknowledger.php

86 строк2 KB

Nicolas Grekas

[Messenger] Make $clock nullable in PostgreSqlNotifyOnIdleListener

04 мар 2026, 17:29

04 мар 2026, 17:2952e6cd3

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Messenger\Handler;

use Symfony\Component\Clock\Clock;
use Symfony\Component\Clock\ClockInterface;
use Symfony\Component\Messenger\Exception\LogicException;

/**
 * @author Nicolas Grekas <p@tchwork.com>
 */
class Acknowledger
{
    public readonly ClockInterface $clock;

    private ?\Closure $ack;
    private \Throwable|false|null $error = null;
    private mixed $result = null;

    /**
     * @param \Closure(\Throwable|null, mixed):void|null $ack
     */
    public function __construct(
        private string $handlerClass,
        ?\Closure $ack = null,
        ?ClockInterface $clock = null,
    ) {
        $this->clock = $clock ?? Clock::get();
        $this->ack = $ack ?? static function () {};
    }

    /**
     * @param mixed $result
     */
    public function ack($result = null): void
    {
        $this->doAck(null, $result);
    }

    public function nack(\Throwable $error): void
    {
        $this->doAck($error);
    }

    public function getError(): ?\Throwable
    {
        return $this->error ?: null;
    }

    public function getResult(): mixed
    {
        return $this->result;
    }

    public function isAcknowledged(): bool
    {
        return null === $this->ack;
    }

    public function __destruct()
    {
        if (null !== $this->ack) {
            throw new LogicException(\sprintf('The acknowledger was not called by the "%s" batch handler.', $this->handlerClass));
        }
    }

    private function doAck(?\Throwable $e = null, mixed $result = null): void
    {
        if (!($ack = $this->ack) || (null !== $this->error && (false !== $this->error || null === $e))) {
            throw new LogicException(\sprintf('The acknowledger cannot be called twice by the "%s" batch handler.', $this->handlerClass));
        }
        $this->error = $e ?: false;
        $this->result = $result;
        $ack($e, $result);
        $this->ack = null;
    }
}