
在现代软件工程中,架构文档往往面临“要么太抽象,要么太琐碎”的困境。为了解决这个问题,Simon Brown 提出的 C4 模型(C4 Model)成为了行业标准。它不仅仅是一套绘图规范,更是一种思维方式,帮助团队通过分层的方式,由宏观到微观地描述软件架构。
本文将结合一个典型的 e-commerce order-processing platform(电子商务订单处理平台)案例,深入解析 C4 模型的四个核心层级,并介绍如何使用 VPasCode 工具快速生成专业的架构模型。
1. 为什么我们需要 C4 模型?
传统的 UML 图往往难以在“高层级概览”和“底层细节”之间取得平衡。C4 模型通过以下四个层级,让架构师能够根据受众的不同(如 CEO、开发人员、运维人员)提供不同颗粒度的视图:
- System Context (系统上下文):宏观视角,关注系统边界。
- Container (容器):中观视角,关注技术栈和部署单元。
- Component (组件):微观视角,关注内部逻辑结构。
- Code (代码):实现视角,关注具体的类和方法(通常由工具自动生成)。
2. 核心层级深度解析
2.1 Level 1: System Context (系统上下文图)
这是架构的“鸟瞰图”。它定义了系统的边界,以及谁在使用这个系统。
- Who uses the system (谁在使用):例如 Customer(客户)、Administrator(管理员)。
- External systems (外部系统):例如 Payment Gateway(支付网关)、Email Service(邮件服务)。
示例场景: 在电商系统中,客户通过 Web 端发起订单,系统需要调用外部的支付网关扣款,并发送邮件确认。
2.2 Level 2: Container (容器图)
进入系统内部,容器图展示了主要的软件单元。一个“容器”通常是一个运行环境或数据存储单元。
- Web App:前端应用,如 React 或 Vue 应用。
- API:后端服务,如 Spring Boot 微服务。
- Database:持久化存储,如 MySQL 或 PostgreSQL。
- Message Queue:消息队列,如 Kafka 或 RabbitMQ。
2.3 Level 3: Component (组件图)
这是最常用也最具价值的图表。它揭示了容器内部的重要构建块,通常对应软件设计中的模块或核心类。
- Controllers:处理 HTTP 请求的入口。
- Application Services:编排业务流程的协调器。
- Domain Services:包含核心业务逻辑。
- Repositories:负责数据访问层。
3. 实战演练:使用 VPasCode 绘制系统上下文图
为了演示 C4 模型的实际应用,我们将使用 Visual Paradigm 的 VPasCode 工具。它允许通过代码(DSL)快速生成符合 C4 标准的图表。以下是构建电商订单处理系统上下文图的代码示例:
@startuml
title Level 1: System Context Diagram - E-Commerce Platform
skinparam packageStyle rectangle
' 定义角色和系统
Person(customer, "Customer", "终端用户")
Person(admin, "Administrator", "系统管理员")
System_Ext(payment_gateway, "Payment Gateway", "外部支付处理系统")
System_Ext(email_service, "Email Service", "第三方邮件服务")
System(System_ECommerce, "E-Commerce Order Platform", "核心电商订单处理系统")
' 定义关系
Rel(customer, System_ECommerce, "places order", "HTTPS")
Rel(admin, System_ECommerce, "manages orders", "HTTPS")
Rel(System_ECommerce, payment_gateway, "processes payment", "API")
Rel(System_ECommerce, email_service, "sends confirmation", "SMTP")
@enduml
上述代码定义了一个清晰的边界。请注意,在 C4 模型中,我们使用 Person(人)、System(系统)和 System_Ext(外部系统)来明确区分内部与外部实体。
4. 深入内部:容器与组件
当我们从 Level 1 下钻到 Level 2 时,我们将 E-Commerce Order Platform 展开。此时,原来的一个绿色方块变成了多个相互连接的容器:
@startuml
title Level 2: Container Diagram
skinparam packageStyle rectangle
skinparam componentStyle rectangle
' 定义容器
Container(web_app, "Web App", "React", "前端界面")
ContainerDb(database, "Database", "MySQL", "订单数据")
ContainerDb(message_queue, "Message Queue", "RabbitMQ", "异步任务")
Container_Boundary(api, "API (Backend)", "Spring Boot") {
Container(controllers, "Controllers", "Java", "HTTP 端点")
Container(services, "Services", "Java", "业务逻辑")
Container(repositories, "Repositories", "Java", "数据访问")
}
' 定义关系
Rel(web_app, api, "calls", "REST API")
Rel(api, database, "reads/writes", "JDBC")
Rel(api, message_queue, "publishes events", "AMQP")
@enduml
在这个层级,我们开始关注技术选型。例如,前端使用 React,后端使用 Spring Boot,数据存储在 MySQL 中。这种技术栈的明确对于运维和 DevOps 团队尤为重要。
5. 从组件到代码 (Level 4)
Level 4 通常不需要手动绘制。大多数现代 IDE 和建模工具(如 Visual Paradigm)都支持通过 Code 插件自动生成代码级图表。
例如,在组件图中,我们有一个 OrderService。在代码图中,它会被展开为具体的类结构:
@startuml
title Level 4: Code Diagram - OrderService
class OrderService {
+ createOrder(req: OrderRequest): Order
+ getOrder(id: OrderId): Order
+ cancelOrder(id: OrderId): void
}
interface OrderRepository {
+ save(order: Order): void
+ findById(id: OrderId): Order
}
class SqlOrderRepository {
+ save(order: Order): void
}
class DynamoOrderRepository {
+ save(order: Order): void
}
OrderService --|> OrderRepository : implements
OrderRepository <|-- SqlOrderRepository : implements
OrderRepository <|-- DynamoOrderRepository : implements
' 伪代码逻辑展示
Note as code
public Order createOrder(OrderRequest rep) {
var order = Order.create(rep);
orderRepository.save(order);
return order;
}
Note code ends
@enduml
这种层级展示了设计模式的应用,例如 Repository Pattern(仓储模式),通过接口 OrderRepository 解耦了业务逻辑与具体的数据存储实现(SQL 或 DynamoDB)。
6. 辅助图表:动态与部署
除了标准的 C4 层级,C4 模型还鼓励使用辅助图表来补充说明:
- System Landscape (系统全景图):展示整个组织内的系统分布,适用于企业级架构。
- Dynamic Diagram (动态图):使用序列图或协作图,描述特定场景下(如“下单流程”)各容器如何交互。
- Deployment Diagram (部署图):展示软件在运行时环境(如 Kubernetes、AWS Cloud)中的物理或逻辑分布。
在电商案例中,部署图会展示 Load Balancer 如何将流量分发到 Container Orchestrator (Kubernetes) 中的多个 Pod,以及这些 Pod 如何连接到外部的数据库。
总结
C4 模型不仅是一套绘图工具,更是一种沟通语言。通过 VPasCode 等工具,我们可以快速迭代这些图表,使其成为项目文档的一部分,而不是过时的摆设。
记住核心原则:Start broad → zoom in only when more detail is needed. 从系统上下文开始,逐步深入,直到你需要解释具体的代码实现为止。
