Clean Architecture & Design Patterns in Practice · 课时

分层测试策略

制定全面的测试策略，覆盖整洁架构各层中的单元测试、集成测试和端到端测试。

分层测试策略 是 CoddyKit 上的免费 Clean Architecture & Design Patterns in Practice 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Clean Architecture & Design Patterns in Practice 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Clean Architecture & Design Patterns in Practice 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

Intro to Layered Testing

Welcome to Layered Testing Strategy! In Clean Architecture, separating concerns allows for a highly effective testing approach.

This lesson explores how to build a comprehensive testing strategy, covering unit, integration, and end-to-end tests across different architectural layers.

The Test Pyramid

A common visualization for testing strategies is the Test Pyramid. It suggests:

Many small, fast Unit Tests at the base.
Fewer Integration Tests in the middle.
Very few, slow End-to-End Tests at the top.

This structure ensures quick feedback and high confidence where it matters most, aligning perfectly with Clean Architecture's decoupled nature.

Unit Tests: Entities

Unit tests are the foundation. In Clean Architecture, we start by testing our Entities. These contain core business rules and should be completely independent of any frameworks or databases.

Focus on testing the pure logic of your entities. They should be fast and deterministic.

public class Product {
  private String name;
  private double price;

  public Product(String name, double price) {
    if (name == null || name.trim().isEmpty()) {
      throw new IllegalArgumentException("Name invalid.");
    }
    if (price <= 0) {
      throw new IllegalArgumentException("Price must be positive.");
    }
    this.name = name;
    this.price = price;
  }

  public String getName() { return name; }
  public double getPrice() { return price; }
}

public class Main {
  public static void main(String[] args) {
    try {
      Product p = new Product("Book", 25.00);
      System.out.println("Product OK: " + p.getName());
    } catch (IllegalArgumentException e) {
      System.out.println("Error: " + e.getMessage());
    }

    try {
      new Product("Pen", -5.00);
    } catch (IllegalArgumentException e) {
      System.out.println("Test Failed (expected): " + e.getMessage());
    }
  }
}

Unit Tests: Use Cases

Next, we unit test our Use Cases (Interactors). These encapsulate application-specific business rules. They orchestrate entities and interact with ports (interfaces) to external layers.

When testing use cases, we mock or stub any external dependencies (like repositories or gateways) to isolate the use case's logic.

interface ProductRepository {
  void save(String name, double price);
}

class MockProductRepository implements ProductRepository {
  private boolean saved = false;
  @Override
  public void save(String name, double price) {
    System.out.println("Mock: Saving " + name + "...");
    saved = true;
  }
  public boolean isSaved() { return saved; }
}

class CreateProductUseCase {
  private final ProductRepository repo;
  public CreateProductUseCase(ProductRepository repo) {
    this.repo = repo;
  }
  public void execute(String name, double price) {
    // Entity validation here in a real app, or trust entity's constructor
    repo.save(name, price);
    System.out.println("Product creation requested.");
  }
}

public class Main {
  public static void main(String[] args) {
    MockProductRepository mockRepo = new MockProductRepository();
    CreateProductUseCase useCase = new CreateProductUseCase(mockRepo);

    useCase.execute("Coffee Mug", 15.00);

    if (mockRepo.isSaved()) {
      System.out.println("Test PASSED: Product saved via mock.");
    } else {
      System.out.println("Test FAILED: Product not saved.");
    }
  }
}

Integration Tests: Adapters

Integration tests verify the interactions between different components and layers. In Clean Architecture, this often means testing the concrete implementations of our Interface Adapters (e.g., a database repository, an external API gateway) with the actual external systems.

We check if the adapter correctly translates data and interacts with the external service as expected.

Integration Tests: Data Persistence

This type of integration test focuses on the Repository implementations. We ensure they correctly save and retrieve data from the actual database (or an in-memory substitute like H2 for faster tests).

It verifies that your data mapping (e.g., from Entity to DTO) and database queries work as intended.

import java.util.HashMap;
import java.util.Map;

interface ProductRepository {
  void save(String id, String name, double price);
  String findNameById(String id);
}

class InMemoryProductRepository implements ProductRepository {
  private final Map<String, String> products = new HashMap<>(); // id -> name
  @Override
  public void save(String id, String name, double price) {
    products.put(id, name);
    System.out.println("In-Memory: Saved " + name + " (ID: " + id + ")");
  }
  @Override
  public String findNameById(String id) {
    return products.get(id);
  }
}

public class Main {
  public static void main(String[] args) {
    InMemoryProductRepository repo = new InMemoryProductRepository();

    repo.save("P001", "Keyboard", 75.00);
    String foundName = repo.findNameById("P001");

    if ("Keyboard".equals(foundName)) {
      System.out.println("Integration Test PASSED: Keyboard found.");
    } else {
      System.out.println("Integration Test FAILED: Keyboard not found.");
    }
  }
}

Integration Tests: Presentation Layer

Testing the Presentation Layer (e.g., Controllers, Presenters) involves ensuring they correctly receive requests, call the appropriate use cases, and format responses. We can use mocks for the underlying use cases.

This confirms the API contract and data flow from the external world into your application's use cases.

interface CreateProductUseCase {
  void execute(String name, double price);
}

class MockCreateProductUseCase implements CreateProductUseCase {
  private boolean called = false;
  @Override
  public void execute(String name, double price) {
    System.out.println("Mock Use Case: Executing for " + name);
    called = true;
  }
  public boolean wasCalled() { return called; }
}

class ProductController {
  private final CreateProductUseCase useCase;
  public ProductController(CreateProductUseCase useCase) {
    this.useCase = useCase;
  }
  public String createProductEndpoint(String jsonBody) {
    // Simulate JSON parsing
    String name = jsonBody.contains("name":"Laptop") ? "Laptop" : "Unknown";
    double price = jsonBody.contains("price":1200) ? 1200.00 : 0.0;

    useCase.execute(name, price);
    return "Product creation request received.";
  }
}

public class Main {
  public static void main(String[] args) {
    MockCreateProductUseCase mockUseCase = new MockCreateProductUseCase();
    ProductController controller = new ProductController(mockUseCase);

    String requestBody = "{\"name\":\"Laptop\", \"price\":1200.00}";
    String response = controller.createProductEndpoint(requestBody);

    System.out.println("Controller Response: " + response);
    if (mockUseCase.wasCalled()) {
      System.out.println("Test PASSED: Use Case was invoked.");
    } else {
      System.out.println("Test FAILED: Use Case not invoked.");
    }
  }
}

End-to-End (E2E) Tests

End-to-End tests simulate a complete user journey through the entire system, from the UI (or API client) to the database and back. They cover all layers and external services.

While slow and expensive, E2E tests provide the highest confidence that the whole system works together as intended. They are crucial for critical business flows.

Benefits of Layered Testing

Implementing a layered testing strategy in Clean Architecture brings significant benefits:

Faster Feedback: Unit tests give immediate results.
Easier Debugging: Failures are isolated to specific layers.
Robust Architecture: Ensures each component and interaction works.
Confidence in Changes: Allows safe refactoring and new feature development.
CI/CD Ready: Supports automated pipelines effectively.

Check Your Knowledge

Let's check your understanding of layered testing in Clean Architecture.

Recap: Testing Clean Systems

You've learned how to develop a comprehensive layered testing strategy for Clean Architecture. We covered:

The Test Pyramid and its levels: Unit, Integration, and E2E.
Unit testing Entities and Use Cases, often using mocks.
Integration testing adapters like Repositories and Controllers.
The role of End-to-End tests for full system validation.

By applying these strategies, you ensure your Clean Architecture codebase is robust, maintainable, and reliable.

常见问题解答

「分层测试策略」课时是免费的吗？

是的 — 「分层测试策略」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Clean Architecture & Design Patterns in Practice 课程的其余内容，请升级到 CoddyKit PRO。 Clean Architecture & Design Patterns in Practice 课程共包含 4 节课。

「分层测试策略」这节课中我会学到什么？

制定全面的测试策略，覆盖整洁架构各层中的单元测试、集成测试和端到端测试。你通过在浏览器中直接运行的动手代码来练习 Clean Architecture & Design Patterns in Practice，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Clean Architecture & Design Patterns in Practice 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Clean Architecture & Design Patterns in Practice 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「分层测试策略」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Clean Architecture & Design Patterns in Practice 课中编写并运行代码吗？

能。每节 Clean Architecture & Design Patterns in Practice 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Clean Architecture & Design Patterns in Practice