kknongchang_2506/app/Module/OpenAPI/Controllers/ApiController.php

<?php

namespace App\Module\OpenAPI\Controllers;

use App\Module\OpenAPI\Contracts\HandlerInterface;
use App\Module\OpenAPI\Handlers\User\UserInfoHandler;
use App\Module\OpenAPI\Handlers\User\UserListHandler;
use App\Module\OpenAPI\Handlers\Game\GameStatsHandler;
use App\Module\OpenAPI\Handlers\Fund\FundBalanceHandler;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Routing\Controller;
use Illuminate\Routing\Middleware\SubstituteBindings;
use Illuminate\Routing\Attributes\Middleware;
use Illuminate\Routing\Attributes\Prefix;

/**
 * OpenAPI业务接口控制器
 * 
 * 使用Handler机制处理具体的业务逻辑
 */
#[Prefix('api/openapi')]
#[Middleware(['api', 'openapi'])]
class ApiController extends Controller
{
    /**
     * 获取用户信息
     *
     * @param Request $request
     * @param UserInfoHandler $handler
     * @return JsonResponse
     */
    #[Middleware('openapi.scope:USER_READ')]
    public function getUserInfo(Request $request, UserInfoHandler $handler): JsonResponse
    {
        return $this->handleRequest($request, $handler);
    }

    /**
     * 获取用户列表
     *
     * @param Request $request
     * @param UserListHandler $handler
     * @return JsonResponse
     */
    #[Middleware('openapi.scope:USER_READ')]
    public function getUserList(Request $request, UserListHandler $handler): JsonResponse
    {
        return $this->handleRequest($request, $handler);
    }

    /**
     * 获取游戏统计
     *
     * @param Request $request
     * @param GameStatsHandler $handler
     * @return JsonResponse
     */
    #[Middleware('openapi.scope:GAME_READ')]
    public function getGameStats(Request $request, GameStatsHandler $handler): JsonResponse
    {
        return $this->handleRequest($request, $handler);
    }

    /**
     * 获取资金余额
     *
     * @param Request $request
     * @param FundBalanceHandler $handler
     * @return JsonResponse
     */
    #[Middleware('openapi.scope:FUND_READ')]
    public function getFundBalance(Request $request, FundBalanceHandler $handler): JsonResponse
    {
        return $this->handleRequest($request, $handler);
    }

    /**
     * 通用请求处理方法
     *
     * @param Request $request
     * @param HandlerInterface $handler
     * @return JsonResponse
     */
    protected function handleRequest(Request $request, HandlerInterface $handler): JsonResponse
    {
        try {
            // 准备请求数据
            $data = array_merge(
                $request->all(),
                $request->route()->parameters()
            );

            // 准备上下文信息
            $context = [
                'app' => $request->attributes->get('openapi_app'),
                'user_id' => $request->attributes->get('user_id', 0),
                'ip' => $request->ip(),
                'user_agent' => $request->userAgent(),
                'request_id' => $request->header('X-Request-ID', uniqid()),
            ];

            // 调用Handler处理请求
            return $handler->handle($data, $context);

        } catch (\Exception $e) {
            return response()->json([
                'success' => false,
                'message' => '请求处理失败',
                'error' => $e->getMessage(),
            ], 500);
        }
    }
}