mirror of https://github.com/GeWuYou/GFramework.git synced 2026-03-24 20:34:29 +08:00

GeWuYou 6cc0ddf7f9 docs: 更新文档中的代码示例和链接引用

- 修复 IEventHandler 接口中的参数关键字冲突
- 修正场景管理器接口中的泛型约束拼写错误
- 本地化核心抽象文档链接为中文标题
- 更新事件系统文档中的接口链接路径
- 修复扩展方法文档中的上下文感知链接
- 调整日志系统文档中的接口链接路径
- 重构架构概述中的代码示例和设计原则
- 统一 Godot 设置模块中的代码块格式
- 优化音频和图形设置的代码示例

2026-02-11 14:49:34 +08:00

2.7 KiB

Raw Blame History

Core Abstractions

GFramework.Core.Abstractions 核心抽象接口定义

概述

GFramework.Core.Abstractions 包含了框架的所有核心接口定义，这些接口定义了组件之间的契约，实现了依赖倒置和面向接口编程。

核心接口

IArchitecture

应用程序架构接口：

public interface IArchitecture
{
    void Initialize();
    void Destroy();
    
    T GetModel<T>() where T : IModel;
    T GetSystem<T>() where T : ISystem;
    T GetUtility<T>() where T : IUtility;
    
    void RegisterModel(IModel model);
    void RegisterSystem(ISystem system);
    void RegisterUtility(IUtility utility);
}

IModel

数据模型接口：

public interface IModel
{
    void Init();
    void Dispose();
    
    IArchitecture Architecture { get; }
}

ISystem

业务逻辑系统接口：

public interface ISystem
{
    void Init();
    void Dispose();
    
    IArchitecture Architecture { get; }
}

IController

控制器接口：

public interface IController : IBelongToArchitecture
{
    void Init();
    void Dispose();
}

IUtility

工具类接口：

public interface IUtility
{
}

事件接口

IEvent

事件基接口：

public interface IEvent
{
}

IEventHandler

事件处理器接口：

public interface IEventHandler<TEvent> where TEvent : IEvent
{
    void Handle(TEvent @event);
}

命令查询接口

ICommand

命令接口：

public interface ICommand
{
    void Execute();
}

IQuery

查询接口：

public interface IQuery<TResult>
{
    TResult Execute();
}

依赖注入接口

IIocContainer

IOC 容器接口：

public interface IIocContainer
{
    void Register<TInterface, TImplementation>() where TImplementation : TInterface;
    void Register<TInterface>(TInterface instance);
    TInterface Resolve<TInterface>();
    bool IsRegistered<TInterface>();
}

生命周期接口

ILifecycle

组件生命周期接口：

public interface ILifecycle
{
    void OnInit();
    void OnDestroy();
}

使用示例

通过接口实现依赖注入

public class MyService : IMyService
{
    private readonly IArchitecture _architecture;
    
    public MyService(IArchitecture architecture)
    {
        _architecture = architecture;
    }
}

自定义事件

public class PlayerDiedEvent : IEvent
{
    public int PlayerId { get; set; }
    public Vector2 Position { get; set; }
}

相关文档：

2.7 KiB Raw Blame History Unescape Escape