CloudYxt.Api 3.1.0

• net6.0

  • CloudYxt.Base (>= 1.0.0)
  • Microsoft.AspNetCore.Mvc.Abstractions (>= 2.2.0)
  • Microsoft.AspNetCore.Mvc.Core (>= 2.2.5)
  • NSwag.AspNetCore (>= 13.16.1)

云享通.Net Core针对WEBAPI常规操作库。

3.1.0
取消对CloudYxt.Models的依赖

3.0.1
增加ApiMessageInfoException错误包装输出方法

3.0.0
升级包目标为.net6，增加remoteRealIp的ipv6支持

2.4.8
增加HttpContext.outputHtml、HttpContext.outputByte的ContentType类型设置

2.4.7
修复await的可返回BUG

2.4.6
增加HttpContext.outputHtml、HttpContext.outputByte用于WebApi直接输出HTML、字节数组到客户端

2.4.5
增加ApiMessagePackage支持Task控制器输出数据流的异常抛出和数据过滤包装，升级nuget版本

2.4.4
增加ApiMessageLog_Ch的入库字段名称序列

2.4.3
增加ApiMessageLog的ClickHouse类型ApiMessageLog_Ch

2.4.2
修复ApiMessagePackageIgnore属性未生效的BUG及日志记录BUG

2.4.0
同步支持CloudYxt.Base

2.3.3
修复当控制器带有动态类参数时日志未完整记录内容的BUG

2.3.2
修复BUG

2.3.1
通过ApiMessageAuthorizationAttribute认证的userId增加返回认证的Scheme

2.3.0
增加InvalidModelStateResponseFactory的ApiMessage处理方法：
services.Configure<ApiBehaviorOptions>(options =>
           {
               options.InvalidModelStateResponseFactory = ApiHelperExtend.ApiMessageInvalidModelState;
           });

注意：若要获取未验证通过的提交内容，务必EnableBuffering：
app.Use(async (ctx, next) =>
           {
               ctx.Request.EnableBuffering();
               await next();
           });

2.2.1
为ApiMessageLogAttribute增加自定义回调方法CallBackMethodName支持

2.2.0
增加权限认证属性[ApiMessageAuthorization]
权限认证成功后自动编写context.HttpContext.Items["userId"]
默认认证回调检查方法为用户自定义实现protected object mApiAuthorization(string Policy, string Roles, string AuthenticationSchemes, ActionExecutingContext context, string Scheme, string Parameter)
在WEBAPI中可通过User.Identities.FirstOrDefault(m => m.AuthenticationType == "Scheme")?.BootstrapContext获取权限检查成功的用户信息

2.1.0
增加无需日志的属性[ApiMessageLogIgnore]
调整回调日志方法mApiLog可为静态方法
context.HttpContext.Items存储的可选扩展字段名为userId、appId、custom

2.0.0
更名ApiMessage属性为ApiMessagePackage
增加ApiMessageLog，其中通用扩展属性字段可使用context.HttpContext.Items["字段名"]传递
例：(注意属性的绑定顺序)
[ApiController]
[ApiMessageLog(ApiName = "myApi")]
[ApiMessagePackage]
public class extController : ControllerBase
   {
       public void mApiLog(ApiMessageLog log)
       {
//由用户实现log的存储
       }

1.0.1
修复一个类型判断时的BUG

1.0.0：
建立基本处理模型。

[ApiMessage] ：数据结果进行messageData包装
[ApiMessageException]：拦截API内报错输出为messageData模式

ApiValidationError：模型验证错误类型
services.Configure<ApiBehaviorOptions>(options =>
{
   options.InvalidModelStateResponseFactory = (context) =>
   {
       var result = context.ModelState.ToMessageResult();
       return result;
   };
});

HttpContext扩展：
remoteRealIp：来源IP
remoteFrom：来源URL
remoteAgent：来源AGENT