Kodunuzun derinliklerinde, anlam\u0131 ilk bak\u0131\u015fta anla\u015f\u0131lmayan, a\u00e7\u0131klay\u0131c\u0131 bir isim ta\u015f\u0131mayan ve tam olarak ne i\u015fe yarad\u0131\u011f\u0131n\u0131 bulmak i\u00e7in detaya inmeniz gereken o gizemli say\u0131larla hi\u00e7 kar\u015f\u0131la\u015ft\u0131n\u0131z m\u0131? \u0130\u015fte onlar, yaz\u0131l\u0131mc\u0131lar\u0131n kabusu olan ‘Magic Number’lar! Bu kapsaml\u0131 rehberde, kod kalitenizi d\u00fc\u015f\u00fcren bu yayg\u0131n hatay\u0131 k\u00f6k\u00fcnden nas\u0131l s\u00f6k\u00fcp ataca\u011f\u0131n\u0131z\u0131, neden bu kadar tehlikeli olduklar\u0131n\u0131 ve gelecekteki projelerinizde nas\u0131l temiz kod yazaca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m ke\u015ffedece\u011fiz. Unutmay\u0131n, okunabilir ve s\u00fcrd\u00fcr\u00fclebilir kod, sadece sizin i\u00e7in de\u011fil, ekibiniz ve projenizin gelece\u011fi i\u00e7in de hayati \u00f6neme sahiptir.<\/p>\n
Her birimizin yaz\u0131l\u0131m kariyerinde, bir noktada “neden bu say\u0131 burada?” sorusunu sordu\u011fu anlar olmu\u015ftur. Bazen bir matematiksel i\u015flemde, bazen bir dizi boyutunda, bazen de bir veritaban\u0131 sorgusunda kar\u015f\u0131m\u0131za \u00e7\u0131kan bu isimsiz de\u011ferler, adeta sihirli bir el de\u011fmi\u015f\u00e7esine kodun i\u00e7ine yerle\u015fir. Ancak bu sihir, k\u0131sa s\u00fcrede bir lanete d\u00f6n\u00fc\u015febilir. ‘Magic Number’, genellikle kodun i\u00e7inde do\u011frudan yaz\u0131lm\u0131\u015f, ba\u011flam\u0131 belirtilmeyen ve a\u00e7\u0131klay\u0131c\u0131 bir de\u011fi\u015fken veya sabit ad\u0131yla temsil edilmeyen say\u0131sal bir sabittir. Genellikle, bu de\u011ferlerin ne anlama geldi\u011fini anlamak i\u00e7in kodu yazan ki\u015fiyle konu\u015fmak veya kapsaml\u0131 bir ara\u015ft\u0131rma yapmak gerekir. Bu durum, \u00f6zellikle b\u00fcy\u00fck ve karma\u015f\u0131k projelerde veya ekip i\u00e7inde \u00e7al\u0131\u015f\u0131rken ciddi sorunlara yol a\u00e7ar. Zamanla, projenin b\u00fcy\u00fcmesiyle birlikte bu t\u00fcr say\u0131lar \u00e7o\u011fal\u0131r, kodun okunabilirli\u011fini ve anla\u015f\u0131labilirli\u011fini dramatik bir \u015fekilde d\u00fc\u015f\u00fcr\u00fcr. Dolay\u0131s\u0131yla, bu gizemli say\u0131lar\u0131 tespit etmek ve onlardan kurtulmak, her yaz\u0131l\u0131mc\u0131n\u0131n \u00f6ncelik vermesi gereken bir g\u00f6revdir. Bu makale, sadece problemi tan\u0131mlamakla kalmayacak, ayn\u0131 zamanda size bu sorunu \u00e7\u00f6zmek i\u00e7in pratik ara\u00e7lar ve stratejiler sunacak.<\/p>\n
Peki, bu ‘Magic Number’lar neden bu kadar tehlikelidir? \u0130lk olarak, kod okunabilirli\u011fini<\/b> ciddi \u015fekilde azalt\u0131rlar. Bir ba\u015fkas\u0131 (veya gelecekteki siz) kodu okudu\u011funda, ‘Magic Number’ kavram\u0131n\u0131n ne oldu\u011funu anlad\u0131k, peki bu gizemli say\u0131lar ger\u00e7ek d\u00fcnya projelerinde tam olarak nerede ve nas\u0131l kar\u015f\u0131m\u0131za \u00e7\u0131kar? \u00c7e\u015fitli yaz\u0131l\u0131m alanlar\u0131nda bu k\u00f6t\u00fc al\u0131\u015fkanl\u0131\u011f\u0131n ne kadar yayg\u0131n oldu\u011funu g\u00f6rmek, meselenin ciddiyetini kavramak a\u00e7\u0131s\u0131ndan \u00f6nemlidir. Bir web uygulamas\u0131n\u0131n backend servisinden, mobil bir uygulaman\u0131n kullan\u0131c\u0131 aray\u00fcz\u00fcne, hatta bir oyunun fizik motoruna kadar her yerde ‘Magic Number’lar sinsi sinsi gizlenebilir ve kod taban\u0131n\u0131zda bir may\u0131n tarlas\u0131 olu\u015fturabilir.<\/p>\n \u00d6rne\u011fin, bir e-ticaret uygulamas\u0131nda<\/b> d\u00fc\u015f\u00fcnelim. Kullan\u0131c\u0131 sipari\u015flerinin durumunu y\u00f6neten bir servisiniz var. Kodunuzda \u015f\u00f6yle bir sat\u0131r g\u00f6r\u00fcyor olabilirsiniz: Mobil uygulama geli\u015ftirme taraf\u0131nda da durum farkl\u0131 de\u011fildir. \u00d6rne\u011fin, bir mobil uygulaman\u0131n kullan\u0131c\u0131 aray\u00fcz\u00fcnde (UI)<\/b>, elemanlar aras\u0131ndaki bo\u015fluklar veya yaz\u0131 tipi boyutlar\u0131 gibi de\u011ferler s\u0131k\u00e7a ‘Magic Number’ olarak kar\u015f\u0131m\u0131za \u00e7\u0131kar: Veritaban\u0131 i\u015flemleri veya API \u00e7a\u011fr\u0131lar\u0131nda da ‘Magic Number’larla kar\u015f\u0131la\u015fmak m\u00fcmk\u00fcnd\u00fcr. \u00d6rne\u011fin, ‘Magic Number’lar\u0131n kodumuz \u00fczerindeki olumsuz etkilerini ve gizli tehlikelerini art\u0131k \u00e7ok iyi biliyoruz. \u015eimdi s\u0131ra geldi, bu gizemli say\u0131lardan kurtulmak i\u00e7in kullanabilece\u011fimiz etkili stratejilere ve ara\u00e7lara. Bu b\u00f6l\u00fcmde, kodunuzu daha okunabilir, bak\u0131m\u0131 daha kolay ve hata riskini daha az hale getirecek temel y\u00f6ntemleri detayl\u0131 bir \u015fekilde inceleyece\u011fiz. Unutmay\u0131n, bu “silahlar” sadece ‘Magic Number’larla sava\u015fmak i\u00e7in de\u011fil, genel olarak daha temiz ve s\u00fcrd\u00fcr\u00fclebilir kod yazma al\u0131\u015fkanl\u0131\u011f\u0131 kazanmak i\u00e7in de son derece de\u011ferlidir.<\/p>\n En temel ve en yayg\u0131n kullan\u0131lan y\u00f6ntemlerden biri, ‘Magic Number’lar\u0131 sabit (constant) de\u011fi\u015fkenlere<\/b> atamakt\u0131r. Bu, belki de en basit ama etkisi en b\u00fcy\u00fck olan refactoring ad\u0131m\u0131d\u0131r. Sabitler, program boyunca de\u011fi\u015fmeyen de\u011ferleri tutmak i\u00e7in kullan\u0131l\u0131r ve onlara a\u00e7\u0131klay\u0131c\u0131, anlaml\u0131 isimler veririz. \u00d6rne\u011fin, yukar\u0131daki e-ticaret \u00f6rne\u011fimizdeki Bir di\u011fer g\u00fc\u00e7l\u00fc ara\u00e7 ise Enum’lar (Enumerations)<\/b> yani numaraland\u0131rmalard\u0131r. \u00d6zellikle birbiriyle ili\u015fkili, belirli bir k\u00fcme i\u00e7indeki de\u011ferleri temsil etmek i\u00e7in idealdirler. Enum’lar, bir dizi adland\u0131r\u0131lm\u0131\u015f sabiti grupland\u0131rarak, kodunuzdaki potansiyel ‘Magic Number’ sorununu k\u00f6kten \u00e7\u00f6zer. E-ticaret \u00f6rne\u011fine geri d\u00f6nersek, sipari\u015f durumlar\u0131n\u0131 temsil etmek i\u00e7in bir Enum kullanabiliriz: D\u0131\u015f yap\u0131land\u0131rma dosyalar\u0131 (configuration files)<\/b> da ‘Magic Number’lardan kurtulmak i\u00e7in harika bir yoldur. \u00d6zellikle uygulama ayarlar\u0131, API anahtarlar\u0131, veritaban\u0131 ba\u011flant\u0131 dizeleri veya ortam de\u011fi\u015fkenleri gibi de\u011ferler i\u00e7in do\u011frudan kod i\u00e7ine g\u00f6mmek yerine, bu de\u011ferleri YAML, JSON, .env veya XML gibi dosyalarda tutmak \u00e7ok daha profesyonel bir yakla\u015f\u0131md\u0131r. Bu sayede, uygulaman\u0131z\u0131 farkl\u0131 ortamlar (geli\u015ftirme, test, \u00fcretim) i\u00e7in kolayca yap\u0131land\u0131rabilirsiniz, kodda herhangi bir de\u011fi\u015fiklik yapman\u0131za gerek kalmaz. \u00d6rne\u011fin, bir API \u00e7a\u011fr\u0131s\u0131n\u0131n zaman a\u015f\u0131m\u0131 s\u00fcresi veya bir veritaban\u0131 havuzunun maksimum ba\u011flant\u0131 say\u0131s\u0131 gibi de\u011ferleri do\u011frudan kod i\u00e7ine yazmak yerine, bu de\u011ferleri bir yap\u0131land\u0131rma dosyas\u0131nda tutmak, uygulaman\u0131z\u0131n esnekli\u011fini art\u0131r\u0131r. De\u011ferleri de\u011fi\u015ftirmek istedi\u011finizde, sadece yap\u0131land\u0131rma dosyas\u0131n\u0131 g\u00fcncellersiniz ve uygulaman\u0131z\u0131 yeniden ba\u015flat\u0131rs\u0131n\u0131z; kodda bir derleme veya de\u011fi\u015fiklik yapma ihtiyac\u0131 ortadan kalkar. Bu, \u00f6zellikle DevOps s\u00fcre\u00e7lerinde ve s\u00fcrekli entegrasyon\/s\u00fcrekli da\u011f\u0131t\u0131m (CI\/CD) boru hatlar\u0131nda kritik \u00f6neme sahiptir.<\/p>\n Son olarak, CSS de\u011fi\u015fkenleri (CSS Custom Properties)<\/b>, web geli\u015ftirme ba\u011flam\u0131nda ‘Magic Number’lardan kurtulmak i\u00e7in modern ve etkili bir y\u00f6ntem sunar. Responsive tasar\u0131mda, farkl\u0131 ekran boyutlar\u0131 i\u00e7in belirlenen k\u0131r\u0131lma noktalar\u0131 (breakpoints) veya UI elemanlar\u0131n\u0131n boyutlar\u0131 s\u0131k\u00e7a do\u011frudan piksel de\u011ferleri olarak yaz\u0131l\u0131r. Ancak bu, ‘Magic Number’ sorununa yol a\u00e7ar. CSS de\u011fi\u015fkenlerini kullanarak bu de\u011ferleri adland\u0131rabilir ve tek bir yerden y\u00f6netebilirsiniz. \u00d6rne\u011fin, medya sorgular\u0131nda (media queries) veya UI bile\u015fenlerinde sabit de\u011ferler yerine de\u011fi\u015fkenler kullanmak, tasar\u0131m de\u011fi\u015fikliklerini \u00e7ok daha kolay hale getirir. \u015e\u00f6yle d\u00fc\u015f\u00fcnebilirsiniz: bir mobil cihaz i\u00e7in belirli bir metin boyutunu veya bir \u00f6\u011fenin kenar bo\u015flu\u011funu tan\u0131mlarken, bu de\u011ferleri do\u011frudan CSS’e g\u00f6mmek yerine, ana bir de\u011fi\u015fkene atayabilirsiniz. \u0130\u015fte bir \u00f6rnek:<\/p>\n <\/code><\/p>\n Bu \u00f6rnekte, 'Magic Number'lardan kurtulman\u0131n teorik yollar\u0131n\u0131 \u00f6\u011frendik, \u015fimdi bu bilgiyi prati\u011fe d\u00f6kme zaman\u0131! Bu b\u00f6l\u00fcmde, kodunuzdaki bu gizemli say\u0131lar\u0131 nas\u0131l tespit edece\u011finizi, onlar\u0131 nas\u0131l anlaml\u0131 isimlerle de\u011fi\u015ftirece\u011finizi ve bu s\u00fcreci al\u0131\u015fkanl\u0131k haline getirerek temiz kod k\u00fclt\u00fcr\u00fcn\u00fc nas\u0131l benimseyece\u011finizi ad\u0131m ad\u0131m g\u00f6sterece\u011fiz. Unutmay\u0131n, iyi yaz\u0131lm\u0131\u015f kod, sadece bir i\u015flevsellik sunmakla kalmaz, ayn\u0131 zamanda ba\u015fkalar\u0131 (ve gelecekteki siz) i\u00e7in de bir hikaye anlat\u0131r. Bu hikayenin anla\u015f\u0131l\u0131r ve tutarl\u0131 olmas\u0131, projenin ba\u015far\u0131s\u0131 i\u00e7in elzemdir.<\/p>\n \u0130lk ad\u0131m, tespit ve tan\u0131mlamad\u0131r<\/b>. Kodunuzu g\u00f6zden ge\u00e7irirken, do\u011frudan yaz\u0131lm\u0131\u015f, ba\u011flam\u0131 belirsiz t\u00fcm say\u0131sal de\u011ferlere dikkat edin. \u00d6zellikle \u0130kinci ad\u0131m, yeniden adland\u0131rma ve refactoring'dir<\/b>. Tespit etti\u011finiz 'Magic Number'lar\u0131, yukar\u0131da bahsetti\u011fimiz sabitler, Enum'lar veya yap\u0131land\u0131rma de\u011ferleri ile de\u011fi\u015ftirin. En basitinden bir sabit tan\u0131mlayal\u0131m. Diyelim ki, bir kullan\u0131c\u0131 rol\u00fc y\u00f6netimi kodunuz var ve 'y\u00f6netici' rol\u00fcn\u00fc temsil eden '1' say\u0131s\u0131n\u0131 g\u00f6r\u00fcyorsunuz:<\/p>\n <\/code><\/p>\n Bu kodu, anlaml\u0131 sabitlerle veya bir Enum ile refactor edebiliriz:<\/p>\n <\/code><\/p>\n G\u00f6rd\u00fc\u011f\u00fcn\u00fcz gibi, Enum kullan\u0131m\u0131, sadece okunabilirli\u011fi art\u0131rmakla kalm\u0131yor, ayn\u0131 zamanda tip g\u00fcvenli\u011fi sa\u011flayarak olas\u0131 hatalar\u0131n \u00f6n\u00fcne ge\u00e7iyor ve kodun kendili\u011finden dok\u00fcmantasyonunu yap\u0131yor. Hatta, bir rol ID'sinin ne anlama geldi\u011fini anlamak i\u00e7in art\u0131k ba\u015fka bir dok\u00fcmantasyona ihtiya\u00e7 kalm\u0131yor, kod kendini a\u00e7\u0131kl\u0131yor. Bu, projenin b\u00fcy\u00fcmesiyle birlikte y\u00f6netimi kolayla\u015ft\u0131ran bir yakla\u015f\u0131md\u0131r.<\/p>\n \u00dc\u00e7\u00fcnc\u00fc ad\u0131m, al\u0131\u015fkanl\u0131k haline getirmektir<\/b>. Bu de\u011fi\u015fiklikleri yapmak sadece bir kerelik bir i\u015f de\u011fildir. Yeni kod yazarken veya mevcut kodu geli\u015ftirirken, her zaman 'Magic Number' kullanmaktan ka\u00e7\u0131nmaya \u00f6zen g\u00f6sterin. Code review s\u00fcre\u00e7lerinde, ekibinizdeki di\u011fer \u00fcyelerin de bu konuya dikkat etmesini sa\u011flay\u0131n ve birbirinizi uyar\u0131n. Otomatik kod analiz ara\u00e7lar\u0131 (linters) da bu konuda size yard\u0131mc\u0131 olabilir. \u00d6rne\u011fin, SonarQube, ESLint veya PMD gibi ara\u00e7lar, 'Magic Number' kullan\u0131mlar\u0131n\u0131 tespit etmek i\u00e7in kurallar i\u00e7erebilir. Bu ara\u00e7lar\u0131 CI\/CD s\u00fcrecinize entegre ederek, kodunuzun her zaman belirli bir kalite standard\u0131n\u0131n \u00fczerinde kalmas\u0131n\u0131 sa\u011flayabilirsiniz. Zamanla, bu, sizin ve ekibinizin do\u011fal bir refleks haline gelecektir. Mobil uyumlu HTML geli\u015ftirirken de CSS de\u011fi\u015fkenlerini kullanarak bu yakla\u015f\u0131m\u0131 benimseyin. Ekran boyutlar\u0131 veya UI bile\u015fenlerinin bo\u015fluklar\u0131 gibi de\u011ferleri do\u011frudan piksel olarak yazmak yerine, Bireysel projelerde 'Magic Number'lardan ka\u00e7\u0131nmak ne kadar \u00f6nemliyse, ekip i\u00e7inde \u00e7al\u0131\u015f\u0131rken ve \u00f6l\u00e7eklenebilir projeler geli\u015ftirirken bu konuyu y\u00f6netmek de bir o kadar kritiktir. Bir yaz\u0131l\u0131m projesi b\u00fcy\u00fcd\u00fck\u00e7e ve ekipteki ki\u015fi say\u0131s\u0131 artt\u0131k\u00e7a, 'Magic Number'lar\u0131n yay\u0131lma riski de katlanarak artar. Bu b\u00f6l\u00fcmde, ekip i\u00e7inde bu k\u00f6t\u00fc al\u0131\u015fkanl\u0131\u011f\u0131n \u00f6n\u00fcne ge\u00e7mek ve s\u00fcrd\u00fcr\u00fclebilir bir kod taban\u0131 olu\u015fturmak i\u00e7in hangi stratejileri izlemeniz gerekti\u011fini detayl\u0131ca ele alaca\u011f\u0131z. Unutmay\u0131n, tutarl\u0131l\u0131k ve ortak standartlar, ba\u015far\u0131l\u0131 ekip \u00e7al\u0131\u015fmas\u0131n\u0131n anahtar\u0131d\u0131r.<\/p>\n En etkili y\u00f6ntemlerden biri, sa\u011flam code review s\u00fcre\u00e7leri<\/b> uygulamakt\u0131r. Bir geli\u015ftirici kodu commit etmeden \u00f6nce, ba\u015fka bir ekip \u00fcyesinin bu kodu g\u00f6zden ge\u00e7irmesi, potansiyel 'Magic Number' kullan\u0131mlar\u0131n\u0131 tespit etmek i\u00e7in harika bir f\u0131rsatt\u0131r. Code review s\u0131ras\u0131nda, sadece i\u015flevselli\u011fi de\u011fil, ayn\u0131 zamanda kodun okunabilirli\u011fini, bak\u0131m kolayl\u0131\u011f\u0131n\u0131 ve standartlara uygunlu\u011funu da kontrol etmek gerekir. Bir 'Magic Number' g\u00f6r\u00fcld\u00fc\u011f\u00fcnde, g\u00f6zden ge\u00e7iren ki\u015fi geli\u015ftiriciye geri bildirimde bulunmal\u0131 ve bu say\u0131n\u0131n neden bir sabit veya Enum ile de\u011fi\u015ftirilmesi gerekti\u011fini a\u00e7\u0131klamal\u0131d\u0131r. Bu s\u00fcre\u00e7, sadece kod kalitesini art\u0131rmakla kalmaz, ayn\u0131 zamanda ekip \u00fcyeleri aras\u0131nda bilgi payla\u015f\u0131m\u0131n\u0131 te\u015fvik eder ve ortak bir \"temiz kod\" anlay\u0131\u015f\u0131 olu\u015fturulmas\u0131na yard\u0131mc\u0131 olur. Bu, herkesin ayn\u0131 sayfalarda olmas\u0131n\u0131 sa\u011flar ve gelecekte benzer hatalar\u0131n yap\u0131lmas\u0131n\u0131 \u00f6nler. Dolay\u0131s\u0131yla, code review'ler sadece hatalar\u0131 bulmak i\u00e7in de\u011fil, ayn\u0131 zamanda en iyi uygulamalar\u0131 ve standartlar\u0131 \u00f6\u011frenmek ve uygulamak i\u00e7in de \u00f6nemli bir platformdur.<\/p>\n \u0130kinci olarak, kodlama standartlar\u0131 ve stil rehberleri<\/b> olu\u015fturmak elzemdir. Ekip olarak hangi sabit adland\u0131rma kurallar\u0131n\u0131 kullanaca\u011f\u0131n\u0131z\u0131 (\u00f6rne\u011fin, \u00dc\u00e7\u00fcnc\u00fcs\u00fc, merkezi yap\u0131land\u0131rma ve ba\u011f\u0131ml\u0131l\u0131k y\u00f6netimi<\/b> sistemlerini etkin bir \u015fekilde kullanmakt\u0131r. \u00d6zellikle mikroservis mimarilerinde veya birden fazla uygulaman\u0131n ayn\u0131 yap\u0131land\u0131rma de\u011ferlerini payla\u015ft\u0131\u011f\u0131 durumlarda, bu de\u011ferleri merkezi bir yerden y\u00f6netmek kritik \u00f6neme sahiptir. Konsolide bir yap\u0131land\u0131rma servisi (\u00f6rne\u011fin, Spring Cloud Config, Kubernetes ConfigMaps, AWS Parameter Store) kullanarak, 'Magic Number'lar\u0131 tek bir kaynaktan y\u00f6netebilir ve t\u00fcm uygulamalar\u0131n tutarl\u0131 de\u011ferler kullanmas\u0131n\u0131 sa\u011flayabilirsiniz. Bu, bir de\u011ferin de\u011fi\u015fmesi gerekti\u011finde, sadece merkezi yap\u0131land\u0131rma sistemini g\u00fcncellemenizin yeterli olaca\u011f\u0131 anlam\u0131na gelir, b\u00f6ylece y\u00fczlerce farkl\u0131 kod sat\u0131r\u0131n\u0131 veya yap\u0131land\u0131rma dosyas\u0131n\u0131 manuel olarak de\u011fi\u015ftirme derdinden kurtulursunuz. Bu yakla\u015f\u0131m, \u00f6l\u00e7eklenebilir projelerde bak\u0131m maliyetini \u00f6nemli \u00f6l\u00e7\u00fcde d\u00fc\u015f\u00fcr\u00fcr ve hatal\u0131 yap\u0131land\u0131rma kaynakl\u0131 sorunlar\u0131 minimize eder. Ayr\u0131ca, bu t\u00fcr sistemler genellikle versiyon kontrol\u00fc ve denetim izi \u00f6zelliklerini de destekler, bu da de\u011fi\u015fikliklerin ne zaman ve kim taraf\u0131ndan yap\u0131ld\u0131\u011f\u0131n\u0131 takip etmenizi kolayla\u015ft\u0131r\u0131r. B\u00f6ylece, projenin b\u00fcy\u00fckl\u00fc\u011f\u00fc ne olursa olsun, de\u011ferlerin ve 'Magic Number'lar\u0131n y\u00f6netimi her zaman kontrol alt\u0131nda tutulur.<\/p>\n Son olarak, d\u00fczenli refactoring ve e\u011fitim<\/b> s\u00fcre\u00e7leri. Mevcut kod taban\u0131ndaki 'Magic Number'lar\u0131 d\u00fczenli olarak temizlemek i\u00e7in zaman ay\u0131r\u0131n. Her sprint veya geli\u015ftirme d\u00f6ng\u00fcs\u00fcnde, k\u00fc\u00e7\u00fck bir \"teknik bor\u00e7\" temizleme b\u00fct\u00e7esi ay\u0131rabilirsiniz. Ayr\u0131ca, ekip i\u00e7i e\u011fitimler d\u00fczenleyerek 'Magic Number'lar\u0131n zararlar\u0131 ve onlardan ka\u00e7\u0131nma yollar\u0131 hakk\u0131nda fark\u0131ndal\u0131k yarat\u0131n. Bu e\u011fitimler, \u00f6zellikle yeni ba\u015flayan geli\u015ftiricilerin projenin kodlama k\u00fclt\u00fcr\u00fcne h\u0131zl\u0131ca adapte olmalar\u0131n\u0131 sa\u011flar. Unutmay\u0131n, temiz kod yazmak sadece teknik bir beceri de\u011fil, ayn\u0131 zamanda bir zihniyet meselesidir. Ekip olarak bu zihniyeti benimsemek, projenizin uzun vadeli ba\u015far\u0131s\u0131 i\u00e7in kritik bir yat\u0131r\u0131m olacakt\u0131r. Bu t\u00fcr proaktif yakla\u015f\u0131mlar, sadece mevcut sorunlar\u0131 \u00e7\u00f6zmekle kalmaz, ayn\u0131 zamanda gelecekteki olas\u0131 sorunlar\u0131 da \u00f6nler. B\u00f6ylece, ekip \u00fcyeleri daha verimli \u00e7al\u0131\u015f\u0131r, kod daha az hata i\u00e7erir ve projenin genel kalitesi istikrarl\u0131 bir \u015fekilde artar. Bu \u00e7abalar, yaz\u0131l\u0131m\u0131n yaln\u0131zca \"\u00e7al\u0131\u015fmas\u0131n\u0131\" de\u011fil, ayn\u0131 zamanda \"iyi \u00e7al\u0131\u015fmas\u0131n\u0131\" sa\u011flar.<\/p>\n \u015eimdiye kadar 'Magic Number'lar \u00fczerine odakland\u0131k ve onlar\u0131n kodumuz i\u00e7in ne kadar tehlikeli olabilece\u011fini detayl\u0131 bir \u015fekilde inceledik. Ancak, kodumuzdaki gizemli de\u011ferler sadece say\u0131larla s\u0131n\u0131rl\u0131 de\u011fil. Asl\u0131nda, ayn\u0131 prensip, programlama d\u00fcnyas\u0131nda s\u0131k\u00e7a kar\u015f\u0131la\u015ft\u0131\u011f\u0131m\u0131z 'Magic String'ler ve hatta 'Magic Boolean' de\u011ferleri i\u00e7in de ge\u00e7erlidir. Bu b\u00f6l\u00fcmde, bu di\u011fer gizli de\u011fer t\u00fcrlerini tan\u0131yacak, onlar\u0131n da neden birer 'Magic Number' gibi ele al\u0131nmas\u0131 gerekti\u011fini ve nas\u0131l temizlenmesi gerekti\u011fini ke\u015ffedece\u011fiz. Unutmay\u0131n, okunabilirlik ve s\u00fcrd\u00fcr\u00fclebilirlik ilkeleri, t\u00fcm do\u011frudan yaz\u0131lm\u0131\u015f, ba\u011flam\u0131 belirsiz de\u011ferler i\u00e7in ge\u00e7erlidir.<\/p>\n 'Magic String'ler, t\u0131pk\u0131 'Magic Number'lar gibi, kod i\u00e7inde do\u011frudan yaz\u0131lm\u0131\u015f ve anlam\u0131 belirsiz karakter dizileridir. \u00d6rne\u011fin, bir veritaban\u0131 sorgusunda bir tablo ad\u0131n\u0131n, bir durum g\u00f6stergesinin veya bir hata mesaj\u0131n\u0131n do\u011frudan kodun i\u00e7ine g\u00f6m\u00fclmesi 'Magic String'e \u00f6rnektir. \u015e\u00f6yle bir senaryo d\u00fc\u015f\u00fcnelim: Bir kullan\u0131c\u0131n\u0131n profilini getiren bir API servisiniz var ve kodunuzda \u015f\u00f6yle bir ifade ge\u00e7iyor: Peki, 'Magic String'lerden nas\u0131l kurtulabiliriz? T\u0131pk\u0131 'Magic Number'larda oldu\u011fu gibi, sabitler<\/b> ve Enum'lar<\/b> en etkili ara\u00e7lard\u0131r. Durumlar\u0131 temsil eden string'ler i\u00e7in Enum'lar kullanmak tip g\u00fcvenli\u011fi sa\u011flar ve olas\u0131 yaz\u0131m hatalar\u0131n\u0131 \u00f6nler. \u00d6rne\u011fin:<\/p>\n <\/code><\/p>\n Benzer \u015fekilde, hata mesajlar\u0131, log mesajlar\u0131 veya di\u011fer metin i\u00e7erikleri i\u00e7in de kaynak dosyalar\u0131 (resource bundles)<\/b> veya uluslararas\u0131la\u015ft\u0131rma (i18n) dosyalar\u0131<\/b> kullanmak, 'Magic String'lerden kurtulman\u0131n ve uygulaman\u0131z\u0131 farkl\u0131 diller i\u00e7in haz\u0131rlaman\u0131n en iyi yoludur. Bu, sadece 'Magic String'leri koddan \u00e7\u0131karmakla kalmaz, ayn\u0131 zamanda dil deste\u011fini de merkezile\u015ftirir. T\u00fcm bu yakla\u015f\u0131mlar, kodunuzun sadece say\u0131lar de\u011fil, ayn\u0131 zamanda metin bazl\u0131 de\u011ferler a\u00e7\u0131s\u0131ndan da temiz ve s\u00fcrd\u00fcr\u00fclebilir olmas\u0131n\u0131 sa\u011flar.<\/p>\n 'Magic Boolean'lar ise biraz daha farkl\u0131d\u0131r ve genellikle bir fonksiyonun veya metodun \u00e7a\u011fr\u0131l\u0131rken ald\u0131\u011f\u0131 Yaz\u0131l\u0131m geli\u015ftirme ser\u00fcvenimiz boyunca, 'Magic Number'lar\u0131n ne kadar sinsi ve y\u0131k\u0131c\u0131 olabilece\u011fini, kod kalitemizi nas\u0131l d\u00fc\u015f\u00fcrd\u00fc\u011f\u00fcn\u00fc ve bak\u0131m maliyetlerini nas\u0131l art\u0131rd\u0131\u011f\u0131n\u0131 detayl\u0131 bir \u015fekilde inceledik. Bu gizemli say\u0131lar\u0131n, sadece rakamlardan ibaret olmad\u0131\u011f\u0131n\u0131, ayn\u0131 zamanda projelerimizde birer zaman bombas\u0131, birer okunabilirlik katili oldu\u011funu hep birlikte g\u00f6rd\u00fck. Ancak, bu makale sadece sorunlar\u0131 ortaya koymakla kalmad\u0131; ayn\u0131 zamanda bu sorunlar\u0131 k\u00f6kten \u00e7\u00f6zmek i\u00e7in pratik, uygulanabilir ve g\u00fc\u00e7l\u00fc stratejiler de sundu. Sabitler, Enum'lar, yap\u0131land\u0131rma dosyalar\u0131 ve hatta CSS de\u011fi\u015fkenleri gibi ara\u00e7larla donanm\u0131\u015f bir \u015fekilde, art\u0131k kodunuzu daha temiz, daha anla\u015f\u0131l\u0131r ve \u00e7ok daha s\u00fcrd\u00fcr\u00fclebilir hale getirme g\u00fcc\u00fcne sahipsiniz. Bu yolculukta, sadece bireysel bir yaz\u0131l\u0131mc\u0131 olarak de\u011fil, ayn\u0131 zamanda bir ekibin par\u00e7as\u0131 olarak da sorumluluklar\u0131n\u0131z\u0131n oldu\u011funu unutmay\u0131n. Code review s\u00fcre\u00e7lerini etkin kullanmak, kodlama standartlar\u0131 belirlemek ve s\u00fcrekli \u00f6\u011frenme k\u00fclt\u00fcr\u00fc olu\u015fturmak, projenizin gelece\u011fini g\u00fcvence alt\u0131na alman\u0131n anahtar\u0131d\u0131r.<\/p>\n 'Magic Number'lardan kurtulmak, sadece bir refactoring g\u00f6revi de\u011fildir; bu, yaz\u0131l\u0131m geli\u015ftirme disiplininin temel ta\u015flar\u0131ndan biridir. Bu de\u011fi\u015fiklikleri uygulayarak, kodunuzun \u00f6mr\u00fcn\u00fc uzatacak, yeni \u00f6zellikler eklemeyi kolayla\u015ft\u0131racak ve gelecekteki olas\u0131 hatalar\u0131n \u00f6n\u00fcne ge\u00e7eceksiniz. Daha da \u00f6nemlisi, kendinizi ve ekibinizi daha verimli \u00e7al\u0131\u015fmaya te\u015fvik edeceksiniz. Okunabilir ve temiz kod, sadece kodun kendisi i\u00e7in de\u011fil, ayn\u0131 zamanda onu okuyan, \u00fczerinde \u00e7al\u0131\u015fan ve onu geli\u015ftiren insanlar i\u00e7in de bir yat\u0131r\u0131md\u0131r. Bu, geli\u015ftirici deneyimini iyile\u015ftirir, onboarding s\u00fcre\u00e7lerini h\u0131zland\u0131r\u0131r ve genel olarak daha keyifli bir \u00e7al\u0131\u015fma ortam\u0131 yarat\u0131r. Unutmay\u0131n, yazd\u0131\u011f\u0131n\u0131z her sat\u0131r kod, bir hikaye anlat\u0131r. Bu hikayenin net, tutarl\u0131 ve anla\u015f\u0131l\u0131r olmas\u0131n\u0131 sa\u011flamak sizin elinizde. \u015eimdi harekete ge\u00e7me ve kodunuzdaki bu gizemli g\u00f6lgelerden kal\u0131c\u0131 olarak kurtulma zaman\u0131. Kodunuzu gelece\u011fe haz\u0131rlay\u0131n ve yaz\u0131l\u0131m d\u00fcnyas\u0131nda kal\u0131c\u0131 bir fark yarat\u0131n. Gelin, bu de\u011fi\u015fimi birlikte ba\u015faral\u0131m ve daha iyi bir yaz\u0131l\u0131m gelece\u011fi in\u015fa edelim!<\/p>\n 1. Her say\u0131 'Magic Number' m\u0131d\u0131r? Ne zaman bir say\u0131y\u0131 sabite d\u00f6n\u00fc\u015ft\u00fcrmeliyim?<\/b><\/p>\n Hay\u0131r, her say\u0131 'Magic Number' de\u011fildir. \u00d6rne\u011fin, bir d\u00f6ng\u00fcde kullan\u0131lan E\u011fer bu sorulardan birine \"hay\u0131r\" cevab\u0131 veriyorsan\u0131z veya \"evet, de\u011fi\u015febilir\" cevab\u0131n\u0131 veriyorsan\u0131z, o say\u0131y\u0131 bir sabite veya Enum'a d\u00f6n\u00fc\u015ft\u00fcrmeniz iyi bir fikirdir. \u00d6rne\u011fin, bir vergi oran\u0131, bir zaman a\u015f\u0131m\u0131 s\u00fcresi, bir durum kodu veya bir UI bo\u015flu\u011fu gibi say\u0131lar kesinlikle sabite d\u00f6n\u00fc\u015ft\u00fcr\u00fclmelidir.<\/p>\n 2. 'Magic Number' temizli\u011fi ne kadar zaman al\u0131r ve mevcut projelerde nas\u0131l yapmal\u0131y\u0131m?<\/b><\/p>\n 'Magic Number' temizli\u011fi, projenin b\u00fcy\u00fckl\u00fc\u011f\u00fcne ve mevcut 'Magic Number' say\u0131s\u0131na ba\u011fl\u0131 olarak de\u011fi\u015fir. B\u00fcy\u00fck projelerde bu, uzun s\u00fcrebilir. Mevcut projelerde bu i\u015flemi \"Big Bang\" \u015feklinde, yani tek seferde yapmaya \u00e7al\u0131\u015fmak riskli olabilir. Bunun yerine, k\u00fc\u00e7\u00fck ve kademeli ad\u0131mlar izlemeniz \u00f6nerilir:<\/p>\n Bu \u015fekilde, teknik borcu yava\u015f yava\u015f azalt\u0131rken, projenin genel i\u015fleyi\u015fini aksatmam\u0131\u015f olursunuz.<\/p>\n 3. Sabitlerimi nerede tan\u0131mlamal\u0131y\u0131m? Hepsini tek bir dosyada m\u0131 toplamal\u0131y\u0131m?<\/b><\/p>\n Sabitlerin tan\u0131mlanaca\u011f\u0131 yer, programlama diline, projenin yap\u0131s\u0131na ve sabitlerin kapsam\u0131na g\u00f6re de\u011fi\u015fir.<\/p>\n Ama\u00e7, sabitleri mant\u0131ksal olarak ilgili yerlerde tutmak ve kolayca bulunabilir, y\u00f6netilebilir olmalar\u0131n\u0131 sa\u011flamakt\u0131r. Hepsini tek bir dosyada toplamak, o dosyan\u0131n \u00e7ok b\u00fcy\u00fck ve y\u00f6netilmesi zor hale gelmesine neden olabilir.<\/p>\n 4. Mobil uyumlu HTML ve CSS'te 'Magic Number' sorununu nas\u0131l daha iyi y\u00f6netebiliriz?<\/b><\/p>\n Mobil uyumlu tasar\u0131mlarda 'Magic Number'lar, genellikle k\u0131r\u0131lma noktalar\u0131 (breakpoints), bo\u015fluklar (margins\/paddings), yaz\u0131 tipi boyutlar\u0131 veya bile\u015fen geni\u015flikleri gibi CSS de\u011ferlerinde kar\u015f\u0131m\u0131za \u00e7\u0131kar. Bu sorunu daha iyi y\u00f6netmek i\u00e7in:<\/p>\n Bu yakla\u015f\u0131mlar, responsive tasar\u0131m de\u011ferlerini tek bir kaynaktan y\u00f6netmenizi, b\u00f6ylece tasar\u0131m de\u011fi\u015fikliklerini kolayca uygulaman\u0131z\u0131 ve kodunuzun daha tutarl\u0131 olmas\u0131n\u0131 sa\u011flar.<\/p>\n <\/body><\/p>\n","protected":false},"excerpt":{"rendered":"Kodunuzun derinliklerinde, anlam\u0131 ilk bak\u0131\u015fta anla\u015f\u0131lmayan, a\u00e7\u0131klay\u0131c\u0131 bir isim ta\u015f\u0131mayan ve tam olarak ne i\u015fe yarad\u0131\u011f\u0131n\u0131 bulmak i\u00e7in…","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1513,1],"tags":[],"class_list":{"0":"post-34974","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-dusunsel-ve-kisisel","7":"category-genel","8":"cs-entry","9":"cs-video-wrap"},"yoast_head":"\nif (status == 5)<\/code> gibi bir ifadeyle kar\u015f\u0131la\u015ft\u0131\u011f\u0131nda, ‘5’in ne anlama geldi\u011fini anlamak i\u00e7in kodun geri kalan\u0131n\u0131, belki de veritaban\u0131 \u015femas\u0131n\u0131 veya API dok\u00fcmantasyonunu incelemesi gerekir. Bu, de\u011ferli zaman kayb\u0131na ve zihinsel y\u00fcklenmeye neden olur. \u0130kinci olarak, bak\u0131m kolayl\u0131\u011f\u0131n\u0131<\/b> olumsuz etkilerler. E\u011fer ‘5’in temsil etti\u011fi durum de\u011fi\u015firse (\u00f6rne\u011fin, ‘6’ olursa), bu ‘5’in kullan\u0131ld\u0131\u011f\u0131 her yerde manuel olarak de\u011fi\u015fiklik yap\u0131lmas\u0131 gerekir. Bu da hata riskini<\/b> inan\u0131lmaz derecede art\u0131r\u0131r. Bir veya iki yerde d\u00fczeltmeyi unuttu\u011funuzda, uygulaman\u0131zda beklenmedik ve tespit etmesi zor hatalar ortaya \u00e7\u0131kabilir. \u00dc\u00e7\u00fcnc\u00fc olarak, kod tekrar\u0131na yol a\u00e7arlar. Ayn\u0131 ‘Magic Number’ farkl\u0131 yerlerde tekrarland\u0131\u011f\u0131nda, her biri ba\u011f\u0131ms\u0131z birer de\u011fer haline gelir ve gelecekteki de\u011fi\u015fikliklerde karma\u015fa yarat\u0131r. Bu nedenlerle, ‘Magic Number’lar\u0131 kodumuzdan temizlemek, sadece estetik bir tercih de\u011fil, ayn\u0131 zamanda yaz\u0131l\u0131m kalitesi ve projenin s\u00fcrd\u00fcr\u00fclebilirli\u011fi i\u00e7in temel bir gerekliliktir. Gelin, bu karma\u015f\u0131k labirentten birlikte \u00e7\u0131kal\u0131m ve kodumuzu daha \u015feffaf, daha g\u00fcvenilir ve daha y\u00f6netilebilir hale getirelim.<\/p>\nMagic Number’\u0131n Sinsice Yay\u0131l\u0131\u015f\u0131: Ger\u00e7ek D\u00fcnya Senaryolar\u0131 ve Gizli Tehlikeleri Nelerdir?<\/h2>\n
if (order.status == 3) { \/\/ Sipari\u015f kargoya verildi }<\/code>. Buradaki ‘3’, sipari\u015fin kargoya verildi\u011fi anlam\u0131na geliyor olabilir. Ancak, kodu okuyan bir ba\u015fkas\u0131 veya birka\u00e7 ay sonra siz, ‘3’\u00fcn tam olarak hangi durumu temsil etti\u011fini nereden bileceksiniz? Ba\u015fka bir yerde if (order.status == 1) { \/\/ Sipari\u015f al\u0131nd\u0131 }<\/code> gibi ba\u015fka bir ‘Magic Number’ ile kar\u015f\u0131la\u015fabilirsiniz. Bu, zamanla okunabilirli\u011fi d\u00fc\u015f\u00fcrmekle kalmaz, ayn\u0131 zamanda bak\u0131m maliyetini de art\u0131r\u0131r. Diyelim ki, yeni bir sipari\u015f durumu eklenmesi veya mevcut durumlar\u0131n de\u011ferlerinin de\u011fi\u015fmesi gerekti. O zaman bu ‘Magic Number’\u0131n ge\u00e7ti\u011fi her yeri bulup g\u00fcncellemeniz gerekir ki bu da ciddi bir hata potansiyelidir. Bir de\u011fi\u015fim durumunda bir yeri atlaman\u0131z, tutars\u0131z verilere ve uygulaman\u0131zda \u00f6ng\u00f6r\u00fclemeyen davran\u0131\u015flara yol a\u00e7abilir. Bu tarz bir senaryo, projenin b\u00fcy\u00fcmesiyle birlikte i\u00e7inden \u00e7\u0131k\u0131lmaz bir hale gelebilir ve yeni \u00f6zellik geli\u015ftirmek yerine mevcut hatalar\u0131 ay\u0131klamakla vakit kaybetmenize neden olabilir. Bu nedenle, proaktif bir yakla\u015f\u0131m sergileyerek bu t\u00fcr yap\u0131lar\u0131 ba\u015ftan engellemek, gelecekteki olas\u0131 felaketlerin \u00f6n\u00fcne ge\u00e7mek anlam\u0131na gelir.<\/p>\ntextView.setTextSize(16);<\/code> veya marginLayoutParams.topMargin = 24;<\/code>. Bu de\u011ferler, farkl\u0131 ekran boyutlar\u0131 veya tasar\u0131m de\u011fi\u015fiklikleri i\u00e7in g\u00fcncellenmesi gerekti\u011finde yine ayn\u0131 sorunlar\u0131 yarat\u0131r. Belki de bir tasar\u0131m revizyonunda t\u00fcm metin boyutlar\u0131n\u0131 16’dan 18’e \u00e7\u0131karmak istediniz. E\u011fer ’16’ direkt kodun i\u00e7inde birden fazla yerde ge\u00e7iyorsa, her birini tek tek bulup de\u011fi\u015ftirmek zorunda kal\u0131rs\u0131n\u0131z. Bu durum sadece zaman kayb\u0131 de\u011fil, ayn\u0131 zamanda farkl\u0131 ekran yo\u011funluklar\u0131 i\u00e7in farkl\u0131 de\u011ferler kullan\u0131ld\u0131\u011f\u0131nda da karma\u015faya yol a\u00e7ar. E\u011fer ’24’ piksel bir bo\u015flu\u011fu ifade ediyorsa ve bu bo\u015fluk uygulaman\u0131n farkl\u0131 b\u00f6l\u00fcmlerinde tekrar tekrar kullan\u0131l\u0131yorsa, bu de\u011ferin tek bir yerden y\u00f6netilememesi, UI tutars\u0131zl\u0131klar\u0131na ve hatal\u0131 g\u00f6r\u00fcn\u00fcmlere davetiye \u00e7\u0131kar\u0131r. Oyun geli\u015ftirme d\u00fcnyas\u0131nda ise bu say\u0131lar daha da kritik olabilir. Bir karakterin hareket h\u0131z\u0131, bir merminin hasar\u0131 veya bir nesnenin yer \u00e7ekimi \u00e7arpan\u0131 gibi de\u011ferler do\u011frudan kod i\u00e7ine g\u00f6m\u00fcld\u00fc\u011f\u00fcnde, oyunun dengesini de\u011fi\u015ftirmek veya ince ayarlar yapmak inan\u0131lmaz derecede zorla\u015f\u0131r. Bu tarz senaryolarda, say\u0131lar\u0131n ne anlama geldi\u011fini anlamak ve bunlar\u0131 do\u011fru \u015fekilde y\u00f6netmek, projenin sa\u011fl\u0131kl\u0131 bir \u015fekilde ilerlemesi i\u00e7in temel bir ad\u0131md\u0131r.<\/p>\nSELECT * FROM users WHERE role_id = 2;<\/code> sorgusundaki ‘2’nin ne anlama geldi\u011fini d\u00fc\u015f\u00fcn\u00fcn. ‘2’ belki “y\u00f6netici” rol\u00fcn\u00fc temsil ediyor olabilir. Ancak, bu bilgi sadece o sorguyla s\u0131n\u0131rl\u0131 kal\u0131r ve kodun di\u011fer k\u0131s\u0131mlar\u0131nda bu role at\u0131fta bulunuldu\u011funda yine ‘Magic Number’ kullan\u0131lmas\u0131na neden olur. Bu da kod tekrar\u0131n\u0131<\/b> ve gelecekteki de\u011fi\u015fikliklerde tutars\u0131zl\u0131k<\/b> riskini art\u0131r\u0131r. \u00d6rne\u011fin, ‘y\u00f6netici’ rol\u00fcn\u00fcn ID’si de\u011fi\u015fti\u011finde, bu ‘Magic Number’\u0131n kullan\u0131ld\u0131\u011f\u0131 her SQL sorgusunu, her yetkilendirme kontrol\u00fcn\u00fc manuel olarak g\u00fcncellemeniz gerekir. Bu durum, \u00f6zellikle g\u00fcvenlik a\u00e7\u0131s\u0131ndan kritik rollerin y\u00f6netildi\u011fi sistemlerde ciddi zaaflara yol a\u00e7abilir. Ayn\u0131 \u015fekilde, bir API \u00e7a\u011fr\u0131s\u0131 yaparken bir parametrenin varsay\u0131lan de\u011feri olarak apiClient.getProducts(category_id=15);<\/code> gibi bir ifade kullan\u0131ld\u0131\u011f\u0131nda, ’15’in hangi kategoriyi temsil etti\u011fini anlamak i\u00e7in API dok\u00fcmantasyonuna bakman\u0131z gerekir. Bu t\u00fcr \u00f6rnekler, ‘Magic Number’lar\u0131n yaz\u0131l\u0131m\u0131n her katman\u0131na nas\u0131l n\u00fcfuz edebilece\u011fini ve ne kadar gizli tehlikeler bar\u0131nd\u0131rd\u0131\u011f\u0131n\u0131 a\u00e7\u0131k\u00e7a g\u00f6stermektedir. Bu nedenle, bu t\u00fcr say\u0131lar\u0131 tan\u0131mlamak ve onlar\u0131 anlaml\u0131 isimlerle de\u011fi\u015ftirmek, projenin uzun vadeli ba\u015far\u0131s\u0131 i\u00e7in kritik bir ad\u0131md\u0131r.<\/p>\nGizemli Say\u0131lardan Kurtulman\u0131n Yollar\u0131: Hangi Silahlar\u0131 Kullanmal\u0131y\u0131z?<\/h2>\n
if (order.status == 3)<\/code> yerine, const ORDER_STATUS_SHIPPED = 3;<\/code> \u015feklinde bir sabit tan\u0131mlay\u0131p if (order.status == ORDER_STATUS_SHIPPED)<\/code> kullanmak, kodunuzun ne anlama geldi\u011fini an\u0131nda netle\u015ftirir. Bu yakla\u015f\u0131m, sadece okunabilirli\u011fi art\u0131rmakla kalmaz, ayn\u0131 zamanda gelecekte bir de\u011fi\u015fiklik gerekti\u011finde (\u00f6rne\u011fin, ‘SHIPPED’ durumu ‘3’ yerine ‘6’ olursa), sadece sabit tan\u0131m\u0131n\u0131 tek bir yerden de\u011fi\u015ftirmeniz yeterli olur. Bu, olas\u0131 hatalar\u0131 minimize eder ve bak\u0131m s\u00fcrecini h\u0131zland\u0131r\u0131r. Sabitlerin isimleri genellikle b\u00fcy\u00fck harflerle ve kelimeler aras\u0131na alt \u00e7izgi konularak yaz\u0131l\u0131r (SNAKE_CASE) ve bu, onlar\u0131n bir sabit oldu\u011funu g\u00f6rsel olarak da belirtir. Hatta, bu sabitleri ilgili mod\u00fcl veya s\u0131n\u0131f i\u00e7inde bir araya toplayarak kodun daha organize olmas\u0131n\u0131 sa\u011flayabilirsiniz.<\/p>\nenum OrderStatus { PENDING = 1, RECEIVED = 2, SHIPPED = 3, DELIVERED = 4 }<\/code>. Daha sonra kodunuzda if (order.status == OrderStatus.SHIPPED)<\/code> \u015feklinde kullanabilirsiniz. Bu, hem okunabilirli\u011fi en \u00fcst d\u00fczeye \u00e7\u0131kar\u0131r hem de tip g\u00fcvenli\u011fi sa\u011flar. Bir Enum kullanmak, yanl\u0131\u015fl\u0131kla ge\u00e7ersiz bir say\u0131sal de\u011feri bir duruma ataman\u0131z\u0131 engeller \u00e7\u00fcnk\u00fc derleyici veya linter size bir hata verecektir. Ayr\u0131ca, Enum’lar sayesinde, IDE’niz otomatik tamamlama \u00f6nerileri sunarak geli\u015ftirme s\u00fcrecini de h\u0131zland\u0131r\u0131r. Farkl\u0131 programlama dillerinde Enum’lar\u0131n uygulan\u0131\u015f\u0131 de\u011fi\u015fiklik g\u00f6sterse de (\u00f6rne\u011fin Java, C#, TypeScript’te g\u00fc\u00e7l\u00fc Enum deste\u011fi varken, Python’da enum<\/code> mod\u00fcl\u00fc ile, JavaScript’te ise object freeze veya TypeScript ile benzer yap\u0131lar olu\u015fturulur), temel prensip ayn\u0131d\u0131r: anlaml\u0131 isimlerle grupland\u0131r\u0131lm\u0131\u015f sabit de\u011ferler sunmak. Bu, \u00f6zellikle karma\u015f\u0131k i\u015f mant\u0131klar\u0131n\u0131 y\u00f6netirken ve farkl\u0131 durumlar veya tipler aras\u0131nda ge\u00e7i\u015f yaparken kodunuzu \u00e7ok daha anla\u015f\u0131l\u0131r ve g\u00fcvenli hale getirir.<\/p>\n:root {\n --primary-color: #007bff;\n --spacing-unit: 8px;\n --font-size-base: 16px;\n --breakpoint-tablet: 768px; \/* Sihirli say\u0131dan kurtulduk! *\/\n --breakpoint-desktop: 1024px;\n}\n\nbody {\n font-size: var(--font-size-base);\n margin: var(--spacing-unit);\n}\n\n.card {\n padding: calc(var(--spacing-unit) * 2); \/* Matematiksel i\u015flemler de m\u00fcmk\u00fcn *\/\n}\n\n@media (min-width: var(--breakpoint-tablet)) {\n \/* Tablet \u00fczeri cihazlar i\u00e7in stiller *\/\n .header {\n height: 80px; \/* Belki buras\u0131 da bir de\u011fi\u015fken olabilir *\/\n }\n}\n\n@media (min-width: var(--breakpoint-desktop)) {\n \/* Masa\u00fcst\u00fc cihazlar i\u00e7in stiller *\/\n body {\n font-size: calc(var(--font-size-base) * 1.125);\n }\n}<\/pre>\n--breakpoint-tablet<\/code> gibi CSS de\u011fi\u015fkenleri, daha \u00f6nce do\u011frudan piksel de\u011ferleri olarak yaz\u0131lan 'Magic Number'lar\u0131n yerini alm\u0131\u015ft\u0131r. Bu sayede, responsive tasar\u0131m\u0131n k\u0131r\u0131lma noktalar\u0131n\u0131 veya temel \u00f6l\u00e7\u00fc birimlerini tek bir yerden g\u00fcncelleyebilir, b\u00f6ylece UI tutarl\u0131l\u0131\u011f\u0131n\u0131 sa\u011flamla\u015ft\u0131rabilir ve bak\u0131m kolayl\u0131\u011f\u0131n\u0131 art\u0131rabilirsiniz. Bu stratejiler, kodunuzu daha mod\u00fcler, daha anla\u015f\u0131l\u0131r ve daha s\u00fcrd\u00fcr\u00fclebilir hale getirmek i\u00e7in vazge\u00e7ilmezdir. Bu silahlar\u0131 do\u011fru kullanarak, 'Magic Number' kabusundan sonsuza dek kurtulabilirsiniz.<\/p>\nPratikte Uygulama: Temiz Kod Yazmak \u0130\u00e7in Ad\u0131m Ad\u0131m Rehber<\/h2>\n
if (x == 10)<\/code>, for (int i = 0; i < 5;)<\/code> veya array[3]<\/code> gibi ifadelerdeki say\u0131lar potansiyel 'Magic Number'lard\u0131r. Bir say\u0131n\u0131n 'Magic Number' olup olmad\u0131\u011f\u0131n\u0131 anlamak i\u00e7in kendinize \u015fu soruyu sorun: \"Bu say\u0131 neden burada? Ne anlama geliyor? Ba\u015fka bir yerde de kullan\u0131l\u0131yor mu?\" E\u011fer cevab\u0131 hemen veremiyorsan\u0131z veya kodun farkl\u0131 yerlerinde ayn\u0131 say\u0131y\u0131 tekrar tekrar g\u00f6r\u00fcyorsan\u0131z, b\u00fcy\u00fck ihtimalle bir 'Magic Number' ile kar\u015f\u0131 kar\u015f\u0131yas\u0131n\u0131zd\u0131r. Bu say\u0131lar\u0131 bir listeye not al\u0131n veya kod yorumlar\u0131yla i\u015faretleyin. \u00d6zellikle bir code review s\u0131ras\u0131nda veya mevcut bir projeyi devrald\u0131\u011f\u0131n\u0131zda bu ad\u0131m\u0131 atlamak, ileride b\u00fcy\u00fck sorunlara davetiye \u00e7\u0131karabilir. Bu y\u00fczden, \u015f\u00fcphe duydu\u011funuz her say\u0131da potansiyel bir sorun oldu\u011funu varsayarak hareket etmek, en g\u00fcvenli yakla\u015f\u0131md\u0131r. K\u00fc\u00e7\u00fck, kademeli de\u011fi\u015fikliklerle bu say\u0131lar\u0131 temizlemek, projenin geneline yay\u0131lm\u0131\u015f b\u00fcy\u00fck bir karma\u015fay\u0131 \u00f6nleyecektir.<\/p>\n\/\/ K\u00f6t\u00fc \u00d6rnek: Magic Number Kullan\u0131m\u0131\npublic void assignRole(User user, int roleId) {\n if (roleId == 1) {\n user.setAdmin(true);\n } else if (roleId == 2) {\n user.setEditor(true);\n }\n}<\/pre>\n\/\/ \u0130yi \u00d6rnek: Sabit Kullan\u0131m\u0131\npublic static final int ROLE_ADMIN = 1;\npublic static final int ROLE_EDITOR = 2;\n\npublic void assignRole(User user, int roleId) {\n if (roleId == ROLE_ADMIN) {\n user.setAdmin(true);\n } else if (roleId == ROLE_EDITOR) {\n user.setEditor(true);\n }\n}\n\n\/\/ Daha \u0130yi \u00d6rnek: Enum Kullan\u0131m\u0131\npublic enum UserRole {\n ADMIN(1),\n EDITOR(2),\n VIEWER(3);\n\n private final int id;\n\n UserRole(int id) {\n this.id = id;\n }\n\n public int getId() {\n return id;\n }\n\n public static UserRole fromId(int id) {\n for (UserRole role : UserRole.values()) {\n if (role.getId() == id) {\n return role;\n }\n }\n throw new IllegalArgumentException(\"Unknown role id: \" + id);\n }\n}\n\npublic void assignRole(User user, UserRole role) { \/\/ do\u011frudan Enum nesnesi al\u0131yoruz\n if (role == UserRole.ADMIN) {\n user.setAdmin(true);\n } else if (role == UserRole.EDITOR) {\n user.setEditor(true);\n }\n}\n\n\/\/ Veya e\u011fer d\u0131\u015far\u0131dan int geliyorsa:\npublic void assignRoleById(User user, int roleId) {\n UserRole role = UserRole.fromId(roleId);\n \/\/ ... art\u0131k role nesnesiyle g\u00fcvenli bir \u015fekilde \u00e7al\u0131\u015fabilirsiniz\n}<\/pre>\n--breakpoint-tablet<\/code> veya --spacing-medium<\/code> gibi anlaml\u0131 de\u011fi\u015fkenler tan\u0131mlayarak kodunuzu daha esnek ve bak\u0131m\u0131 daha kolay hale getirin. Unutmay\u0131n, k\u00fc\u00e7\u00fck ad\u0131mlarla ba\u015flayan bu s\u00fcre\u00e7, zamanla projenizin genel kalitesini ve s\u00fcrd\u00fcr\u00fclebilirli\u011fini radikal bir \u015fekilde art\u0131racakt\u0131r. Her temizledi\u011finiz 'Magic Number', kodunuzu gelece\u011fe biraz daha haz\u0131rlar ve sizi daha iyi bir yaz\u0131l\u0131mc\u0131 yapar.<\/p>\nEkip \u00c7al\u0131\u015fmas\u0131nda ve \u00d6l\u00e7eklenebilir Projelerde 'Magic Number' Y\u00f6netimi Nas\u0131l Olmal\u0131?<\/h2>\n
SNAKE_CASE<\/code>), Enum'lar\u0131 ne zaman tercih edece\u011finizi ve yap\u0131land\u0131rma dosyalar\u0131n\u0131n nerede tutulaca\u011f\u0131n\u0131 net bir \u015fekilde belirlemelisiniz. Bu standartlar\u0131 bir dok\u00fcmanda toplay\u0131n ve t\u00fcm ekip \u00fcyelerinin bunlara eri\u015febildi\u011finden ve anlad\u0131\u011f\u0131ndan emin olun. Yeni kat\u0131lan ekip \u00fcyeleri i\u00e7in bu dok\u00fcmanlar, projenin kodlama k\u00fclt\u00fcr\u00fcne h\u0131zla adapte olmalar\u0131n\u0131 sa\u011flar. Otomatik kod bi\u00e7imlendiriciler (formatter) ve linter'lar bu standartlar\u0131n uygulanmas\u0131na yard\u0131mc\u0131 olabilir. \u00d6rne\u011fin, bir linter'\u0131 belirli bir say\u0131sal e\u015fi\u011fin \u00fczerindeki do\u011frudan say\u0131lar\u0131 uyarmak veya belirli Enum desenlerini zorunlu k\u0131lmak \u00fczere yap\u0131land\u0131rabilirsiniz. Bu, insan hatas\u0131 riskini azalt\u0131r ve kodun tutarl\u0131l\u0131\u011f\u0131n\u0131 sa\u011flamla\u015ft\u0131r\u0131r. Ayr\u0131ca, d\u00fczenli aral\u0131klarla bu standartlar\u0131 g\u00f6zden ge\u00e7irmek ve gerekti\u011finde g\u00fcncellemek, projenin evrilen ihtiya\u00e7lar\u0131na uyum sa\u011flamak a\u00e7\u0131s\u0131ndan da \u00f6nemlidir. B\u00f6ylece, proje b\u00fcy\u00fcd\u00fck\u00e7e bile kod kalitesinden \u00f6d\u00fcn verilmez ve ortak bir dil konu\u015fulmaya devam edilir.<\/p>\nSadece Say\u0131lar M\u0131? 'Magic String' ve Di\u011fer Gizli De\u011ferler<\/h2>\n
if (user.status.equals(\"active\")) { \/\/ Kullan\u0131c\u0131 aktif ise }<\/code>. Buradaki \"active\" kelimesi bir 'Magic String'dir. E\u011fer bu \"active\" durumu veritaban\u0131nda veya ba\u015fka bir sistemde \"ACTIVE\" (b\u00fcy\u00fck harfle) veya \"enabled\" olarak de\u011fi\u015ftirilirse, kodunuzda bu \"active\" string'inin kullan\u0131ld\u0131\u011f\u0131 her yeri bulup g\u00fcncellemeniz gerekir. Bu da ciddi bir hata potansiyeli yarat\u0131r ve b\u00fcy\u00fck\/k\u00fc\u00e7\u00fck harf duyarl\u0131l\u0131\u011f\u0131 gibi sorunlarla kar\u015f\u0131la\u015fman\u0131za neden olabilir. Ayn\u0131 durum, kullan\u0131c\u0131 aray\u00fcz\u00fcnde g\u00f6sterilen hata mesajlar\u0131 veya ba\u015far\u0131 bildirimleri i\u00e7in de ge\u00e7erlidir. Bir mesaj\u0131n i\u00e7eri\u011fi de\u011fi\u015fti\u011finde, mesaj\u0131n ge\u00e7ti\u011fi her yeri manuel olarak g\u00fcncellemek, zaman kayb\u0131na ve tutars\u0131z kullan\u0131c\u0131 deneyimlerine yol a\u00e7ar. Bu t\u00fcr string'ler, genellikle harici kaynaklardan veya yap\u0131land\u0131rmadan gelmesi gereken de\u011ferlerdir ve kodun i\u00e7ine g\u00f6m\u00fcld\u00fcklerinde esnekli\u011fi ve yerelle\u015ftirme (localization) yeteneklerini k\u0131s\u0131tlarlar. Bu nedenle, 'Magic String'leri tespit etmek ve onlar\u0131 sabitler, Enum'lar veya yap\u0131land\u0131rma dosyalar\u0131 arac\u0131l\u0131\u011f\u0131yla y\u00f6netmek, kodunuzun daha esnek ve bak\u0131m\u0131 daha kolay olmas\u0131n\u0131 sa\u011flar.<\/p>\n\/\/ K\u00f6t\u00fc \u00d6rnek: Magic String Kullan\u0131m\u0131\npublic void processUser(User user) {\n if (user.getStatus().equals(\"ACTIVE\")) {\n \/\/ ...\n }\n}\n\n\/\/ \u0130yi \u00d6rnek: Enum Kullan\u0131m\u0131\npublic enum UserStatus {\n ACTIVE(\"ACTIVE\"),\n INACTIVE(\"INACTIVE\"),\n PENDING(\"PENDING\");\n\n private final String statusValue;\n\n UserStatus(String statusValue) {\n this.statusValue = statusValue;\n }\n\n public String getStatusValue() {\n return statusValue;\n }\n\n public static UserStatus fromString(String text) {\n for (UserStatus b : UserStatus.values()) {\n if (b.statusValue.equalsIgnoreCase(text)) {\n return b;\n }\n }\n throw new IllegalArgumentException(\"Unexpected value '\" + text + \"'\");\n }\n}\n\npublic void processUser(User user) {\n if (user.getStatus().equals(UserStatus.ACTIVE.getStatusValue())) { \/\/ Veya do\u011frudan UserStatus nesnesi d\u00f6nd\u00fcr\u00fcyorsa: if (user.getStatus() == UserStatus.ACTIVE)\n \/\/ ...\n }\n}<\/pre>\ntrue<\/code> veya false<\/code> de\u011feriyle ilgilidir. \u00d6rne\u011fin, printReport(data, true)<\/code> gibi bir \u00e7a\u011fr\u0131 g\u00f6rd\u00fc\u011f\u00fcn\u00fczde, bu 'true' de\u011ferinin ne anlama geldi\u011fini anlamak i\u00e7in fonksiyon tan\u0131m\u0131na bakman\u0131z gerekir. 'true' belki \"raporu PDF olarak yazd\u0131r\" veya \"raporu otomatik olarak e-postala\" anlam\u0131na geliyor olabilir. Bu t\u00fcr durumlar i\u00e7in anlaml\u0131 adland\u0131r\u0131lm\u0131\u015f parametreler<\/b> veya \u00f6zelle\u015ftirilmi\u015f builder desenleri<\/b> kullanmak daha uygun bir yakla\u015f\u0131md\u0131r. E\u011fer kulland\u0131\u011f\u0131n\u0131z dil named arguments (adland\u0131r\u0131lm\u0131\u015f arg\u00fcmanlar) destekliyorsa, printReport(data, asPdf: true)<\/code> \u015feklinde \u00e7a\u011f\u0131rmak, kodu \u00e7ok daha okunur hale getirir. E\u011fer desteklemiyorsa, parametreleri a\u00e7\u0131klayan bir Enum veya sabit kullanabilir veya a\u015f\u0131r\u0131 y\u00fcklenmi\u015f fonksiyonlar (overloaded methods) tan\u0131mlayarak farkl\u0131 davran\u0131\u015flar\u0131 ayr\u0131 ayr\u0131 ifade edebilirsiniz. Sonu\u00e7 olarak, 'Magic Number' olsun, 'Magic String' olsun veya 'Magic Boolean' olsun, kodunuzda do\u011frudan yaz\u0131lm\u0131\u015f ve ba\u011flam\u0131 belirsiz t\u00fcm bu gizli de\u011ferlerden ka\u00e7\u0131nmak, her zaman daha iyi bir kod kalitesi, daha kolay bak\u0131m ve daha az hata demektir. Bu prensibi benimseyerek, kodunuzun her par\u00e7as\u0131n\u0131 \u015feffaf ve anla\u015f\u0131l\u0131r hale getirebilirsiniz.<\/p>\nSonu\u00e7: Kodunuzu Gelece\u011fe Haz\u0131rlay\u0131n, Gelin Birlikte Ba\u015faral\u0131m!<\/h2>\n
S\u0131k\u00e7a Sorulan Sorular (SSS)<\/h3>\n
for (int i = 0; i < 5; i++)<\/code> ifadesindeki 0<\/code> ve 5<\/code> gibi basit say\u0131lar genellikle 'Magic Number' olarak kabul edilmez, \u00e7\u00fcnk\u00fc ba\u011flamlar\u0131 genellikle a\u00e7\u0131kt\u0131r (\"0'dan ba\u015flay\u0131p 5'e kadar git\"). Bir say\u0131n\u0131n 'Magic Number' olup olmad\u0131\u011f\u0131n\u0131 anlamak i\u00e7in \u015fu sorular\u0131 sorun:<\/p>\n\n
\n
\n
private static final<\/code> veya benzeri bir \u015fekilde tan\u0131mlamak en iyisidir.<\/li>\nConstants<\/code> s\u0131n\u0131f\u0131 veya mod\u00fcl\u00fc olu\u015fturmak yayg\u0131n bir yakla\u015f\u0131md\u0131r. Ancak, bu s\u0131n\u0131f\u0131n \u00e7ok b\u00fcy\u00fck olmamas\u0131na dikkat edin; aksi takdirde \"Allah nesnesi\" (God Object) haline gelebilir.<\/li>\n\n
:root<\/code> veya di\u011fer kapsam belirleyiciler alt\u0131nda CSS de\u011fi\u015fkenleri olarak tan\u0131mlay\u0131n (\u00f6rn. --breakpoint-tablet: 768px;<\/code>). Daha sonra bu de\u011fi\u015fkenleri medya sorgular\u0131n\u0131zda veya stil tan\u0131mlar\u0131n\u0131zda kullan\u0131n.<\/li>\n$breakpoint-tablet: 768px;<\/code>) bu i\u015f i\u00e7in m\u00fckemmeldir. Bu de\u011fi\u015fkenleri tek bir dosyada tan\u0131mlay\u0131p projenizin her yerinde kullanabilirsiniz.<\/li>\n.m-sm { margin: 8px; }<\/code>).<\/li>\n