ConsoleAppFramework 5.5.0版本新增KeyedServices支持解析

在依赖注入场景中，KeyedServices（键控服务）是一种常见的模式，它允许开发者通过指定键名来获取特定实现的服务实例。近期发布的ConsoleAppFramework 5.5.0版本正式加入了对KeyedServices的支持，解决了之前版本中[FromKeyedServices]属性被忽略的问题。

背景与问题

在之前的ConsoleAppFramework版本中，虽然框架支持依赖注入，但无法正确处理带有[FromKeyedServices]标记的参数注入。例如以下代码：

services.AddSingleton<ITest, Test>();
services.AddKeyedSingleton<ITest, KeyedTest>("Key");

class TestCommand([FromKeyedServices("Key")] ITest test) {
    public void Run() {
        Console.WriteLine(test.Value); // 预期输出2，实际输出1
    }
}

这种情况下，框架会忽略键控服务的指定，始终返回默认注册的服务实例，导致业务逻辑出现偏差。

解决方案

5.5.0版本通过改进代码生成逻辑，现在能够正确识别和处理[FromKeyedServices]属性。当检测到该属性时：

1. 框架会检查服务容器中是否存在对应的键控服务注册
2. 优先从键控服务容器中解析依赖
3. 如果找不到匹配的键控服务，才会回退到常规服务解析

实现原理

在底层实现上，ConsoleAppFramework通过源代码生成器在编译时创建命令类的依赖注入逻辑。新版本改进了生成器，使其能够：

• 识别构造函数参数上的[FromKeyedServices]属性
• 生成调用GetKeyedService而非GetService的代码
• 正确处理键名参数传递

使用建议

开发者现在可以安全地在ConsoleAppFramework项目中使用键控服务模式：

// 注册服务
services.AddKeyedSingleton<ILogger, FileLogger>("File");
services.AddKeyedSingleton<ILogger, ConsoleLogger>("Console");

// 使用服务
class LogCommand([FromKeyedServices("File")] ILogger logger) {
    public void Run() {
        logger.Log("This will use FileLogger");
    }
}

注意事项

1. 确保使用的Microsoft.Extensions.DependencyInjection版本支持键控服务（7.0+）
2. 键名区分大小写，需保持注册和使用时的一致性
3. 当键控服务不存在时，框架会尝试回退到常规服务解析

总结

ConsoleAppFramework 5.5.0对KeyedServices的支持完善了其依赖注入功能，使开发者能够更灵活地管理服务实现的选择。这一改进特别适合需要根据不同场景切换服务实现的复杂应用场景，进一步提升了框架在命令行应用开发中的实用性。