mirror of https://github.com/GeWuYou/GFramework.git synced 2026-03-24 04:06:48 +08:00

GeWuYou 8f847de24e docs(core): 更新架构文档并修复链接路径

- 修复 Core 概述链接路径，添加 index.md 后缀
- 统一标点符号使用，在冒号后添加空格
- 优化段落格式和列表样式，提升文档可读性
- 调整代码示例缩进和格式
- 更新架构类标题描述，明确其为基类
- 修正文档中的拼写和格式错误
- 调整设计模式章节标题格式
- 更新最佳实践部分的格式和表述
- 优化相关包列表的显示格式

2026-02-11 15:29:41 +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