# 基于分层架构的React应用模块化与重构实践

> 本文基于Martin Fowler的Presentation Domain Data Layering理论及Juntao Qiu的实践案例，探讨了如何在React应用中实施分层架构以解决模块化与重构问题。文章首先阐述了表现层、领域层和数据层分离的理论依据与优势，包括缩小关注范围、提高可替换性和可测试性。随后，通过一个支付功能模块的重构案例，详细展示了从单组件到分层架构的演进过程，包括分离View与Non-view逻辑、引入领域模型、使用Anti-Corruption Layer和Gateway模式隔离外部依赖。最终，这种分层架构提升了代码的可维护性、复用性和可扩展性，使React仅作为视图层存在。

原文：/knowledge/crawler-35c0883381a6c9fbb7134ddf4a6acfc913a0f71edf0940e1bb809e17ecc1fcd4

在构建前端应用时，许多开发者容易将React视为一个全能框架，从而将数据获取、业务逻辑和视图渲染全部塞入组件中。然而，React本质上只是一个用于构建视图的库。随着应用复杂度增加，这种“一切皆组件”的做法会导致代码难以维护、测试困难且复用性低。为了解决这一问题，可以借鉴Martin Fowler提出的Presentation Domain Data Layering（表现层-领域层-数据层）分层架构，将React应用重构为结构清晰、职责单一的模块化系统。

本文基于Martin Fowler的相关文章及Juntao Qiu的实践案例，探讨如何在React应用中通过分层架构实现View与Non-view逻辑的分离，并介绍Anti-Corruption Layer和Gateway模式在模块化重构中的具体应用。


## Presentation Domain Data Layering：理论定义与适用场景

Presentation Domain Data Layering是一种将信息丰富型程序模块化为三个主要层级的架构模式：表现层（Presentation/UI）、领域逻辑层（Domain/Business Logic）和数据访问层（Data Access）。

### 核心优势
1. **缩小关注范围（Narrowing Scope）**：这是该架构最大的优势。开发者在编写某一层的代码时，可以相对独立地思考，无需同时关注其他层的细节。例如，在编写领域逻辑时，可以将数据源视为抽象函数；在编写表现层时，可以将数据视为通过函数调用 magically 出现。
2. **可替换性（Substitutability）**：分离使得可以用不同的实现替换模块。例如，可以在相同的领域逻辑之上构建多个表现层（如Web端、移动端、命令行接口），或者替换数据源实现（如从关系型数据库切换到NoSQL）。
3. **可测试性（Testability）**：模块边界为测试提供了良好的切入点。领域逻辑可以被轻松测试，无需复杂的UI交互；数据访问层可以通过Test Doubles进行模拟，提高测试响应速度。

### 适用场景与限制
- **适用性**：适用于大多数信息丰富型应用，无论是Web应用、桌面GUI应用还是后端服务。它不仅仅是一种物理分层，更是一种逻辑上的模块划分。
- **粒度限制**：Martin Fowler强调，这种分层应在相对较小的粒度上应用。当应用规模扩大时，每个层内部可能变得过于复杂，此时不应继续将Presentation-Domain-Data作为最高层级的模块划分，而应进一步拆分为面向领域的模块（Domain-Oriented Modules），每个模块内部再保持分层结构。
- **团队组织建议**：虽然技术架构上分层，但建议团队具备全栈能力，避免按层划分团队（如前端组、后端组、DBA组），因为层间交互频繁，跨层协作需要紧密的团队配合。


## React应用的分层演进路径

在React应用中实施分层架构并非一蹴而就，通常经历以下演进阶段：

1. **单组件应用（Single Component Application）**：所有逻辑（UI、状态、副作用）都集中在一个组件中。适用于小型或一次性项目，但随规模增长变得难以维护。
2. **多组件应用（Multiple Component Application）**：将UI拆分为多个组件，但仍将数据获取和转换逻辑放在组件内部（如useEffect中）。这导致组件职责过重，且逻辑与UI耦合。
3. **基于Hooks的状态管理**：将状态和副作用逻辑提取到自定义Hooks中。这改善了代码复用，但Hooks中可能混杂了纯计算逻辑和状态管理逻辑，界限依然模糊。
4. **领域模型出现（Business Models Emerged）**：开发者开始意识到应将纯计算和数据映射逻辑提取为独立的领域对象（Domain Objects）。这些对象不依赖UI，可独立测试和复用。
5. **分层前端应用（Layered Frontend Application）**：最终形成清晰的分层结构：
   - **Presentation Layer**：React组件，仅负责UI渲染和用户交互事件。
   - **Domain Layer**：纯JavaScript/TypeScript代码，包含业务规则、数据转换和领域模型。
   - **Data Layer**：负责与外部系统（API、LocalStorage等）交互，提供数据访问接口。

这种演进的核心思想是：React只应作为视图层存在，而将业务逻辑下沉到支持模型层，将数据访问下沉到数据层。


## 实战案例：支付功能模块的重构

以下通过一个在线订购应用中的“支付功能”模块，展示如何从混乱的组件重构为分层架构。

### 初始实现：View与Non-view逻辑混杂
初始的`Payment`组件直接处理数据获取、转换和UI渲染：

```tsx
export const Payment = ({ amount }: { amount: number }) => {
  const [paymentMethods, setPaymentMethods] = useState<LocalPaymentMethod[]>([]);

  useEffect(() => {
    const fetchPaymentMethods = async () => {
      const url = "https://online-ordering.com/api/payment-methods";
      const response = await fetch(url);
      const methods: RemotePaymentMethod[] = await response.json();

      if (methods.length > 0) {
        // 数据转换逻辑混杂在组件中
        const extended: LocalPaymentMethod[] = methods.map((method) => ({
          provider: method.name,
          label: `Pay with ${method.name}`,
        }));
        extended.push({ provider: "cash", label: "Pay in cash" });
        setPaymentMethods(extended);
      } else {
        setPaymentMethods([]);
      }
    };

    fetchPaymentMethods();
  }, []);

  return (
    <div>
      <h3>Payment</h3>
      <div>
        {paymentMethods.map((method) => (
          <label key={method.provider}>
            <input
              type="radio"
              name="payment"
              value={method.provider}
              defaultChecked={method.provider === "cash"}
            />
            <span>{method.label}</span>
          </label>
        ))}
      </div>
      <button>${amount}</button>
    </div>
  );
};
```

**问题**：组件职责过多，包含网络请求、数据映射、默认值处理等，难以复用和测试。

### 重构步骤1：分离View与Non-view逻辑
将UI部分保留在React组件中，将数据获取和转换逻辑提取到Hooks和领域对象中。

### 重构步骤2：引入领域模型与Anti-Corruption Layer
为了处理后端API返回的`RemotePaymentMethod`与前端使用的`LocalPaymentMethod`之间的差异，引入一个领域类作为Anti-Corruption Layer（防腐层）或Gateway。

```typescript
// Domain/PaymentMethodConverter.ts
export class PaymentMethodConverter {
  static convert(remoteMethods: RemotePaymentMethod[]): LocalPaymentMethod[] {
    if (remoteMethods.length === 0) {
      return [{ provider: "cash", label: "Pay in cash" }];
    }
    return remoteMethods.map(method => ({
      provider: method.name,
      label: `Pay with ${method.name}`,
    }));
  }
}
```

这个转换器类封装了数据映射逻辑，确保了前端内部数据结构的一致性，并限制了后端API变更对前端的影响范围。

### 重构步骤3：简化Hooks
数据获取Hook变得极其简洁，仅负责调用数据访问层并更新状态：

```tsx
// hooks/usePaymentMethods.ts
export const usePaymentMethods = () => {
  const [paymentMethods, setPaymentMethods] = useState<PaymentMethod[]>([]);

  useEffect(() => {
    // 假设fetchPaymentMethods是数据访问层的函数
    fetchPaymentMethods().then(methods => setPaymentMethods(methods))
  }, []);

  return {
    paymentMethods,
  };
};
```

### 重构步骤4：处理复杂业务逻辑（多态与策略模式）
当需求增加（如“捐赠到慈善机构”的凑整逻辑）时，如果继续用if-else处理，会导致“霰弹手术”问题。此时应使用多态或策略模式，将不同支付方式的特定逻辑封装到不同的类中，每个类实现统一的接口。

### 重构步骤5：提取网络客户端（Gateway模式）
将网络请求进一步抽象为Gateway对象，封装对远程服务的访问。这使得数据访问逻辑独立于业务逻辑，便于替换数据源或进行单元测试。

```typescript
// Data/PaymentGateway.ts
export class PaymentGateway {
  async fetchMethods(): Promise<RemotePaymentMethod[]> {
    const response = await fetch("https://online-ordering.com/api/payment-methods");
    return response.json();
  }
}
```

## 重构后的收益
1. **可维护性**：缺陷定位更容易，修改特定层（如UI样式）不会影响其他层（如业务逻辑）。
2. **模块化与复用**：领域逻辑和数据访问逻辑是纯JavaScript/TypeScript代码，不依赖React，可在后端或其他前端项目中复用。
3. **可读性**：代码结构清晰，开发者只需关注当前层的逻辑。
4. **可扩展性**：新增功能（如新的支付方式）只需添加新的领域类或策略，无需修改现有组件。
5. **技术栈迁移**：如果未来需要更换视图库（如从React切换到Vue），只需替换Presentation层，Domain和Data层保持不变。


## Anti-Corruption Layer与Gateway模式详解

在分层架构中，Anti-Corruption Layer（ACL）和Gateway是两个关键的模式，用于隔离外部系统的影响。

### Anti-Corruption Layer (ACL)
- **定义**：ACL是一个边界，用于保护内部领域模型不受外部系统（如遗留系统、第三方API）复杂或不一致数据模型的影响。
- **在React中的应用**：如上述案例中的`PaymentMethodConverter`，它将后端复杂的`RemotePaymentMethod`结构转换为前端简洁的`LocalPaymentMethod`结构。这样，前端业务逻辑只依赖于内部模型，当后端API变更时，只需修改转换器，而不影响业务逻辑。

### Gateway
- **定义**：Gateway是一个封装对外部系统或资源访问的对象。它将外部API的复杂性隐藏在一个简单的接口后面。
- **在React中的应用**：如`PaymentGateway`类，它封装了`fetch`调用。这使得数据访问逻辑集中管理，便于添加缓存、重试机制或切换数据源（如从REST API切换到GraphQL）。
- **与ACL的区别**：Gateway侧重于访问外部资源的机制，而ACL侧重于保护内部模型免受外部数据模型的污染。在实际应用中，Gateway常常作为ACL的一部分实现。

<!-- knowledgefill:references -->
## 参考资料

- [Modularizing React Applications with Established UI Patterns](https://martinfowler.com/articles/modularizing-react-apps.html)
- [Presentation Domain Data Layering (https://martinfowler.com/bliki/PresentationDomainDataLayering.html)](https://martinfowler.com/bliki/PresentationDomainDataLayering.html)
- [Gateway](https://martinfowler.com/eaaCatalog/gateway.html)
