企业官网建设流程全解析

手机搭建网站,创意礼品私人定制,为学校网站做网站推广策划书,云南网站建设哪家权威目录 一、场景分析#xff1a;一个复杂的订单对象 二、代码实战#xff1a;实现订单对象的建造者模式 1. 定义商品项和地址等辅助 DTO 2. 实现核心的 OrderDTO 及其建造者 3. 客户端如何使用 三、在芋道#xff08;Yudao#xff09;框架中的实践要点 四、总结 在无人…目录一、场景分析一个复杂的订单对象二、代码实战实现订单对象的建造者模式1. 定义商品项和地址等辅助 DTO2. 实现核心的 OrderDTO 及其建造者3. 客户端如何使用三、在芋道Yudao框架中的实践要点四、总结在无人售货柜这类复杂的业务系统中一个 “订单” 对象通常包含大量信息如商品明细、支付信息、收货地址、物流信息、用户信息等。如果使用传统的构造器或大量的setter方法来创建代码会非常臃肿且容易出错。下面我们将结合现代 Java 开发的最佳实践如链式调用、final字段保证不可变性和芋道Yudao这类企业级开发框架的代码风格为你展示如何为一个复杂的Order对象设计并实现建造者模式。一、场景分析一个复杂的订单对象一个完整的订单OrderDTOData Transfer Object可能包含以下部分基础信息订单 ID、创建时间。商品信息商品列表ListOrderItemDTO。支付信息支付方式、支付金额、交易流水号。用户信息下单用户 ID。收货信息收货地址、联系人、联系电话。物流信息物流单号、物流公司。二、代码实战实现订单对象的建造者模式我们将采用静态内部类的方式来实现建造者这是目前最流行和推荐的做法因为它将建造者与产品紧密耦合在一起封装性最好。1. 定义商品项和地址等辅助 DTO首先我们定义订单中会用到的子对象。java运行// OrderItemDTO.java import lombok.Data; import java.math.BigDecimal; Data public class OrderItemDTO { private Long productId; private String productName; private Integer quantity; private BigDecimal unitPrice; } // AddressDTO.java import lombok.Data; Data public class AddressDTO { private String receiver; private String phone; private String province; private String city; private String district; private String detailAddress; }2. 实现核心的OrderDTO及其建造者这是本次实战的核心。我们将建造者Builder作为OrderDTO的静态内部类并使用链式调用。java运行// OrderDTO.java import java.math.BigDecimal; import java.time.LocalDateTime; import java.util.ArrayList; import java.util.List; import java.util.Objects; /** * 订单数据传输对象 (DTO) * 采用建造者模式构建保证对象创建的灵活性和可读性 */ public class OrderDTO { // 基础信息 private final Long id; private final LocalDateTime createTime; // 商品信息 private final ListOrderItemDTO items; private final BigDecimal totalAmount; // 支付信息 private final String paymentMethod; private final String transactionId; // 用户信息 private final Long userId; // 收货信息 private final AddressDTO deliveryAddress; // 物流信息 private final String logisticsCode; private final String logisticsCompany; // 私有化构造器只能通过Builder创建 private OrderDTO(Builder builder) { this.id builder.id; this.createTime builder.createTime; this.items new ArrayList(builder.items); // 深拷贝防止外部修改 this.totalAmount calculateTotalAmount(builder.items); // 内部计算总金额 this.paymentMethod builder.paymentMethod; this.transactionId builder.transactionId; this.userId builder.userId; this.deliveryAddress builder.deliveryAddress; this.logisticsCode builder.logisticsCode; this.logisticsCompany builder.logisticsCompany; // 在这里可以添加校验逻辑确保订单的完整性 validate(); } /** * 计算订单总金额 */ private BigDecimal calculateTotalAmount(ListOrderItemDTO items) { return items.stream() .map(item - item.getUnitPrice().multiply(BigDecimal.valueOf(item.getQuantity()))) .reduce(BigDecimal.ZERO, BigDecimal::add); } /** * 校验订单数据的完整性 */ private void validate() { Objects.requireNonNull(userId, 用户ID不能为空); Objects.requireNonNull(paymentMethod, 支付方式不能为空); Objects.requireNonNull(deliveryAddress, 收货地址不能为空); if (items null || items.isEmpty()) { throw new IllegalStateException(订单商品列表不能为空); } if (totalAmount.compareTo(BigDecimal.ZERO) 0) { throw new IllegalStateException(订单总金额必须大于0); } } // Getters for all fields // ... (此处省略所有字段的getter方法实际项目中需要生成) Override public String toString() { return OrderDTO{ id id , createTime createTime , items items , totalAmount totalAmount , paymentMethod paymentMethod \ , transactionId transactionId \ , userId userId , deliveryAddress deliveryAddress , logisticsCode logisticsCode \ , logisticsCompany logisticsCompany \ }; } /** * 静态内部建造者类 */ public static class Builder { // 1. 定义与OrderDTO完全相同的字段 private Long id; private LocalDateTime createTime; private final ListOrderItemDTO items new ArrayList(); private String paymentMethod; private String transactionId; private Long userId; private AddressDTO deliveryAddress; private String logisticsCode; private String logisticsCompany; // 2. 为每个字段提供链式的setter方法 public Builder id(Long id) { this.id id; return this; } public Builder createTime(LocalDateTime createTime) { this.createTime createTime; return this; } public Builder addItem(OrderItemDTO item) { this.items.add(item); return this; } public Builder items(ListOrderItemDTO items) { this.items.addAll(items); return this; } public Builder paymentMethod(String paymentMethod) { this.paymentMethod paymentMethod; return this; } public Builder transactionId(String transactionId) { this.transactionId transactionId; return this; } public Builder userId(Long userId) { this.userId userId; return this; } public Builder deliveryAddress(AddressDTO deliveryAddress) { this.deliveryAddress deliveryAddress; return this; } public Builder logisticsCode(String logisticsCode) { this.logisticsCode logisticsCode; return this; } public Builder logisticsCompany(String logisticsCompany) { this.logisticsCompany logisticsCompany; return this; } // 3. 提供一个build方法创建OrderDTO实例 public OrderDTO build() { // 可以在这里设置一些默认值 if (this.createTime null) { this.createTime LocalDateTime.now(); } return new OrderDTO(this); } } }3. 客户端如何使用客户端代码变得极其清晰和易于阅读就像在 “描述” 一个订单的创建过程。java运行// Client.java import java.math.BigDecimal; import java.time.LocalDateTime; import java.util.Arrays; public class Client { public static void main(String[] args) { // 1. 准备订单的各个组成部分 OrderItemDTO item1 new OrderItemDTO(); item1.setProductId(1001L); item1.setProductName(可口可乐); item1.setQuantity(2); item1.setUnitPrice(new BigDecimal(3.5)); OrderItemDTO item2 new OrderItemDTO(); item2.setProductId(1002L); item2.setProductName(薯片); item2.setQuantity(1); item2.setUnitPrice(new BigDecimal(5.0)); AddressDTO address new AddressDTO(); address.setReceiver(张三); address.setPhone(13800138000); address.setProvince(广东省); address.setCity(深圳市); address.setDistrict(南山区); address.setDetailAddress(科技园路100号); // 2. 使用建造者模式创建订单 OrderDTO order new OrderDTO.Builder() .id(9527L) .userId(101L) .paymentMethod(WECHAT_PAY) .transactionId(wx20231027...) .deliveryAddress(address) .addItem(item1) .addItem(item2) .logisticsCompany(顺丰速运) .logisticsCode(SF1234567890) // createTime 会在build时自动填充为当前时间 .build(); // 3. 打印订单信息 System.out.println(成功创建订单); System.out.println(order); } }三、在芋道Yudao框架中的实践要点芋道框架非常推崇领域驱动设计DDD和整洁的代码风格上述建造者模式的实现方式与芋道的理念高度契合。在芋道项目中你可以这样做在dto包中定义OrderDTO将上述OrderDTO.java文件放在your-project-module-api/src/main/java/.../dto/目录下。结合 Lombok 简化代码虽然上面为了清晰展示原理而手动编写了构造器和getter但在实际项目中你可以使用 Lombok 的Getter和Builder注解来极大地简化代码。java运行import lombok.Builder; import lombok.Getter; import lombok.Singular; // ... 其他 import Getter Builder(builderClassName Builder, toBuilder true) public class OrderDTO { private final Long id; private final LocalDateTime createTime; Singular // 用于集合会自动生成 addItem 和 items 方法 private final ListOrderItemDTO items; private final BigDecimal totalAmount; // 注意Lombok的Builder无法直接处理派生字段需要手动处理 // ... 其他字段 // 为了处理totalAmount这种派生字段可以使用一个私有构造器和静态工厂方法 // 或者在Service层计算好后再传入Builder }注意Lombok 的Builder对于需要在构建时动态计算的字段如totalAmount支持不佳。在这种情况下手动实现建造者模式如本示例所示能提供更强大的控制力因为你可以在OrderDTO的私有构造器中执行计算和校验逻辑。在service层中使用在你的OrderService实现类中当需要创建一个OrderDTO返回给前端时就可以使用这个建造者。java运行// OrderServiceImpl.java Service public class OrderServiceImpl implements OrderService { Override public OrderDTO getOrderDetails(Long orderId) { // ... 从数据库或领域模型中获取数据 ... OrderDO orderDO orderMapper.selectById(orderId); ListOrderItemDO itemDOs orderItemMapper.selectListByOrderId(orderId); UserDO userDO userMapper.selectById(orderDO.getUserId()); // ... 将DO转换为DTO的各个部分 ... ListOrderItemDTO itemDTOs itemDOs.stream().map(...).collect(Collectors.toList()); AddressDTO addressDTO buildAddressDTO(userDO); // 使用建造者模式构建最终的OrderDTO return new OrderDTO.Builder() .id(orderDO.getId()) .createTime(orderDO.getCreateTime()) .userId(orderDO.getUserId()) .paymentMethod(orderDO.getPaymentMethod()) .transactionId(orderDO.getTransactionId()) .deliveryAddress(addressDTO) .items(itemDTOs) .logisticsCompany(orderDO.getLogisticsCompany()) .logisticsCode(orderDO.getLogisticsCode()) .build(); } }四、总结为订单对象实现建造者模式带来了以下显著好处可读性高客户端代码如同自然语言清晰地描述了订单的构成。灵活性强可以轻松地增加或减少订单的组成部分而无需修改构造函数。健壮性好通过在build()或OrderDTO构造器中进行校验可以确保创建出的订单对象总是有效的。代码解耦将复杂对象的创建逻辑封装在建造者中客户端无需关心对象的内部结构和创建细节。这种模式非常适合在无人售货柜这类业务复杂、对象属性繁多的系统中广泛应用。