REST API geliştirmeye başlamak kolaydır; asıl zorluk proje büyüdüğünde kodun hâlâ anlaşılır, test edilebilir ve değiştirilebilir kalmasını sağlamaktır.
Katmanları neden ayırmalıyız?
Route dosyalarının hem doğrulama, hem veritabanı sorgusu, hem de iş kuralı taşıdığı projeler kısa sürede zor yönetilir. Her katmana tek bir sorumluluk vermek, değişikliklerin etkisini sınırlar.
Basit bir akışta route yalnızca isteği karşılar, controller HTTP seviyesindeki kararı verir, service iş kurallarını yürütür ve repository ya da model katmanı veriye erişir.
Pratik bir klasör yapısı
Klasör yapısı tek başına mimari değildir; fakat ekipte herkesin aynı yeri araması önemli bir avantajdır. Modül bazlı bir yapı, ilgili route, service ve doğrulamaları birbirine yakın tutar.
- routes: endpoint tanımları ve middleware zinciri
- controllers: request/response koordinasyonu
- services: iş kuralları ve tekrar kullanılabilir operasyonlar
- models veya repositories: veri erişimi
- schemas: request doğrulama kuralları
Hata yönetimini merkezileştirin
Her controller içinde aynı try/catch kalıbını tekrarlamak yerine, uygulama seviyesinde ortak bir hata formatı belirlemek istemci tarafını da sadeleştirir. Hatanın kullanıcıya gösterilecek mesajı ile loglanacak teknik detayı birbirinden ayırın.
Sonraki adım
Öğrendiklerini gerçek bir projede uygula
BilGen Akademi eğitimleri, konuyu sadece okumak yerine adım adım proje geliştirerek pekiştirmen için hazırlanır.
Kursları incele