StructureMap项目中的IConfiguredInstance详解

概述

在StructureMap这个依赖注入容器中，IConfiguredInstance接口是一个核心组件，它负责管理具体类型的创建和解析过程。本文将深入探讨这个接口的功能和使用方法，帮助开发者更好地控制对象的构建过程。

IConfiguredInstance的作用

IConfiguredInstance接口主要处理以下场景：

• 通过调用公共构造函数创建对象
• 可选地填充公共setter属性的值
• 支持多种配置方式（约定注册、配置属性和构建策略）

这个接口为开发者提供了细粒度的控制能力，可以在运行时动态调整对象的构建方式。

生命周期管理

通过IConfiguredInstance，我们可以灵活地控制实例的生命周期：

// 设置特定生命周期类型
instance.LifecycleIs<SingletonLifecycle>();

// 或者直接使用生命周期对象
instance.LifecycleIs(new SingletonLifecycle());

StructureMap还提供了一些便捷的扩展方法来设置常见生命周期：

• Singleton()
• Transient()
• AlwaysUnique()

反射构造函数参数

了解如何反射构造函数参数对于高级配置场景非常重要：

var parameters = instance.Constructor.GetParameters();
foreach (var param in parameters)
{
    Console.WriteLine($"参数名: {param.Name}, 类型: {param.ParameterType}");
}

需要注意的是，构造函数选择过程是构建计划的第一步，会影响后续的所有构建策略和属性配置。

反射setter属性

StructureMap提供了便捷方法来获取所有可设置的属性：

var properties = instance.SettableProperties();
foreach (var prop in properties)
{
    Console.WriteLine($"属性名: {prop.Name}, 类型: {prop.PropertyType}");
}

依赖管理

IConfiguredInstance.Dependencies属性是一个Argument对象的集合，用于建模内联依赖关系。每个Argument包含三个关键信息：

1. 类型：匹配属性或参数的依赖类型
2. 名称：匹配属性或参数的名称
3. 依赖：可以是依赖类型的对象/值，或者是用于构建依赖的Instance对象

StructureMap在确定构建计划时，会按照以下顺序搜索显式配置的依赖：

1. 按依赖类型和名称完全匹配
2. 仅按依赖类型部分匹配
3. 仅按名称部分匹配

对于原始类型参数（如字符串或数字），搜索逻辑是先按名称，再按类型。

添加属性依赖

如果已经拥有具体类型的PropertyInfo，可以使用AddForProperty方法添加内联依赖：

// 使用值添加依赖
instance.Dependencies.AddForProperty(propertyInfo, propertyValue);

// 使用Instance对象添加依赖
instance.Dependencies.AddForProperty(propertyInfo, new ObjectInstance(propertyValue));

添加构造函数参数依赖

同样地，可以为特定构造函数参数添加依赖：

instance.Dependencies.AddForConstructorParameter(parameterInfo, parameterValue);

添加拦截器

IConfiguredInstance支持直接添加拦截器：

instance.InterceptWith(new MyInterceptor());

拦截器可以用于实现AOP编程范式，如日志记录、事务管理等横切关注点。

最佳实践

1. 在自定义构建策略或配置属性时优先使用IConfiguredInstance接口
2. 对于复杂依赖场景，合理利用依赖搜索顺序
3. 考虑使用拦截器来实现横切关注点，而不是修改核心业务逻辑
4. 在性能敏感场景中，缓存反射结果以提高效率

通过掌握IConfiguredInstance的各种功能，开发者可以充分利用StructureMap的强大依赖注入能力，构建更加灵活和可维护的应用程序架构。