Furion.ObjectMapper 5.0.0-preview.1.20230805.2

This is a prerelease version of Furion.ObjectMapper.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Furion.ObjectMapper --version 5.0.0-preview.1.20230805.2                
NuGet\Install-Package Furion.ObjectMapper -Version 5.0.0-preview.1.20230805.2                
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.ObjectMapper" Version="5.0.0-preview.1.20230805.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Furion.ObjectMapper --version 5.0.0-preview.1.20230805.2                
#r "nuget: Furion.ObjectMapper, 5.0.0-preview.1.20230805.2"                
#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.ObjectMapper as a Cake Addin
#addin nuget:?package=Furion.ObjectMapper&version=5.0.0-preview.1.20230805.2&prerelease

// Install Furion.ObjectMapper as a Cake Tool
#tool nuget:?package=Furion.ObjectMapper&version=5.0.0-preview.1.20230805.2&prerelease                

alternate text is missing from this package README image

先知(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 nuget ⚠️
Furion.DependencyInjection nuget ⚠️
Furion.DependencyInjection.AspNetCore nuget ⚠️
Furion.DependencyInjection.Hosting nuget ⚠️
Furion.DependencyInjection.Named nuget ⚠️
Furion.DependencyInjection.TypeScanning nuget ⚠️
Furion.Component nuget ⚠️
Furion.Component.AspNetCore nuget ⚠️
Furion.Component.Hosting nuget ⚠️
Furion.Configuration nuget ⚠️
Furion.Configuration.FileScanning nuget ⚠️
Furion.Configuration.ManifestResource nuget ⚠️
Furion.Configuration.Remoted nuget ⚠️
Furion.Validation nuget ⚠️
Furion.Validation.AspNetCore nuget ⚠️
Furion.Validation.Fluent nuget ⚠️
Furion.Exception nuget ⚠️
Furion.Exception.AspNetCore nuget ⚠️
Furion.Exception.Policy nuget ⚠️
Furion.Logging ⚠️
Furion.Logging.AspNetCore ⚠️
Furion.Logging.Console ⚠️
Furion.Logging.File ⚠️

状态说明

图标 描述
⚠️ 待定
进行中
完成
💔 随时抛弃

赞助 Furion

亲爱的用户,

感谢您一直以来对 Furion 开源项目的支持和关注!您的持续捐赠将极大地帮助我们推动项目的发展与改进。

作为开源项目的作者,我们始终致力于提供优质的软件和服务,以满足用户的需求。然而,项目的开发和维护是一项耗费时间和资源的工作,您的捐赠能够为我们提供资金支持,帮助我们改进项目、扩大团队,并使我们能够持续地为您提供更好的体验和功能。

您的每一份捐赠都将被用于项目的运营和发展,确保我们能够持续提供高质量、稳定可靠的软件服务。无论您选择捐赠多少,您的支持都将对我们意义重大,使我们能够更好地满足您的需求,同时也激励着我们不断前进。

感谢您的慷慨捐助!如果您愿意给予您的支持,请点击以下链接进行捐赠:

<img src="./assets/support.png" width="300" />

<br />

再次向您表达我们最衷心的感激之情,期待继续为您提供更好的软件和服务!

最诚挚的问候,

百小僧 <br /> Furion 开发团队

协议

Furion 采用 MIT 开源协议。

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.0.0-preview.1.20240813.1 60 8/13/2024
5.0.0-preview.1.20231116.1 175 11/16/2023
5.0.0-preview.1.20230826.1 83 8/25/2023
5.0.0-preview.1.20230824.1 78 8/23/2023
5.0.0-preview.1.20230822.1 77 8/21/2023
5.0.0-preview.1.20230805.2 84 8/5/2023
5.0.0-preview.1.20230805.1 84 8/4/2023
5.0.0-preview.1.20230804.2 84 8/4/2023
5.0.0-preview.1.20230804.1 78 8/3/2023
5.0.0-preview.1.20230801.1 84 8/1/2023
5.0.0-preview.1.20230731.4 83 7/31/2023
5.0.0-preview.1.20230731.3 80 7/31/2023
5.0.0-preview.1.20230731.2 78 7/30/2023
5.0.0-preview.1.20230731.1 76 7/30/2023
5.0.0-preview.1.20230730.1 79 7/29/2023
5.0.0-preview.1.20230729.1 81 7/28/2023
5.0.0-preview.1.20230728.2 83 7/28/2023
5.0.0-preview.1.20230728.1 83 7/27/2023
5.0.0-preview.1.20230727.1 82 7/27/2023
5.0.0-preview.1.20230726.1 79 7/26/2023
5.0.0-preview.1.20230724.1 81 7/24/2023
5.0.0-preview.1.20230722.1 91 7/21/2023
5.0.0-preview.1.20230720.4 76 7/20/2023
5.0.0-preview.1.20230720.1 80 7/19/2023
5.0.0-preview.1.20230719.1 82 7/18/2023
5.0.0-preview.1.20230718.4 84 7/18/2023
5.0.0-preview.1.20230718.3 77 7/18/2023
5.0.0-preview.1.20230718.2 80 7/18/2023
5.0.0-preview.1.20230718.1 76 7/17/2023
5.0.0-preview.1.20230717.1 86 7/16/2023
5.0.0-preview.1.20230716.1 80 7/15/2023
5.0.0-preview.1.20230715.1 76 7/14/2023
5.0.0-preview.1.20230713.1 88 7/12/2023
5.0.0-preview.1.20230711.1 76 7/11/2023
5.0.0-preview.1.20230710.1 80 7/10/2023
5.0.0-preview.1.20230707.2 77 7/7/2023
5.0.0-preview.1.20230707.1 81 7/6/2023
5.0.0-preview.1.20230704.1 79 7/3/2023
5.0.0-preview.1.20230701.3 78 7/2/2023
5.0.0-preview.1.20230701.2 82 6/30/2023
5.0.0-preview.1.20230701.1 83 6/30/2023
5.0.0-preview.1.20230630.1 77 6/29/2023
5.0.0-preview.1.20230621.8 78 6/20/2023
5.0.0-preview.1.20230620.32 73 6/20/2023
5.0.0-preview.1.20230620.30 73 6/20/2023