Aesir Architecture 快速开始¶

using Runestone.AesirArchitecture;

// [InternalContext]:标记为框架内部用途,使其不出现在用户工作流的 Context 选择器中
//(如 AesirModules Binder 的「Context 类型」下拉)。业务项目通常**不加**该标记。
public class CounterContext : AbstractContext<CounterContext>
{
    protected override void Configure()
    {
        // 第一课按具体类注册(无接口抽象)
        RegisterModel(new CounterModel());
    }
}

[Serializable]
public sealed class CounterModel : AbstractModel
{
    // 私有字段 + 只读属性暴露可写 ObservableValue(快捷档 View 可直改,封装不倒退)
    [SerializeField] ObservableValue<int> count = new ObservableValue<int>(0);

    public ObservableValue<int> Count => count;
}

public class CounterPanel : MonoViewController<CounterContext>
{
    [SerializeField] Text countText;
    [SerializeField] Button increaseButton;

    CounterModel _model;

    void Start()
    {
        // GetModel 缓存为字段,避免每次字典查找
        _model = this.GetModel<CounterModel>();
        // AddListenerAndInvoke:订阅并立即触发一次(拿到当前值);物体销毁自动退订
        _model.Count.AddListenerAndInvoke(UpdateCountText)
            .RemoveListenerWhenGameObjectOnDestroyed(gameObject);
    }

    void OnEnable() => increaseButton.onClick.AddListener(Increase);
    void OnDisable() => increaseButton.onClick.RemoveListener(Increase);

    // 快捷档特有写法:View 兼 Controller 直改 ObservableValue
    void Increase() => _model.Count.Value++;

    public void UpdateCountText(int count) => countText.text = count.ToString();
}

public interface ICounterModel : IModel
{
    IReadOnlyObservableValue<int> Count { get; }
    void Increase();
    void Decrease();
}

public sealed class CounterModel : AbstractModel, ICounterModel
{
    [SerializeField] ObservableValue<int> count = new ObservableValue<int>(0);

    public IReadOnlyObservableValue<int> Count => count;
    public void Increase() => count.Value++;
    public void Decrease() => count.Value--;

    protected override void OnInitialize() { }
}

// 严格档:按接口注册(Register 与 Get 类型参数必须一致)
RegisterModel<ICounterModel>(new CounterModel());

// 严格档的 View 改用 MonoView<T>(仅只读能力)并按业务窄接口持有纯 C# Controller
public class UICounterPanel : MonoView<CounterContext>
{
    [SerializeField] Text countText;
    [SerializeField] Button increaseButton;

    ICounterModel _model;
    CounterController _ctrl;

    void Start()
    {
        _model = this.GetModel<ICounterModel>();
        _model.Count.AddListenerAndInvoke(UpdateCountText)
            .RemoveListenerWhenGameObjectOnDestroyed(gameObject);
        _ctrl = new CounterController();
    }

    void OnEnable() => increaseButton.onClick.AddListener(_ctrl.Increase);
    void OnDisable() => increaseButton.onClick.RemoveListener(_ctrl.Increase);

    public void UpdateCountText(int count) => countText.text = count.ToString();
}

// 定义命令(写操作)
public class AddScoreCommand : AbstractCommand
{
    protected override void OnExecute()
    {
        var model = this.GetModel<IScoreModel>();
        model.AddScore(10);
    }
}

// Controller 中执行
this.ExecuteCommand<AddScoreCommand>();