此外/无障碍/异步/请求后重置状态

异步请求的状态重置

HLEB2框架提供执行异步请求的能力，这对代码提出了额外的要求。其中一个主要要求是在请求完成时消除存储的状态。

存储的状态可以包括当前用户数据、请求数据缓存、各种形式的备忘化等。

在编程中，备忘化是一种优化方法，使已经计算过的数据可重用。该方法涉及缓存类方法的输出，并强制方法检查所需的计算是否已在缓存中，然后才进行计算。

需要确定哪些存储的状态与请求数据有关，哪些与整个应用程序的运行有关。例如，一般费率信息的计算状态不会从请求到请求改变，但每个用户选择的费率需要重置。在异步请求时，下一请求可能属于不同用户，因此重要的是清除前一个用户的信息。

现代编程实践不推荐使用存储为类静态属性的状态，但它通常很方便，只有在过渡到异步模式时才需关心这一点。
为了方便这一转变，HLEB2框架提供了一个特殊的接口RollbackInterface，拥有一个静态方法rollback。

例如，有一个存储的状态包含当前用户数据（简化代码）：

class Example
{
    private static ?User $currentUser = null;

    public function set(User $user): void
    {
        self::$currentUser = $user;
    }
}

为了重置状态，添加了接口RollbackInterface并实现了方法rollback：

class Example implements \Hleb\Base\RollbackInterface
{
    private static ?User $currentUser = null;

    public function set(User $user): void
    {
        self::$currentUser = $user;
    }

    #[\Override]
    public static function rollback(): void
    {
        self::$currentUser = null;
    }
}

现在，在异步请求完成时，框架会检查类是否具有接口RollbackInterface并执行重置方法rollback。需要注意的是，用于重置状态的方法必须是幂等的，而且别无其他。也就是说，重复执行时，应用的结果不会改变。

从下面这个更复杂的示例中可以看出幂等性的必要性，其中接口用于继承（重置方法可能被调用两次）：

class Example implements \Hleb\Base\RollbackInterface
{
    private static ?User $currentUser = null;

    #[\Override]
    public static function rollback(): void
    {
        self::$currentUser = null;
    }
}

class ChildExample extends Example
{
    /** @param User[] */
    private static array $currentUserFriends = [];

    #[\Override]
    public static function rollback(): void
    {
        parent::rollback();
        self::$currentUserFriends = [];
    }
}

如果需要在完成异步请求后执行任何与特定类中的状态重置无关的操作，可以将其添加到App\Bootstrap\ContainerFactory类的rollback方法中。

页面翻译：chatgpt 4-o

PHP Framework HLEB2

HLEB2

异步请求的状态重置