GeWuYou 7d581f07ca feat(settings): 重构设置系统架构以支持数据仓库模式
- 为 ILoadableFrom 接口添加 XML 文档注释
- 重命名 UnifiedSettingsRepository 为 UnifiedSettingsDataRepository
- 将仓库基类从 IDataRepository 替换为更具体的 ISettingsDataRepository
- 为 UnifiedSettingsDataRepository 添加完整的 XML 文档注释
- 在 SettingsModel 中使用 ISettingsDataRepository 替代 IDataRepository
- 修改 SettingsModel 中的应用器存储结构从 ConcurrentBag 到 ConcurrentDictionary
- 添加 LoadAllAsync 方法以支持批量加载所有设置数据
- 优化 SettingsModel 初始化逻辑以使用批量加载提高性能
- 为 AudioSettings、GraphicsSettings 和 LocalizationSettings 添加 LoadFrom 实现
- 将设置数据版本属性改为私有只读以防止外部修改
- 更新 SettingsSystem 接口约束以匹配新的抽象层设计
- 添加 GetApplicator 泛型方法以支持获取特定类型的应用器
- 实现 Reset 泛型方法以支持重置指定类型的设置数据
- [release ci]
2026-01-30 21:16:31 +08:00

63 lines
2.5 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Copyright (c) 2026 GeWuYou
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
using GFramework.Core.Abstractions.utility;
namespace GFramework.Game.Abstractions.data;
/// <summary>
/// 定义数据仓库接口,提供异步的数据加载、保存、检查存在性和删除操作
/// </summary>
public interface IDataRepository : IUtility
{
/// <summary>
/// 异步加载指定位置的数据
/// </summary>
/// <typeparam name="T">要加载的数据类型必须实现IData接口并具有无参构造函数</typeparam>
/// <param name="location">数据位置信息</param>
/// <returns>返回加载的数据对象</returns>
Task<T> LoadAsync<T>(IDataLocation location)
where T : class, IData, new();
/// <summary>
/// 异步保存数据到指定位置
/// </summary>
/// <typeparam name="T">要保存的数据类型必须实现IData接口</typeparam>
/// <param name="location">数据位置信息</param>
/// <param name="data">要保存的数据对象</param>
/// <returns>返回异步操作任务</returns>
Task SaveAsync<T>(IDataLocation location, T data)
where T : class, IData;
/// <summary>
/// 异步检查指定位置是否存在数据
/// </summary>
/// <param name="location">数据位置信息</param>
/// <returns>返回布尔值,表示数据是否存在</returns>
Task<bool> ExistsAsync(IDataLocation location);
/// <summary>
/// 异步删除指定位置的数据
/// </summary>
/// <param name="location">数据位置信息</param>
/// <returns>返回异步操作任务</returns>
Task DeleteAsync(IDataLocation location);
/// <summary>
/// 异步批量保存多个数据项到各自的位置
/// </summary>
/// <param name="dataList">包含数据位置和对应数据对象的可枚举集合</param>
/// <returns>返回异步操作任务</returns>
Task SaveAllAsync(IEnumerable<(IDataLocation location, IData data)> dataList);
}