Czar.Cms配置文件与AutoFac依赖注入实战：如何构建自动扫描整个程序集的DI容器

Czar.Cms配置文件与AutoFac依赖注入实战如何构建自动扫描整个程序集的DI容器【免费下载链接】Czar.Cms.NET Core实战项目之CMS系列教程的源码精简而又功能丰富的权限设计内容管理设计让你轻松搭建一个ASP.NET Core2.2的网站系统.此项目准备用EFCore进行重构敬请期待项目地址: https://gitcode.com/gh_mirrors/cz/Czar.CmsCzar.Cms 是一个精简而功能丰富的 .NET Core CMS 系统源码内置权限管理、内容管理与定时任务。本文带你实战解析 Czar.Cms 的配置文件体系与 AutoFac 依赖注入玩法从 appsettings.json 读取数据库配置到用几行代码构建一个自动扫描整个程序集的 DI 容器让 Repository 与 Service 层零手动注册。 项目一览Czar.Cms 的分层结构Czar.Cms 采用经典的分层架构整个解决方案位于src/目录各层职责清晰项目职责Czar.Cms.Admin后台管理站点MVC 配置入口Czar.Cms.Core基础设施连接工厂、缓存、帮助类Czar.Cms.Models / ViewModels实体模型与视图模型Czar.Cms.IRepository / IServices仓储层、业务层的接口Czar.Cms.Repository.SqlServer / Services仓储层、业务层的实现Czar.Cms.Quartz / Job定时任务调度中心与任务 正是靠下面要讲的配置文件 AutoFac 容器各层才能在Startup.cs启动时即插即用最终渲染出这个后台登录页。 配置文件实战连接串到底放在哪1. 核心配置都在 appsettings.jsonCzar.Cms 的 Web 配置入口是 appsettings.json数据库相关配置集中在DbOpion节中DbOpion: { ConnectionString: Data Source.;Initial CatalogCzarCms;User IDsa;Password1;..., DbType: SqlServer }开发环境则通过 appsettings.Development.json 覆盖日志级别——ASP.NET Core 会按环境合并策略自动叠加两个文件你只需要改对应环境的文件即可互不干扰。2. 配置绑定成强类型选项类裸读字符串不如绑定成类。Czar.Cms 在 DbOption.cs 中定义了只有ConnectionString和DbType两个属性的选项类然后在 Startup.cs 中一行完成绑定services.ConfigureDbOption(CzarCms, Configuration.GetSection(DbOpion));注意这里多了一个选项名CzarCms配合IOptionsSnapshotDbOption的options.Get(CzarCms)使用意味着同一应用可以绑定多份不同来源的配置互不串扰。3. 日志配置独立成 Nlog.config日志由 NLog 负责规则写在 Nlog.config 中Czar.Cms.*命名空间下的日志写入数据库NLog表而Microsoft.*的框架日志全部扔进黑洞。该文件通过 csproj 中的CopyToOutputDirectory配置保证发布时随站点一起输出。 AutoFac 构建 DI 容器四步法自动扫描程序集C# 依赖注入的精髓是面向接口编程 运行时装配。Czar.Cms 没有用框架默认的AddScoped逐个注册而是引入 AutoFac用类型命名约定一次性装配整个程序集。核心代码在 Startup.csvar builder new ContainerBuilder(); builder.Populate(services); // 第1步把 Microsoft DI 的服务搬进 AutoFac builder.RegisterAssemblyTypes(typeof(ManagerRoleRepository).Assembly) .Where(t t.Name.EndsWith(Repository)) .AsImplementedInterfaces(); // 第2步扫描仓储层程序集 builder.RegisterAssemblyTypes(typeof(ManagerRoleService).Assembly) .Where(t t.Name.EndsWith(Service)) .AsImplementedInterfaces(); // 第3步扫描业务层程序集 return new AutofacServiceProvider(builder.Build()); // 第4步接管服务提供四步法拆解如下步骤代码作用①Populate(services)合并容器前面AddMvc、AddSession等注册的服务对 AutoFac 可见②RegisterAssemblyTypes(...)自动扫描反射遍历整个程序集里的所有类型③.Where(...).AsImplementedInterfaces()约定注册只要类名以约定后缀结尾就按它实现的接口注册④AutofacServiceProvider接管整个应用从此由 AutoFac 统一解析实例 约定大于配置命名即注册这套玩法的钥匙是命名约定——类名必须以 Repository 或 Service 结尾。例如 ManagerRoleRepository.cs 中public class ManagerRoleRepository : BaseRepositoryManagerRole, int, IManagerRoleRepository { public ManagerRoleRepository(IOptionsSnapshotDbOption options) { _dbOption options.Get(CzarCms); _dbConnection ConnectionFactory.CreateConnection(_dbOption.DbType, _dbOption.ConnectionString); } }可以看到仓储的构造函数通过IOptionsSnapshotDbOption注入配置再由 ConnectionFactory.cs 按DbType创建 SqlServer / MySQL / PostgreSQL 三种连接——换数据库只改配置不改代码。后续新增业务模块时你只需要在Czar.Cms.IRepository里写接口IXxxRepository在Czar.Cms.Repository.SqlServer里写XxxRepository实现命名以Repository结尾——完成无需回到 Startup.cs 改一行代码。这就是自动扫描整个程序集的价值注册逻辑从每个类一行代码变成一个规则扫一遍漏注册的可能性基本归零。⚠️ 实战要点与常见坑 节名必须一字不差appsettings.json中的节名是DbOpion作者的小拼写失误代码里GetSection(DbOpion)必须与之完全一致否则绑定出来是 null运行时才炸。 单例要单独注册如ScheduleCenter这类带状态的服务用services.AddSingletonScheduleCenter()显式注册Startup.cs不要交给约定扫描。 扫描范围要精准RegisterAssemblyTypes是按程序集扫描的仓储与业务分属两个程序集分别注册避免把不该注册的类型扫进来。 Populate 不能少忘记builder.Populate(services)是最常见的坑症状是AutoFac 解析不到 IMvcBuilder 系的服务报错信息往往还很迷惑。 小结能力Czar.Cms 的做法多环境配置appsettings.json 环境文件自动合并强类型配置services.ConfigureDbOption(CzarCms, ...)命名选项依赖注入AutoFac 四步法 命名约定自动扫描多数据库支持ConnectionFactory 按 DbType 分派连接配置决定系统怎么连DI 容器决定系统怎么活。读懂了 Czar.Cms 的这套组合拳你在自己的 ASP.NET Core 项目里也可以轻松搭出命名即注册的自动装配体系。【免费下载链接】Czar.Cms.NET Core实战项目之CMS系列教程的源码精简而又功能丰富的权限设计内容管理设计让你轻松搭建一个ASP.NET Core2.2的网站系统.此项目准备用EFCore进行重构敬请期待项目地址: https://gitcode.com/gh_mirrors/cz/Czar.Cms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考