{"id":182,"date":"2026-11-08T17:06:00","date_gmt":"2026-11-08T17:06:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=182"},"modified":"2026-11-08T17:06:00","modified_gmt":"2026-11-08T17:06:00","slug":"jpa-enum-ordinal-string","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/11\/08\/jpa-enum-ordinal-string\/","title":{"rendered":"JPA&#8217;da Enum&#8217;u ORDINAL ile Saklamay\u0131n"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Bir sipari\u015f entity&#8217;si:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@Enumerated\nprivate OrderStatus status;<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>enum OrderStatus { PENDING, SHIPPED, CANCELLED }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>@Enumerated<\/code> anotasyonunun varsay\u0131lan de\u011feri <code>EnumType.ORDINAL<\/code>. Yani veritaban\u0131na enum&#8217;un ad\u0131 de\u011fil, s\u0131ra numaras\u0131 yaz\u0131l\u0131r.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>PENDING   \u2192 0\nSHIPPED   \u2192 1\nCANCELLED \u2192 2<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Birka\u00e7 ay sonra yeni bir durum gerekiyor: \u00f6deme al\u0131nd\u0131 ama hen\u00fcz kargolanmad\u0131. Geli\u015ftirici mant\u0131kl\u0131 bir yere ekliyor:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>enum OrderStatus { PENDING, PAID, SHIPPED, CANCELLED }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Deploy ediyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Veritaban\u0131nda <code>1<\/code> olarak saklanan b\u00fct\u00fcn kargolanm\u0131\u015f sipari\u015fler art\u0131k <code>PAID<\/code> olarak okunuyor. <code>2<\/code> olan iptal edilmi\u015f sipari\u015fler <code>SHIPPED<\/code> g\u00f6r\u00fcn\u00fcyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kod derlendi. Testler ge\u00e7ti. Hi\u00e7bir hata yok.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ama veritaban\u0131ndaki b\u00fct\u00fcn sipari\u015f durumlar\u0131n\u0131n anlam\u0131 de\u011fi\u015fti.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Ordinal bir s\u00f6zle\u015fme de\u011fil<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bir enum&#8217;daki s\u0131ra, kodun okunabilirli\u011fi i\u00e7in se\u00e7ilir. De\u011ferleri mant\u0131ksal bir s\u0131rayla dizmek do\u011fal bir davran\u0131\u015ft\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">ORDINAL ile sakland\u0131\u011f\u0131nda bu s\u0131ra, veritaban\u0131ndaki verinin anlam\u0131na ba\u011flan\u0131r. Bir de\u011feri eklemek, silmek veya yer de\u011fi\u015ftirmek, kal\u0131c\u0131 veriyi sessizce bozar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sadece sona eklemek g\u00fcvenlidir. Ama bu kural\u0131n her geli\u015ftirici taraf\u0131ndan her zaman hat\u0131rlanaca\u011f\u0131n\u0131 varsaymak ger\u00e7ek\u00e7i de\u011fil.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">STRING<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Daha g\u00fcvenli se\u00e7enek:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@Enumerated(EnumType.STRING)\nprivate OrderStatus status;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Veritaban\u0131nda <code>SHIPPED<\/code>, <code>CANCELLED<\/code> gibi okunabilir de\u011ferler saklan\u0131r. Enum&#8217;a yeni de\u011ferler istenen yere eklenebilir, s\u0131ra de\u011fi\u015ftirilebilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir bonus: veritaban\u0131n\u0131 do\u011frudan sorgulayan biri, <code>status = 2<\/code> yerine <code>status = 'SHIPPED'<\/code> g\u00f6r\u00fcr. Raporlar ve hata ay\u0131klama kolayla\u015f\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bedeli birka\u00e7 byte fazla depolama. Pratikte ihmal edilebilir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Yeniden adland\u0131rma h\u00e2l\u00e2 tehlikeli<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">STRING kullan\u0131ld\u0131\u011f\u0131nda da bir risk kal\u0131r: enum de\u011ferinin ad\u0131n\u0131 de\u011fi\u015ftirmek.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>CANCELLED<\/code> de\u011ferini <code>CANCELED<\/code> olarak d\u00fczeltmek, veritaban\u0131ndaki mevcut <code>CANCELLED<\/code> kay\u0131tlar\u0131n\u0131n okunamamas\u0131na yol a\u00e7ar. Hibernate bilinmeyen de\u011feri enum&#8217;a \u00e7eviremez ve exception f\u0131rlat\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Yeniden adland\u0131rma gerekiyorsa, bir migration ile mevcut de\u011ferlerin de g\u00fcncellenmesi gerekir. Ve rolling deploy s\u0131ras\u0131nda eski kodun yeni de\u011feri okuyamayaca\u011f\u0131 da hesaba kat\u0131lmal\u0131. Yine expand and contract: \u00f6nce iki de\u011feri de tan\u0131yan kod, sonra migration, sonra eski de\u011ferin kald\u0131r\u0131lmas\u0131.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Kod ile veritaban\u0131 de\u011ferini ay\u0131rmak<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Daha esnek bir yakla\u015f\u0131m, enum&#8217;a veritaban\u0131nda saklanacak sabit bir kod vermek:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>enum OrderStatus {\n    PENDING(\"P\"), PAID(\"A\"), SHIPPED(\"S\"), CANCELLED(\"C\");\n    final String code;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Bir <code>AttributeConverter<\/code> ile bu kod veritaban\u0131na yaz\u0131l\u0131r ve okunur. Enum sabitlerinin ad\u0131 istenildi\u011fi gibi de\u011fi\u015ftirilebilir, veritaban\u0131ndaki de\u011fer sabit kal\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">K\u0131sa kodlar okunabilirli\u011fi biraz azalt\u0131r. Ama d\u0131\u015f sistemlerle payla\u015f\u0131lan veya y\u0131llarca saklanacak de\u011ferler i\u00e7in bu kararl\u0131l\u0131k de\u011ferli.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Veritaban\u0131nda kontrol<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Veritaban\u0131 seviyesinde ge\u00e7erli de\u011ferleri s\u0131n\u0131rlamak da faydal\u0131 bir g\u00fcvenlik a\u011f\u0131:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ALTER TABLE orders\nADD CONSTRAINT chk_orders_status\nCHECK (status IN ('PENDING', 'PAID', 'SHIPPED', 'CANCELLED'));<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Yeni bir de\u011fer eklendi\u011finde constraint&#8217;in de migration ile g\u00fcncellenmesi gerekir. Biraz ekstra i\u015f. Ama uygulaman\u0131n bir bug&#8217;\u0131 veya ba\u015fka bir sistem, tabloya ge\u00e7ersiz bir de\u011fer yazamaz.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">PostgreSQL&#8217;in kendi <code>ENUM<\/code> tipi de bir se\u00e7enek. Ama de\u011fer silmek veya yeniden adland\u0131rmak daha zahmetli oldu\u011fu i\u00e7in, bir\u00e7ok ekip <code>CHECK<\/code> constraint&#8217;li bir text kolonu daha esnek buluyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">JPA&#8217;n\u0131n varsay\u0131lan de\u011ferleri genellikle makuld\u00fcr.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>EnumType.ORDINAL<\/code> ise, de\u011fi\u015ftirilmesi gereken nadir varsay\u0131lanlardan biri.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Enum&#8217;un ortas\u0131na yeni bir de\u011fer eklendi ve veritaban\u0131ndaki b\u00fct\u00fcn durumlar bir kayd\u0131. EnumType.ORDINAL&#8217;\u0131n riski, STRING kullan\u0131m\u0131 ve enum de\u011ferlerini de\u011fi\u015ftirmenin g\u00fcvenli yolu.<\/p>\n","protected":false},"author":1,"featured_media":181,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[],"class_list":["post-182","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-veritabani"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/182","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/comments?post=182"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/182\/revisions"}],"predecessor-version":[{"id":233,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/182\/revisions\/233"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/181"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=182"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=182"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=182"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}