Furion.DependencyInjection
5.0.0-preview.1.20240813.1
This is a prerelease version of Furion.DependencyInjection.
dotnet add package Furion.DependencyInjection --version 5.0.0-preview.1.20240813.1
NuGet\Install-Package Furion.DependencyInjection -Version 5.0.0-preview.1.20240813.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Furion.DependencyInjection" Version="5.0.0-preview.1.20240813.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Furion.DependencyInjection --version 5.0.0-preview.1.20240813.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Furion.DependencyInjection, 5.0.0-preview.1.20240813.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Furion.DependencyInjection as a Cake Addin #addin nuget:?package=Furion.DependencyInjection&version=5.0.0-preview.1.20240813.1&prerelease // Install Furion.DependencyInjection as a Cake Tool #tool nuget:?package=Furion.DependencyInjection&version=5.0.0-preview.1.20240813.1&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
先知（v5）
一个应用程序框架，您可以将它集成到任何 .NET/C# 应用程序中。
新域名
过去 Furion 没有独立好记的域名，这一次我们出手了，以合理的交易价格购买下了 furion.net 域名。
域名寓意非常好 —— Furion 是基于 .NET 开发的基础框架，正是 furion + .net 的组合。
访问新官网（建设中）：https://furion.net
项目背景
当前的 👉 Furion v4 版本已经逐步成熟且稳定，但仍存在以下问题：
- 早期开发进展迅速，很多代码存在仓促上线的情况，缺乏充分思考和考虑
- 所有模块都包含在一个项目中，无法按需加载和安装
- 过度使用静态类和静态内存存储，不利于进行单元测试和数据隔离
- 对于 .NET Core 的掌握程度有限，导致历史代码臃肿且高度耦合
- 代码架构和设计模式缺乏统一性，可以说是一个大杂烩
- 在早期对用户需求掌握不足，导致后期不断打补丁来进行改进，稍有改动就可能引发破坏性的修改
- 模块、类型、属性、方法、属性等命名混乱，很难从字面上理解其功能含义
- 模块功能封装过度，配置参数繁杂
- 框架示例混乱，用户只能自行摸索最佳实践
- 虽有单元测试，但是非常混乱
正是因为存在以上诸多问题，为了 Furion 能够长期发展，我们团队决定进行下一版本（v5）开发。
技术选择
Furion v5 版本采用 C# 12 和 .NET 8 进行开发。
开发团队
百小僧、百签科技（广东）有限公司
设计指导
- 计划和分析: 在开始编写代码之前，仔细规划和分析整个框架的需求和功能。确定好核心功能和结构，以及可能的扩展和变化。这样可以减少后续的重构工作。
- 模块化设计: 将整个框架划分为多个独立的模块，每个模块负责一个特定的功能。这样可以降低代码间的依赖性，方便后续的修改和调整。
- 接口设计: 设计清晰的接口和抽象层，以便将来的修改不会对其他模块产生过多的影响。好的接口设计可以提高代码的可维护性和可扩展性。
- 设计模式: 使用合适的设计模式来解决常见的问题，例如单例模式、观察者模式、策略模式等。这些设计模式可以提供灵活性和可扩展性，减少需要重构的风险。
- 自动化测试: 在开发过程中编写充分的自动化测试，覆盖各个模块的功能和边界情况。这样可以及早发现问题，并减少在重构时引入新的错误。
- 审查和反馈: 定期进行代码审查，并及时处理同事和用户的反馈意见。这有助于发现问题和改进，避免重复的重构工作。
- 持续集成: 将代码集成到一个持续集成系统中，并在每次提交代码时运行自动化测试。这可以及时发现潜在的问题，避免代码质量下降。
框架目标
- 实现完全无第三方依赖（除微软官方提供外）
- 实现彻底模块化，每个模块都是独立的项目
- 每个模块的单元测试覆盖率要达到 92% 以上
- 确保每个类型、属性、字段、方法都有详细的注释
- 尽可能避免使用静态内存存储
- 所有模块都采用上下文和构建器模式进行设计
- 所有模块都采用依赖注入/控制反转的设计模式
- 所有模块都采用约定大于配置设计原则
- 尽可能为每个模块提供看板功能
- 提供所有模块最佳实践示例
- 提供所有模块详细使用文档和 API 文档
模块状态
| 模块名称 | 状态 | 单元测试 | 版本 | 文档 |
|---|---|---|---|---|
| Furion.Core | ✅ | ✅ |  |
⚠️ |
| Furion.DependencyInjection | ✅ | ✅ |  |
⚠️ |
| Furion.DependencyInjection.AspNetCore | ✅ | ✅ |  |
⚠️ |
| Furion.DependencyInjection.Hosting | ✅ | ✅ |  |
⚠️ |
| Furion.DependencyInjection.Named | ✅ | ✅ |  |
⚠️ |
| Furion.DependencyInjection.TypeScanning | ✅ | ✅ |  |
⚠️ |
| Furion.Component | ✅ | ✅ |  |
⚠️ |
| Furion.Component.AspNetCore | ✅ | ✅ |  |
⚠️ |
| Furion.Component.Hosting | ✅ | ✅ |  |
⚠️ |
| Furion.Configuration | ✅ | ✅ |  |
⚠️ |
| Furion.Configuration.FileScanning | ✅ | ✅ |  |
⚠️ |
| Furion.Configuration.ManifestResource | ✅ | ✅ |  |
⚠️ |
| Furion.Configuration.Remoted | ✅ | ✅ | |
⚠️ |
| Furion.Validation | ✅ | ✅ |  |
⚠️ |
| Furion.Validation.AspNetCore | ✅ | ✅ |  |
⚠️ |
| Furion.Validation.Fluent | ✅ | ✅ |  |
⚠️ |
| Furion.Exception | ✅ | ✅ |  |
⚠️ |
| Furion.Exception.AspNetCore | ✅ | ✅ |  |
⚠️ |
| Furion.Exception.RescuePolicy | ✅ | ✅ |  |
⚠️ |
| Furion.Kit | ✅ | ✅ |  |
⚠️ |
| Furion.OpenApi | ⏳ | ⏳ | ⚠️ | |
| Furion.Logging | ⏳ | ⏳ | ⚠️ | |
| Furion.Logging.AspNetCore | ⏳ | ⏳ | ⚠️ | |
| Furion.Logging.Console | ⏳ | ⏳ | ⚠️ | |
| Furion.Logging.File | ⏳ | ⏳ | ⚠️ |
状态说明
图标 描述 ⚠️ 待定 ⏳ 进行中 ✅ 完成 💔 随时抛弃
协议
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net9.0
- Furion.Component (>= 5.0.0-preview.1.20240813.1)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Furion.DependencyInjection:
| Package | Downloads |
|---|---|
|
Furion.DependencyInjection.AspNetCore
Furion 框架依赖注入模块。 |
|
|
Furion.DependencyInjection.Hosting
Furion 框架依赖注入模块。 |
GitHub repositories
This package is not used by any popular GitHub repositories.