主题对照

跨平台代码共享

同一份代码在服务器与浏览器等不同环境运行时如何处理模块系统、平台差异与打包:运行时分支、构建时分支与模块替换,以及服务端渲染与通用数据获取。

16 张卡片 · 5 本书

本层 16 张卡片 · 含下级覆盖 16 张卡片

本主题的卡片

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

同构代码先抹平差异

Node.js 和 Chrome 都跑在 V8 上,但前后端共享代码远不像看起来那么容易:Node 里没有 DOM 和长存的视图,浏览器里没有文件系统、也不能起新进程,语言特性支持程度也不同。跨平台开发的主要功夫,是借助抽象和模式把差异压到最小,让代码能在运行时或构建时切换到与平台兼容的实现。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

UMD兼容多模块系统

浏览器端模块系统很分散:可能只有全局变量,也可能有 AMD 加载器。UMD 用一个自执行函数包住模块工厂,依次检测 AMD 的 define、CommonJS 的 module.exports,否则挂到全局对象上,并把依赖注入工厂。它能用,但样板多、难以在每种环境测试,只适合包装已写好的单个模块,新代码应交给打包工具自动处理。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

ES模块可静态分析

ES2015 内置模块系统兼有 CommonJS 的紧凑语法与循环依赖支持、AMD 的异步加载支持。更重要的是它是声明式语法,静态分析器能在构建时分析依赖树,把导入模块中未使用的部分剥离,给浏览器更小的包。书写作时 Node.js 还不支持它,需借 Babel;现在 Node.js 已原生支持 ES 模块。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

打包器抽象require

与其手写 UMD,不如继续按 Node.js 约定写 require 和 module.exports,再用打包器(Webpack、Browserify、Rollup 等)编译:它递归扫描源码中的 require,把所有依赖连同一个抽象的 require 实现打进一个包。Webpack 还提供许多 Node 核心模块的浏览器版,并能把不兼容的模块排除、替换为空对象或另一个实现。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

运行时分支的代价

最直观的跨平台做法是运行时检测宿主(例如看 window 是否存在),用 if…else 切换实现。代价有三:两个平台的代码都进了同一个包,体积变大;平台判断与业务逻辑混在一起,可读性下降;按平台动态 require 的模块全都会被打包,因为打包器在构建时不知道运行时变量的值。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

构建时剔除服务端码

构建时分支让打包器在编译阶段决定:DefinePlugin 把 BROWSER 这类标记替换为常量,压缩器再删除永远走不到的死代码。结果包更小,也避免把只该留在服务器的敏感代码意外暴露给浏览器。但滥用会让源码满是平台判断;多数时候更好的办法是在构建时直接替换整个模块的实现。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

构建时交换模块

通常在构建前就知道客户端包该含什么,于是可以让打包器按规则把一个模块整体换成另一个:书中用 NormalModuleReplacementPlugin 把服务端的 alertServer(console.log)替换为浏览器版 alertBrowser(后改用 toastr 弹窗)。主程序和服务端模块都不用改,包里没有多余代码,也没有平台判断语句。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

跨平台复用旧模式

跨平台开发用到的仍是熟悉的模式:策略和模板共享与平台无关的算法骨架,只替换平台相关的步骤;适配器在浏览器兼容接口上替换整个组件(如 fs 的 LevelUP 适配器);远程代理让浏览器通过 Ajax 或 WebSocket 调用服务器上的 fs;观察者可以替换事件发生器而不影响监听者;DI 和服务定位器在注入时替换实现。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

数据别打进前端包

示例起初用一个 JSON 模块当数据库,前端、后端和每个组件都直接读它。问题是完整数据库会被打进前端包:可能意外暴露敏感信息,包随数据增长而变大,数据一改就得重新构建。正确做法是拆出独立的 REST API 服务器,按需异步获取当前页面需要的那部分数据,并能独立于应用其余部分扩展。

查看卡片与原书出处

Node.js设计模式(第2版) · 通用JavaScript的Web应用程序

通用数据获取

浏览器只有 XHR,服务器用 http 库,而且同源策略禁止页面直接调用另一端口的 API。书中的做法:Web 服务器用 http-proxy 把 /api 代理到 API 服务器;用 axios 这类两端通用的客户端,按是否存在 window 选择 URL 前缀。服务端渲染时先异步加载完数据再渲染,并把已加载的数据以脚本形式嵌入页面,浏览器不必重复请求。

查看卡片与原书出处

前端Serverless 面向全栈的无服务器架构实战 · Serverless与前端技术

Node连接前后端

Node.js 是基于 Chrome V8 引擎封装的 JavaScript 服务端运行环境,让 JavaScript 能在服务端运行。由于 BFF 由各客户端的研发人员维护,前端自然采用 Node.js;基于 Node.js 的 Serverless 应用能轻松开发服务端程序,并实现快速部署、低成本运维。发散:语言统一的最大收益是协作和心智成本下降。

查看卡片与原书出处

前端架构:从入门到微前端 · 架构设计:多页面应用

搜索流量要HTML

网站流量有直接访问、外链、搜索、分享等来源,搜索是较“轻松”的一种。Google 能抓取 JavaScript 渲染的内容,但百度、搜狗等国内搜索引擎支持不好。如果主要流量来自搜索,就要尽量提供 HTML:单页面应用需借助预渲染、同构应用或混合式后台渲染;若交互不复杂,直接用多页面应用做后台渲染反而更简单。发散:SEO 会反向决定前端渲染架构。

查看卡片与原书出处

前端架构:从入门到微前端 · 架构设计:单页面应用

SSR为速度与搜索

前后端不分离时,服务端渲染是默认的:后端把数据渲染到模板上,直接返回 HTML,比客户端加载 JavaScript 后再渲染更快。单页面应用的服务端渲染多依赖服务端的 JavaScript 引擎,分三类:非 JavaScript 语言的同构渲染、基于 JavaScript 的同构渲染和预渲染。之所以需要它,是因为百度等国内搜索引擎对客户端渲染支持不好;预渲染则不适合数据量大、更新频繁的应用。

查看卡片与原书出处

前端架构:从入门到微前端 · 架构设计:单页面应用

同构难在状态

同构渲染的难点在状态。非 JavaScript 语言的同构要在后端语言里维护一份状态、在 JavaScript 里再处理一份,反复切换代码库,容易漏掉新状态。基于 JavaScript 的同构不用学新语言,状态在同一份代码里处理,主流框架都能直接渲染组件,并把路由和状态传给客户端;代价是组件和模块必须同时兼容浏览器和 Node.js。

查看卡片与原书出处

软件系统架构:使用视点和视角与利益相关者合作(原书第2版) · 其他视角

国际化先建立机制再逐地本地化

国际化使系统能适应多语言、国家与文化,本地化再准备特定地区文本和规则。需覆盖全部触点、输入输出、管理员资料和设备,处理方向、度量、日期时间货币、文化语义与格式;内容表现分离和外置消息有助扩展。不能只考察与母语相近的语言,也不能等末期才补机制。

查看卡片与原书出处

深入理解Nginx:模块开发与架构解析(第2版) (LinuxUnix技术丛书)

平台差异隔离在系统层

可移植服务器让核心流程依赖统一的数据结构、日志和算法接口,把操作系统特有的系统调用放在单独实现层。新增平台时,优先检查这层差异及构建探测结果,而非在业务模块中散布平台分支。此设计与 [[编译探测平台能力]] 配合:探测说明能用什么,隔离层负责如何调用。

查看卡片与原书出处
辅助阅读:卢曼编号

按卢曼编号阅读

点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。

  • 展开或收起下级: 2095 考虑间接用户 路径上下文 软件系统架构:使用视点和视角与利益相关者合作(原书第2版) · 其他视角 理解等级:未标注
  • 展开或收起下级: 2431 同构代码先抹平差异 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.a UMD兼容多模块系统 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.b ES模块可静态分析 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.c 打包器抽象require 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.d 运行时分支的代价 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.e 构建时剔除服务端码 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.f 构建时交换模块 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.g 跨平台复用旧模式 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.k 数据别打进前端包 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
    • 2431.l 通用数据获取 主题成员 Node.js设计模式(第2版) · 通用JavaScript的Web应用程序 理解等级:未标注
  • 展开或收起下级: 2871 BFF贴近体验 路径上下文 前端Serverless 面向全栈的无服务器架构实战 · Serverless与前端技术 理解等级:未标注
    • 2871.a Node连接前后端 主题成员 前端Serverless 面向全栈的无服务器架构实战 · Serverless与前端技术 理解等级:未标注
  • 展开或收起下级: 2902 SPA不是默认 路径上下文 前端架构:从入门到微前端 · 架构设计:多页面应用 理解等级:未标注
    • 2902.a 搜索流量要HTML 主题成员 前端架构:从入门到微前端 · 架构设计:多页面应用 理解等级:未标注
  • 展开或收起下级: 2903 MVC分离职责 路径上下文 前端架构:从入门到微前端 · 架构设计:单页面应用 理解等级:未标注
    • 2903.f SSR为速度与搜索 主题成员 前端架构:从入门到微前端 · 架构设计:单页面应用 理解等级:未标注
    • 2903.g 同构难在状态 主题成员 前端架构:从入门到微前端 · 架构设计:单页面应用 理解等级:未标注
  • 展开或收起下级: 3568 Cycle承载运行态 路径上下文 深入理解Nginx:模块开发与架构解析(第2版) (LinuxUnix技术丛书) 理解等级:未标注
    • 3568.b 平台差异隔离在系统层 主题成员 深入理解Nginx:模块开发与架构解析(第2版) (LinuxUnix技术丛书) 理解等级:中级

来源书籍

来源书籍

Node.js设计模式(第2版)

JavaScript运行时与服务端工程类

Skill 版本:v8

书籍类型:工程实践

清单覆盖 5/6

174 张卡片

主题索引

远程调用与REST设计

比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。

303 张卡片 · 53 本书

主题索引

模块化与信息隐藏

比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。

209 张卡片 · 51 本书

主题索引

模式语言与选型

模式之间的关系与意图对比、组合用法,以及模式在框架、语言与重构中的适用边界。

64 张卡片 · 15 本书