Value Object ve Record — Anlamı Tipe Taşımak

Bir sayı tek başına pek bir şey anlatmaz; yanında ne olduğu yazmıyorsa herkes onu başka türlü okur.

Önceki derste kuralları entity’ye taşıdık ve iki çağrı yine de geçti: farklı para birimi ve yer değiştirmiş argümanlar. İkisinin de sebebi aynı: int ve BigDecimal ne olduklarını bilmiyorlar.

Her şey long olunca

Şu imza, Spring Boot servislerinde sık görülür:

1
public void transfer(long fromAccountId, long toAccountId, BigDecimal amount) { … }
2

3
transfer(toId, fromId, amount);   // derlenir. Para ters yöne gider.

Bu duruma primitive obsession?Terimin tanımını açprimitive obsessionAnlamı ve kuralı olan bir değeri (para, e-posta, hesap numarası) çıplak bir ilkel tiple (long, String, BigDecimal) taşımak. Derleyici iki long'u birbirinden ayıramaz.Sözlükte gör → denir: anlamı olan bir değeri çıplak bir ilkel tiple taşımak. Derleyici “iki long” görür, “gönderen ve alıcı” görmez.

BigDecimal da aynı sorunu taşır. 15’in lira mı dolar mı olduğunu bilmez, bu yüzden 15 TRY + 5 USD = 20 hesabına hiçbir itirazı olmaz.

Satır satır: record ile Money

Kimliği olmayan, değeriyle eşit sayılan ve değiştirilemeyen küçük nesneye value object?Terimin tanımını açvalue objectKimliği olmayan, değeriyle eşit sayılan ve değiştirilemeyen küçük nesne: Money, Email, Quantity. Kendi geçerlilik kuralını kurucusunda taşır.Sözlükte gör → denir. Java 21’de bunun doğal kalıbı bir record’dur. Kural ise compact constructor?Terimin tanımını açcompact constructorJava record'larında parametre listesi yazılmadan tanımlanan kurucu. Alanlar atanmadan önce çalışır; doğrulama ve normalleştirme için kullanılır.Sözlükte gör →’a yazılır.

Record sana equals, hashCode, toString ve değişmez alanları bedava verir. Kuralı vermez. plus içindeki kontrolü yazmazsan, Money sadece iki alanlı bir kılıftır.

Spring Boot’ta saklamak ve taşımak

Value object’in kimliği yok, bu yüzden kendi tablosu da yok. Sahibi olan entity’nin kolonlarında yaşar:

Hibernate 6.2 ve sonrası (Spring Boot 3.1+) record’ları doğrudan @Embeddable olarak kabul eder. AttributeConverter ise kolondan okurken new Email(...) çağırır; yani veritabanından gelen değer de aynı doğrulamadan geçer.

Controller’da entity yerine record DTO almanın sebebi aynı fikrin öbür yüzü: istemci yalnızca tanımladığın alanları gönderebilir. total ya da status gibi alanları dışarıdan yazmak mümkün olmaz.

Üçünü bir arada görmek için küçük bir havale ekranı düşünelim. IBAN tek alanlı, tutar ise iki alanlı bir value object; ikisi de tabloya kendi kurallarıyla girip çıkıyor.

1
public record Iban(String value) {
2

3
    public Iban {
4
        Objects.requireNonNull(value, "IBAN is required");
5
        value = value.replace(" ", "").toUpperCase(Locale.ROOT);
6
        if (!value.matches("[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}") || !hasValidCheckDigits(value)) {
7
            throw new IllegalArgumentException("invalid IBAN");
8
        }
9
    }
10

11
    // ISO 13616 mod-97 check: move the first four characters to the end, A=10 ... Z=35.
12
    private static boolean hasValidCheckDigits(String iban) {
13
        String rearranged = iban.substring(4) + iban.substring(0, 4);
14
        int remainder = 0;
15
        for (char c : rearranged.toCharArray()) {
16
            int n = Character.getNumericValue(c);
17
            remainder = (remainder * (n < 10 ? 10 : 100) + n) % 97;
18
        }
19
        return remainder == 1;
20
    }
21
}

1
// autoApply: every Iban field in every entity is stored through this converter.
2
@Converter(autoApply = true)
3
class IbanConverter implements AttributeConverter<Iban, String> {
4

5
    @Override
6
    public String convertToDatabaseColumn(Iban iban) {
7
        return iban == null ? null : iban.value();
8
    }
9

10
    @Override
11
    public Iban convertToEntityAttribute(String column) {
12
        // A bad value in the table fails here, not three services later.
13
        return column == null ? null : new Iban(column);
14
    }
15
}

1
@Entity
2
@Table(name = "outgoing_transfer")
3
public class OutgoingTransfer {
4

5
    @Id
6
    @GeneratedValue
7
    private Long id;
8

9
    private Iban debtorIban;
10
    private Iban creditorIban;
11

12
    // The Money record from this lesson, marked @Embeddable: two columns, no table of its own.
13
    @Embedded
14
    @AttributeOverride(name = "amount", column = @Column(name = "amount", precision = 19, scale = 2))
15
    @AttributeOverride(name = "currency", column = @Column(name = "currency", length = 3))
16
    private Money amount;
17

18
    @Enumerated(EnumType.STRING)
19
    private TransferStatus status;
20

21
    protected OutgoingTransfer() {
22
        // for JPA
23
    }
24

25
    public OutgoingTransfer(Iban debtorIban, Iban creditorIban, Money amount) {
26
        this.debtorIban = debtorIban;
27
        this.creditorIban = creditorIban;
28
        this.amount = amount;
29
        this.status = TransferStatus.PENDING;
30
    }
31
}

1
// The body carries only what the customer may choose.
2
// The debtor account comes from the logged-in customer; status is set by the bank.
3
public record TransferRequest(
4
        @NotBlank String creditorIban,
5
        @NotNull @Positive BigDecimal amount,
6
        @NotBlank @Pattern(regexp = "[A-Z]{3}") String currency) {
7

8
    public OutgoingTransfer toTransfer(Iban debtorIban) {
9
        Money money = new Money(amount, Currency.getInstance(currency));
10
        return new OutgoingTransfer(debtorIban, new Iban(creditorIban), money);
11
    }
12
}

Kendin gör

Önceki dersin simülatörü, bu kez son iki modeli karşılaştırmak için.

1. Modeli Zengin entity yap ve sonuna kadar oynat. Kuralların beşinden ikisi hâlâ kırmızı: para birimi ve argüman sırası.
2. Zengin entity + value object’e geç. Negatif miktar artık metotta değil, Quantity.of(-1) kurucusunda duruyor. Kural bir adım sola kaydı.
3. Yer değiştirmiş argümanlara bak. Bu kez kod derlenmiyor: Money bir Quantity değil. En ucuz hata, hiç çalışmayan koddur.
4. Sıfır bozulma görevini tamamla.

Tuzaklar

BigDecimal.equals ve ölçek. new BigDecimal("2.0").equals(new BigDecimal("2.00")) false döner.

Record’un üretilen equals’ı da bunu kullanır. Ölçeği compact constructor’da sabitle ya da karşılaştırmada compareTo kullan.

Yüzeysel değişmezlik. record Basket(List<Item> items) değişmez görünür ama dışarıdan verilen liste hâlâ değiştirilebilir. Compact constructor’da items = List.copyOf(items); yaz.

Her şeyi sarmalamak. Kuralı ya da karıştırılma riski olmayan bir alan (serbest bir “not”) için value object yalnızca dönüştürme kodu ekler. Soru şu: bu değerin bir kuralı var mı, başka bir değerle karışabilir mi?

Value object’e kimlik vermek. Money’yi @Entity yapıp id vermek onu bir entity’ye çevirir. İki aynı tutar artık “farklı” nesneler olur.

Kendini sına