如何在 40 秒内创建一个.Net Core Web API?

为什么我们需要自己写代码?为什么计算机无法自动为我们生成这些代码呢?很显然,我们应该可以利用这些共同点,从一个给定的数据库自动化构建系统——这就是“我”创建Magic的初衷。

作者 | Thomas Hansen

译者 | 弯月,责编 | 郭芮

出品 | CSDN(ID:CSDNnews)

以下为译文:

作为一名C#开发人员,我坦白虽然我很喜欢C#,喜欢它的强类型、编译器、泛型、LINQ等等,但有时我也会嫉妒PHP和Python开发人员。Python和PHP在本质上更为动态,而且还可以实现C#几乎不可能完成的任务。大约在一年前,我的一位朋友向我展示了Django,我羞愧地承认.NET没有类似的功能。因此,我决定通过自己的努力创造奇迹,于是我创建了Magic。

CRUD、HTTP和SQL

在软件开发人员眼中,很多问题都可以归结为将JSON从客户端传输到后端。这个问题是如此普遍,所以我们总结出了一个缩写CRUD:创建(Create)、读取(Read)、更新(Update)和删除(Delete)。HTTP请求的类型有post、put、delete和get。SQL拥有insert、update、delete和select。可以说,所有这些操作都基于相同的概念,即CRUD。

因此,很显然我们应该可以利用这些共同点,从一个给定的数据库自动化构建系统。为什么我们需要自己写代码?为什么计算机无法自动为我们生成这些代码呢?

Magic

我创建的Magic能够从数据库架构中读取元信息,并利用这些信息来创建HTTP REST端点的脚手架代码,并对数据库中的每个CRUD操作提供封装。我们的目的是在控制器端点和数据库之间建立一层薄薄的“ Hyperlambda”,你只需轻轻点击一个按钮,就可以创建和公开数据库上所有的CRUD操作。

Hyperlambda是一种动态编程语言,也是一种DSL,它不需要编译,但是它能够快速处理这些类型的操作,因为每个Hyperlambda关键字只不过是C#中的类的封装。

因此,我们很容易创建Hyperlambda“关键字”,并通过这些关键字对客户端进行身份验证和授权、将记录插入到我们的数据库中、读取记录等,所有的操作只需几行代码即可实现。它的语法非常容易理解,而且计算机也很容易理解,这样用户可以通过对关键字的排列来创建代码的脚手架。

演示过程:https://youtu.be/ncH4QRpKvx0

在这段视频中,Magic首先会读取数据库中每个表的数据库架构。然后,创建四个Hyperlambda文件,每个CRUD操作一个文件。这些Hyperlambda文件的路径取决于数据库对象的名称,因此,假设数据库名为“ foo”,表名为“ bar”,那么HTTP GET的路径为“/files/magic/foo/bar.get.hl”,指向包含Hyperlambda文件的磁盘物理路径。

接下来,我通过一个动态路由控制器接受“/magic”下面的“任何” URL。该路由负责解析我的Hyperlambda文件,并根据给出的URL,执行相应的HTTP动词。

那么,现在我可以在运行时自动创建Hyperlambda代码了,这些代码可以封装现有的数据库,却不会中断应用程序的正常使用。此外,我还通过一个路由机制将HTTP请求动态路由到服务器中的文件和文件夹(之前创建的文件)。

对于小规模的简单应用程序来说,整个后端的Web API就这么多,下一步你可以立即开始创建Angular或React的前端了。而复杂的应用程序可能需要上面没有提供的其他功能,但是至少你的后端已有了基本的雏形,接下来你可以随意编写C#代码和.Net控制器。

Magic基本上就相当于“面向.Net Core和C# 的Django”。即使你的应用根本不需要CRUD,但如果你使用MySQL或微软的SQL Server,它仍然可以作为一个出色数据库管理系统,帮助你在生产和开发环境中管理数据库。从这个角度来说,它相当于“面向.Net Core的PHPMyAdmin”。

功能简介

Magic可以自动处理身份验证和授权。例如,可以为每个HTTP端点分配一个“角色”列表(以逗号分隔),客户端必须经过身份验证才能执行端点的代码。这个实现采用了JWT令牌,它会在调用“身份验证” HTTP端点时生成并返回给客户端。

由于Magic本身可以兼容所有的数据库,因此仍需要在这些方面进行一些手工操作。但实际上只是复制/粘贴的工作,你可以根据需要在生产中进行。顺便说一句,有人可能对密码存储感兴趣,我在这里说明一下:密码的存储采用了BlowFish散列(“慢散列”),还支持独立的加盐算法。

你还可以通过Magic通知脚手架代码的生成过程,要求将各个端点上的HTTP请求写入日志。默认情况下,Magic使用log4net,但你可以创建自己的日志接口并替换,然后通过依赖注入提供给Magic。实际上,Magic中的所有内容都是基于IoC和依赖注入的。

另外,你可以声明希望它提供支持的CRUD操作。例如,某些数据库表可能是“只读”,在这种情况下你根本不需要删除或更新端点。你只需修改生成脚手架代码过程中的一个简单的复选框。

Magic超级快。首先,每个Hyperlambda文件的大小都很小——大约只有10-20行代码。因此,与执行和处理针对某些数据库的SQL命令的昂贵过程相比,解析和评估Hyperlambda文件几乎没有成本。

因此,这种“微小的Hyperlambda层”几乎没有额外的成本。此外,Hyperlambda的评估过程也已经优化到了极致。Hyperlambda本质上是百分百“异步”,这意味着它在评估Hyperlambda文件时也会使用C#和CLR的异步功能。因此,可以带来巨大的“吞吐量”,并提供了可扩展性功能,以方便应用到任何“纯” C#或.NET的应用程序中。如果你问我的看法,那么我会告诉你一行代码都不用写,难道不够伟大吗?

通过你自己的关键字扩展Hyperlambda就像创建一个简单的C#类一样容易。下面是一个真实的示例,我使用了自己的一个关键字[strings.starts-with],如果某个字符串以其他字符串开头则返回true。

namespace magic.lambda.strings

{

[Slot(Name = "strings.starts-with")]

public class StartsWith : ISlot

{

public void Signal(ISignaler signaler, Node input)

{

// Sanity checking.

if (input.Children.Count() != 1)

throw new ApplicationException("[strings.starts-with] must be given exactly one argument that contains value to look for");

signaler.Signal("eval", input);

input.Value = input.GetEx()

.StartsWith(input.Children.First().GetEx(), StringComparison.InvariantCulture);

}

}

}

创建自己的关键字就像向类添加属性和接口一样简单,而且你还有一个新的“ Hyperlambda关键字”。这个功能为编程语言提供了一些极端的“DSL功能”。由此产生的Hyperlambda更方便人类的阅读和理解。

然而,你无需了解Hyperlambda即可使用Magic,因为你的计算机明白如何创建和维护Hyperlambda。因此,Hyperlambda与Magic的关系就相当于CLR代码与C#。

如下示例演示了一个Hyperlambda HTTP端点。请注意,由于Hyperlambda是我自己创建的,因此在DZone甚至在Visual Studio Code中都没有办法高亮显示Hyperlambda,据我所知,Hyperlambda在全球范围内只有不到5个用户。

但是,我有一个基于JavaScript的Hyperlambda编辑器,它是Magic不可或缺的部分,它可以在你的代码中高亮显示Hyperlambda语法,而且也可以自动补齐。

/*

* Declaration of arguments the endpoint can accept.

*/

.arguments

limit:long

offset:long

order:string

direction:string

id:long

name:string

/*

* Appending arguments in [slots.signal] below.

*/

add:x:./*/slots.signal/*/args

get-nodes:x:@.arguments/*

/*

* Invoking [slots.signal] with "magic.db.mysql.read".

*/

slots.signal:magic.db.mysql.read

database:magic_auth

table:roles

args

columns

id

name

/*

* Returning the results to caller.

* This will transform the result to JSON,

* and return to the client as the HTTP response.

*/

slots.return-nodes:x:@slots.signal/*

注意:Magic是一个全新的项目,可能包含一些bug。它还未能在GitHub上赢得一百万颗星,而且据我所知,目前没有任何纳斯达克上市公司在使用它。因此,如果你想对其进行评估,请耐心等待。我会全力以赴提高代码的质量,并且修改所有发现的bug。将来我会持续维护该项目,但有时可能会出现一些测试版中常见的问题。

你可以通过我的GitHub代码库(https://github.com/polterguy/magic)汇报bug或请求功能。即便你没有可以汇报的bug,我也希望你对该项目提出建议或给予鼓励。

总结

总的来说,Magic可以减轻你一半的工作量,让计算机来承担无聊的工作,而你则可以专注于有趣的工作。这不正是我们发明计算机的初衷吗?希望你能找到Magic带来的快乐。

有关Magic的详细信息如下:

主页:https://polterguy.github.io/

GitHub项目网站:https://github.com/polterguy/magic

支持系统:https://github.com/polterguy/magic/issues

原文:https://dzone.com/articles/creating-a-net-core-web-api-in-40-seconds

本文为 CSDN 翻译,转载请注明来源出处。

【END】

热 文 推 荐

Chronicle 已死,凶手是谷歌!

重磅!腾讯正式开源图计算框架 Plato,十亿级节点图计算进入分钟级时代

沈向洋离开微软,曾是华人在美科技圈最高级高管,畅谈职业生涯的 7 堂课!

谈谈能带来高薪报酬的软件技术

DevOps到底是什么意思?

GitHub App终于来了,iPhone用户可尝鲜,「同性交友」更加便捷

任天堂、雅达利、索尼, 曾经的王者之争, 如何影响区块链游戏?

点击阅读原文参与开发者大调查,好礼送不停!

你点的每个“在看”,我都认真当成了喜欢