# Jakarta EE 的 CDD 设计支柱基于认知驱动开发 (CDD) 和 Alberto Souza 的“Pilares Design Código”的设计原则，适用于 Jakarta EE/MicroProfile 应用。 ## 核心理念 > 最好的代码是不需要编写的代码。当我们必须编写代码时，它应该通过尽可能简单的实现来正确运行，并且需要最少的脑力来理解、维护和发展。 ## 认知负荷理论代码复杂性是通过**内在认知负荷**来衡量的——理解代码所需的脑力劳动。研究表明工作记忆可同时保存约 7 个项目。 ### 认知负荷点元素|积分 ---|--- 自定义类依赖 | +1 分支（if、else、switch case）| +1 循环（for、while、forEach）| +1 Try-catch 块 |每次捕获+1 Lambda/函数转换 | +1 嵌套分支 | +1 额外 ### 按组件类型划分的负载限制组件|最大积分 |基本原理 ---|---|--- 领域服务/应用服务| 7 |业务流程必须一目了然实体/值对象 | 9 |可以容纳更复杂的状态逻辑控制器/资源| 7 |切入点应该简单存储库实施 | 5 |应该是直接的数据访问 ## 核心支柱 ### 1\.质量是不容谈判的设计与现有知识的复杂性成正比。尽可能快地执行代码——从外到内实施。 ### 2\.保护系统边界 * 外部边界得到最大程度的保护 * 切勿将外部请求参数直接绑定到域对象 * 切勿将域对象直接序列化为 API 响应 * 使用DTO进行输入/输出 ### 3\.仅创建有效引用每个对象从创建之日起就必须处于有效状态。使用构造函数和工厂方法来强制不变量。 ### 4\.将操作保留在所属类别中对类型为语言原语的数据的操作应该位于拥有该数据的类内。 ### 5\.每个间接都必须赢得它的位置每个新的类/文件都会增加系统的复杂性。仅当认知负荷超过限制时才创建抽象。 ### 6\.明确的业务规则业务规则必须在代码中显式声明，而不是隐藏在条件中或分散在各个层中。 ### 7\.有利于内聚的封装不要修改不是您创建的引用。将状态操作保留在所属类内。 ## Jakarta EE 快速参考 ### JAX-RS 资源（≤7 分） @路径（“/订单”） @RequestScoped 公共类订单资源{ @注入私有 OrderService orderService； // +1 @POST @Consumes(MediaType.APPLICATION_JSON) public Response create(@Valid CreateOrderRequest request) { // +1 订单 order = orderService.create(request); // +1 return Response.created(/*uri*/).entity(OrderResponse.from(order)).build(); } // 总计：3 分 ✓ } ### CDI服务（≤7分） @ApplicationScoped 公共类支付服务{ @注入私有 PaymentGateway 网关； // +1 @注入私有 TransactionRepository 交易； // +1 公共交易流程（PaymentRequest请求）{ if (!request.isValid()) { // +1 分支抛出新的 InvalidPaymentException(); } 支付 payment = gateway.charge(request); // +1 交易 tx = Transaction.from(付款); // +1 返回 transactions.save(tx); } // 总计：5 分 ✓ } ### 具有封装逻辑的 JPA 实体（≤9 分） @实体公开课顺序{ @Id @GenerateValue 私人长ID；私人即时到期时间； @Enumerated(EnumType.STRING) 私人 OrderStatus 状态； // ✓ 对拥有数据的操作保留在类中公共布尔接受修改（）{ 返回 this.expiresAt.isAfter(Instant.now()) && this.status == OrderStatus.PENDING; } // ✓ 封装状态变化公共无效取消（）{ if (!acceptsModification()) { 抛出新的 OrderCannotBeCancelledException(); } this.status = OrderStatus.CANCELLED; } } ### 使用 DTO 进行边界分离 // 请求DTO - 外部边界公共记录CreateOrderRequest( @NotBlank 字符串 customerId， @NotEmpty 列表项目）{ 公共订单到实体（客户客户）{ 返回新订单（客户，items.stream（） .map(OrderItemRequest::toEntity) .toList()); } } // 响应DTO - 外部边界公共记录 OrderResponse( 字符串订单ID，字符串状态，大十进制总计）{ 公共静态 OrderResponse from(订单订单) { 返回新的订单响应（ order.getId().toString(), order.getStatus().name(), order.getTotal() ）； } } ## 反模式 ### ❌ 拥有类之外的逻辑 // 不好：订单数据上的逻辑位于订单之外 if (order.getExpiresAt().isBefore(Instant.now())) { 返回“已过期”； } // 好：询问对象 if (order.isExpired()) { 返回“已过期”； } ### ❌ 超出认知负荷 // 不好：一项服务的积分太多（~11 分）公共结果处理（请求req）{ List handlers = this.handlers.stream() // +1 .map(h -> h.accepts(req)) // +1 .filter(Optional::isPresent) // +2（过滤器 + 分支） .map(可选::get) // +1 .collect(toList()); // +1 for (Handler h : handlers) { // +1 尝试{//+1 返回 h.handle(); } catch (NetworkException e) { // +1 日志.错误(...); } catch (异常 e) { // +1 日志.错误(...); } } 返回结果.失败(); } // 好：提取以减少点 @注入私有 HandlerSelector 处理程序选择器； // 提取的抽象公共结果处理（请求req）{ List handlers = handlerSelector.selectFor(req); // +1 返回executeWithFallback（处理程序，请求）； // 提取的 } ## 食谱索引 ### 核心支柱 * [protect-boundaries]() \- 保护系统边界 * [valid-state-only]() \- 仅创建有效引用 * [explicit-business-rules]() \- 明确业务规则 * [favor-encapsulation]() \- 内聚封装 ### 认知负荷模式 * [cognitive-load-limits]() \- 测量和限制负载 * [concentrate-operations]() \- 将操作保留在所属类中 * [extract-abstractions]() \- 何时创建新的抽象 ### 雅加达 EE 申请 * [boundary-separation]() \- DTO 和边界保护 * [rest-resource-design]() \- 带 CDD 的 JAX-RS * [cdi-bean-design]() \- 具有认知限制的 CDI beans * [jpa-entity-design]() \- 具有封装逻辑的实体 * [validation-patterns]() \- Bean 验证模式

Cdd 设计支柱

包含技能