在目前的软件开发的潮流中,不管是前后端分离还是服务化改造,后端更多的是通过构建 API 接口服务从而为 web、app、desktop 等各种客户端提供业务支持,如何构建一个符合规范、容易理解的 API 接口是我们后端开发人员需要考虑的。在本篇文章中,我将列举一些我在使用 ASP.NET Core Web API 构建接口服务时使用到的一些小技巧,因才疏学浅,可能会存在不对的地方,欢迎指出。
代码仓储:https://github.com/Lanesra712/ingos-server
二、Step by Step因为本篇文章中涉及到的一些知识点在之前的文章中也已经有具体的解释了,所以这里只会说明如何在 ASP.NET Core Web API 中如何去使用,不会做过多的详细介绍。如果你需要详细了解的话,可以跳转到文章中给出的外链地址去查看。
本篇文章中使用的代码是基于 .NET Core 2.2 + .NET Standard 2.0 进行构建的,如果你采用的版本与我使用的不同,可能最终实现起来的代码会有所不同,请提前知悉。同时,本篇文章中所有示例代码都会存在于前言中所列出的 github repo 中,我会尝试将每个功能点的开发作为一次 commit,并且也会在后续进行不定期的更新完善,最终搭建一个基于领域驱动思想的后端项目模板,如果对你有帮助的话,欢迎持续关注。
1、使用小写路由在我之前的一篇文章中(构建可读性更高的 ASP.NET Core 路由)有提到过,因为 .NET 默认采用 Pascal 的类命名方式,如果采用默认生成的路由,最终构建出的路由地址会存在大小写混在一起的情况,虽然在 .NET Core 中大小写的路由地址最终都会对于到正确的资源上,但是为了更好的符合前端的规范,所以这里我们首先按照之前的文章中所列出的方法去修改默认生成的路由地址格式。
因为这里我们最终想要实现的是符合 Restful 风格的 API 接口,所以这里我们首先需要将默认生成的 URL 地址改为全小写模式。
public void ConfigureServices(IServiceCollection services) { // 采用小写的 URL 路由模式 services.AddRouting(options => { options.LowercaseUrls = true; }); }