mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
23489570bf
- 清理 GFramework.Core 与 GFramework.Cqrs 中的大量低风险 Meziantou 警告 - 修复 GFramework.Godot 运行时中的 ConfigureAwait、StringComparison 与参数校验告警 - 调整 Core SourceGenerators 中的字符串比较、文件命名与局部长方法问题 - 拆分部分配置与缓存辅助类型文件以消除 file/type mismatch 告警 - 更新 warning reduction 跟踪与执行记录，保留下一批结构性告警的恢复点
88 lines
3.1 KiB
C#
88 lines
3.1 KiB
C#
using GFramework.Core.Abstractions.Environment;
|
||
using GFramework.Core.Rule;
|
||
|
||
namespace GFramework.Core.Environment;
|
||
|
||
/// <summary>
|
||
/// 环境基础抽象类，实现了IEnvironment接口，提供环境值的存储和获取功能
|
||
/// </summary>
|
||
public abstract class EnvironmentBase : ContextAwareBase, IEnvironment
|
||
{
|
||
/// <summary>
|
||
/// 存储环境值的字典，键为字符串，值为对象类型
|
||
/// </summary>
|
||
protected readonly IDictionary<string, object> Values = new Dictionary<string, object>(StringComparer.Ordinal);
|
||
|
||
/// <summary>
|
||
/// 获取环境名称的抽象属性
|
||
/// </summary>
|
||
public abstract string Name { get; }
|
||
|
||
/// <summary>
|
||
/// 根据键获取指定类型的值
|
||
/// </summary>
|
||
/// <typeparam name="T">要获取的值的类型，必须为引用类型</typeparam>
|
||
/// <param name="key">用于查找值的键</param>
|
||
/// <returns>如果找到则返回对应类型的值，否则返回null</returns>
|
||
public virtual T? Get<T>(string key) where T : class
|
||
{
|
||
return TryGet<T>(key, out var value) ? value : null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 尝试根据键获取指定类型的值
|
||
/// </summary>
|
||
/// <typeparam name="T">要获取的值的类型，必须为引用类型</typeparam>
|
||
/// <param name="key">用于查找值的键</param>
|
||
/// <param name="value">输出参数，如果成功则包含找到的值，否则为null</param>
|
||
/// <returns>如果找到指定键且类型匹配则返回true，否则返回false</returns>
|
||
public virtual bool TryGet<T>(string key, out T value) where T : class
|
||
{
|
||
if (Values.TryGetValue(key, out var obj) && obj is T typed)
|
||
{
|
||
value = typed;
|
||
return true;
|
||
}
|
||
|
||
value = null!;
|
||
return false;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 根据键获取必需的指定类型值，如果找不到则抛出异常
|
||
/// </summary>
|
||
/// <typeparam name="T">要获取的值的类型，必须为引用类型</typeparam>
|
||
/// <param name="key">用于查找值的键</param>
|
||
/// <returns>找到的对应类型的值</returns>
|
||
/// <exception cref="InvalidOperationException">当指定键的值不存在时抛出</exception>
|
||
public virtual T GetRequired<T>(string key) where T : class
|
||
{
|
||
if (TryGet<T>(key, out var value))
|
||
return value;
|
||
|
||
throw new InvalidOperationException(
|
||
$"Environment [{Name}] missing required value: key='{key}', type='{typeof(T).Name}'");
|
||
}
|
||
|
||
void IEnvironment.Register(string key, object value)
|
||
{
|
||
Register(key, value);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 抽象方法，用于初始化操作。具体实现由派生类提供。
|
||
/// </summary>
|
||
public abstract void Initialize();
|
||
|
||
/// <summary>
|
||
/// 注册键值对到环境值字典中
|
||
/// </summary>
|
||
/// <param name="key">要注册的键，作为字典中的唯一标识符</param>
|
||
/// <param name="value">要注册的值，与键关联的数据</param>
|
||
protected void Register(string key, object value)
|
||
{
|
||
// 将键值对添加到Values字典中
|
||
Values[key] = value;
|
||
}
|
||
}
|