用在线购物系统案例吃透MVC架构:从类图绘制到模块拆分的完整指南
很多朋友在学习软件体系结构时,都曾面对过这样一道经典的课程设计或考试题目:“设计一个在线购物系统,要求实现商品展示、购物车管理和订单处理功能,并使用MVC模式。” 试卷上的标准答案往往简洁明了,给出了几个核心类及其职责划分,仿佛照着画个类图就能万事大吉。然而,当你真正着手将这份“标准答案”落地成一个可以运行、便于维护的真实项目时,却常常感到无从下手——视图和控制器怎么通信?业务逻辑全塞在模型里吗?数据库操作放哪儿?团队协作时代码会不会乱成一团?
这正是理论与实践的鸿沟。考试考察的是对模式核心思想的理解,而真实项目则要求我们在理解的基础上,做出大量适应工程化、团队协作和业务演变的设计决策。本文将以这个经典的“在线购物系统”为蓝本,带你跨越这道鸿沟。我们不会止步于复刻试卷上的类图,而是会深入探讨如何将一个MVC的“骨架”,填充上“肌肉”和“血液”,构建出一个结构清晰、职责分明、易于扩展的企业级应用架构模板。无论你是正在为课程设计绞尽脑汁的大学生,还是需要重构一个老旧电商模块的初级架构师,这份从“解题”到“解题”的完整指南,都将为你提供一套可直接落地的思路与实践方案。
1. 解构经典:从试卷答案到真实项目的思维跃迁
翻开软件体系结构的试卷,第六大题的计算题通常是这样要求的:用MVC模式设计在线购物系统,给出类图和职责划分。标准答案会清晰地列出Product、Cart、Order这三个模型类,以及对应的视图和控制器。这构成了我们对MVC最初始、最纯粹的认知。
1.1 试卷上的“理想国”与项目中的“现实世界”
试卷中的MVC设计,是一个高度抽象和简化的模型。它的核心价值在于清晰地阐述了关注点分离这一根本原则:数据、界面和控制逻辑被划分到三个独立的组件中。Model(模型)负责数据和业务规则,View(视图)负责呈现数据,Controller(控制器)负责接收用户输入并协调模型和视图。
然而,这个理想模型在落地时会立刻遇到几个现实挑战:
- 业务逻辑的归属:计算购物车总价、验证库存、应用优惠券,这些逻辑放在哪里?如果全放在
Cart或Order模型里,模型类会迅速膨胀,变成难以维护的“上帝类”。 - 数据持久化的困惑:
Product模型应该自己负责从数据库读取和保存数据吗?这会让模型与特定的数据库技术(如MySQL、MongoDB)紧耦合。 - 控制器臃肿:一个
OrderController可能要处理创建订单、支付、取消、查询物流等多个复杂流程,如果所有逻辑都写在控制器方法里,它会变得极其冗长和复杂。 - 层间通信的代价:视图如何获取模型更新?简单的MVC实现可能导致视图直接监听模型(观察者模式),但在Web环境中,这通常意味着频繁的页面刷新或复杂的前后端状态同步。
提示:理解试卷答案的关键,不在于记住那几个类名,而在于内化“分离”的思想。真实项目的设计,就是在这种思想指导下,应对上述复杂性的过程。
1.2 核心演进:引入“服务层”(Service Layer)
为了解决业务逻辑混杂的问题,现代Web应用架构普遍在MVC的基础上引入了一个新的层次——服务层。服务层位于控制器和模型之间,专门用于封装复杂的业务逻辑和用例。
我们可以通过一个表格来对比引入服务层前后,处理“添加商品到购物车”这个操作的职责变化:
| 组件 | 传统MVC(试卷答案)职责 | 引入服务层后的职责 |
|---|---|---|
| 控制器 (CartController) | 1. 接收商品ID和数量参数。 2. 调用 Cart模型的addItem方法。3. 可能包含库存检查、优惠计算等逻辑。 4. 更新视图(或返回结果)。 | 1. 接收商品ID和数量参数。 2. 调用 CartService.addItemToCart 方法,并传递参数。3. 接收服务层返回的结果(成功或失败信息)。 4. 根据结果,选择渲染哪个视图或返回何种JSON响应。 |
| 模型 (Cart) | 1. 维护商品列表、总价等属性。 2. 提供 addItem, removeItem, calculateTotal等方法。3. 可能包含业务逻辑(如库存判断)。 | 1. 仅作为数据载体(贫血模型)或具有简单行为的领域对象(充血模型)。例如,Cart类只负责维护自身商品集合的完整性(如防止重复添加),复杂的校验和计算被剥离。 |
| 服务层 (CartService) | 不存在。 | 1. 协调多个模型和外部服务,完成“添加商品到购物车”这个业务用例。 2. 调用 ProductRepository检查库存。3. 调用 PromotionService计算可用优惠。4. 调用 Cart模型的方法更新数据。5. 调用 OrderRepository保存购物车状态。6. 处理整个流程中的异常,并返回明确的结果。 |
这种设计的优势立竿见影:控制器变得轻薄,只关注HTTP请求/响应的转换;模型变得纯粹,更贴近业务领域本身;而所有复杂的、涉及多个对象的操作逻辑,都被收敛到了服务层,使得核心业务流一目了然,且易于进行单元测试。
2. 绘制可落地的UML:超越基础类图
有了引入服务层的架构意识,我们再来重新审视和绘制在线购物系统的设计图。此时,我们的绘图目标不再是为了答题,而是为了与团队成员沟通设计,并为后续编码提供蓝图。
2.1 静态结构图:展示分层与依赖
一份好的静态结构图(主要是类图,结合包图思想)应该能清晰地展示系统的物理分层和依赖方向。下图描绘了一个典型的四层结构:
[表示层 (Presentation Layer)]
|
| 依赖
v
[应用层/服务层 (Application/Service Layer)]
|
| 依赖
v
[领域层/模型层 (Domain/Model Layer)]
|
| 依赖
v
[基础设施层 (Infrastructure Layer)]
对应到我们的购物系统,可以绘制一个更具体的包/模块依赖图:
com.example.shop
├── web (表示层)
│ ├── controller
│ │ ├── ProductController
│ │ ├── CartController
│ │ └── OrderController
│ └── dto (Data Transfer Object, 数据传输对象)
│ ├── ProductDTO
│ └── CartItemDTO
├── service (应用层)
│ ├── ProductService
│ ├── CartService
│ └── OrderService
├── domain (领域层)
│ ├── model
│ │ ├── Product
│ │ ├── Cart
│ │ └── Order
│ └── repository (接口定义)
│ ├── ProductRepository
│ └── OrderRepository
└── infrastructure (基础设施层)
├── persistence
│ ├── JpaProductRepository (实现)
│ └── JpaOrderRepository (实现)
└── external
└── PaymentClient (支付客户端)
关键点解读:
- 依赖方向:上层模块依赖下层模块。
web依赖service,service依赖domain。domain是核心,它不依赖任何其他层(除了基本的Java库),这保证了领域模型的纯粹性。 - 接口与实现分离:在
domain层定义Repository接口,在infrastructure层提供基于JPA、MyBatis等的具体实现。这样,领域层完全不知道数据是如何持久化的,符合依赖倒置原则。 - DTO的使用:控制器和视图(或前端)之间传递的数据对象,通常是领域模型的简化或投影,避免将复杂的领域对象直接暴露给外部,也解耦了内部领域模型与外部API的变更。
2.2 动态交互图:理清关键业务流程
类图展示了系统有哪些“零件”,而时序图或活动图则展示了这些“零件”如何协作来完成一项任务。这对于理解复杂的业务流程至关重要。
以“用户提交订单”为例,其时序图可以清晰地描绘出跨组件的调用流:
(注意:根据要求,此处不使用mermaid图表,改用文字描述结合伪代码块说明交互流程)
参与者:用户、OrderController、OrderService、Order(领域模型)、PaymentService、OrderRepository
流程描述:
1. 用户在前端点击“提交订单”。
2. 前端调用后端 API: POST /orders
3. OrderController.receiveSubmitRequest(orderData) 被触发。
4. OrderController 将 orderData 转换为内部指令,调用 OrderService.placeOrder(command)。
5. OrderService 开始执行事务:
a. 通过 CartRepository 获取当前用户的购物车信息。
b. 通过 ProductRepository 验证所有商品库存。
c. 创建 Order 领域对象(此时订单状态为“待支付”)。
d. 调用 PaymentService.initiatePayment(order) 与第三方支付网关交互。
e. 如果支付预授权成功,调用 Order.confirm() 方法,将订单状态改为“已支付,待发货”。
f. 调用 OrderRepository.save(order) 持久化订单。
g. 调用 CartService.clearCart() 清空购物车。
6. OrderService 将操作结果(成功或失败)返回给 OrderController。
7. OrderController 根据结果,构造相应的响应(如跳转到成功页面或返回错误信息JSON)给前端。
通过这样的动态描述,我们就能非常清楚地看到,OrderService是如何作为业务流程的“总指挥”,协调多个仓库(Repository)、领域对象和外部服务,原子性地完成整个下单动作。这远比在控制器里写下一大段过程式代码要清晰和健壮。
3. 模块深度拆分:商品、购物车、订单的实战设计
现在,让我们将目光聚焦到三个核心模块,看看在引入了服务层和清晰的分层之后,每个模块应该如何具体设计。
3.1 商品展示模块:不仅仅是CRUD
商品模块看似简单,但要做好却需要考虑缓存、搜索、分类聚合等多个方面。
-
领域模型设计:
// domain/model/Product.java public class Product { private ProductId id; private String name; private Money price; // 使用值对象表示金额 private String description; private StockQuantity stock; // 库存值对象 private CategoryId categoryId; // ... 其他属性如SKU、图片等 // 领域行为:减少库存 public void reduceStock(Quantity quantity) { if (this.stock.isLessThan(quantity)) { throw new InsufficientStockException(this.id, quantity); } this.stock = this.stock.subtract(quantity); } // 注意:增加库存等行为可能由后台管理触发,此处略。 }这里,
Product不再是一个简单的“数据袋子”(贫血模型),它封装了“减少库存”这个核心领域逻辑,并守护了自己的不变性(库存不能为负)。 -
服务层设计:
// service/ProductService.java @Service @Transactional public class ProductService { private final ProductRepository productRepository; private final CacheManager cacheManager; public ProductDetailDTO getProductDetail(ProductId id) { // 1. 尝试从缓存读取 String cacheKey = "product:detail:" + id.getValue(); ProductDetailDTO cached = cacheManager.get(cacheKey, ProductDetailDTO.class); if (cached != null) { return cached; } // 2. 缓存未命中,查询数据库 Product product = productRepository.findById(id) .orElseThrow(() -> new ProductNotFoundException(id)); // 3. 组装DTO(可能涉及多个聚合的数据) ProductDetailDTO dto = assembleDetailDTO(product); // 4. 写入缓存 cacheManager.put(cacheKey, dto, Duration.ofMinutes(30)); return dto; } public PagedResult<ProductSummaryDTO> searchProducts(ProductSearchQuery query) { // 可能委托给专门的SearchService,使用Elasticsearch等搜索引擎 return productSearchService.search(query); } // ... 其他方法如getProductsByCategory }服务层处理了缓存逻辑、异常转换、以及跨聚合的数据组装,这些都是控制器不应关心的细节。
3.2 购物车模块:状态管理与业务规则
购物车是一个有状态的、通常是用户会话级别的概念。其设计需要区分临时购物车(未登录用户)和持久化购物车(已登录用户)。
-
核心领域逻辑:
// domain/model/Cart.java public class Cart { private CartId id; private UserId userId; // 可为空,表示匿名用户 private List<CartItem> items = new ArrayList<>(); private Money totalAmount; // 添加商品项 public void addItem(Product product, Quantity quantity) { // 检查是否已存在相同商品 Optional<CartItem> existingItem = findItemByProductId(product.getId()); if (existingItem.isPresent()) { existingItem.get().increaseQuantity(quantity); } else { items.add(new CartItem(product, quantity)); } calculateTotal(); // 重新计算总价 } // 计算总价(可应用优惠规则) private void calculateTotal() { Money total = items.stream() .map(CartItem::getSubTotal) .reduce(Money.ZERO, Money::add); // 此处可以预留钩子,未来让PromotionService注入优惠计算逻辑 this.totalAmount = total; } // 清空购物车(下单后调用) public void clear() { this.items.clear(); this.totalAmount = Money.ZERO; } }购物车自身负责维护其商品列表的完整性和总价计算。复杂的跨商品优惠(如满减、折扣券)则更适合放在
CartService中,因为它可能需要访问促销规则库。 -
服务层的协调作用:
// service/CartService.java @Service public class CartService { public CartDTO getOrCreateCart(UserId userId, String sessionId) { Cart cart; if (userId != null) { // 优先获取用户的持久化购物车 cart = cartRepository.findByUserId(userId).orElseGet(() -> createNewCart(userId)); // 可选:合并会话中的临时购物车 mergeSessionCart(cart, sessionId); } else { // 获取或创建基于会话的临时购物车 cart = sessionCartStore.get(sessionId).orElseGet(() -> createTemporaryCart(sessionId)); } // 应用当前所有可用优惠(调用PromotionService) PromotionContext context = new PromotionContext(cart); PromotionResult result = promotionService.applyPromotions(context); return cartAssembler.toDTO(cart, result.getAppliedPromotions(), result.getFinalAmount()); } }
3.3 订单模块:复杂状态机与事务边界
订单是电商系统的核心,其生命周期涉及多个状态和外部系统交互。
-
订单状态建模:使用枚举明确状态流转。
// domain/model/Order.java public class Order { private OrderId id; private OrderStatus status; private List<OrderLine> lines; private Money totalAmount; private PaymentInfo paymentInfo; private ShippingAddress shippingAddress; public enum OrderStatus { PENDING_PAYMENT, // 待支付 PAID, // 已支付 SHIPPED, // 已发货 DELIVERED, // 已送达 CANCELLED, // 已取消 REFUNDED // 已退款 } // 领域行为:支付成功 public void markAsPaid(PaymentInfo paymentInfo) { if (this.status != OrderStatus.PENDING_PAYMENT) { throw new IllegalOrderStatusException("Only orders in PENDING_PAYMENT can be marked as paid."); } this.status = OrderStatus.PAID; this.paymentInfo = paymentInfo; this.paidTime = Instant.now(); // 可能触发领域事件:OrderPaidEvent registerEvent(new OrderPaidEvent(this.id)); } // 领域行为:取消订单 public void cancel(String reason) { if (!canBeCancelled()) { // 内部方法,判断当前状态是否允许取消 throw new IllegalOrderStatusException("Order cannot be cancelled in current status."); } this.status = OrderStatus.CANCELLED; this.cancellationReason = reason; // 触发库存释放等后续操作(通过领域事件) registerEvent(new OrderCancelledEvent(this.id, this.lines)); } }将状态流转的规则封装在领域对象内部,是保证业务一致性的关键。
-
服务层处理分布式事务:下单流程可能涉及扣减库存、创建订单、调用支付、清空购物车等多个操作,需要保证原子性。
// service/OrderService.java @Service @Transactional(rollbackFor = Exception.class) // 声明式事务 public class OrderService { public OrderResult placeOrder(PlaceOrderCommand command) { // 1. 验证及准备(在事务内) Cart cart = validateCart(command.getCartId()); List<Product> products = validateAndLockStock(cart); // 悲观锁或乐观锁 // 2. 创建订单(领域对象) Order order = OrderFactory.create(cart, command.getShippingAddress()); // 3. 扣减库存(调用领域行为) for (Product product : products) { product.reduceStock(...); // 这会修改Product实体,由JPA自动持久化 } // 4. 保存订单 orderRepository.save(order); // 5. 清空购物车 cart.clear(); cartRepository.save(cart); // 6. 调用外部支付(注意:这是非事务性操作,需要补偿机制) // 通常将支付作为后续步骤,或使用Saga等分布式事务模式 PaymentRequest paymentRequest = buildPaymentRequest(order); // paymentClient.initiate(paymentRequest); // 可能放在事务外或异步处理 return OrderResult.success(order.getId()); } }注意:真实的分布式场景下,支付调用往往在本地事务提交后进行,并通过消息队列、状态机补偿等方式保证最终一致性。这是企业级架构与课程设计最大的区别之一。
4. 从模式到实践:构建可维护的分层架构模板
掌握了模块设计后,我们需要一套可复用的项目结构和编码约定,来保证整个团队能高效、一致地在此架构上工作。
4.1 项目目录结构约定
一个清晰的项目结构是良好架构的物理体现。推荐如下组织方式:
src/main/java/com/yourcompany/shop
├── application/ # 应用层 (Service, DTO, Assembler, 查询器)
│ ├── service/
│ ├── dto/
│ └── query/ # 专门处理复杂查询的类
├── domain/ # 领域层 (核心)
│ ├── model/ # 领域实体、值对象、聚合根
│ ├── repository/ # 仓储接口
│ ├── service/ # 领域服务(纯领域逻辑,无外部依赖)
│ └── event/ # 领域事件
├── infrastructure/ # 基础设施层
│ ├── persistence/ # 持久化实现 (JPA, MyBatis)
│ ├── external/ # 外部服务客户端 (支付、短信等)
│ └── config/ # 配置类
└── interfaces/ # 接口层/表示层 (Web, RPC API)
├── web/
│ ├── controller/
│ ├── request/ # 请求参数对象
│ └── response/ # 响应对象
└── rpc/ # 如果提供RPC接口
4.2 使用依赖注入与接口隔离
利用Spring等框架的依赖注入(DI)特性,严格遵循依赖倒置原则。高层模块(如Service)不应依赖低层模块(如DAO实现)的细节,而应依赖其抽象。
// 在领域层定义接口
package com.yourcompany.shop.domain.repository;
public interface OrderRepository {
Order findById(OrderId id);
Order save(Order order);
List<Order> findByUserId(UserId userId);
}
// 在基础设施层提供JPA实现
package com.yourcompany.shop.infrastructure.persistence.jpa;
@Repository
public class JpaOrderRepository implements OrderRepository {
private final OrderJpaRepository jpaRepository; // Spring Data JPA接口
@Override
public Order findById(OrderId id) {
return jpaRepository.findById(id.getValue())
.map(orderEntityConverter::toDomain)
.orElse(null);
}
// ... 其他方法实现
}
// 在应用层通过接口注入使用
@Service
public class OrderServiceImpl implements OrderService {
private final OrderRepository orderRepository; // 依赖抽象
// 构造函数注入
public OrderServiceImpl(OrderRepository orderRepository) {
this.orderRepository = orderRepository;
}
}
这种模式使得领域层完全与技术细节解耦。明天如果你想将持久化从JPA换成MyBatis,只需在基础设施层提供一个新的实现类,领域层和应用层的代码一行都不需要改动。
4.3 测试策略:为分层架构保驾护航
良好的架构必须辅以完善的测试。分层架构天然支持分层测试。
-
领域层单元测试:使用JUnit + Mockito,专注于测试领域对象(如
Order、Cart)的行为和业务规则。这些测试不依赖数据库和外部服务,运行速度极快。@Test void should_throw_exception_when_reduce_stock_beyond_available() { Product product = new Product(new ProductId("1"), "Test Product", Money.of(100), StockQuantity.of(10)); assertThrows(InsufficientStockException.class, () -> { product.reduceStock(StockQuantity.of(15)); }); } -
服务层集成测试:使用
@SpringBootTest加载部分上下文,测试Service与Repository(可使用内存数据库如H2)的集成。验证完整的业务用例。@SpringBootTest class OrderServiceIntegrationTest { @Autowired private OrderService orderService; @Autowired private TestEntityManager entityManager; @Test @Transactional void should_create_order_and_clear_cart() { // 准备测试数据 Cart cart = createTestCartWithItems(); entityManager.persist(cart); // 执行服务方法 OrderResult result = orderService.placeOrder(new PlaceOrderCommand(cart.getId())); // 验证结果 assertTrue(result.isSuccess()); assertTrue(cart.getItems().isEmpty()); // 购物车已清空 } } -
API层端到端测试:使用
@WebMvcTest或TestRestTemplate,测试从HTTP请求到响应的完整链条,确保API契约正确。
通过这样一套从理论到实践、从模式到代码的完整拆解,你会发现,MVC不再是一道僵化的考试题,而是一个活生生的、可以随着业务成长而灵活演进的架构蓝图。真正的挑战不在于画出那个标准的类图,而在于如何在日复一日的开发中,坚守分层与分离的初心,让每一行代码都落在它该在的位置上。
125



被折叠的 条评论
为什么被折叠?



