kknongchang_2506/app/Module/Game/Services/ItemTempService.php

<?php

namespace App\Module\Game\Services;

use App\Module\Game\Dtos\ItemChangeTempDto;
use App\Module\Game\Logics\ItemTemp;
use Illuminate\Support\Facades\Log;

/**
 * 物品临时数据服务类
 *
 * 提供物品临时数据相关的服务方法，用于外部调用
 */
class ItemTempService
{
    /**
     * 获取用户的物品变更临时数据
     *
     * @param int $userId 用户ID
     * @return ItemChangeTempDto[] 用户的物品变更数据
     */
    public function getUserItemChanges(int $userId): array
    {
        try {
            return ItemTemp::getUserItemChanges($userId);
        } catch (\Exception $e) {
            Log::error('获取用户物品变更临时数据失败', [
                'error' => $e->getMessage(),
                'user_id' => $userId,
            ]);
            return [];
        }
    }

    /**
     * 获取用户特定物品的变更临时数据
     *
     * @param int $userId 用户ID
     * @param int $itemId 物品ID
     * @return ItemChangeTempDto|null 物品变更数据，不存在时返回null
     */
    public function getUserItemChange(int $userId, int $itemId): ?ItemChangeTempDto
    {
        try {
            return ItemTemp::getUserItemChange($userId, $itemId);
        } catch (\Exception $e) {
            Log::error('获取用户特定物品变更临时数据失败', [
                'error' => $e->getMessage(),
                'user_id' => $userId,
                'item_id' => $itemId,
            ]);
            return null;
        }
    }

    /**
     * 清除用户的物品变更临时数据
     *
     * @param int $userId 用户ID
     * @return bool 操作是否成功
     */
    public function clearUserItemChanges(int $userId): bool
    {
        try {
            ItemTemp::clearUserItemChanges($userId);
            return true;
        } catch (\Exception $e) {
            Log::error('清除用户物品变更临时数据失败', [
                'error' => $e->getMessage(),
                'user_id' => $userId,
            ]);
            return false;
        }
    }
}