Clear Code for Minimal API
|
我在写MinimalAPI的时候,发现不能最清晰的看到每个API,原因就是:WebAPI中不断增长逻辑处理过程
于是我在想如何简化API至一行,在一点一点想办法中,发现了简化DotNET Minimal API的方式。特此记录下来这个思路给需要帮助的人。我的灵感来源于 C# 11 功能 - 接口中的静态虚拟成员,通过静态虚拟成员清晰整个API。
这是我思路的最终结果:在 Program.cs 中我们能通过一行代码,清晰的看到代码情况。
而无需指定平常不是很关心的处理过程和请求方式。- app.MapGroup("Connect", o =>
- {
- o.MapMethods<Authorize>("Authorize");
- o.MapMethods<Authorize.Callback>("Authorize/Callback");
- o.MapMethods<Token>("Token");
- o.MapMethods<UserInfo>("UserInfo").RequireAuthorization(new AuthorizeAttribute()
- {
- AuthenticationSchemes = OpenIddictValidationAspNetCoreDefaults.AuthenticationScheme
- });
- o.MapMethods<Endsession>("Endsession");
- });
- app.MapGroup("Account", o =>
- {
- o.MapMethods<Login>("Login");
- o.MapMethods<Externallogin>("Externallogin");
- o.MapMethods<Externallogin.Callback>("Externallogin/Callback");
- o.MapMethods<ConfirmationLogin>("ConfirmationLogin");
- o.MapMethods<ForgotPassword>("ForgotPassword");
- o.MapMethods<ResetPassword>("ResetPassword");
- });
复制代码 我们只需要简单的三步就可以做到这个事情,并且可以不用反射和其他的复杂过程。
第一步,我们需要创建(附带静态抽象函数的接口)IEndpointBase。- public interface IEndpointBase
- {
- public static abstract IEnumerable<string> HTTPMethods();
- public static abstract Delegate Handler();
- }
复制代码 第二步,需要实现IEndpointBase。- public class Login : IEndpointBase
- {
- public record AccountLoginRequest
- {
- [JsonPropertyName("u"), Required]
- public string UserName { get; set; } = default!;
- [JsonPropertyName("p"), Required]
- public string Password { get; set; } = default!;
- [JsonPropertyName("r"), Required]
- public string ReturnUrl { get; set; } = default!;
- [FromQuery]
- public bool UseCookies { get; set; }
- }
- public static Delegate Handler()
- {
- var callback = async ([FromBody] AccountLoginRequest request, [FromServices] SignInManager signInManager) =>
- {
- // Todo: returnUrl validate is success
- var result = await signInManager.PasswordSignInAsync(request.UserName, request.Password, request.UseCookies, lockoutOnFailure: true);
- return Results.Text(result.ToString());
- };
- return callback;
- }
- public static IEnumerable<string> HTTPMethods() => [HttpMethods.Post];
- }
复制代码 第三步:处理静态IEndpointBase,此时我们已经完成了这件事情。- public static RouteHandlerBuilder MapMethods<T>(this IEndpointRouteBuilder app, [StringSyntax("Route")] string pattern) where T : IEndpointBase
- {
- return app.MapMethods(pattern, T.HTTPMethods(), T.Handler());
- }
复制代码 单纯的使用扩展好的 MapMethods 已经足够清晰了。
但如果有对API进行分组的要求,使用原生的还是不会清晰,原因是:
- 要对 MapGroup 的值赋予变量名,比如说 var accountGroup = app.MapGroup("Account"),每个组都要想个名字。accountGroup
- 不能清楚自己的边界,比如说 写代码时,有可能出现插队的情况,本来 accountGroup下面都是属于它的端点,结果不小心插进来一个别的。
于是简单的对MapGroup进行了扩展,最终结果在本文最上面。- public static void MapGroup(this IEndpointRouteBuilder endpoints, [StringSyntax("Route")] string prefix, Action<IEndpointRouteBuilder> action)
- {
- var group = endpoints.MapGroup(prefix);
- action(group);
- }
复制代码 总结:通过这种方式,代码结构已经清晰多了。若是有议,可以在评论区联系我。
来源:https://www.cnblogs.com/YataoFeng/p/18202396
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作! |
|
|
|
发表于 2024-5-20 20:24:58
举报
回复
分享
|
|
|
|