📝 发布 Furion v4.6.1 版本

### 功能描述

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

包含以下功能更新：

### 功能清单

- [x] 包含 [https://gitee.com/dotnetchina/Furion/issues/I5UVMV](https://gitee.com/dotnetchina/Furion/issues/I5UVMV) 功能更新
- [x] 新增 `LogMessage` 结构 `UseUtcTimestamp` 字段，解释日志记录时间格式是 `UTC` 还是 `LOCAL` 时间 <sup>4.6.1</sup> [aab0371](https://gitee.com/dotnetchina/Furion/commit/aab0371d6473117e1e602eef1b9841c48d184e84)
- [x] 新增 `LoggingMonitor` 支持序列化忽略指定属性名或属性类型 <sup>4.6.1</sup> [81c6343](https://gitee.com/dotnetchina/Furion/commit/81c6343a2ddb3751e72de7c5943048c903c638b4)
- [x] 优化 `LogMessage` 结构类型字段设计 [b85dc56](https://gitee.com/dotnetchina/Furion/commit/b85dc56d0b29a2f764886608050430ec0d021651)
- [x] 发布 `v4.6.1` 版本文档
- [x] 更新示例项目 `samples` 依赖至 `v4.6.1` 版本
- [x] [Replit](https://replit.com/) 网站 `Furion` 案例同步到 `v4.6.1` 版本
- [x] `Gitee` 和 `Github` 发布 `Release-v4.6.1` 版本
- [x] 同步更新日志

### 代码实现

[https://gitee.com/dotnetchina/Furion/pulls/615](https://gitee.com/dotnetchina/Furion/pulls/615)

[https://gitee.com/dotnetchina/Furion/commit/aab0371d6473117e1e602eef1b9841c48d184e84](https://gitee.com/dotnetchina/Furion/commit/aab0371d6473117e1e602eef1b9841c48d184e84)

[https://gitee.com/dotnetchina/Furion/commit/b85dc56d0b29a2f764886608050430ec0d021651](https://gitee.com/dotnetchina/Furion/commit/b85dc56d0b29a2f764886608050430ec0d021651)

[https://gitee.com/dotnetchina/Furion/commit/4f6b59183ba0a43eb705925b5d01982021f71d90](https://gitee.com/dotnetchina/Furion/commit/4f6b59183ba0a43eb705925b5d01982021f71d90)

[https://gitee.com/dotnetchina/Furion/commit/81c6343a2ddb3751e72de7c5943048c903c638b4](https://gitee.com/dotnetchina/Furion/commit/81c6343a2ddb3751e72de7c5943048c903c638b4)

### 文档更新

1. **日志默认模板显示 `U` 表示时间是 `UTC`，显示 `L` 表示时间是 `LOCAL`，也就是本地时间。**

![输入图片说明](https://foruda.gitee.com/images/1665339504519106561/671695bc_974299.png "屏幕截图")

2. **`LoggingMonitor` 支持序列化忽略指定属性名或属性类型**

- **局部配置**

```cs
// 忽略名称和属性，支持单一配置或局部配置
[LoggingMonitor(JsonBehavior = JsonBehavior.OnlyJson
    , IgnorePropertyNames = new[] { "Bytes" }
    , IgnorePropertyTypes = new[] { typeof(byte[]) })]
public object 测试指定忽略指定序列化类型(int id)
{
    return new
    {
        Id = 10,
        Bytes = File.ReadAllBytes("image.png")
    };
}
```

- **全局配置**

```cs
// 忽略名称和属性，支持单一配置或局部配置
services.AddMonitorLogging(options =>
{
    options.IgnorePropertyNames = new[] { "Byte" };
    opensource.IgnorePropertyTypes = new[] { typeof(byte[]) };
});
```

![输入图片说明](https://foruda.gitee.com/images/1665401130490992395/e34bc877_974299.png "屏幕截图")

3. **事件总线增加重试失败后支持回调功能**

```

2. 注册 `EventFallbackPolicy` 类型服务

```cs
services.AddEventBus(options =>
{
    options.AddFallbackPolicy<EventFallbackPolicy>();
});
```

3. 通过 `[EventSubscribe]` 特性配置 `FallbackPolicy` 属性使用

```cs
[EventSubscribe("test:error", NumRetries = 3, FallbackPolicy = typeof(EventFallbackPolicy))]  // 重试三次
public async Task TestError(EventHandlerExecutingContext context)
{
    Console.WriteLine("我执行啦~~");
    throw new NotImplementedException();
}
```

![输入图片说明](https://foruda.gitee.com/images/1665394940924096835/3d125de8_974299.png "屏幕截图")

------

可以定义多个 `IEventFallbackPolicy` 实现类，然后通过 `options.AddFallbackPolicy<T>()` 注册多个，这样实现不同的事件订阅程序执行不同的策略。如：

```cs showLineNumbers {1,3}
[EventSubscribe("test:error", NumRetries = 3, FallbackPolicy = typeof(EventFallbackPolicy))]

[EventSubscribe("test:error", NumRetries = 1010, FallbackPolicy = typeof(OtherEventFallbackPolicy))]
```

GVP dotNET China/Furion

内容风险标识

评论 (2)

GVPdotNET China/Furion

内容风险标识