❤️ 感谢不看好我们的人 | .NET 框架 Furion v4.9.2.25-低调大师

❤️ 感谢不看好我们的人 | .NET 框架 Furion v4.9.2.25

2024-04-21 300

感谢看好我们的人，更感谢不看好我们的人

自2023年11月26日以来，Furion 在商业化探索的道路上已走过了五个多月的历程。这段时间里，我们积极组建了一支充满活力和创新精神的新团队，不仅全力投入到下一代 Furion 版本的研发中，还同步研发了多款具有市场竞争力的商业应用产品。

起初，我们担心商业化的进程可能会引发市场的抵触和疑虑。然而，事实却证明我们的担忧是多余的。通过不断的努力和优化，我们逐渐吸引了越来越多的精准用户，他们不仅认可我们的价值，还愿意与我们携手共进，共同成长。更令人欣喜的是，这类用户的数量还在持续增长，为我们未来的发展奠定了坚实的基础。

在这个过程中，我们与用户之间建立了深厚的信任和合作关系。用户们可以更加放心地使用 Furion 框架，遇到问题时也能得到我们及时、专业的支持。而我们则通过用户的反馈和需求，不断优化产品功能，提升用户体验，实现了与用户的互利共赢。

此外，我们还通过商业化的收入，进一步壮大了团队规模，吸引了更多优秀的人才加入我们的行列。这使得我们能够更加专注于产品的研发和创新，为用户提供更多、更好的功能和应用产品。

展望未来，我们将继续秉承用户至上的理念，不断优化 Furion 框架和商业应用产品，为用户提供更加便捷、高效、安全的解决方案。同时，我们也期待与更多的合作伙伴携手共进，共同开创更加美好的未来。

最后，

对于那些看好我们的人，我们心怀感激，你们的信任与支持是我们前进的动力。同样我们也珍视那些不看好我们的人，因为你们的质疑与挑战，让我们时刻保持清醒与警觉，不断寻找改进的空间。

在这个阶段，我们其实更期待听到质疑的声音，因为它们能让我们更加深入地审视自己，从而做出更好的决策。逆风翻盘，往往比顺风顺水更具挑战性，也更能体现出我们的价值。

无论外界如何看待我们，我们都坚信，我们正在做的事情是正确的、有意义的，它让我们自己感到快乐，也为更多用户带来了价值。这就是我们前进的动力，也是我们坚持下去的信念。

企业招聘/市场情况

自 Furion 于2023年11月26日启动商业化以来，已成功为 4175 家企业开通文档会员或VIP会员服务，并出具了相应发票。同时，我们在招聘平台上统计到已有 653 个企业发布了招聘岗位，仅2024年4月就有 49 家企业在平台上发布招聘信息。

此外，在 Gitee 平台上，Furion 仓库收获了超过 11K 的 Stars，近 6K 的 Watches，以及 4K 的 Forked。值得一提的是，我们的仓库贡献者已超过 250人，大家的热情参与和贡献是我们不断前行的动力。而在 NuGet 平台，我们的总下载量已接近 1600万，这一数字充分证明了 Furion 的受欢迎程度和广泛应用。

在此，我们衷心感谢大家的支持与信任。未来，我们将继续努力，为大家提供更好的产品和服务。

BOSS 直聘

https://www.zhipin.com/web/geek/job?query=furion&city=100010000

前程无忧

https://we.51job.com/pc/search?jobArea=000000&keyword=furion&searchType=2&keywordType=

项目信息

Gitee：https://gitee.com/dotnetchina/Furion
Github：https://github.com/MonkSoul/Furion
NuGet：https://www.nuget.org/profiles/monk.soul
文档：https://furion.net

本期亮点

1. 新增定时任务作业计划工厂 `ISchedulerFactory` 启停作业 `StartJob` 和 `PauseJob` 方法

问题分析

在过去，要启动或暂停某个作业，需遵循一系列步骤：

// 首先要检查作业计划是否存在
-if (_schedulerFactory.TryGetJob(jobId, out var scheduler))
{
     // 接着启动作业
-    scheduler?.Start();
     
     // 或暂停作业
-    scheduler?.Pause();
}

这种操作方式虽然功能完备，但处理大量作业时显得繁琐冗长。

解决方案

现在，我们进行了优化，只需通过以下简洁的调用即可完成操作：

 // 轻松启动作业
+_schedulerFactory.TryStartJob(jobId, out var scheduler);

 // 便捷暂停作业
+_schedulerFactory.TryPauseJob(jobId, out var scheduler);

此优化显著提升了作业管理的便捷性和效率，操作上更加流畅自如。

2. 新增运行时动态修改 `Swagger UI` 信息

问题分析

在某些应用场景中，我们可能需要对 Swagger UI 的描述内容进行动态调整，以适应不同需求。为此，可以利用 ISwaggerProvider 接口实现灵活操作。

以下是相关代码示例：

+ public void ChangeSwaggerUI_Information([FromServices] ISwaggerProvider swaggerProvider)
  {
      // 通过依赖注入的方式，引入 ISwaggerProvider 接口
+     var openApiDocument = swaggerProvider.GetSwagger("Default"); // 获取名为 "Default" 的分组文档

      // 直接对文档信息进行修改
+     openApiDocument.Info.Title = "我是新标题";
+     openApiDocument.Info.Description = "我是新描述";
}

以下是相关的屏幕截图：

在这段代码中，我们首先通过依赖注入的方式获取了 ISwaggerProvider 接口的实例，然后调用其 GetSwagger 方法获取了名为 "Default" 的分组文档。接着，我们直接修改了文档中的标题和描述信息，实现了对 Swagger UI 描述内容的动态调整。

3. 新增 `AES` 加解密支持向量 `IV`、模式 `Mode` 和填充 `Padding` 配置

问题分析

在使用前端库 crypto-js 与后端 Java 进行 AES 加解密操作时，由于先前的 Furion 框架未提供必要的向量 IV（初始化向量）、模式 Mode（加密模式）以及填充 Padding（数据填充方式）的配置选项，这导致了在与其他编程语言进行互操作时，加解密过程出现异常情况。

示例代码

// 要加密的明文
var plainText = "一个应用程序框架，您可以将它集成到任何 .NET/C# 应用程序中。";

// 密钥（必须为 16、24 或 32 字节，这里使用 32 字节）
+ var key = "bda66540c463dfdbe70666019f89e554";    // furion 小写 32 位 MD5 加密字符串

// 自定义偏移量（16 字节），如果不指定，则使用默认值
+ byte[] customIV = { 0x1a, 0x2b, 0x3c, 0x4d, 0x5e, 0x6f, 0x70, 0x81, 0x92, 0xa3, 0xb4, 0xc5, 0xd6, 0xe7, 0xf8, 0x09 };

// 使用 CBC 模式和 PKCS7 填充进行加密
+ var encryptedText = AESEncryption.Encrypt(plainText, key
+     , customIV    // 向量
+     , CipherMode.CBC    // 模式
+     , PaddingMode.PKCS7);    // 填充

Console.WriteLine("加密后文本: " + encryptedText);

// 使用相同的密钥、偏移量、模式和填充进行解密
+ var decryptedText = AESEncryption.Decrypt(encryptedText, key
+     , customIV    // 向量
+     , CipherMode.CBC    // 模式
+     , PaddingMode.PKCS7);    // 填充

Console.WriteLine("解密后文本: " + decryptedText);

输出结果

+ 加密后文本: Gis8TV5vcIGSo7TF1uf4Ceu2xkJjjXomVxcd7SGBQOi5doe8iu+m1mI+FYK6pTrmhp4vKQEfjNAtbQnZiqjHwWrk0Tt2gPXEcX750PjCvsbA/OQBBc0r/JsJPuW2V5Hf+7fk5b8Q7mqHOwDM8432Ag==

+ 解密后文本: 一个应用程序框架，您可以将它集成到任何 .NET/C# 应用程序中。

4. 修复动态 `WebAPI` 错误将 `CancellationToken` 类型当作路由参数

问题分析

在实际应用中，经常需要监控客户端发送的请求是否在中途意外中断，例如服务器尚未完成响应时，用户关闭了浏览器窗口或标签页，或其他不可预见的因素导致请求未能完整执行。

解决方案

针对这种情况，我们可以在 Action 方法的参数列表中增加 CancellationToken 参数。此参数的作用在于能够监听客户端是否提前终止了请求，从而进行相应的处理。

[HttpGet]
+public async Task SomeApi(CancellationToken cancellationToken)
{
    // 监听客户端是否终止请求
+    cancellationToken.Register(() => 
+    {
+        Console.WriteLine("用户中断了请求。");
+    });

    // 确保在异步方法中使用 cancellationToken
    await Task.Run(() => {
        // 模拟异步操作
+    }, cancellationToken);
}

注意，在异步方法中，应该确保 CancellationToken 被正确传递并用于可能中断的异步操作。在上面的代码中，我们使用了 Task.Run 来模拟一个异步操作，并将 cancellationToken 作为参数传递，以便在需要时能够中断该操作。

5. 新增粘土对象 `Clay` 支持无限极组合嵌套

问题分析

在之前的版本中，Clay 粘土对象主要支持通过对象或 JSON 字符串的方式生成，但缺乏对对象属性直接设置粘土对象的支持。

在新版本中，我们实现了对任意组合和嵌套的支持，使得粘土对象更为灵活和强大。

public dynamic TestClay()
{
    // 创建粘土对象 package
+    var package = Clay.Object(new
+    {
+        Name = "我是第一层"
+    });

    var a3 = Clay.Object(new object[] { });

    // 为 a3 数组添加多个对象元素
    a3[0] = new
    {
        Name = "明细1"
    };
    a3[1] = new
    {
        Name = "明细2"
    };
    a3[2] = package; // 将 package 嵌套到 a3中

+    // 创建另一个粘土对象，其中嵌套了 package
+    a3[3] = new
+    {
+        package // 这里直接使用变量名作为键，将 package 作为一个属性嵌套
+    };

+    // 创建粘土对象 policy，其中包含多个嵌套对象
+    var policy = Clay.Object(new
    {
        search = new
        {
            hotel_id = 10,
            check_in_date = DateTime.Now
        },
+        // 在 policy 中嵌套 package 对象
+        package,
+        // 使用匿名类（或类型类）嵌套粘土对象
+        package1 = new
+        {
+            package, // 嵌套 package 对象
+            a3 // 嵌套 a3 数组对象
+        }
    });

    return policy;
}

最终输出

经过上述代码的构造，我们得到了一个嵌套的粘土对象 policy，其结构如下：

{
  "search": {
    "hotel_id": 10,
    "check_in_date": "2024-04-16T14:37:46.201809+08:00"
  },
  "package": {
    "Name": "我是第一层"
  },
  "package1": {
    "package": {
      "Name": "我是第一层"
    },
    "a3": [
      {
        "Name": "明细1"
      },
      {
        "Name": "明细2"
      },
      {
        "Name": "我是第一层"
      },
      {
        "package": {
          "Name": "我是第一层"
        }
      }
    ]
  }
}

这个输出的 JSON 结构清晰地展示了 policy 对象内部是如何嵌套 package 和 a3 对象的，以及 a3 数组又是如何包含多个对象元素的。这样的结构使得粘土对象能够灵活处理各种复杂的嵌套场景。

6. 新增动态 `WebAPI` 支持贴 `[Route]` 特性动态生成控制器情况

示例代码

在 Furion 框架的演进中，控制器生成的方式发生了显著变化。以往，生成控制器需要满足一系列条件，如派生自 ControllerBase 基类，或添加 [DynamicApiController] 特性，或实现 IDynamicApiController 接口。

现在，我们大大简化了这一过程，只需在类上添加 [Route("路由模板")] 特性，即可轻松生成控制器。

- // [ApiController]    // 此特性可选，主要实现模型绑定验证
+[Route("[controller]")]    // 仅需添加此路由特性，即可实现控制器的生成
 public class RouteController
 {
     public void Get()
     {
     }
 }

这一改进不仅简化了代码结构，还提高了开发效率，让开发者能够更加专注于业务逻辑的实现。

7. 修复审计日志 `Monitor` 不支持粘土对象 `Clay/dynamic` 类似格式化输出

问题分析

粘土对象赋予了强类型 C# 语言操作对象的能力，使其类似于弱类型语言 JavaScript 的灵活性。

在某些情况下，我们需要在接口中直接返回粘土对象 Clay/dynamic 类型。当引入审计日志 [LoggingMonitor] 支持时，我们发现无法正确输出 JSON 格式。例如：

+[LoggingMonitor]
+public dynamic TestClayMonitor()
{
    var clay = Clay.Parse("""
        {
        	"name": "Furion",
        	"age": 4,
        	"products": [{
        		"name": "Furion",
        		"author": "百小僧"
        	},
        	{
        		"name": "Layx",
        		"author": "百小僧"
        	}],
        }
        """);

+    return clay;
}

输出结果却是：

观察打印结果，我们发现粘土对象被错误地转换成了 key:value 格式，这显然不是期望的结果。

解决方案

在最近的更新中，我们已经修复了这个问题，现在输出格式正确无误：

8. 新增远程情况代理模式支持 `[BaseAddress]` 特性快速设置客户端 `BaseAddress`

问题分析

在实际开发中，我们经常会遇到需要对接第三方 API 接口的情况。过去，通常的做法是在全局配置文件如 Program.cs 或 Startup.cs 中统一设置每个接口的 BaseAddress。例如：

services.AddRemoteRequest(options =>
{
+    options.AddHttpClient("weixin", client => 
+    {
+        client.BaseAddress = new Uri("https://weixin.qq.com/");
+    });
});

这种方式虽然可以实现功能，但每次添加新的第三方接口时都需要在全局配置中增加相应的设置，显得不够灵活且不够直观。

解决方案

为了解决上述问题，我们在新版本中引入了 [BaseAddress] 特性。这一特性允许我们在接口级别甚至接口方法级别直接设置 BaseAddress，从而无需在全局配置中进行繁琐的设置。以下是使用新特性的示例：

+[BaseAddress("https://weixin.qq.com/")] // 为整个接口方法设置基础地址
public interface IHttp : IBase
{
     [Get("api/theapi")]
     Task<HttpResponseMessage> TheApi();

+    [Get("api/otherapi"), BaseAddress("https://v2.weixin.qq.com/")] // 为特定方法设置不同的基础地址
     Task<HttpResponseMessage> OtherApi();
}

使用 [BaseAddress] 特性的好处在于，它提供了更加灵活和精细化的配置方式，让我们能够根据不同的接口或方法需求设置不同的 BaseAddress。同时，这也减少了在全局配置中维护大量设置的工作量和出错的可能性。

因此，我们无需再编写如下全局配置代码：

// 不再需要全局配置设置 BaseAddress
// options.AddHttpClient("weixin", client => 
// {
//     client.BaseAddress = new Uri("https://weixin.qq.com/");
// });

通过这种方式，我们可以更加高效、简洁地进行接口的配置，提高开发效率和代码的可维护性。

本期更新

更新日志：https://furion.net/docs/category/upgrade/

新特性
- [新增] 远程请求代理模式支持 [BaseAddress] 特性快速设置 HttpClient 客户端 BaseAddress 4.9.2.25 ⏱️2024.04.19 ea88c95
- [新增] 粘土对象进行固化类型时支持 JsonSerializerOptions 序列化配置 4.9.2.24 ⏱️2024.04.17 cc6dd13
- [新增] 动态 WebAPI 支持贴 [Route] 特性动态生成控制器 4.9.2.19 ⏱️2024.04.16 #I9H1QH
- [新增] 粘土对象支持无限极组合嵌套功能 4.9.2.19 ⏱️2024.04.16 b02916e
- [新增] AES 加解密支持向量 IV、模式 Mode 和填充 Padding 配置 4.9.2.18 ⏱️2024.04.15 d549bba
- [新增] 定时任务作业计划工厂 ISchedulerFactory 启停作业 StartJob 和 PauseJob 方法 4.9.2.16 ⏱️2024.04.11 89061ef
突破性变化
- [更新] Swagger 文档注释逻辑，将 /// 注释方式优先级调整至最高，可覆盖 [DisplayName] 特性方式 4.9.2.17 ⏱️2024.04.14 ba5249c
- [更新] 定时任务作业计划工厂 TryRunJob 方法签名，追加 out IScheduler scheduler 参数 4.9.2.16 ⏱️2024.04.11 89061ef
问题修复
- [修复] 定时任务创建作业处理程序存在内存溢出风险 4.9.2.25 ⏱️2024.04.19 #I9D0RH
- [修复] 动态 WebAPI 不支持 [BindNever] 特性忽略路由和 Action 参数设置 4.9.2.25 ⏱️2024.04.19 21599e6
- [修复] 审计日志 Monitor 不支持粘土对象 Clay/dynamic 类型格式化输出 4.9.2.24 ⏱️2024.04.17 d578cfb
- [修复] 粘土对象无限嵌套粘土对象且 XElement 属性包含 type="null" 节点出现异常问题 4.9.2.21 ⏱️2024.04.16 9d5870f
- [修复] 粘土对象嵌套粘土对象只输出第一个属性问题 4.9.2.20 ⏱️2024.04.16 1a75778
- [修复] 动态 WebAPI 错误将 CancellationToken 类型当作路由参数 4.9.2.19 ⏱️2024.04.16 #I9H14X
- [修复] 定时任务因新增 GroupSet 功能影响到了原有的 SetGroupName 逻辑 4.9.2.15 ⏱️2024.04.11 #I9FOU0 9e08278
文档
- [更新] 事件总线文档、定时任务文档、规范化接口文档、远程请求文档、粘土对象文档、FS 静态类文档、序列化文档、模块化文档、规范化文档、数据加解密文档、动态 WebAPI 文档

微信关注我们

原文链接：https://www.oschina.net/news/288793/furion-4-9-2-25-released

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

有奖 | 寻找最美“开源声”

近日，开源中国 APP 正式版发布。此版本带来众多更新，如：应用整体页面布局更加合理与美观、动弹新增了语音与 GIF 能力等等.... 为了鼓励大家积极体验我们动弹的语音功能，特推出最美“开源声”活动。活动规则： 4 月 22 日- 4 月 28 日期间，在开源中国 APP「动弹」板块发布语音动弹，即有机会获得开源中国精美周边一份！礼物随时掉落，记得关注自己消息提现哦~ 还等什么，快来开源中国 APP 发布语音动弹，看谁的声音能够打动运营小姐姐吧~ ps：一段优美音乐 or 一段真情感慨 or 身边一切美好的声音均可~ 开源中国 APP 下载：https://www.oschina.net/app

2024-04-22

262

优化：优化用户管理模块；优化职级导入、导出功能；优化日志存储功能；优化广告功能模块；修复：修复近期用户反馈的BUG；一款 Java 语言基于 SpringCloud、SpringSecurity、Nacos、OAuth2、Vue2.x、ElementUI、MySQL 等框架精心打造的一款前后端分离框架，致力于实现模块化、组件化、可插拔的前后端分离架构敏捷开发框架，可用于快速搭建前后端分离后台管理系统，本着简化开发、提升开发效率的初衷，目前框架已集成了完整的 RBAC 权限架构和常规基础模块，前端 Vue 端支持多主题切换，可以根据自己喜欢的风格选择想一个的主题，实现了个性化呈现的需求；为了敏捷快速开发，提升研发效率，框架内置了一键 CRUD 代码生成器，自定义了模块生成模板，可以根据已建好的表结构 (字段注释需规范) 快速的一键生成整个模块的所有代码和增删改查等等功能业务，真正实现了低代码开发，极大的节省了人力成本的同时提高了开发效率，缩短了研发周期，是一款真正意义上实现组件化、低代码敏捷开发框架。软件信息软件名称：JavaWeb 微服务 Nacos 系列 EleVu...

2024-04-22

277

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Oracle

Oracle Database，又名Oracle RDBMS，或简称Oracle。是甲骨文公司的一款关系数据库管理系统。它是在数据库领域一直处于领先地位的产品。可以说Oracle数据库系统是目前世界上流行的关系数据库管理系统，系统可移植性好、使用方便、功能强，适用于各类大、中、小、微机环境。它是一种高效率、可靠性好的、适应高吞吐量的数据库方案。

JDK

JDK是 Java 语言的软件开发工具包，主要用于移动设备、嵌入式设备上的java应用程序。JDK是整个java开发的核心，它包含了JAVA的运行环境（JVM+Java系统类库）和JAVA工具。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。