前后端跨语言同构——邂逅一场美丽的编程童话-唐霜

基于 JS 的同构或许你已经尝试过了，甚著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】至已经如火纯青了，然而，倘若现在我们要跨【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net语言进行同构呢？关于这篇文章的背景，我不【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】想赘述。既然要讨论，那开门见山：跨语言同原创内容，盗版必究。未经授权，禁止复制转载。构，是一场美丽的编程童话，做的好，天堂见【本文受版权保护】【原创内容，转载请注明出处】，做的不好，再也不见。

跨端跨语言同构

首先不可避免的，我们需要为“同构”下一个本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。定义。同构本来是一个数学概念，但是在编程【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】领域，我们可以简单理解为，同构是指在不同【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】平台上使用相同代码实现相同目标（确保一致原创内容，盗版必究。【本文首发于唐霜的博客】性）的方案。前后端同构就是在前端和后端使转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net用相同代码（sharing code b【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】etween the front-end未经授权，禁止复制转载。【本文受版权保护】 and the back-end），以【未经授权禁止转载】【本文首发于唐霜的博客】达到前后端效果一致的方案。它的核心，在于未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net“共用（share）”。至于实现什么目标【本文受版权保护】【版权所有】唐霜 www.tangshuang.net并不确定，比如在前后端使用同一个 lod【本文首发于唐霜的博客】【未经授权禁止转载】ash 函数保证处理结果的一致性，比如利【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。用 react 特性实现同构渲染等等。

【转载请注明来源】【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

我们不去探讨哪些东西适合前后端同构，或者原创内容，盗版必究。【作者：唐霜】哪种方式才叫同构，以及如何实现同构直出。原创内容，盗版必究。【本文首发于唐霜的博客】我们直接跳过了概念之争，跳过流于形式的实【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。现过程。我们即将探讨的是，用一种什么方式转载请注明出处：www.tangshuang.net【转载请注明来源】，能够让我们保证实现相同目标的过程是一致转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】的。即在架构设计上，确保前后端业务逻辑的未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】一致性。在这里，同构是一种设计思想。

【转载请注明来源】未经授权，禁止复制转载。原创内容，盗版必究。【转载请注明来源】

而且更进一步，我们要探讨，在前后端跨语言【原创不易，请尊重版权】【原创内容，转载请注明出处】场景下，如何利用同构思想解决问题。由于我本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】们所指的前端主要是指 Web 前端，基本本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】上就是使用 JS 语言，这里的跨语言大部【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net分是指后端使用 PHP、Java 等其他【版权所有】唐霜 www.tangshuang.net【转载请注明来源】语言的场景。传统上，在后端开发中跨语言互【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】调其实我们经常使用，方案也非常多，例如著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netPHP 去使用 Python 代码，单就转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。这一个问题，也有多套方案实现。不过在本文【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net中，我们理想中的跨语言，本质上和语言无关，我们要找到一种无论在什么语言环境中都能未经授权，禁止复制转载。原创内容，盗版必究。运转的方案。如果我们不想实现一个 JS 【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。中运行 PHP 的 PHPvm，或者一个未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。 Java 中运行 JS 的 JSrun原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.netner，那么我们为何不寻找一种基于协议的【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】同构方案呢？

【本文受版权保护】著作权归作者所有，禁止商业用途转载。

校验逻辑共用

在复杂系统中，表单可能存在较为复杂的字段转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net逻辑，从而带来复杂的校验逻辑。表单校验是转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】任何系统中必备的能力，而且为保证业务准确【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net性和数据安全，前后端都会做校验。我们可以本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net采用一种形式，确保前后端的校验是一致的，【原创内容，转载请注明出处】【本文首发于唐霜的博客】没有差错的。

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshua原创内容，盗版必究。转载请注明出处：www.tangshuang.netngnet】

我们首先来解剖校验，它的本质是什么？校验【作者：唐霜】【版权所有，侵权必究】的本质，是将流动的信息体与既定的形状进行【作者：唐霜】【版权所有，侵权必究】匹配，如果信息流动中的体态与既定形状没有本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net补集，那么我们认为给定信息是符合要求的。【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】而这里的既定形状，我认为主要包含两大方面【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。要素：

【本文受版权保护】【转载请注明来源】

所需的所有字段总和（多少）

【未经授权禁止转载】

著作权归作者所有，禁止商业用途转载。

单个字段的取值范围（类型、大小、结构）

本文作者：唐霜，转载请注明出处。

【作者：唐霜】

所有字段总和是指要完成当前操作，所必备的【本文受版权保护】【未经授权禁止转载】和可选的字段应该是哪些。如果超出这个总和【本文受版权保护】原创内容，盗版必究。的部分可能导致数据更新出错；不足这个总和【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。可能导致对象无法创建。在完成字段总和的校【转载请注明来源】本文作者：唐霜，转载请注明出处。验之后，单个字段的值，需要符合规定的逻辑【本文首发于唐霜的博客】原创内容，盗版必究。，这里的逻辑就包含该值应该是什么数据类型【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。，值的大小应该在什么范围，以及如果这是一原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。个结构体，应该具备什么结构，具体结构节点本文版权归作者所有，未经授权不得转载。【本文受版权保护】上的数据类型又应该是什么。

【作者：唐霜】【原创不易，请尊重版权】

请注意我上文所提的“形状（shape）”本文作者：唐霜，转载请注明出处。【本文受版权保护】这个概念，形状是可以被描述的。既然可以被【本文首发于唐霜的博客】【作者：唐霜】描述，那么我们就可以建立自己的描述体系来【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】对我们的校验进行描述，从而抽象出脱离代码本文作者：唐霜，转载请注明出处。【未经授权禁止转载】的描述文本。

在著名 PHP 框架 Laravel 中【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。就建立了这样的描述体系。我们来看下官方给出的代码示例：

原创内容，盗版必究。【本文受版权保护】【本文受版权保护】本文版权归作者所有，未经授权不得转载。

/**
 * Store a new blog post.
 *
 * @param  Request  $request
 * @return Response
 */
public function store(Request $request)
{
    $validatedData = $request->validate([
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
    ]);

    // The blog post is valid...
}

上面代码中 required|unique:posts|max:255 就是关于 title 字段的校验描述文本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】本，而且我们可以很容易理解这一描述文本，【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】只要我们在描述系统中对这种描述表达式加以原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net解释，那么就可以融会贯通，将这种表达方式【本文受版权保护】【关注微信公众号：wwwtangshuangnet】用在其他校验描述中。

【转载请注明来源】未经授权，禁止复制转载。转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netng.net

一旦校验可以用文本（而非代码）进行描述，【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。也就意味着可以用文本的形式确定相同字段在【本文受版权保护】原创内容，盗版必究。前后端的校验逻辑的“形状”，而文本，是我【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。们最喜欢的东西，因为它可以以任何形式在客【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】户端与服务端之间传输。我们要做的，是在服【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。务端和客户端构筑基于不同语言的解析器，一【本文首发于唐霜的博客】未经授权，禁止复制转载。旦两端解析器抹平了平台差异，那么校验描述原创内容，盗版必究。转载请注明出处：www.tangshuang.net文本就可以基于 HTTP 跳着舞，确保两未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。端的校验是一致的准确的。

数据结构共享

这里所讲的数据结构不是指计算机数据结构，【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net而是单纯地指结构体对象的形状结构，也就是【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。 JS 对象的结构。在前后端交互时，我们【本文受版权保护】【本文首发于唐霜的博客】经常需要前端对后台吐出的数据结构和数据类【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】型进行检查，后端也需要对前端提交的数据进本文作者：唐霜，转载请注明出处。【作者：唐霜】行检查，这些传输在网络中的数据，不是我们【原创内容，转载请注明出处】【作者：唐霜】一句“上 typescript”就可以解原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。决的。

让我们回到描述文本。

既然我们已经隐约觉得，文本是我们的大杀器【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】，为什么我们不尝试将这一发现试验在前后端【原创不易，请尊重版权】【原创不易，请尊重版权】数据结构的一致性上呢？如果我们可以用文本【本文首发于唐霜的博客】【本文受版权保护】方式，提前描述后端返回的数据的形状，那么未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。前端就可以校验后端吐出的真实数据是否符合【本文首发于唐霜的博客】【本文首发于唐霜的博客】这个形状。这件事我们不一定要在正式环境做未经授权，禁止复制转载。【未经授权禁止转载】，在开发和测试阶段我们就可以利用这一特性本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】，检查后端吐出数据的边界，避免上了正式环本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】境才来互怼。

有人可能会说：有什么是一份 API 文档【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。解决不了的呢？如果真有，就再来一份文档注【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】释。嗯！很有道理，但太敷衍。在 API 【原创不易，请尊重版权】未经授权，禁止复制转载。这件事上，文档只能解决一件事，就是定调，【版权所有，侵权必究】【未经授权禁止转载】走不走音，节奏乱不乱，完全控制不了。

GraphQL 虽然被定义为一门独立的前【未经授权禁止转载】本文作者：唐霜，转载请注明出处。后端接口查询语言，但是，在事实上，我们在【本文首发于唐霜的博客】【未经授权禁止转载】使用时仍然是以描述文本的形式在前后端之间原创内容，盗版必究。【版权所有，侵权必究】传输这段描述，前端提交这段描述后，后端返原创内容，盗版必究。【原创内容，转载请注明出处】回基于描述的结果数据。基于 GraphQ【原创不易，请尊重版权】【本文首发于唐霜的博客】L 的系统，提前约定了前后端在数据结构上【版权所有，侵权必究】转载请注明出处：www.tangshuang.net的一致性，从协议层面解决了数据结构的共享【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。。不过，GraphQL 还是会有一些问题著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】，目前来讲核心问题在于成本高昂，它需要复本文作者：唐霜，转载请注明出处。原创内容，盗版必究。杂的部署，才能让开发者读懂，才能让后端系原创内容，盗版必究。未经授权，禁止复制转载。统按约定输出，受到已经具有成熟接口开发经转载请注明出处：www.tangshuang.net【版权所有，侵权必究】验的后端开发者的抵触。

回到描述文本的思路上来。如果描述文本能够【原创内容，转载请注明出处】【本文首发于唐霜的博客】准确的生成易读 API 文档的同时，还能【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】生成前端数据校验检查器，更进一步生成 M【转载请注明来源】【原创内容，转载请注明出处】ock 数据，并且基于 Mock 数据实【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。现自动化测试，是不是更有意思？没错，这件【未经授权禁止转载】未经授权，禁止复制转载。事其实我已经做完了，我创建了一个叫 tyshemo 的项目，它为前端提供了一个运行时的类型本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】与结构检查工具，同时，基于它的描述能力，【转载请注明来源】【原创内容，转载请注明出处】上述说的文档功能、Mock 功能、自动化本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net测试功能，也轻松实现了。为什么可以？因为【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。在类型系统的构建上，它遵循“描述”系统，【未经授权禁止转载】【未经授权禁止转载】而非“约定”系统。所谓描述系统，是基于已未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net知信息，推演更多信息；而约定系统，则是基【作者：唐霜】【原创不易，请尊重版权】于共识，框定行为范围。具体举个例子，虽然【未经授权禁止转载】【版权所有，侵权必究】都是对类型进行检查，TypeScript 是描述系统，而 p著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。rop-types 是约定系统。

本文作者：唐霜，转载请注明出处。【作者：唐霜】转载请注明出处：www.tangshua原创内容，盗版必究。【本文首发于唐霜的博客】ng.net著作权归作者所有，禁止商业用途转载。

在前后端共同开发过程中，使用一套描述系统【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。之所以难以实施，在于没有共通语言进行描述著作权归作者所有，禁止商业用途转载。【本文受版权保护】。而我，找到了这个共通语言：JSON。

“PHP 不是世界上最好的语言，JSON【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】才是”。虽说 JSON 最大的问题是没未经授权，禁止复制转载。原创内容，盗版必究。有注释，但是作为描述语言，它本身就是用于【本文受版权保护】【关注微信公众号：wwwtangshuangnet】描述的，它本身就有注释性，给注释加注释说本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net不通呀！而使用 JSON 的最大好处，除【本文受版权保护】【原创不易，请尊重版权】了前后端开发者都能看懂外，它还可以轻易的未经授权，禁止复制转载。【原创内容，转载请注明出处】在 HTTP 中传输，几乎没有什么约束。

{
  "name": "string",
  "age": "number",
  "body": {
    "head": "boolean",
    "hand": {
      "left": "boolean",
      "right": "boolean"
    }
  }
}

虽然上面的描述有点细思极恐，但我相信，无【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】论是刚入编程的新萌，还是梭哈多年的老鸟，著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】都能用自己的膝跳反射读懂这一串 JSON【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net 所描述的内容。现在，我们把它作为后端【本文受版权保护】【版权所有】唐霜 www.tangshuang.netAPI 接口返回的数据描述，我可以用小拇【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。指就能想出如何将它解析为可被用于类型校验【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。的 JS 程序，以及基于数据类型生成 M【版权所有，侵权必究】【转载请注明来源】ock 数据的 express 中间价，【转载请注明来源】【版权所有】唐霜 www.tangshuang.net至于文档，哦，你还需要一个在线文档吗？通【转载请注明来源】转载请注明出处：www.tangshuang.net过这套方案提前管理前后端在接口输出结构上原创内容，盗版必究。【原创内容，转载请注明出处】的一致性，比 GraphQL 方案好的地【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】方在于，这套方案不需要后端改变现有编程方【本文受版权保护】【原创内容，转载请注明出处】案，只需要人为参与一份 JSON 的维护【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】即可（前后端共建），这份 JSON 即我著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net们所需要的“同构”，无论后端使用什么语言原创内容，盗版必究。【转载请注明来源】开发，都不影响在接口数据结构一致性上的实【版权所有，侵权必究】未经授权，禁止复制转载。现方式。当然，在条件允许的情况下，后端接本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】口可以根据描述返回必要的字段，组装合适的未经授权，禁止复制转载。【未经授权禁止转载】结构，裁剪不必要的字段，达到和 Gra【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。phQL一样的效果（但事实上，后端应该在【作者：唐霜】【版权所有】唐霜 www.tangshuang.net开发时对照着 JSON 所描述的结构，直原创内容，盗版必究。原创内容，盗版必究。接给出结果）。

原创内容，盗版必究。【原创不易，请尊重版权】【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。

等一等，这似乎也不满足我们的一些需求啊！

转载请注明出处：www.tangshua【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】ng.net【作者：唐霜】

描述系统的缺陷是，无法简单快速的完成某些【本文受版权保护】【作者：唐霜】复杂结构的说明，这有的时候导致我们很困惑【本文受版权保护】著作权归作者所有，禁止商业用途转载。。但是，我想说的是，约定系统并不被禁止，本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】当你无法描述一些东西的时候，我们可以约定【版权所有，侵权必究】原创内容，盗版必究。它，我们可以约定类型逻辑，甚至约定类型本【本文受版权保护】本文版权归作者所有，未经授权不得转载。身，比如：

本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】

{
  "name": "?string",
  "age": "number|numeric",
  "parents": "(Person,Person)"
}

我们用符号来约定一些规则，用大写开头的单本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。词约定一些可能应该具备深层结构的对象或实著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】例。不冲突，描述和约定并不冲突。我们要做本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。的，是构筑前后端基于不同语言的解析器，以未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net支撑起我们想要的多语言同构的美丽童话。

本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

领域模型共建

无论是校验逻辑，还是数据结构，它们都太单未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。调了，它们是静态的，虽说有点意思，却无法原创内容，盗版必究。原创内容，盗版必究。解决我们实际编程中所面临的业务问题。我们【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。所面临的问题，多半是“有状态”问题。静态原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。规则我写一个正则就可以解析了，可是，当我著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】们的业务在运行中时，应用的状态在变，而这本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】些变化的东西，可能会影响所有上述静态的规【本文首发于唐霜的博客】【本文受版权保护】则。

举个例子，当 a 字段为 0 时，b 字【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】段要使用 X 规则校验，而如果 a 规则未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。为 1 时，b 字段要使用 Y 规则进行转载请注明出处：www.tangshuang.net原创内容，盗版必究。校验。这……再一个例子，后端返回的接口中著作权归作者所有，禁止商业用途转载。【本文受版权保护】，当 a 字段为 0 时，b 字段的类型【未经授权禁止转载】【原创不易，请尊重版权】为 string，但当 a 字段为 1 【本文受版权保护】【本文首发于唐霜的博客】时，b 字段返回的类型为 number。【本文受版权保护】著作权归作者所有，禁止商业用途转载。这……要用纯文本描述，还得把业务特殊性给【原创不易，请尊重版权】【原创内容，转载请注明出处】兜住，办不到……办不到……

等等，真的办不到吗？

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

用静态的方式，概括动态的上下文，这件事我著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】们没做过吗？在前端开发中，我们天天在做。【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。“实例”来自“类”，而“类”不就是静态的【作者：唐霜】本文作者：唐霜，转载请注明出处。吗？或者，“接口”不就是静态的吗？当然，本文版权归作者所有，未经授权不得转载。【本文受版权保护】“接口”本身并不包含动态上下文的全部描述著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】，只有我们“实现接口”之后，我们才得到了【转载请注明来源】【作者：唐霜】一个完整的描述，结构体应该具备什么属性成转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】员，它的方法成员将会带来哪些副作用等等。

再往上走，我们的业务在运行时所制造的状态原创内容，盗版必究。原创内容，盗版必究。变化，是按照什么描述而发生的呢？

【本文受版权保护】【访问 www.tangshuang.n【未经授权禁止转载】本文作者：唐霜，转载请注明出处。et 获取更多精彩内容】

我们用领域模型描述领域对象的业务逻辑。领著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。域模型是静态的，不变的，它描述了一个领域【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】对象在运行时将拥有哪些属性，当操作领域对本文版权归作者所有，未经授权不得转载。【作者：唐霜】象的方法时，将会带来哪些副作用（变化）。著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。我们阅读领域模型，便知道该业务拥有什么，【转载请注明来源】【版权所有，侵权必究】能干什么，不拥有什么，不能干什么。不过，转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】不得不说的是，我们阅读领域模型，所得到的【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。信息是不连贯的，我们知道领域对象的能力，未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。但我们不能知道在运行时，由于什么环境让它本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。释放了这种能力，不同属性和方法之间需要通著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。过什么操作逻辑进行前后顺序关联。总而言之转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net，领域模型是基于描述的抽象体，是我们业务【原创内容，转载请注明出处】【原创不易，请尊重版权】流转的核心和基础。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】【原创不易，请尊重版权】

你可能会埋怨：我们用得着领域模型吗？前端本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。需要领域模型吗？

未经授权，禁止复制转载。【转载请注明来源】【转载请注明来源】【原创内容，转载请注明出处】

需要的。当你需要管理复杂的业务流转的时候本文作者：唐霜，转载请注明出处。【作者：唐霜】，你务必需要分清楚，当前流转中的业务，它【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】是对什么领域对象在操作。而只有拥有领域模本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】型，你才能对你所操作的对象心知肚明。提高前端开发的整体门槛，是保障前端工程稳【作者：唐霜】【转载请注明来源】定可靠的途径之一。我已经厌倦了把代码写给新手看，“新人接手本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】才能更快上手”的逻辑！为什么我们的高校老著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。师会说，学前端只要会点 jQuery 就【转载请注明来源】未经授权，禁止复制转载。可以走遍天下了？因为我们的项目通过降低编程结构的前瞻性，牺牲【原创内容，转载请注明出处】【作者：唐霜】业务逻辑的抽象性，来成全新人立即上手的便【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。捷性。为什么工厂工人需要集中培训一个月，而到了著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。前端这里就立即上手开始撸？如果一个项目任原创内容，盗版必究。【作者：唐霜】何人都可以立即上手开始撸，那对于一知半解【版权所有，侵权必究】原创内容，盗版必究。的新人，随手写句烂代码，暗暗庆幸“效果出【作者：唐霜】【作者：唐霜】来了”，岂不是高楼少砖，飞机缺钉。新人加原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】入团队，不应该由老成员低下身，配合新成员本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】写效率低下的，以界面效果为导向的流水账代本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。码，而应该是新成员仰起头，通过学习和研究著作权归作者所有，禁止商业用途转载。【本文受版权保护】项目的编程结构和领域模型，掌握项目的前瞻【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。性和抽象性，之后才开始上手接触业务编写。

原创内容，盗版必究。原创内容，盗版必究。【本文受版权保护】

让我们回到同构。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

既然领域模型是基于描述的，那么我们就可以【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】延续我们前面提出的同构方式。JSON 为【转载请注明来源】未经授权，禁止复制转载。我们提供了共通的描述语言。而领域模型又是本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。静态的，岂不是我们可以通过 JSON 来未经授权，禁止复制转载。【转载请注明来源】描述领域模型？

著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】ng.net【未经授权禁止转载】

{
  "schema": {
    "age": {
      "default": 0,
      "type": "number",
      "validators": [
        {
          "validate(value)": "value > 0",
          "message": "年龄必须大于0"
        }
      ]
    },
  },
  "methods": {
    "grow()": "age ++"
  }
}

我用上面的 JSON 描述了一个模型，该【版权所有，侵权必究】【本文受版权保护】模型包含一个 age 属性和 grow 【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net方法。age 属性默认值为 0，数值类型【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net，且在校验时要求值大于 0，否则会给出提【原创内容，转载请注明出处】【转载请注明来源】示文案。grow 方法是使得 age 属【本文受版权保护】【原创不易，请尊重版权】性自加。我们并不知道，什么时候会发生校验【原创内容，转载请注明出处】【原创内容，转载请注明出处】，也不知道什么时候 grow 会被调用，【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。然而，我们却读懂了这个模型所包含的一切。

前后端使用同一个领域模型未尝不可，但是由【转载请注明来源】【关注微信公众号：wwwtangshuangnet】于运行环境的差异，前后端领域模型还是会比【本文受版权保护】【本文首发于唐霜的博客】较大的不同。以前文的 unique:posts 这个校验规则为例，在后端将记录插入到数本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】据库之前，需要检查当前记录的 title本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。字段是否已经被其他记录占用了。这一条规原创内容，盗版必究。【转载请注明来源】则几乎不能被前端所直接使用，因为后端不可【版权所有，侵权必究】原创内容，盗版必究。能把所有记录的 title 一次性返回给【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。前端，唯一可行的比较好的体验，是用户输入【作者：唐霜】【本文首发于唐霜的博客】 title 的时候，就立即通过 aja【关注微信公众号：wwwtangshuangnet】【转载请注明来源】x 交互，反馈当前 title 是否可用【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】。这个例子说明，前后端共用同一个模型，很原创内容，盗版必究。转载请注明出处：www.tangshuang.net多情况下是不行的。但是，前端所使用的模型【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】，却可以来自后端，它可以是后端模型的子集【原创内容，转载请注明出处】【转载请注明来源】，或者后端处理过后的优化模型。通过 JS转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】ON 的方式，这一模型被传送给前端。

【转载请注明来源】【未经授权禁止转载】【未经授权禁止转载】

但如果我们能够解释模型的 JSON，那么【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】我们就能实例化模型，得到运行时的实体对象未经授权，禁止复制转载。【原创不易，请尊重版权】。而这个对象，和我们用代码本身写死的对象未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。，并无二致。通过文本描述，在运行时得到模【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。型实体，并进行进一步操作，这是一种典型的【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】反射思想。我们若能在我们特有的业务系统中【版权所有，侵权必究】【转载请注明来源】实现这一套反射接口，或许看上去复杂的问题【作者：唐霜】本文作者：唐霜，转载请注明出处。也变得非常简单。

本文作者：唐霜，转载请注明出处。【转载请注明来源】未经授权，禁止复制转载。【访问 www.tangshuang.n【未经授权禁止转载】【原创不易，请尊重版权】et 获取更多精彩内容】

在 HTTP 的两端，虽然运行的代码不同【原创内容，转载请注明出处】【原创内容，转载请注明出处】，却因为一份基于文本描述的 JSON，可【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net以最大限度的保证在大部分业务逻辑上，它们【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。是一致的。我们要做的，是构筑前后端基于不原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】同语言的转换器和解析器，实现前端反射机制【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。，确保业务尽可能准确，房子就可以修的越高著作权归作者所有，禁止商业用途转载。【转载请注明来源】，飞机就可以飞的更久。

TDL 驱动业务自定义

TDL（Transfer Descrip转载请注明出处：www.tangshuang.net【版权所有，侵权必究】tion Language）指基于传输协未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。议的描述语言，即通过后端发送用描述语言编本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。写的描述文本给前端，由前端解释该描述文本未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。并创建运行时对象。和从后台加载真实脚本到【关注微信公众号：wwwtangshuangnet】【转载请注明来源】前端进行执行不同，TDL 需要先接收再解【原创不易，请尊重版权】【本文受版权保护】释后执行。加载脚本是不够安全的，前端并不【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。能确保动态传输的脚本是否安全，但 TDL转载请注明出处：www.tangshuang.net【转载请注明来源】是安全的。总的来说，我们前面提到的通过未经授权，禁止复制转载。【原创内容，转载请注明出处】 JSON 发送领域模型给前端使用，本质【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。上是一种 TDL。

业务自定义是大部分系统所想要的美好构想。【本文受版权保护】【作者：唐霜】例如自定义权限逻辑、自定义表单、自定义布【原创不易，请尊重版权】【转载请注明来源】局和交互……

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。

我们可以想象，存在这样一种前端应用，它本著作权归作者所有，禁止商业用途转载。【转载请注明来源】身没有任何业务逻辑的代码实现，它是一个壳【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。，它是一个 TDL 的运行器，所有的业务本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。逻辑都由后端决定，并通过 TDL 动态执著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。行。这样的应用其实很常见，以一个在线ex著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。cel表格为例，它具备排序、字段筛选、搜原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】索、格式化、表头固定、栏固定、字体颜色、未经授权，禁止复制转载。【未经授权禁止转载】表达式等等特性，而相同的一个前端代码，却【转载请注明来源】【未经授权禁止转载】要完成无数用户的无数场景，怎么做到的？就【版权所有，侵权必究】【原创内容，转载请注明出处】是通过 TDL，将所有这些用以表现的描述【本文首发于唐霜的博客】【原创不易，请尊重版权】，随表格数据一起通过接口返回。前端仅仅是本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。一个解释器和交互呈现装置，不需要业务逻辑本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net，所有的业务逻辑通过 TDL 传输，并通本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】过前后端的约定，加以解释。

【本文受版权保护】【作者：唐霜】【本文受版权保护】

著名的框架 strapi 拥有无限自定义的能力，它通过巧妙的架构【转载请注明来源】【本文受版权保护】，实现业务自定义配置化。这和我们将业务写著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。在代码中完全不同，写死在代码中的业务，一【原创不易，请尊重版权】原创内容，盗版必究。旦稍有改动，就需要完成复杂的发版流程。而原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。基于自定义配置化的业务，业务的变动只需要【原创内容，转载请注明出处】未经授权，禁止复制转载。通过在线手动配置，即可轻松修改。它在界面【未经授权禁止转载】未经授权，禁止复制转载。上将业务的属性、逻辑，通过用户交互完成逻本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】辑关联，将这种关联抽象为描述信息，存储在【原创内容，转载请注明出处】【原创不易，请尊重版权】数据库中，需要的时候，从数据库中读取出来著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】，加以解释。当这些配置被存储在数据库中时【转载请注明来源】本文作者：唐霜，转载请注明出处。，仅仅是一些描述文本，但当它们被代码解释著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。并运行时，就组建起极为强大的业务能力。自定义，是代码工程的最高境界，它看似是后未经授权，禁止复制转载。未经授权，禁止复制转载。端问题，实质是前端问题。当这些配置以 TDL 发送给前端，也可以【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】让前端同时具备极为强大的业务能力。

转载请注明出处：www.tangshua【作者：唐霜】原创内容，盗版必究。ng.net未经授权，禁止复制转载。

TDL 还能帮前端省代码量，让前端专注于未经授权，禁止复制转载。【版权所有，侵权必究】表现逻辑，而非业务逻辑。对于前端而言，业【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】务本身并不重要，重要的是可以对传输的描述【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】文本实现完整解释。一旦 TDL 运行起来【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。，任何业务都可以在前端表现出来，因为前端转载请注明出处：www.tangshuang.net原创内容，盗版必究。并不需要知道业务本身，而是需要解释用于描未经授权，禁止复制转载。【未经授权禁止转载】述业务的 TDL 的能力。如此一来，同一【版权所有，侵权必究】【本文首发于唐霜的博客】套前端代码，可以适用于千变万化的业务需求著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】，只要它们的 TDL 遵循相同语法。

原创内容，盗版必究。【原创内容，转载请注明出处】【本文受版权保护】

当然，撰写 TDL 解释器需要花费一些精本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。力，但得到的收益未尝不是一劳永逸。我们要【本文受版权保护】【转载请注明来源】做的，是在前后端之间建立起 TDL 桥梁【版权所有，侵权必究】未经授权，禁止复制转载。，构筑前端与后端对 TDL 的输出和解释【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。，确保在前端与业务解耦，通过解释器完成所【本文首发于唐霜的博客】未经授权，禁止复制转载。有业务逻辑的指令，这样，前端从复杂业务中【版权所有，侵权必究】【未经授权禁止转载】被解脱出来，让表现层的东西更优雅，更从容【本文受版权保护】【原创内容，转载请注明出处】不迫。

原创内容，盗版必究。【原创内容，转载请注明出处】

结束语

从前后端同构讲起，我们以校验逻辑的描述文【版权所有，侵权必究】转载请注明出处：www.tangshuang.net本、数据类型和结构的 JSON 描述、领【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net域模型的反射、TDL 为切入口，一层一层【作者：唐霜】【版权所有】唐霜 www.tangshuang.net的去探讨探讨前后端跨语言同构。不过，从本转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。质上讲，这里的“同构”和我们传统意义的基著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】于代码共享（使用同一份代码）的同构，完全【作者：唐霜】【作者：唐霜】是两回事。这里的同构是，如何在前后端之间，构筑起一个可通过 HT未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netTP 传输描述文件实现业务逻辑后端化，后【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。端专注业务，前端业务解耦，专注表现层，通本文作者：唐霜，转载请注明出处。原创内容，盗版必究。过 TDL 确保前后端一致性准确性，由于转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】 TDL 不依赖前后端本身的实现语言，因著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】此，可以说是跨语言的，这样的编程方案。但是不要忘记，美丽的东西【原创不易，请尊重版权】【版权所有，侵权必究】总是带刺，让前端脱离业务是理想中的好事，本文作者：唐霜，转载请注明出处。【转载请注明来源】前端少了很多事，后端也完全可以自洽业务逻转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。辑，然而，当问题出现的时候，调试难度会上【本文受版权保护】【版权所有，侵权必究】来，由于领域模型实际在后端，而对领域对象【原创内容，转载请注明出处】【作者：唐霜】的操作在前端，导致一个完整的业务实现，需转载请注明出处：www.tangshuang.net【转载请注明来源】要完成从后端到前端再回到后端的整个数据流【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】转，前后端耦合增强，在具体问题上可以说又转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】是死循环般无解。但无论如何，我认为这种尝未经授权，禁止复制转载。【原创内容，转载请注明出处】试是值得的，如果没有这种尝试，我们将永远未经授权，禁止复制转载。【原创内容，转载请注明出处】陷在当前复杂的业务逻辑中无法自拔，而当我本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】们尝试了，尝到了甜头，尝到了苦头，才会最未经授权，禁止复制转载。未经授权，禁止复制转载。终明白，我们确实需要什么，我们也确实不需转载请注明出处：www.tangshuang.net【本文受版权保护】要什么。

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】ng.net【转载请注明来源】

【未经授权禁止转载】【本文首发于唐霜的博客】【原创不易，请尊重版权】【版权所有，侵权必究】【作者：唐霜】著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net【本文受版权保护】未经授权，禁止复制转载。原创内容，盗版必究。【转载请注明来源】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。未经授权，禁止复制转载。【本文首发于唐霜的博客】【未经授权禁止转载】【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】著作权归作者所有，禁止商业用途转载。【作者：唐霜】【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【本文受版权保护】【版权所有，侵权必究】【未经授权禁止转载】

2020-06-26 6293

唐霜

前后端跨语言同构——邂逅一场美丽的编程童话

跨端跨语言同构

校验逻辑共用

数据结构共享

领域模型共建

TDL 驱动业务自定义

结束语

为价值买单，打赏一杯咖啡

声明

关于

生态