如何创建可扩展和可维护的前端架构

&＃x1f447;&＃x1f447;关注后回复 “进群” &＃xff0c;拉你进程序员交流群&＃x1f447;&＃x1f447;

作者丨Kevin Pennekamp

译者丨Sambodhi

策划丨辛晓亮

来源丨InfoQ 架构头条&＃xff08;ID&＃xff1a;ArchFront&＃xff09;

现代的前端框架和库可以轻松地创建可重用的 UI 组件。在创建可维护前端应用方面&＃xff0c;这是一个很好的方向。但是&＃xff0c;在多年来的许多项目中&＃xff0c;我发现开发可重复使用的组件常常是不够的。我的项目由于需求的变化或者新需求的出现而变得不可维护。要查找正确的文件或调试多个文件所需的时间越来越长。

必须改变。我可以提高搜索技能&＃xff0c;或者更熟练地使用 Visual Studio Code。但我并不是唯一在前端工作的人。所以&＃xff0c;我们需要对前端项目进行设置。要让它们变得更易于维护和扩展。那意味着我们可以对当前特性进行修改&＃xff0c;但也可以更快地添加新特性。

1 高级架构

对于后端开发&＃xff0c;我们可以遵循很多架构模式。领域驱动开发&＃xff08;domain-driven development&＃xff0c;DDD&＃xff09;和关注点分离&＃xff08;separation of concerns&＃xff0c;SoC&＃xff09;是目前使用的两个概念。这两个概念给前端开发带来了巨大价值。在 DDD 中&＃xff0c;你试着把相似的特性分组合起来&＃xff0c;并尽量使它们和其他组&＃xff08;比如模块&＃xff09;解耦。而在 SoC 中&＃xff0c;例如&＃xff0c;我们可以分离逻辑、试图和数据模型&＃xff08;例如&＃xff0c;使用 MVC 或 MVVM 设计模式&＃xff09;。

希望现代的前端应用程序能完成越来越多的繁重工作。当复杂度增加时&＃xff0c;Bug 也会变得更加频繁。由于用户和前端的交互&＃xff0c;我们需要一个既可维护又可扩展的可靠架构。在这一点上&＃xff0c;我的首选架构是模块化和领域驱动的。记住&＃xff0c;我的想法也许会改变&＃xff0c;但这是我此刻首选的方式。

当用户与我们的应用交互时&＃xff0c;应用将路由引导用户到正确的模块。每一个模块都被完全包含。然而&＃xff0c;如果用户想要使用一个应用&＃xff0c;而非几个小应用&＃xff0c;就会有一些藕合。该耦合存在于特定的特性或业务逻辑中。有几个特性可以在模块间共享。你可以将该逻辑放在应用层。也就是说&＃xff0c;每个模块可以选择与应用层进行交互。例如&＃xff0c;需要通过客户端的 API 连接到后端&＃xff0c;或者设置 API 网关。

在查看项目的结构时&＃xff0c;我们可以遵循如下所示的内容。应用层的所有代码都在 app 目录下。并且所有的模块都有一个目录&＃xff0c;位于 modules 目录下。不依赖业务逻辑的可重复使用的 UI 组件&＃xff08;如表格&＃xff09;在 components 目录下。

app/
assets/
components/
lib/
modules/
styles/

其余的目录存放我们的静态 assets&＃xff08;如图片&＃xff09;或者 lib 中的辅助函数。辅助函数可以非常简单。它们可以将某些东西转换为某种格式&＃xff0c;或者帮助处理对象。但更复杂的代码可以存放于 lib 目录中。处理模式或图的工作&＃xff08;例如检查有向图中的循环的算法&＃xff09;也不例外。

很多人都使用 CSS-in-JS 或样式组件之类的东西&＃xff0c;但是我更喜欢普通的 CSS。为什么呢&＃xff1f;无需 Javascript&＃xff0c;我们可以使用 CSS 和 HTML 解决很多 UI 问题。当我们应用 SoC 的概念时&＃xff0c;这会变得更加容易。此外&＃xff0c;在一个地方维护 CSS 使你更容易维护&＃xff0c;因为你可以减少重复的工作。它要求一个稳定的 CSS 架构。尽管我会在另一篇博文中讨论这个问题&＃xff0c;但是我的 CSS 架构是基于 Harry Roberts 的 ITCSS。

2 填写应用细节

通过高层和项目结构&＃xff0c;我们已经有了一个良好的开端。然而&＃xff0c;为了实现这一前端架构&＃xff0c;我们还需要更多的细节。我们先来看看更详细的架构图&＃xff0c;如下图所示。在这幅图中&＃xff0c;我放大了应用层&＃xff0c;但同时也放大了一个模块。在我们的前端应用中&＃xff0c;应用层是我们的核心&＃xff0c;所以我们首先讨论它。

应用层由两部分组成&＃xff1a;存储和客户端 API。存储是我们的全局应用状态。这个状态保存着不同模块在同一时间可以存取的数据。即使在屏幕上不需要这些数据&＃xff0c;它也会持续存在于存储中。正如你所看到的&＃xff0c;每一个发送到存储的更新请求都可以通过一连串的逻辑。这就是我们所说的中间件。这是 Redux 中使用的一种模式。中间件的一个简单例子是记录存储的传入请求。

有时候&＃xff0c;需要通过外部服务中的数据对存储的传入请求进行增强。在 Redux 中&＃xff0c;我们使用 Promise 处理这个调用。它可能是后端服务&＃xff0c;但是它也可能是公共的第三方 API。有些情况下&＃xff0c;只需使用浏览器 fetch API 就可以实现单一目的的 REST 调用。如果希望使用同一个 API 来执行不同的调用&＃xff0c;那么创建 API 客户端定义是个不错的想法。

基本的 API 客户端处理外部请求、响应和错误。你甚至可以让它为你提供有关请求状态的信息&＃xff08;例如&＃xff0c;加载&＃xff09;。不过&＃xff0c;更复杂的 API 客户端可以处理更多的事情。有些 API 通过 web-socket 连接甚至是 GraphQL API。在这种情况下&＃xff0c;你将拥有更多的配置选项&＃xff0c;如下图所示。

对于更加复杂的 API 客户端&＃xff0c;我们可以通过中间件修改所有发出的请求&＃xff08;例如&＃xff0c;添加认证头&＃xff09;。响应可以由后件修改&＃xff08;比如更改数据结构&＃xff09;。更改响应之后&＃xff0c;我们将其存储在客户端的缓存中&＃xff0c;这就像应用存储一样。有什么不同吗&＃xff1f;缓存只处理传入的 API 数据&＃xff0c;而我们可以把任何数据放入应用存储里。

很多前端应用都会有专门的后端服务来对话。无论是在有许多微服务的 Kubernetes 集群之上的 API 网关&＃xff0c;还是一个单一的单体后端。但是有时候我们需要连接到不同的外部服务。使用这种架构&＃xff0c;我们可以创建大量的 API 客户端。每个 API 客户端都有缓存、中间件和后件。我们应用的不同部分应该能够与这些 API 客户端中的每一个进行交互。

应用目录的相应项目结构可以如下所示&＃xff1a;

app/api/
config/store/
pubsub/schemas/index.js

app 中的两个目录现在听起来应该很熟悉&＃xff1a;api 和 store。这两个目录保存了与前面描述的用例有关的所有内容。config 存放静态定义和配置&＃xff08;比如常量&＃xff09;&＃xff0c;用于整个应用。schemas 描述了 Javascript 对象的特定数据结构。这在使用 TypeScript 或 Javascript 时都可以使用。应用的所有通用模式都存储在 schemas 目录中。

pubsub 是一个很好的例子&＃xff0c;它可以扩展前端的基本架构。pubsub 可以用于模块通信或管理预定作业。因为它对于应用的核心很重要&＃xff0c;所以它位于 app 目录内。最后&＃xff0c;我们得到了 index.js 文件。通过这个文件&＃xff0c;我们可以添加 app 目录中的所有函数和常量。这就是说&＃xff0c;这个文件的功能是进入应用逻辑的入口点。

3 模块的架构

介绍了应用层之后&＃xff0c;就剩下模块了。详细的架构图已经显示了一个模块的内部结构。如果应用的路由指向一个特定的模块时&＃xff0c;这个模块就会决定路由应该如何继续。模块的路由决定哪个页面应该显示。一个页面包括许多 UI 组件&＃xff0c;也就是用户在屏幕上看到的内容。

在本例中&＃xff0c;页面与 UI 组件没有任何区别。它是一个大的 UI 组件。然而&＃xff0c;其他模块可以与组件&＃xff08;和动作&＃xff09;交互&＃xff0c;但不能与页面交互。只有使用嵌套路由才能使来自不同模块的页面相互作用。这就是说&＃xff0c;你将模块的路由放在不同模块的页面中。

组件通过动作与应用层交互。这些动作可能表现为各种形式。它们可以是普通的 Javascript 函数、Redux 相关函数或者 React Hooks。有时候&＃xff0c;你有一些小的实用函数专门用于某些模块。如果是这样&＃xff0c;你可以将它们放到 actions 目录下&＃xff0c;也可以为模块创建一个专门的 utils 目录。下面显示了项目的模块结构&＃xff1a;

users/actions/components/
config/constants.jsroutes.jstables.js forms.jspages/
gql/schemas/index.js

和应用层一样&＃xff0c;我们也可以有静态代码&＃xff08;如常量或模式定义&＃xff09;&＃xff0c;而只涉及到我们的模块。本例中&＃xff0c;我们将这些代码放入 config 或 schema 目录下。在使用 GraphQL 时&＃xff0c;可以有查询和变异的定义。这些应该放在 gql 目录下&＃xff08;或者一个具有相似用途的目录&＃xff09;。添加 interface.js 文件&＃xff0c;用于存储该模块的应用。这个文件描述了如何访问存储中的数据。

index.js 作为 app 目录的 index.js。在这里&＃xff0c;我们描述了供他人访问的所有的组件、动作和常量。

4 模块的通信

并不是每个模块都需要拥有上述所有的目录和文件。比如&＃xff0c;有些模块不需要页面&＃xff0c;因为它们只包括组件和动作。“files”模块就是一个很好的例子。这个模块结合了组建和动作来查看和上传文件。一个例子是一个拖放文件的区域&＃xff0c;将结果上传到一个 blob 存储。它可以成为可重复使用的组件。但是&＃xff0c;文件的实际上传取决于我们能够使用的服务。我们通过将 UI 组件和上传文件的实际动作结合起来&＃xff0c;创建了一个小的包含模块。将组件与业务逻辑结合在一起时&＃xff0c;我们将其转换为模块。

但是其他模块是如何使用文件模块中的组件或者动作的&＃xff1f;模块的 index.js 文件描述了哪些组件、动作和常量可以被其他组件访问。因此&＃xff0c;我们可以在文件模块中使用文件拖放区或上传动作。然而&＃xff0c;有时候我们需要选择我们想要公开的内容。这是一个动作&＃xff0c;还是我们要将这一动作合并为一个组件&＃xff1f;

下面来看看用户下拉列表的示例。通过创建动作&＃xff0c;可以为我们提供可以从不同模块选择的所有用户。不过&＃xff0c;现在我们需要在其他所有模块中创建一个特定的下拉列表。这可能不需要太多努力&＃xff0c;就能得到一个通用的下拉组件。但这个组件可能无法在窗体中工作。也许有必要创建一个可以使用的 UserDropdown 组件。现在我们只在用户周围更改一个组件时更改。因此有时候我们需要选择公开的内容&＃xff1a;动作或组件。

在组件之间使用的一种高级模式是使用 pubsub。在这个模式下&＃xff0c;不能共享组件&＃xff0c;但是我们可以共享数据。上面的图片说明了它的工作原理。再一次强调一下&＃xff0c;这是一种高级模式&＃xff0c;仅当你想要走微型前端路线或者需要的时候。

5 UI 组件剖析

还缺少最后一个细节层面&＃xff0c;那就是 UI 组件的架构。我在以前的博文中已经对此进行过描述。你可以从这种解剖图中看到一些我们已经广泛应用的概念。

前端是用户的第一个入口点。当前端项目特性增加时&＃xff0c;我们也引入了更多的 Bug。但是我们的用户期望没有 Bug&＃xff0c;新特性也会更快。那不可能。但是&＃xff0c;只要有了一个好的架构&＃xff0c;我们就能尽可能达到这个目标。

作者介绍&＃xff1a;

Kevin Pennekamp&＃xff0c;富有创意的前端工程师。喜欢 CSS&＃xff0c;并遵循一些基本的工程原则。

原文链接&＃xff1a;

https://dev.to/crinklesio/how-to-create-a-scalable-and-maintainable-front-end-architecture-4f47

-End-

最近有一些小伙伴&＃xff0c;让我帮忙找一些 面试题 资料&＃xff0c;于是我翻遍了收藏的 5T 资料后&＃xff0c;汇总整理出来&＃xff0c;可以说是程序员面试必备&＃xff01;所有资料都整理到网盘了&＃xff0c;欢迎下载&＃xff01;

点击&＃x1f446;卡片&＃xff0c;关注后回复【面试题】即可获取

在看点这里好文分享给更多人↓↓