作者 | 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<string>.StartsWith(input.Children.First.GetEx<string>, 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./.argumentslimit:longoffset:longorder:stringdirection:stringid:longname:string/ Appending arguments in [slots.signal] below./add:x:.//slots.signal//argsget-nodes:x:@.arguments// Invoking [slots.signal] with \"大众magic.db.mysql.read\公众./slots.signal:magic.db.mysql.readdatabase:magic_authtable:rolesargscolumnsidname/ 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】
