# 雅加达 EE 的 DDD da Massa 适用于 Web 应用程序的实用领域驱动设计模式，应用认知负载理论来创建可维护的代码。改编自阿尔贝托·苏扎 (Alberto Souza) 的《DDD da Massa》。 ## 理念 > 使 Web 应用程序开发能够执行必要的操作，具有足够灵活的设计，并且无需花费太多精力即可理解项目的大部分内容。 ## 关键原则 1. **利用框架**——不要忽视它们，最大化它们的价值 2. **上下文负载限制** - 不同的组件有不同的限制 3. **逻辑责任划分**——基于认知负荷，而不是感受 4. **100% 内聚组件** — 每个方法使用的每个属性 ## 情境认知负荷限制 Web 应用程序的不同部分有不同的复杂性预算：组件|最大积分 |基本原理 ---|---|--- **控制器/资源** | 7 |处理信息流，必须清晰 **域名服务** | 7 |业务流程应该容易理解 **表格/请求 DTO** | 9 |具有转换逻辑的瞬态 **实体** | 9 |具有行为的持久状态 **存储库** | 3 |框架承担繁重的工作 **基础设施** |无穷大|很少接触，复杂一点也可以 **配置** |无穷大|模板，很少修改 ## 核心模式 ### 1\. 100% 内聚控制器控制器中的每个方法都必须使用所有注入的依赖项。 @Path("/订单/{orderId}/付款") @RequestScoped 公共类 OrderPaymentResource { @注入私有 OrderRepository 订单； // 被所有方法使用 @注入私有 PaymentGateway 网关； // 被所有方法使用 @注入私有 Event 事件； // 被所有方法使用 @POST @事务性公众响应流程支付( @PathParam("orderId") 长 orderId, @Valid PaymentRequest请求）{ 订单 order =orders.findById(orderId) .orElseThrow(NotFoundException::new); 付款 payment = request.toPayment(order); PaymentResult 结果 = gateway.process( payment); events.fire(new PaymentEvent(order, result)); 返回 Response.ok(PaymentResponse.from(结果)).build(); } } // 使用所有 3 个依赖项 ✓ ### 2\.表单值对象（智能 DTO）知道如何将自身转换为域对象的 DTO。公共记录CreateOrderRequest( @NotBlank 字符串 customerId， @NotEmpty List<@Valid OrderItemRequest> 项目，弦乐音符）{ // 转换逻辑位于此处，而不是位于单独的映射器中公共订单到实体（客户客户）{ 返回新订单( 客户， items.stream().map(OrderItemRequest::toEntity).toList(), 笔记）； } } ### 3\.丰富的实体实体拥有业务逻辑，而不仅仅是数据。 @实体公开课博佬{ 私人即时到期时间； @ElementCollection 私人集邀请电子邮件； // ✓ 状态逻辑存在于实体中公众参与接受（用户参与者）{ if (expiresAt.isBefore(Instant.now())) { 抛出新的 InvitationExpiredException(); } if (!invitedEmails.contains(participant.getEmail())) { 抛出新的NotInvitedException（参与者）； } 返回新的参与（this，参与者）； } } ### 4\.域服务控制器当控制器+服务角色合并时（对于简单流程）： @Path(“/付款/pagseguro/{orderId}”) @RequestScoped 公共类 PagseguroPaymentCallbackResource { @注入私有 OrderRepository 订单； @注入私人支付存储库支付； @注入私有事件 paymentEvents; @POST @事务性公共无效过程回调（ @PathParam("orderId") 长 orderId, @Valid PagseguroCallbackRequest 请求）{ 订单 order =orders.findById(orderId) .orElseThrow(NotFoundException::new); 付款 payment = request.toPayment(order); 付款.保存（付款）； paymentEvents.fire(new NewPaymentEvent(付款)); } } // 充当控制器和域服务 ## 负载分布检查如果实体的负载较低，但调用代码的负载较高→分布不良： // ❌ 实体太瘦，控制器太胖 @POST 公共响应接受（@Valid AcceptRequest请求）{ bolao bolao = bolaoRepo.findById(request.bolaoId()).get(); // 所有这些逻辑都应该在实体中 if (bolao.getExpiresAt().isBefore(Instant.now())) { return Response.status(422).entity("过期").build(); } if (!bolao.getEmails().contains(request.email())) { return Response.status(422).entity("未邀请").build(); } // ...更多外部逻辑 } // ✓ 将逻辑移至实体 @POST 公共响应接受（@Valid AcceptRequest请求）{ bolao bolao = bolaoRepo.findById(request.bolaoId()).get(); 用户 user = userRepo.findByEmail(request.email()).orElseThrow(); 参与参与 = bolao.accept(user); // 实体有逻辑参与Repo.save(参与); 返回 Response.ok().build(); } ## 何时创建新类仅在以下情况下创建新文件： 1. **超出认知负荷** — 必须分配 2. **新领域概念**——实体、值对象 3. **语言特征**——Enum，密封类型不要仅仅因为“感觉更干净”而创建类。 ## 食谱索引 ### 控制器模式 * [cohesive-resources]() \- 100% 内聚 JAX-RS 资源 * [domain-service-controller]() \- 合并控制器/服务模式 ### DTO 模式 * [form-value-objects]() \- 带转换的智能 DTO * [request-validation]() \- DTO 中的验证 ### 域模式 * [rich-entities]() \- 具有行为的实体 * [load-distribution]() \- 跨层平衡负载 ### 服务模式 * [cohesive-services]() \- 100% 内聚 CDI 服务 * [splitting-load]() \- 何时以及如何拆分服务

达达马萨

包含技能