寄语

每一个孩子都是世界上最可爱的模样，愿我们多一点童心，不忘初心，逐梦不止。

本期更新

• 新特性

  • [新增] 规范化文件 EnableAllGroups 功能，可以将多个分组合并到一个分组中 9277b98
  • [新增] angular-utils 客户端工具库，专门处理 angular 项目接口代理问题 6c70584
  • [新增] Swagger 支持单个接口更多描述功能（支持 html）e5e1db0
  • [新增] Swagger 接口 [Obsolete] 过时支持功能 e5e1db0

• 突破性变化

  • [内置] 默认内置 GBK，Windows-1252, Shift-JIS, GB2312 等编码支持 c456ecb

• 问题修复

  • [修复] <inheritdoc /> 不能跨程序集问题 3b9d39c
  • [修复] v3.3.1 版本导致 Swagger 不能显示问题 6763352
  • [修复] 远程请求、JSON以及 Web 页面不支持 GBK，GB2312 等国标编码问题 c456ecb
  • [修复] 远程请求响应报文设置了 Content-Type:charset= 不能自动转换编码问题 c456ecb

• 其他更改

  • [新增] axios-utils.ts 和 angular-utils.ts 多客户端支持

• 文档

  • [新增] GlobalUsings 文档 文档地址
  • [更新] 规范化文档，Worker Service 文档，动态 API 文档

本期亮点

1. 启用 All Groups 分组功能

有时候我们为了更好的对接口进行归类，配置了 Swagger 多个分组的功能，但这样也对生成客户端请求代码造成了困扰，所以添加了新的配置：

{
  "SpecificationDocumentSettings": {
    "EnableAllGroups": true
  }
}

2. 接口过时控制

当我们某个接口已经过时，提示尽早调用最新接口，只需要在方法上面贴 [Obsolete] 即可，如：

[Obsolete("GetName() 已经过时，请调用 GetFrameworkName() 替代")]
public string GetName()
{
  return nameof(Furion);
}

[Obsolete]
public string Other()
{
  // ...
}

3. 单一接口更多描述

在该版本新增了 [ApiDescriptionSettings] 的 Description 属性，支持定义更多描述，如：

[ApiDescriptionSettings(Description = "我是一段描述，显示更多内容 <button>我是按钮</button>")]
public string add()
{
  //....
}