📝 发布 Furion v4.8.3 版本

### 功能描述

发布 `Furion` 和 `Furion.Tools` 和 `Furion.Xunit` `v4.8.3` 版本

### 历史背景

>
>在 v4.8.0 版本之前，旧版本定时任务提供了 `SpareTime.DoIt` 和 `SpaceTime.DoOnce` 来模拟后台执行，但这种方式内部使用的是 `Task` + `Timer` 实现，**性能差不说，而且使用时内存和 `CPU` 存在波动不平，在高并发的情况下会因为 `GC` 频繁回收检查导致 尾延迟（Tail Latency） 现象严重。**
>
> 所以开发出新的模块：任务队列（TaskQueue），除了替代上面的 `SpareTime` 两个方法以外，同时具有**超低内存，超低 `CPU` 占用，吞吐量极高等非常优秀的特点。**
>
> [https://furion.baiqian.ltd/docs/task-queue](https://furion.baiqian.ltd/docs/task-queue)

包含以下功能更新：

### 功能清单

- [x] 新增 **定时任务 `IScheduler` 对象每次操作后自动刷新和提供手动刷新 `Reload()` 方法** 4.8.3.3 ⏱️2022.12.09 [#I65EQ1](https://gitee.com/dotnetchina/Furion/issues/I65EQ1#note_15047484_link)
- [x] 新增 **🎉 [全新的任务队列模块](https://furion.baiqian.ltd/docs/task-queue)** 4.8.3 【[查看源码](https://gitee.com/dotnetchina/Furion/tree/v4/framework/Furion/TaskQueue)】
- [x] 新增 [TaskQueued](https://furion.baiqian.ltd/docs/global/taskqueued) 全局静态类文档
- [x] 修复 定时任务通过 `scheduler.RemoveTrigger(triggerId)` 报异常问题 4.8.3.3 ⏱️2022.12.09 [#I65EQ1](https://gitee.com/dotnetchina/Furion/issues/I65EQ1#note_15047484_link)
- [x] 修复 定时任务作业触发器配置了 `EndTime` 和 `StartTime` 之后 `Status` 没有对应上 4.8.3.1 ⏱️2022.12.09 [52a5506](https://gitee.com/dotnetchina/Furion/commit/52a5506c2fda7c31df01b2e90af7ad6b0c5f94aa)
- [x] 修复 定时任务通过 `scheduler.AddTrigger(triggerBuilder)` 无效的问题 4.8.3.1 ⏱️2022.12.09 [#I65EQ1](https://gitee.com/dotnetchina/Furion/issues/I65EQ1)
- [x] 发布 `v4.8.3` 版本文档
- [x] 更新 示例项目 `samples` 依赖至 `v4.8.3` 版本
- [x] 同步 [Replit](https://replit.com/@MonkSoul/HelloFurion) 网站 `Furion` 案例至 `v4.8.3` 版本
- [x] 发布 `Gitee` 和 `Github` `Release-v4.8.3` 版本
- [x] 同步 更新日志

### 代码实现

[https://gitee.com/dotnetchina/Furion/tree/v4/framework/Furion/TaskQueue](https://gitee.com/dotnetchina/Furion/tree/v4/framework/Furion/TaskQueue)

### 文档更新

**1. 任务队列服务 `ITaskQueue`**

注册 `TaskQueue` 服务

```cs showLineNumbers
services.AddTaskQueue();
```

使用 `ITaskQueue` 服务

```cs showLineNumbers {1,8,18,24,34,32,38,46,53,61,68}
using Furion.TaskQueue;

namespace Your.Application;

public class YourService : IYourService
{
    private readonly ITaskQueue _taskQueue;
    public YourService(ITaskQueue taskQueue)
    {
        _taskQueue = taskQueue;
    }

/// <summary>
 /// 同步入队
 /// </summary>
 public void SyncTask()
 {
 _taskQueue.Enqueue(provider =>
 {
 Console.WriteLine("我是同步的");
 });

// 如无需使用 provider 参数，可用 _ 替代
        _taskQueue.Enqueue(_ => {});
    }

/// <summary>
 /// 同步入队，延迟 3 秒触发
 /// </summary>
 public void SyncTask2()
 {
 _taskQueue.Enqueue(provider =>
 {
 Console.WriteLine("我是同步的，但我延迟了 3 秒");
 }, 3000);

// 如无需使用 provider 参数，可用 _ 替代
        _taskQueue.Enqueue(_ => {}, 3000);
    }

/// <summary>
 /// 异步入队
 /// </summary>
 public async Task AsyncTask()
 {
 await _taskQueue.EnqueueAsync(async (provider, token) =>
 {
 Console.WriteLine("我是异步的");
 await ValueTask.CompletedTask;
 });

// 如无需使用 provider 和 token 参数，可用 _ 替代
        await _taskQueue.EnqueueAsync(async (_, _) => {});
    }

/// <summary>
 /// 异步入队
 /// </summary>
 public async Task AsyncTask2()
 {
 await _taskQueue.EnqueueAsync(async (provider, token) =>
 {
 Console.WriteLine("我是异步的，但我延迟了 3 秒");
 await ValueTask.CompletedTask;
 }, 3000);

// 如无需使用 provider 和 token 参数，可用 _ 替代
        await _taskQueue.EnqueueAsync(asyn (_, _) => {}, 3000);
    }
}
```

-----

**2. `TaskQueued` 静态类**

框架还提供了 `TaskQueued` 静态类可在任何线程中操作，如：

```cs showLineNumbers {2,5}
// 同步入队
TaskQueued.Enqueue((provider) => {}, [delay]);

// 异步入队
await TaskQueued.EnqueueAsynce(async (provider, token) => {}, [delay]);
```

-----

**3. 强制刷新当前作业**

通常情况下我们通过 `_schedulerFactory.GetJob("jobId")` 获取到作业之后，然后对这个作业进行操作，**但操作之后这个对象并不能同步更改，需要反复调用 `GetJob` 方法。**。

所以在 `Furion 4.8.3.3+` 版本之后，**`IScheduler` 任何操作都将自动调用 `Reload()` 方法刷新变量**。

```cs showLineNumbers
// 也可以自己手动强制刷新（通常不需要调用下面代码~~）
scheduler.Reload();
```

GVP dotNET China/Furion

内容风险标识

评论 (5)

GVPdotNET China/Furion

内容风险标识