Zenject-2019中的装饰器绑定模式详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00945/article/details/148863223

Zenject-2019中的装饰器绑定模式详解

Zenject-2019 Dependency Injection Framework for Unity3D 项目地址: https://gitcode.com/gh_mirrors/ze/Zenject-2019

装饰器模式简介

在Zenject依赖注入框架中，装饰器绑定(Decorator Bindings)是一项强大功能，它实现了经典的设计模式——装饰器模式。这种模式允许开发者在不修改原有类结构的情况下，动态地扩展对象的功能。

装饰器模式的核心思想

装饰器模式的核心在于"包装"：通过创建一个装饰器类来包裹原始对象，在不改变原始对象接口的前提下，增加或修改其行为。这种设计特别适合以下场景：

需要动态地为对象添加功能
需要在不影响其他对象的情况下为特定对象添加功能
当继承不切实际时（如需要大量子类的情况）

游戏开发中的实际应用

让我们通过一个游戏开发的实例来理解装饰器绑定的实际应用。假设我们有一个敌人属性系统：

public interface IEnemyStats
{
    float Damage { get; }
    float Health { get; }
}

我们有两种敌人实现：兽人(Orc)和恶魔(Demon)，它们分别实现了这个接口。

基础绑定

首先，我们进行基础绑定：

public class TestInstaller : MonoInstaller<TestInstaller>
{
    public override void InstallBindings()
    {
        Container.Bind<IEnemyStats>().To<OrcStats>().AsSingle();
    }
}

添加武器升级装饰器

现在，我们想为敌人添加武器升级功能，而不修改原有类：

public class WeaponUpgradeEnemyDecorator : IEnemyStats
{
    readonly IEnemyStats _stats;

    public WeaponUpgradeEnemyDecorator(IEnemyStats stats)
    {
        _stats = stats;
    }

    public float Damage => _stats.Damage + 2;
    public float Health => _stats.Health;
}

绑定装饰器：

Container.Decorate<IEnemyStats>().With<WeaponUpgradeEnemyDecorator>();

添加护盾升级装饰器

同样地，我们可以添加护盾升级功能：

public class ShieldUpgradeEnemyDecorator : IEnemyStats
{
    readonly IEnemyStats _stats;

    public ShieldUpgradeEnemyDecorator(IEnemyStats stats)
    {
        _stats = stats;
    }

    public float Damage => _stats.Damage;
    public float Health => _stats.Health + 20;
}

绑定多个装饰器：

Container.Decorate<IEnemyStats>().With<WeaponUpgradeEnemyDecorator>();
Container.Decorate<IEnemyStats>().With<ShieldUpgradeEnemyDecorator>();

此时，装饰器的应用顺序是从内到外的：ShieldUpgradeEnemyDecorator(WeaponUpgradeEnemyDecorator(OrcStats()))

装饰器的其他应用场景

装饰器不仅限于游戏属性修改，还可以用于：

性能分析：为方法添加计时功能
日志记录：记录方法调用信息
输入验证：验证方法参数或返回值
缓存：为方法添加缓存层

例如，为游戏存档添加性能分析：

public class SaveGameProfilerDecorator : ISaveGameHandler
{
    readonly ISaveGameHandler _handler;

    public SaveGameProfilerDecorator(ISaveGameHandler handler)
    {
        _handler = handler;
    }

    public void SaveGame()
    {
        var stopwatch = Stopwatch.StartNew();
        _handler.SaveGame();
        Debug.Log($"存档耗时: {stopwatch.Elapsed.TotalSeconds:0.00}秒");
    }
}

装饰器绑定语法详解

Zenject提供了灵活的装饰器绑定语法：

Container.Decorate<ContractType>()
    .With<DecoratorType>()
    .FromConstructionMethod()
    .WithArguments(Arguments)
    .(Copy|Move)Into(All|Direct)SubContainers();

参数说明：