builder pattern

// Builder thông thường: Compile thành công nhưng CRASH tại Runtime!
PaymentOrder order = PaymentOrder.builder()
    .orderId("ORD-001")
    // Quên set amount!
    .currency(Currency.getInstance("VND"))
    .build(); // 🔴 Ném ra IllegalStateException tại Runtime!

package com.company.payment.domain;
 
import java.math.BigDecimal;
import java.util.Currency;
import java.util.Objects;
import java.util.Optional;
 
public final class PaymentOrder {
 
    // Immutable Fields
    private final String orderId;
    private final BigDecimal amount;
    private final Currency currency;
    private final String description;
    private final String callbackUrl;
 
    private PaymentOrder(Builder builder) {
        this.orderId = builder.orderId;
        this.amount = builder.amount;
        this.currency = builder.currency;
        this.description = builder.description;
        this.callbackUrl = builder.callbackUrl;
    }
 
    // Các Bước Ép Buộc (Stages)
    public interface OrderIdStep {
        AmountStep orderId(String orderId);
    }
 
    public interface AmountStep {
        CurrencyStep amount(BigDecimal amount);
    }
 
    public interface CurrencyStep {
        BuildStep currency(Currency currency);
    }
 
    public interface BuildStep {
        BuildStep description(String description);
        BuildStep callbackUrl(String callbackUrl);
        PaymentOrder build();
    }
 
    // Entry point duy nhất
    public static OrderIdStep stagedBuilder() {
        return new Builder();
    }
 
    // Builder Implementation ẩn bên trong
    private static class Builder implements OrderIdStep, AmountStep, CurrencyStep, BuildStep {
        private String orderId;
        private BigDecimal amount;
        private Currency currency;
        private String description;
        private String callbackUrl;
 
        @Override
        public AmountStep orderId(String orderId) {
            this.orderId = Objects.requireNonNull(orderId, "orderId không được null");
            return this;
        }
 
        @Override
        public CurrencyStep amount(BigDecimal amount) {
            if (amount == null || amount.compareTo(BigDecimal.ZERO) <= 0) {
                throw new IllegalArgumentException("amount phải lớn hơn 0");
            }
            this.amount = amount;
            return this;
        }
 
        @Override
        public BuildStep currency(Currency currency) {
            this.currency = Objects.requireNonNull(currency, "currency không được null");
            return this;
        }
 
        @Override
        public BuildStep description(String description) {
            this.description = description;
            return this;
        }
 
        @Override
        public BuildStep callbackUrl(String callbackUrl) {
            this.callbackUrl = callbackUrl;
            return this;
        }
 
        @Override
        public PaymentOrder build() {
            return new PaymentOrder(this);
        }
    }
 
    // Getters bảo vệ tính đóng gói
    public String getOrderId() { return orderId; }
    public BigDecimal getAmount() { return amount; }
    public Currency getCurrency() { return currency; }
    public Optional<String> getDescription() { return Optional.ofNullable(description); }
    public Optional<String> getCallbackUrl() { return Optional.ofNullable(callbackUrl); }
}

PaymentOrder.stagedBuilder()
    .orderId("TX-12345")
    .amount(BigDecimal.valueOf(500000))
    // Tại đây, IDE CHỈ CHO PHÉP gọi .currency(...)!
    // Phương thức .build() hoàn toàn CHƯA TỒN TẠI!

// Anti-Pattern: Gán trực tiếp tham chiếu
public User build() {
    this.roles = builder.roles; // 🔴 Lỗ hổng bảo mật: bên ngoài vẫn có thể gọi builder.roles.add("SUPERADMIN")!
}
 
// Hardened Pattern: Sao chép phòng thủ (Defensive Copy)
public User build() {
    // Tạo bản sao bất biến không thể sửa đổi
    this.roles = builder.roles == null ? Set.of() : Set.copyOf(builder.roles);
}