Biff.core：Clojure Web 应用的系统组合新范式

背景

Clojure 生态中的 Web 框架 Biff 正在经历从 v1 到 v2 的重大重构。作者 Jacob O'Bryant 此前曾提及，他致力于将 Biff 拆分为一系列独立的库（libraries），并在重构过程中调整了诸多设计细节。目前，这十二个核心库的初稿已全部完成，作者正逐一进行打磨并准备发布。

在 Biff 的传统架构中，应用遵循“模块（modules）”和“组件（components）”的结构。每个应用命名空间（namespace）暴露一个“模块”映射（map），开发者需要编写大量样板代码（boilerplate）将这些模块合并为单一的“系统”映射（system map），随后在启动时将系统映射传递给“组件”函数。

Biff 2 保留了这一核心结构，但引入了新的机制来消除繁琐的样板代码。作为整个生态系统的粘合剂，biff.core 作为第一个发布的库，旨在解决模块组合中的核心痛点。

核心内容

biff.core 的核心目标是简化 Biff 项目的系统组合逻辑，并提供一套更清晰的接口。

1. 从样板代码到“初始化函数”

在旧版 Biff 中，开发者需要手动编写代码来提取各个模块中的数据。例如，从模块中获取 :routes 和 :api-routes 键，并将其转换为系统映射中的 :biff/handler 值。这种逻辑分散在应用的各个命名空间中，导致每次添加模块时，都可能需要复制粘贴额外的组合逻辑到主命名空间。

biff.core 引入了**初始化函数（init functions）**的概念。这些函数接收一组模块集合，并返回一个映射，该映射可以直接合并到系统映射中。

• 实现方式：初始化函数存储在模块映射的 :biff.core/init 键下。
• 效果：开发者只需关注模块和组件的定义，无需在主命名空间中编写复杂的组合样板代码。

2. 解决“后期绑定”与“热更新”的矛盾

将组合逻辑提取到库代码中并非没有代价。在 Clojure 中，定义 (def handler ...) 变量具有一个重要的副作用：后期绑定（late binding）。

• 传统优势：如果修改了模块，handler 变量会自动更新。如果在系统映射中将 :biff/handler 设置为变量引用（如 #'handler）而非具体值，Ring 服务器在处理请求时会获取最新的 handler，从而实现无需重启 Web 服务器即可更新路由逻辑。
• 库代码的局限：如果将逻辑完全封装在库中，通常无法直接利用这种基于变量的后期绑定机制。

3. 解决方案：基于 Var 的动态解析

为了兼顾代码整洁性与热更新能力，作者设计了一套特定的模式：

1. 传递 Var 而非值：初始化函数接收的是模块向量的 Var（引用），而不是向量本身的值。
2. 函数化系统映射：系统映射中需要动态更新的部分，必须定义为函数。例如，不直接设置 :com.example/my-thing 为值，而是设置 :com.example/get-my-thing 为一个函数。
3. 延迟求值与缓存：该函数在运行时解引用（dereference）模块 Var，并将其传递给一个记忆化函数（memoized function）。这个记忆化函数负责构建最终需要的对象（如 Ring handler）。

这种设计使得主命名空间保持干净，只需添加模块和组件，同时通过函数包装和 Var 引用，保留了在不停止服务的情况下更新逻辑的能力。

4. 关于组件依赖的哲学

尽管有诱惑力去进一步简化，例如让模块支持 :biff.core/on-start 和 :biff.core/on-stop 键，并通过某种机制表达生命周期函数之间的依赖关系以自动排序，但作者选择了拒绝这种复杂性。

• 理由：手动管理组件顺序并不困难，尤其是 Biff 的启动项目（starter project）已经处理好了默认顺序。
• 优势：保持组件作为“通过映射传递的一系列函数”的简单模型，使得开发者更容易理解组件的工作原理。如果项目状态资源极其复杂，开发者可以在调用 biff.core 之前，在更高层面上自行解决依赖排序问题。

关键要点

• 模块化重构：Biff 2 将核心功能拆分为 12 个独立库，biff.core 是第一个发布的库，负责系统组合。
• 初始化函数（Init Functions）：通过 :biff.core/init 键定义，接收模块集合并返回可合并的系统映射，消除了主命名空间中的组合样板代码。
• 热更新机制：通过传递模块的 Var 引用而非值，并结合记忆化函数，实现了在不重启 Web 服务器的情况下更新 Handler 和其他系统配置。
• 设计取舍：作者刻意避免在库层面引入复杂的生命周期依赖排序逻辑，坚持让组件保持为简单的函数序列，将依赖管理的复杂性留给开发者或高层级工具处理。
• 开发状态：Biff 2 仍在开发中，目前所有库的初稿已完成，正在逐步打磨发布。

意义与影响

biff.core 的发布标志着 Biff 框架在工程化实践上的成熟。它解决了一个在函数式 Web 开发中常见的问题：如何在保持代码模块化、可组合性的同时，避免样板代码膨胀，并保留动态语言特有的热重载优势。

对于 Clojure 开发者而言，这一设计模式提供了一种新的思路：利用 Var 引用和记忆化函数作为“胶水”，在静态的库代码和动态的应用逻辑之间建立桥梁。这不仅简化了 Biff 项目的初始化和维护，也为其他类似框架提供了关于系统组合和生命周期管理的参考案例。

此外，这也反映了现代 Web 框架设计的一种趋势：从“约定优于配置”转向“组合优于继承”，并通过抽象层屏蔽底层复杂性，让开发者专注于业务逻辑（模块）而非基础设施搭建（系统组装）。