Enum — Sabit Bir Seçenek Listesi

Bir restoranın menüsünde üç yemek var. Garson “pizzza” yazarsa mutfak ne yapacağını bilemez; menüde öyle bir şey yok.

Kodda da bazı değerlerin yalnızca birkaç seçeneği vardır. Onları serbest metin yerine sabit bir menü olarak yazmanın yolu enum’dur.

Metin yerine sabit bir liste

Bir enum?Terimin tanımını açenumBir değerin alabileceği seçenekleri baştan sayan tip. Listede olmayan bir değer derlenmez.Enum bir sınıftır: her sabit onun tek bir nesnesidir ve alan, kurucu, metot taşıyabilir. Sabitler tekil olduğu için == ile karşılaştırılabilir.Sözlükte gör → bir değerin alabileceği bütün seçenekleri baştan sayar. Listede olmayan bir değeri yazamazsın; derleyici durdurur.

1
enum Durum { HAZIRLANIYOR, KARGODA, TESLIM_EDILDI }
2

3
Durum d = Durum.KARGODA;       // listeden seçildi
4
Durum e = Durum.KARGODAA;      // derleme hatası: böyle bir seçenek yok

Switch ifadesi enum’daki her seçeneği ele almak zorundadır. Enum’a yeni bir durum eklediğinde, onu unuttuğun her switch derlenmez.

1
String etiket = switch (d) {
2
    case HAZIRLANIYOR -> "Hazırlanıyor";
3
    case KARGODA -> "Yolda";
4
    case TESLIM_EDILDI -> "Teslim edildi";
5
};

Enum aslında bir sınıf

Her enum sabiti, o enum sınıfının tek bir nesnesidir. Bu yüzden alanlar, bir kurucu ve metotlar taşıyabilir.

1
enum TransferTipi {
2
    FAST(new BigDecimal("0.00")),
3
    EFT(new BigDecimal("4.50")),
4
    SWIFT(new BigDecimal("25.00"));
5

6
    private final BigDecimal ucret;
7

8
    TransferTipi(BigDecimal ucret) {
9
        this.ucret = ucret;
10
    }
11

12
    BigDecimal ucret() {
13
        return ucret;
14
    }
15
}

Böylece “tip EFT ise ücret şu” diye uzayan if-else zincirleri kaybolur: bilgi, ait olduğu seçeneğin içinde durur. Her sabit tek bir nesne olduğu için enum’ları == ile karşılaştırmak da güvenlidir.

Satır satır: metinden enum’a

Dışarıdan gelen bir metni (bir istek parametresi, bir dosya satırı) enum’a çevirmen gerekebilir.

1. Varsayılanla oynat. Metin olarak saklayınca yazım hatası KARGODAA da bir durum gibi kaydedildi.
2. “Durum.valueOf(girdi)” seç. Küçük harfle gelen her geçerli durum reddedildi.
3. “Türkçe JVM” seçeneğini dene. teslim_edildi, TESLİM_EDİLDİ’ye döndü ve reddedildi.
4. “Locale.ROOT” seç. Dört geçerli yazım tanındı, yazım hatası reddedildi.

EnumMap ve EnumSet

Anahtarı enum olan bir map ya da enum’lardan oluşan bir küme gerekiyorsa, bunlar için yapılmış iki hazır yapı var.

1
Map<Durum, Integer> sayac = new EnumMap<>(Durum.class);
2
Set<Durum> acik = EnumSet.of(Durum.HAZIRLANIYOR, Durum.KARGODA);

İkisi de enum’ların sayısının sabit ve küçük olduğunu bilir; içeride basit bir dizi gibi çalışır. Sıraları da enum’daki tanım sırasıdır, bu yüzden çıktıları hep aynı düzende gelir.

Bir bankada para birimleri ve transfer tipleri tam böyle yazılır: her seçenek kendi kuralını taşır, hesaplama switch’e değil seçeneğin kendisine sorulur.

1
public enum TransferType {
2
    FAST(new BigDecimal("0.00"), true),
3
    EFT(new BigDecimal("4.50"), false),
4
    SWIFT(new BigDecimal("25.00"), false);
5

6
    private final BigDecimal fee;
7
    private final boolean alwaysOpen;
8

9
    TransferType(BigDecimal fee, boolean alwaysOpen) {
10
        this.fee = fee;
11
        this.alwaysOpen = alwaysOpen;
12
    }
13

14
    public BigDecimal fee() {
15
        return fee;
16
    }
17

18
    // EFT and SWIFT only run in banking hours in this example.
19
    public boolean availableAt(LocalTime time) {
20
        return alwaysOpen || (!time.isBefore(LocalTime.of(9, 0)) && time.isBefore(LocalTime.of(17, 0)));
21
    }
22
}

1
@Entity
2
public class Transfer {
3

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

8
    // STRING stores "EFT"; the default ORDINAL would store 1 and break if the order ever changed.
9
    @Enumerated(EnumType.STRING)
10
    private TransferType type;
11

12
    private BigDecimal amount;
13
}

1
public class Main {
2
    public static void main(String[] args) {
3
        TransferType type = TransferType.valueOf("eft".toUpperCase(Locale.ROOT));
4
        System.out.println(type.fee());                              // 4.50
5
        System.out.println(type.availableAt(LocalTime.of(20, 0)));   // false
6
        System.out.println(TransferType.FAST.availableAt(LocalTime.of(20, 0)));   // true
7
    }
8
}

Tuzaklar

Veritabanına sıra numarası yazmak. JPA’da @Enumerated’ın varsayılanı sıra numarasıdır (ordinal?Terimin tanımını açordinalBir enum sabitinin listedeki sıfırdan başlayan sırası. İlk sabitin ordinal değeri 0'dır.Liste değişince değişir; bu yüzden kalıcı bir kimlik olarak (veritabanında, dosyada) kullanılmaz. Kalıcı olan sabitin adıdır: name().Sözlükte gör →). Enum’un ortasına yeni bir sabit eklersen eski kayıtların anlamı kayar; bu yüzden EnumType.STRING kullan.

Kullanıcı girdisini doğrudan valueOf’a vermek. Bilinmeyen bir değer IllegalArgumentException atar ve bu, kullanıcıya 500 hatası olarak dönebilir. Hatayı yakalayıp 400 olarak anlamlı bir mesajla dön.

Switch’e default yazmak. Default, yeni eklenen bir sabiti sessizce yutar. Enum üzerindeki switch ifadesinde default yazmazsan derleyici eksik seçeneği gösterir.

Kendini sına