mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
e3652db030
- 修复 Core、Cqrs、Godot 与 Game 模块中的异常契约、空值校验和线程亲和性问题 - 更新 Settings API 为 ApplyAsync 并同步实现、调用点、测试与中文文档 - 补充 AGENTS.md 中的构建校验、自动提交与分支创建规则 - 整理 Logging、WeakCache 与 Resource 相关实现的行为与文档一致性
101 lines
3.0 KiB
C#
101 lines
3.0 KiB
C#
using GFramework.Core.Extensions;
|
||
using GFramework.Core.Systems;
|
||
using GFramework.Game.Abstractions.Setting;
|
||
using GFramework.Game.Setting.Events;
|
||
|
||
namespace GFramework.Game.Setting;
|
||
|
||
/// <summary>
|
||
/// 设置系统，负责管理和应用各种设置配置
|
||
/// </summary>
|
||
public class SettingsSystem : AbstractSystem, ISettingsSystem
|
||
{
|
||
private ISettingsModel _model = null!;
|
||
|
||
/// <summary>
|
||
/// 应用所有设置配置
|
||
/// </summary>
|
||
/// <returns>完成的任务</returns>
|
||
public async Task ApplyAll()
|
||
{
|
||
// 遍历所有设置应用器并尝试应用
|
||
foreach (var applicator in _model.AllApplicators()) await TryApplyAsync(applicator);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 应用指定类型的设置配置
|
||
/// </summary>
|
||
/// <typeparam name="T">设置配置类型，必须是类且实现IResetApplyAbleSettings接口</typeparam>
|
||
/// <returns>完成的任务</returns>
|
||
public Task Apply<T>() where T : class, IResetApplyAbleSettings
|
||
{
|
||
var applicator = _model.GetApplicator<T>();
|
||
return applicator != null
|
||
? TryApplyAsync(applicator)
|
||
: Task.CompletedTask;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 保存所有设置数据到存储库
|
||
/// </summary>
|
||
/// <returns>完成的任务</returns>
|
||
public async Task SaveAll()
|
||
{
|
||
await _model.SaveAllAsync();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 重置所有设置并应用更改
|
||
/// </summary>
|
||
/// <returns>异步任务</returns>
|
||
public async Task ResetAll()
|
||
{
|
||
_model.ResetAll();
|
||
await ApplyAll();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 重置指定类型的设置并应用更改
|
||
/// </summary>
|
||
/// <typeparam name="T">设置类型，必须实现IPersistentApplyAbleSettings接口且具有无参构造函数</typeparam>
|
||
/// <returns>异步任务</returns>
|
||
public async Task Reset<T>() where T : class, ISettingsData, IResetApplyAbleSettings, new()
|
||
{
|
||
_model.Reset<T>();
|
||
await Apply<T>();
|
||
}
|
||
|
||
|
||
/// <summary>
|
||
/// 初始化设置系统，获取设置模型实例
|
||
/// </summary>
|
||
protected override void OnInit()
|
||
{
|
||
_model = this.GetModel<ISettingsModel>()!;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 尝试应用可应用的设置配置
|
||
/// </summary>
|
||
/// <param name="section">设置配置对象</param>
|
||
private async Task TryApplyAsync(ISettingsSection section)
|
||
{
|
||
if (section is not IApplyAbleSettings applyAbleSettings) return;
|
||
|
||
// 发送设置应用中事件
|
||
this.SendEvent(new SettingsApplyingEvent<ISettingsSection>(section));
|
||
|
||
try
|
||
{
|
||
await applyAbleSettings.ApplyAsync();
|
||
// 发送设置应用成功事件
|
||
this.SendEvent(new SettingsAppliedEvent<ISettingsSection>(section, true));
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
// 发送设置应用失败事件
|
||
this.SendEvent(new SettingsAppliedEvent<ISettingsSection>(section, false, ex));
|
||
}
|
||
}
|
||
}
|