深入理解与实践：APIATO Porto 架构中的类覆盖策略

// 原始第三方库类 (Vendor/Package/OriginalService.php)
namespace Vendor\Package;

class OriginalService
{
    public function processData(array $data): array
    {
        // 原始的数据处理逻辑
        echo "Original processing: " . json_encode($data) . "\n";
        return array_map('strtoupper', $data);
    }

    public function getVersion(): string
    {
        return "1.0.0";
    }
}

// 在你的 APIATO 容器中创建自定义类 (例如：App/Containers/MyFeature/Services/CustomService.php)
namespace App\Containers\MyFeature\Services;

use Vendor\Package\OriginalService; // 引入原始类

class CustomService extends OriginalService
{
    /**
     * 重写 processData 方法，添加自定义逻辑
     */
    public function processData(array $data): array
    {
        // 可以在调用父类方法之前或之后添加自定义逻辑
        echo "Custom pre-processing for: " . json_encode($data) . "\n";

        // 调用父类的原始逻辑
        $processedData = parent::processData($data);

        // 添加自定义的后处理逻辑
        $customProcessedData = array_map(function($item) {
            return $item . '_CUSTOM';
        }, $processedData);

        echo "Custom post-processing: " . json_encode($customProcessedData) . "\n";
        return $customProcessedData;
    }

    /**
     * 也可以添加全新的方法
     */
    public function getCustomConfig(): array
    {
        return ['api_key' => 'YOUR_CUSTOM_KEY'];
    }
}

// 原始第三方库接口 (Vendor/Package/ServiceInterface.php)
namespace Vendor\Package;

interface ServiceInterface
{
    public function executeAction(string $param): string;
    public function getStatus(): string;
}

// 在你的 APIATO 容器中创建自定义实现类 (例如：App/Containers/MyFeature/Services/CustomServiceImplementation.php)
namespace App\Containers\MyFeature\Services;

use Vendor\Package\ServiceInterface; // 引入原始接口

class CustomServiceImplementation implements ServiceInterface
{
    public function executeAction(string $param): string
    {
        // 完全自定义的执行逻辑
        return "Custom action executed with: " . $param . " at " . date('Y-m-d H:i:s');
    }

    public function getStatus(): string
    {
        return "Custom Service is Active";
    }
}

// 在你的 APIATO 容器中创建服务提供者 (例如：App/Containers/MyFeature/Providers/MyFeatureServiceProvider.php)
namespace App\Containers\MyFeature\Providers;

use App\Containers\MyFeature\Services\CustomService;
use App\Containers\MyFeature\Services\CustomServiceImplementation;
use App\Ship\Parents\Providers\MainServiceProvider as ParentServiceProvider; // APIATO 的父级服务提供者
use Vendor\Package\OriginalService; // 引入原始类
use Vendor\Package\ServiceInterface; // 引入原始接口

class MyFeatureServiceProvider extends ParentServiceProvider
{
    /**
     * 注册所有服务绑定
     */
    public function register(): void
    {
        parent::register();

        // 绑定策略一：继承重写
        // 当应用请求 Vendor\Package\OriginalService 时，实际会提供 App\Containers\MyFeature\Services\CustomService 实例
        $this->app->bind(OriginalService::class, CustomService::class);

        // 绑定策略二：接口实现
        // 当应用请求 Vendor\Package\ServiceInterface 时，实际会提供 App\Containers\MyFeature\Services\CustomServiceImplementation 实例
        $this->app->singleton(ServiceInterface::class, CustomServiceImplementation::class); // 使用 singleton 如果服务是单例
    }
}

// app/Containers/MyFeature/Providers/ContainerServiceProvider.php (示例)
namespace App\Containers\MyFeature\Providers;

use App\Ship\Parents\Providers\ContainerServiceProvider as ParentContainerServiceProvider;

class ContainerServiceProvider extends ParentContainerServiceProvider
{
    public array $serviceProviders = [
        // ... 其他服务提供者
        MyFeatureServiceProvider::class, // 注册你的自定义服务提供者
    ];

    // ... 其他方法
}