{"id":97,"date":"2026-09-03T18:25:00","date_gmt":"2026-10-16T18:25:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/2026\/10\/16\/hexagonal-architecture-overengineering\/"},"modified":"2026-10-25T18:13:56","modified_gmt":"2026-10-25T18:13:56","slug":"hexagonal-architecture-overengineering","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/09\/03\/hexagonal-architecture-overengineering\/","title":{"rendered":"Her \u015eeye Interface Yazmak Mimari De\u011fildir"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Bir kullan\u0131c\u0131n\u0131n ad\u0131n\u0131 g\u00fcncelleyen bir endpoint d\u00fc\u015f\u00fcn\u00fcn.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Baz\u0131 projelerde bu i\u015flem \u015fu dosyalardan ge\u00e7er:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>UpdateUserNameController\nUpdateUserNameRequest\nUpdateUserNameCommand\nUpdateUserNameUseCase\nUpdateUserNameService\nUserRepositoryPort\nUserPersistenceAdapter\nUserJpaEntity\nUserDomainModel\nUserMapper\nUserEntityMapper<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On bir dosya.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir <code>UPDATE<\/code> sorgusu i\u00e7in.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ve bu yap\u0131 &#8220;temiz mimari&#8221; olarak savunulur.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Fikirler de\u011ferli<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Hexagonal architecture&#8217;\u0131n temel fikri g\u00fc\u00e7l\u00fc: i\u015f mant\u0131\u011f\u0131 veritaban\u0131ndan, framework&#8217;ten ve d\u0131\u015f servislerden ba\u011f\u0131ms\u0131z olmal\u0131. D\u0131\u015f d\u00fcnya ile ileti\u015fim port&#8217;lar \u00fczerinden olmal\u0131.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bu sayede i\u015f kurallar\u0131 d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klar olmadan test edilebilir. Altyap\u0131 de\u011fi\u015fti\u011finde i\u015f mant\u0131\u011f\u0131 etkilenmez.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ger\u00e7ekten karma\u015f\u0131k bir domain&#8217;de, bir\u00e7ok d\u0131\u015f entegrasyonu olan ve uzun y\u0131llar ya\u015fayacak bir sistemde bu ayr\u0131m \u00e7ok de\u011ferli.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Problem, bu yap\u0131n\u0131n i\u015f kural\u0131 neredeyse olmayan kodlara da ayn\u0131 \u015fekilde uygulanmas\u0131.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tek implementasyonlu interface<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">En s\u0131k g\u00f6rd\u00fc\u011f\u00fcm kal\u0131p \u015fu:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>public interface UserService { ... }\npublic class UserServiceImpl implements UserService { ... }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Interface&#8217;in tek bir implementasyonu var. \u0130kincisinin olmas\u0131 da \u00f6ng\u00f6r\u00fclm\u00fcyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">S\u0131k duyulan gerek\u00e7e test edilebilirlik. Ama modern mock k\u00fct\u00fcphaneleri concrete s\u0131n\u0131flar\u0131 da mock&#8217;layabiliyor. Spring de proxy olu\u015fturmak i\u00e7in interface&#8217;e ihtiya\u00e7 duymuyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Gerek\u00e7elerden biri de &#8220;ileride de\u011fi\u015firse&#8221; d\u00fc\u015f\u00fcncesi. Ama ihtiya\u00e7 ger\u00e7ekten ortaya \u00e7\u0131kt\u0131\u011f\u0131nda bir s\u0131n\u0131ftan interface \u00e7\u0131karmak, IDE&#8217;de birka\u00e7 saniyelik bir refactoring.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Gereksiz interface&#8217;in maliyeti ise her g\u00fcn \u00f6denir. Koda &#8220;go to definition&#8221; ile gidildi\u011finde interface&#8217;e ula\u015f\u0131l\u0131r, implementasyonu bulmak i\u00e7in bir ad\u0131m daha at\u0131l\u0131r. Her de\u011fi\u015fiklik iki dosyada yap\u0131l\u0131r.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mapper zinciri<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Katmanlar aras\u0131nda veri d\u00f6n\u00fc\u015ft\u00fcrmek, katmanlar\u0131n birbirinden ba\u011f\u0131ms\u0131z evrilebilmesi i\u00e7in yap\u0131l\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Request DTO&#8217;su API s\u00f6zle\u015fmesidir. Entity veritaban\u0131 \u015femas\u0131d\u0131r. Domain model i\u015f kurallar\u0131n\u0131 ta\u015f\u0131r. Bunlar\u0131n ayr\u0131 olmas\u0131 bazen ger\u00e7ekten gerekir. \u00d6zellikle d\u0131\u015far\u0131ya a\u00e7\u0131k API&#8217;nin veritaban\u0131 \u015femas\u0131na ba\u011fl\u0131 olmamas\u0131 \u00f6nemli.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ama d\u00f6rt modelin de birebir ayn\u0131 alanlara sahip oldu\u011fu ve her mapper&#8217;\u0131n sadece alanlar\u0131 kopyalad\u0131\u011f\u0131 bir yap\u0131da, bu ayr\u0131m\u0131n sa\u011flad\u0131\u011f\u0131 bir esneklik yok. Sadece bir alan eklemek i\u00e7in d\u00f6rt dosyay\u0131 ve \u00fc\u00e7 mapper&#8217;\u0131 g\u00fcncellemek gerekiyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ve mapper&#8217;larda unutulan bir alan, derleme hatas\u0131 vermeden sessizce <code>null<\/code> olarak ta\u015f\u0131n\u0131yor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Karma\u015f\u0131kl\u0131\u011f\u0131 nereye harcad\u0131\u011f\u0131m\u0131z<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bence as\u0131l soru \u015fu: bu soyutlama hangi de\u011fi\u015fikli\u011fi kolayla\u015ft\u0131r\u0131yor?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u00d6deme sa\u011flay\u0131c\u0131s\u0131n\u0131n de\u011fi\u015fmesi ger\u00e7ek bir ihtimalse, \u00f6deme i\u015flemi i\u00e7in bir port tan\u0131mlamak mant\u0131kl\u0131. Bug\u00fcn iki sa\u011flay\u0131c\u0131 varsa zaten gerekli.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Veritaban\u0131n\u0131n PostgreSQL&#8217;den ba\u015fka bir \u015feye ge\u00e7mesi pratikte nadir ve ge\u00e7ildi\u011finde de soyutlama genellikle yetmez. Sorgular, transaction davran\u0131\u015flar\u0131, index stratejileri de\u011fi\u015fir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Soyutlamalar, de\u011fi\u015fmesi muhtemel olan \u015feylerin etraf\u0131na kondu\u011funda de\u011fer \u00fcretir. Her \u015feyin etraf\u0131na kondu\u011funda ise kodu okumay\u0131 zorla\u015ft\u0131ran bir katmana d\u00f6n\u00fc\u015f\u00fcr.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mod\u00fcl s\u0131n\u0131rlar\u0131 daha \u00f6nemli<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Benim deneyimimde bir projeyi uzun vadede as\u0131l koruyan \u015fey, her s\u0131n\u0131f\u0131n bir interface&#8217;inin olmas\u0131 de\u011fil, mod\u00fcller aras\u0131 s\u0131n\u0131rlar\u0131n net olmas\u0131.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sipari\u015f mod\u00fcl\u00fc fatura mod\u00fcl\u00fcn\u00fcn veritaban\u0131 tablolar\u0131na do\u011frudan eri\u015femiyorsa, mod\u00fcller aras\u0131nda a\u00e7\u0131k\u00e7a tan\u0131mlanm\u0131\u015f bir API varsa, mod\u00fcl i\u00e7inde basit bir katmanl\u0131 yap\u0131 \u00e7o\u011fu zaman yeterli.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Karma\u015f\u0131kl\u0131k, domain&#8217;in ger\u00e7ekten karma\u015f\u0131k oldu\u011fu mod\u00fcllerde art\u0131r\u0131labilir. Basit bir ayarlar mod\u00fcl\u00fc ile kural motoru i\u00e7eren bir fiyatland\u0131rma mod\u00fcl\u00fc ayn\u0131 mimari t\u00f6renden ge\u00e7mek zorunda de\u011fil.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u0130yi mimari, en \u00e7ok kal\u0131b\u0131 uygulayan mimari de\u011fil.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir sonraki de\u011fi\u015fikli\u011fi en az dosyaya dokunarak, en az riskle yapman\u0131z\u0131 sa\u011flayan mimari.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hexagonal architecture ve clean architecture de\u011ferli fikirler. Ama tek implementasyonu olan interface&#8217;ler ve katman katman mapper&#8217;lar her projede bir kazan\u00e7 de\u011fil.<\/p>\n","protected":false},"author":1,"featured_media":96,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"class_list":["post-97","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-mimari"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/97","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=97"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/97\/revisions"}],"predecessor-version":[{"id":98,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/97\/revisions\/98"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/96"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=97"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=97"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=97"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}