功能描述

发布 Furion 和 Furion.Tools 和 Furion.Xunit v4.8.4 版本

包含以下功能更新：

功能清单

• [新增] 定时任务 Dashboard 看板 ^{4.8.4 ⏱️2022.12.30} d3f9669
• [移除] 旧版本定时任务模块所有功能代码，请尽快迁移到新版本 d9dc9e4
• [新增] 视图引擎支持无命名空间的强类型 ^{4.8.4.16 ⏱️2023.01.15} #I6ABN3:视图引擎强类型模板运行报错 #I6A7SI:视图引擎,对数组的类型转换问题 076bb17
• [新增] 视图引擎支持匿名类型模型带集合类型属性 @foreach 遍历 ^{4.8.4.15 ⏱️2023.01.13} #I6A7SI:视图引擎,对数组的类型转换问题
• [新增] Swagger 支持复制路由地址功能 ^{4.8.4.13 ⏱️2023.01.11} #I5VNJI:Swagger 增加复制功能
• [新增] 动态 WebAPI 方法支持通过 [ActionName(名称)] 和 [HttpMethod(Name=名称)] 指定路由名称 ^{4.8.4.12 ⏱️2023.01.10} #I69AOJ:Get、Post特性能否用在标记动态ApiController的方法中替换方法名形成路由 f699540
• [新增] BadPageResult.Status401Unauthorized 等常见状态码 401,403,404,500 静态属性 ^{4.8.4.11 ⏱️2023.01.09} #I69KQF:JwtHandler中如何返回BadPageResult()视图对象
• [新增] crontab.GetSleepTimeSpan(baseTime) 实例方法 ^{4.8.4.10 ⏱️2023.01.09} #I69HM4:新版定时作业如何实现Sparetime.DoOnce操作
• [新增] Enqueue/EnqueueAsync 支持 Cron 表达式 实例重载方法 ^{4.8.4.10 ⏱️2023.01.09} #I69HM4:新版定时作业如何实现Sparetime.DoOnce操作
• [新增] *.bcmap 和 .properties 文件类型 MIME 支持 ^{4.8.4.9 ⏱️2023.01.06} !694:【轻量级 PR】：update framework/Furion.Pure/VirtualFileServer/FS.cs.
• [新增] 定时任务 Dashboard 查看作业触发器最近运行记录功能 ^{4.8.4.3 ⏱️2023.01.03} e7d24d8
• [新增] 定时任务作业触发器 trigger.GetTimelines() 获取最近 10 条运行记录列表 ^{4.8.4.3 ⏱️2023.01.03} e7d24d8
• [新增] 定时任务 IScheduler.GetEnumerable() 方法，可将作业计划转换成可枚举字典 ^{4.8.4 ⏱️2022.12.30} 4d5235c
• [修复] 定时任务 StartAll 出现个别作业显示 无触发时间 的状态 ^{4.8.4.14 ⏱️2023.01.12} #I6A08X:schedule pauseall startall的问题
• [修复] 动态 WebAPI 配置 [Consumes] 特性后 Swagger 不显示问题 ^{4.8.4.12 ⏱️2023.01.10} daf25f8
• [修复] 定时任务停止作业触发器后运行记录不能写入最新记录问题 ^{4.8.4.8 ⏱️2023.01.05} d4c553f
• [修复] 数据库日志注册在一些特殊情况下丢失日志上下文问题 ^{4.8.4.6 ⏱️2023.01.04} #I68PDF:请帮看下使用第三方微信服务后，导致日志上下文为null的问题
• [修复] 远程请求配置 WithEncodeUrl(false) 对 application/x-www-form-urlencoded 请求类型无效 ^{4.8.4 ⏱️2022.12.30} #I682DX: 远程请求（第二次使用远程请求遇到问题，这次不确定是框架问题，还是我不会使用）
• [修复] 在类中贴 [SuppressMonitor] 特性但 LoggingMonitor 依然输出问题 ^{4.8.4 ⏱️2022.12.30} #I6882I:SuppressMonitor 在Class中标记无效
• [修复] 定时任务使用 Furion.Pure 包访问 Dashboard 出现 404 问题 ^{4.8.4.2 ⏱️2023.01.02} 21977b7
• [优化] 任务队列同步调用代码 79884ff
• [升级] SqlSugarCore 拓展包及脚手架至 v5.1.3.45 版本
• [发布] v4.8.4 版本文档
• [更新] 示例项目 samples 依赖至 v4.8.4 版本
• [同步] Replit 网站 Furion 案例至 v4.8.4 版本
• [发布] Gitee 和 Github Release-v4.8.4 版本
• [同步] 更新日志

代码实现

d9dc9e4

adebfd6

4d5235c

c87f23d

79884ff

文档更新

1. 新增定时任务 Dashboard 看板功能

在 Furion 4.8.4+ 版本内置了一个嵌入的定时任务看板功能，只需要在 Startup.cs 中启用即可，如：

app.UseStaticFiles();
app.UseScheduleUI();

// 还可以配置生产环境关闭
app.UseScheduleUI(options =>
{
    options.DisableOnProduction = true;
});

app.UseScheduleUI() 必须在 app.UseStaticFiles() 之后注册，且当前版本暂未提供任何自定义功能。

接着打开浏览器并访问 /schedule 地址即可：

注意：当前 Furion 4.8.4+ 版本暂未提供任何自定义功能，包括 /schedule 地址配置。

2. 定时任务作业计划可转换成可枚举字典

通常我们在开发应用时，需要将作业计划信息进行拆解，比如一个作业计划包含两个作业触发器，那么可以通过 scheduler.GetEnumerable() 方法生成可枚举字典对象，字典中的项数量等于作业触发器数量。

foreach (var (jobDetail, trigger) in scheduler.GetEnumerable())
{
      // ....
}

3. 添加 InjectOptions 配置文档

.Inject() 方法提供了一个可配置的选项 InjectOptions，可以通过该配置配置框架初始化的一些配置，如：

.Inject((builder, options) =>
{
    options.AssemblyName = "Furion";    // 配置外部程序集名称
    options.AutoRegisterBackgroundService = true;   // 是否自动注册 BackgroundService

    options.ConfigurationScanDirectories("目录1", "目录2", ...); // 配置配置文件扫描目录
    options.IgnoreConfigurationFiles("文件1", "文件2", ...);    // 配置忽略配置文件

    // 配置配置对象
    options.ConfigureAppConfiguration((context, config) =>
    {
    });

    // 配置配置对象（Web）
    options.ConfigureWebAppConfiguration((context, config) =>
    {
    });

    // 配置 ConfigureServices
    options.ConfigureServices((context, services) =>
    {
    });

    // 配置 ConfigureServices（Web）
    options.ConfigureWebServices((context, services) =>
    {
    });
});

4. 获取内存中作业触发器最近运行的 10 条记录

var timelines = trigger.GetTimelines();   // => [{numberOfRuns: 2, lastRunTime: "2023-01-03 14:00:08"}, {numberOfRuns: 1, lastRunTime: "2023-01-03 14:00:03"}, ...]