📝 发布 Furion v4.6.6 版本

### 功能描述

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

包含以下功能更新：

### 功能清单

- [x] 新增支持特定控制台或特定方法支持独立的序列化配置选项 [797b0bf](https://gitee.com/dotnetchina/Furion/commit/797b0bfe7c702877b1e0f56ee1a97d91fc80c551)
- [x] 新增 `Newtonsoft.Json` 反序列化 `0001-01-01 00:00:00` 格式（缺失毫秒）为 `DateTimeOffset` 异常处理 [ea62ce7](https://gitee.com/dotnetchina/Furion/commit/ea62ce7d998980792d6235e577a7e71325401808)
- [x] 优化 `axios-utils.ts` 代码，添加全局异常处理 [416c960](https://gitee.com/dotnetchina/Furion/commit/416c960c1921f2bd0a3c98e535bd689d18172ad1)
- [x] 发布 `v4.6.6` 版本文档
- [x] 更新示例项目 `samples` 依赖至 `v4.6.6` 版本
- [x] [Replit](https://replit.com/) 网站 `Furion` 案例同步到 `v4.6.6` 版本
- [x] `Gitee` 和 `Github` 发布 `Release-v4.6.6` 版本
- [x] 同步更新日志

### 代码实现

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

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

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

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

### 文档更新

**1. 支持特定控制器或特定方法独立序列化配置选项**

很少开发者注意到 `new JsonResult(data)` 实际上有第二个参数的，也就是 `new JsonResult(data, serializerSettings)`，那么可以根据自己的逻辑传递第二个参数，如果不传递则采用全局配置的序列化选项。

`Furion` 框架提供两种处理方式：

- 第一种：手动 `new JsonResult` 对象并设置 `serializerSettings` 参数

```cs showLineNumbers {1,4,13-16}
[NonUnify]
public IActionResult SpecialApi()
{
    return new JsonResult(new YourRESTfulResult<object>
    {
        StatusCode = 200,
        Succeeded = true,
        Data = new
        {
            Name = "Furion"
        },
        Timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()
    }, new JsonSerializerOptions
    {
        PropertyNamingPolicy = null
    });
}
```

- 第二种：通过 `services.AddUnifyJsonOptions` 配置多个序列化选项 **推荐**

在 `Startup.cs` 中注册一套新的规则：

```cs showLineNumbers {1}
services.AddUnifyJsonOptions("special", new JsonSerializerOptions // 如果使用 Newtonsoft.Json => new JsonSerializerSettings
{
    PropertyNamingPolicy = null
});
```

代码使用：

```cs showLineNumbers {1}
[UnifySerializerSetting("special")]
public object SpecialApi()
{
    return new
    {
      Name = "Furion"
    }
}
```

其他补充：目前 `Swagger` 暂未提供个别的接口自定义 `schema` 序列化选项。

-----

**2. `DateTimeOffset` 发序列化异常**

以下处理只针对 `Newtonsoft.Json`，数据为 `0001-01-01 00:00:00` 的情形下反序列化为 `DateTimeOffset` 类型报错：

```txt showLineNumbers
Could not convert string to DateTimeOffset: 0001-01-01 00:00:00
```

相关问题讨论：[https://stackoverflow.com/questions/50628374/json-net-deserializing-datetimeoffset-value-fails-for-datetimeoffset-minvalue-wi/50631270#50631270](https://stackoverflow.com/questions/50628374/json-net-deserializing-datetimeoffset-value-fails-for-datetimeoffset-minvalue-wi/50631270#50631270)

- `System.Text.Json` 方式

无需配置

- `Newtonsoft.Json` 方式

```cs showLineNumbers {3-5}
.AddNewtonsoftJson(options =>
{
    options.SerializerSettings.MetadataPropertyHandling = MetadataPropertyHandling.Ignore;
    options.SerializerSettings.DateParseHandling = DateParseHandling.None;
    options.SerializerSettings.Converters.Add(new IsoDateTimeConverter { DateTimeStyles = DateTimeStyles.AssumeUniversal });
});
```

GVP dotNET China/Furion

内容风险标识

评论 (2)

GVPdotNET China/Furion

内容风险标识