mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 17:21:16 +08:00
bb2b3a0c60
- 将组件注册逻辑提取到独立的 ArchitectureComponentRegistry 类中 - 实现 ArchitectureComponentActivator 来支持注册阶段实例化组件 - 更新系统和模型注册文档说明，明确在注册阶段创建实例并参与初始化 - 修复类型注册在架构准备就绪后的行为一致性问题 - 添加完整的组件注册行为测试覆盖实例注册、工厂注册和生命周期管理 - 优化依赖注入解析机制，支持构造函数依赖和单例缓存
94 lines
4.2 KiB
C#
94 lines
4.2 KiB
C#
using GFramework.Core.Abstractions.Ioc;
|
||
using GFramework.Core.Abstractions.Logging;
|
||
|
||
namespace GFramework.Core.Architectures;
|
||
|
||
/// <summary>
|
||
/// 为架构组件的类型注册路径提供实例创建能力。
|
||
/// 该类型在容器冻结前基于当前服务集合和已注册实例进行激活，
|
||
/// 使 <see cref="ArchitectureComponentRegistry" /> 可以在注册阶段就物化 System / Model，
|
||
/// 避免它们在 Ready 之后首次解析时才参与生命周期而导致状态不一致。
|
||
/// </summary>
|
||
internal sealed class ArchitectureComponentActivator(
|
||
IIocContainer container,
|
||
ILogger logger)
|
||
{
|
||
/// <summary>
|
||
/// 根据当前容器状态创建组件实例。
|
||
/// 激活过程优先复用已经注册到容器中的实例，再按服务描述解析实现类型或工厂方法，
|
||
/// 以兼容构造函数依赖于框架服务、用户实例服务和先前注册组件的场景。
|
||
/// </summary>
|
||
/// <typeparam name="TComponent">要创建的组件类型。</typeparam>
|
||
/// <returns>创建完成的组件实例。</returns>
|
||
public TComponent CreateInstance<TComponent>() where TComponent : class
|
||
{
|
||
var activationProvider = new RegistrationServiceProvider(container, logger);
|
||
return ActivatorUtilities.CreateInstance<TComponent>(activationProvider);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 面向组件注册的轻量级服务提供者。
|
||
/// 该实现只覆盖预冻结阶段需要的解析能力，避免引入完整容器冻结过程。
|
||
/// </summary>
|
||
private sealed class RegistrationServiceProvider(
|
||
IIocContainer container,
|
||
ILogger logger) : IServiceProvider
|
||
{
|
||
private readonly Dictionary<Type, object?> _singletonCache = [];
|
||
|
||
/// <summary>
|
||
/// 从当前服务集合中解析指定类型的服务。
|
||
/// 解析顺序为：已注册实例 → 服务描述实例/工厂/实现类型 → 可直接实例化的具体类型。
|
||
/// </summary>
|
||
/// <param name="serviceType">请求解析的服务类型。</param>
|
||
/// <returns>解析到的服务实例；若无法解析则返回 null。</returns>
|
||
public object? GetService(Type serviceType)
|
||
{
|
||
if (serviceType == typeof(IServiceProvider))
|
||
return this;
|
||
|
||
var existingInstance = container.Get(serviceType);
|
||
if (existingInstance != null)
|
||
return existingInstance;
|
||
|
||
var descriptor =
|
||
container.GetServicesUnsafe.LastOrDefault(candidate => candidate.ServiceType == serviceType);
|
||
if (descriptor != null)
|
||
return ResolveDescriptor(serviceType, descriptor);
|
||
|
||
if (!serviceType.IsAbstract && !serviceType.IsInterface)
|
||
return ActivatorUtilities.CreateInstance(this, serviceType);
|
||
|
||
logger.Trace($"Activation provider could not resolve {serviceType.Name}");
|
||
return null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 根据服务描述解析实例，并对单例描述进行缓存。
|
||
/// 这样可以保证同一类型在一次组件注册流程中只创建一次依赖实例。
|
||
/// </summary>
|
||
/// <param name="requestedType">请求的服务类型。</param>
|
||
/// <param name="descriptor">命中的服务描述。</param>
|
||
/// <returns>解析到的实例。</returns>
|
||
private object? ResolveDescriptor(Type requestedType, ServiceDescriptor descriptor)
|
||
{
|
||
if (descriptor.Lifetime == ServiceLifetime.Singleton &&
|
||
_singletonCache.TryGetValue(requestedType, out var cached))
|
||
return cached;
|
||
|
||
object? resolved = descriptor switch
|
||
{
|
||
{ ImplementationInstance: not null } => descriptor.ImplementationInstance,
|
||
{ ImplementationFactory: not null } => descriptor.ImplementationFactory(this),
|
||
{ ImplementationType: not null } => ActivatorUtilities.CreateInstance(this,
|
||
descriptor.ImplementationType),
|
||
_ => null
|
||
};
|
||
|
||
if (descriptor.Lifetime == ServiceLifetime.Singleton && resolved != null)
|
||
_singletonCache[requestedType] = resolved;
|
||
|
||
return resolved;
|
||
}
|
||
}
|
||
} |