JCoder.Ioc4Net 3.2604.1

JCoder.Ioc4Net

| 属性 | | | --------------- | -------------------------------------------- | | 作者(Authors) | Jackie Law | | 版权(Copyright) | Copyright © Jackie Law. All rights reserved. | | 协议 | Apache-2.0 | | 联系(QQ) | 1378071853 | | 联系(Wechat) | JackieLaw1024 | | 联系(Email) | JackieLaw-dev@outlook.com |

目录

[TOC]

一.架构说明

1.1 引用类库

1.2 相关类库

| 相关类库 | 说明 | | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | JCoder | The base library of JCoder Serial.（JCoder库系列的基础库。） | | JCoder.Aop4Net | AOP框架，用于实现AOP功能。 | | JCoder.CoreKits | A simple library for C# extension.（一款简易的用于C#的扩展库。） | | JCoder.Data | A library of generic data objects.（一款通用的数据对象库。） | | JCoder.Mock4Net | A simple library for data mock.（一款简易版的用于模拟数据的功能库。） |

获取方式

1. 版本要求：>=3.2603.1
2. 以版本3.2603.1为例

使用说明

一、创建容器（IocCastle）

using JCoder.Ioc4Net;

IIocCastle _iocCastle = new IocCastle();

容器默认：

• 注册模式：IocRegisterMode.Override（覆盖注册，后注册者生效）；
• 注册目标：IocRTarget.Interface | IocRTarget.Class（同时注册接口与类继承链）。

可通过 SetMode(...) / SetTypeTargets(...) 修改，或通过 GetConfig() 查看当前配置。

二、注册程序集

1. 直接注册 Assembly

using JCoder.Ioc4Net;

IIocCastle _iocCastle = new IocCastle();
var _assemblies = AppDomain.CurrentDomain.GetAssemblies();
foreach (var a in _assemblies)
{
    _iocCastle.RegisterAssembly(a);
}

2. 从文件夹注册程序集（可配合文件过滤器）

IIocCastle _iocCastle = new IocCastle();

// 只注册 *.dll 文件
_iocCastle.RegisterFromFolder(@"D:\MyPlugins", "*.dll", true);

3. 添加过滤（加载Assembly / 类型）

IIocCastle _iocCastle = new IocCastle();

//添加文件过滤（根据文件名称）
_iocCastle.AddFilter(new IocNameFileFilter
{
    Prefix = "JCoder.Ioc4Net.",
    Postfix = ".dll",
});

//添加Assembly过滤（根据Assembly名称）
_iocCastle.AddFilter(new IocAssemblyNameFilter
{
    Prefix = "JCoder.Ioc4Net."
});

//添加Namespace过滤（根据Namespace名称）
_iocCastle.AddFilter(new IocNamespaceBunchFilter
{
    Prefix = "JCoder.Ioc4Net."
});

三、创建实例（依赖注入）

using JCoder.Ioc4Net;

public interface IServiceA { }
public class ServiceA : IServiceA { }

public class ServiceB
{
    public ServiceB(IServiceA a) { this.A = a; }
    public IServiceA A { get; }
}

IIocCastle _iocCastle = new IocCastle();
_iocCastle.RegisterAssembly(typeof(ServiceA).Assembly);

var _b = _iocCastle.Create<ServiceB>();   // 自动解析 IServiceA -> ServiceA

构造函数参数解析规则

使用特性控制依赖

public class ServiceC
{
    // 每次创建都使用新实例（即使其它地方已注册单例）
    public ServiceC([NewObject] IServiceA a) { ... }

    // 强制使用单例
    public ServiceC([Singleton] IServiceA a) { ... }
}

四、注册类型映射（手动注册）

IIocCastle _iocCastle = new IocCastle();

_iocCastle.Register<IServiceA>(typeof(ServiceA));        // 接口 -> 实现
_iocCastle.RegisterType<ServiceB>();                      // 按默认注册目标注册
_iocCastle.RegisterType(typeof(ServiceC)
    , IocRTarget.Interface | IocRTarget.Class);           // 指定注册目标

五、预设值（RegisterPrevalue）

IIocCastle _iocCastle = new IocCastle();

_iocCastle.RegisterPrevalue<int>("PageSize", 20);
_iocCastle.RegisterPrevalue<string>("ConnectionString", "server=.;database=db;");

// 创建实例时按“类型 + 参数名”自动注入
public class PageQuery
{
    public PageQuery(int pageSize) { ... }   // 自动注入 20
}

六、单例（Singleton）

IIocCastle _iocCastle = new IocCastle();

var _singleton = _iocCastle.GetSingleton<IServiceA>();   // 不存在时自动创建并缓存
_iocCastle.RegisterSingleton(new ServiceA());            // 手动注册单例

_iocCastle.UnregisterSingleton<IServiceA>();             // 注销单例

七、实现簇（Bunch，一个接口多个实现）

IIocCastle _iocCastle = new IocCastle();

_iocCastle.RegisterToBunchs(typeof(ServiceA));           // 注册该类型的所有基类/接口簇
_iocCastle.RegisterToBunch<IServiceA>(typeof(ServiceA)); // 注册到指定基类/接口

var _types = _iocCastle.GetBunchTypes<IServiceA>();      // 获取所有实现类型
var _items = _iocCastle.CreateFromBunch<IServiceA>();    // 创建所有实现实例

八、建造者（IocBuilder，流式注册）

using JCoder.Ioc4Net;

IIocCastle _iocCastle = new IocBuilder()
    .Register<ServiceA>()
        .AsInterfaces().AsSelf()                 // 注册接口映射 + 自身
    .Register(typeof(ServiceB))
        .As<IServiceB>()                         // 指定映射目标
    .Register(typeof(ServiceC).Assembly)
        .AsInterfaces()
        .Where(t => t.Namespace?.StartsWith("MyApp") == true)
    .Build();

注意：Register<TClass>() 之后需要调用 AsSelf() / AsInterfaces() / AsClass(deep) / As<TBase>() 之一，才会生成映射；AsClass(-1) 表示注册整个继承链（不含 object）。

九、事件（可选）

IIocCastle _iocCastle = new IocCastle();

_iocCastle.OnBeforeRegisterAssembly += (s, e) => { /* 注册程序集前 */ };
_iocCastle.OnTypeMapping          += (s, e) => { /* 类型映射后 */ };
_iocCastle.OnInstanceCreated      += (s, e) => { /* 实例创建后 */ };
_iocCastle.OnSingletonRegistered  += (s, e) => { /* 单例注册后 */ };

十、释放资源

_iocCastle.Dispose();   // 释放内部存储与事件订阅；之后再调用 API 会抛出 ObjectDisposedException

注意事项

1. 类型以 AssemblyQualifiedName（失败时回退 FullName/Name）作为存储标识；
2. RegisterAssembly 对已注册过的程序集保持幂等（返回 true，不重复注册）；
3. 程序集中存在接口、枚举、抽象类时不会导致注册失败（跳过并继续）；
4. 过滤器按 Priority 降序执行，任一过滤器返回 false 即被过滤。