ASP.NET Core Web API ve PostgreSQL ile CRUD API Geliştirme

ASP.NET Core Web API ve PostgreSQL ile CRUD API Geliştirme

Merhaba! Bu makalede, ASP.NET Core Web API ve PostgreSQL kullanarak bir CRUD (Create, Read, Update, Delete) API’si nasıl geliştirileceğini adım adım ele alacağız. Bu rehber, temel seviyeden orta seviyeye kadar olan geliştiriciler için idealdir. Öncelikle, projenin temel mimarisini ve gerekli kütüphaneleri kuracağız. Ardından, veritabanı bağlantısını yapılandıracağız ve CRUD işlemlerini gerçekleştirecek kontrolcüler (Controllers) oluşturacağız. Son olarak, API’yi test ederek tamamlayacağız.

Proje Kurulumu

İlk adım olarak, yeni bir ASP.NET Core Web API projesi oluşturacağız. Bunun için Visual Studio veya .NET CLI kullanabilirsiniz. Proje oluşturulduktan sonra, PostgreSQL ile etkileşim kurmak için gerekli NuGet paketlerini eklememiz gerekiyor. Bunlar genellikle Npgsql paketidir. Bu paketi NuGet Paket Yöneticisi aracılığıyla veya komut satırından ekleyebilirsiniz. Ekledikten sonra, projemize PostgreSQL bağlantı dizesini eklemeyi unutmayın. Bu dizi, veritabanı sunucunuzun adresini, veritabanı adını, kullanıcı adını ve şifresini içerecektir.

// appsettings.json dosyasına bağlantı dizesi örneği
"ConnectionStrings": {
  "PostgreSQLConnection": "Server=localhost;Port=5432;Database=MyDatabase;User Id=myuser;Password=mypassword;"
}

Veritabanı Modeli

Şimdi, veritabanımızda kullanılacak veri modeli (Entity) sınıflarını oluşturalım. Bu sınıflar, API’nin hangi verileri işleyeceğini tanımlar. Örneğin, bir blog uygulaması için bir Post modeli oluşturabilir ve bu model içerisinde başlık, içerik ve yayın tarihi gibi özellikleri tanımlayabiliriz. Bu sınıflar, daha sonra Entity Framework Core ile veritabanına eşlenecektir.

public class Post
{
    public int Id { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    public DateTime PublishedDate { get; set; }
}

CRUD İşlemleri

Veritabanı modeli tanımlandıktan sonra, CRUD işlemlerini gerçekleştirecek kontrolcülerimizi oluşturabiliriz. Bu kontrolcüler, HTTP isteklerini işleyerek veritabanı işlemlerini yönetir. Örneğin, bir POST isteği yeni bir gönderi eklerken, bir GET isteği mevcut gönderileri getirir. UPDATE ve DELETE istekleri ise ilgili gönderileri günceller ve siler.

İşte basit bir örnek:

[Route("api/[controller]")]
[ApiController]
public class PostsController : ControllerBase
{
    // ... (DbContext ve diğer bağımlılıkları ekleyin) ...

    [HttpGet]
    public async Task<ActionResult<IEnumerable<Post>>> GetPosts()
    {
        return Ok(await _context.Posts.ToListAsync());
    }

    // ... (Diğer CRUD metodları) ...
}

API Test Etme

Son olarak, geliştirdiğiniz API’yi test etmeniz önemlidir. Bunun için Postman, Swagger gibi araçları kullanabilirsiniz. Bu araçlar, HTTP isteklerini kolayca göndermenizi ve API’nin doğru çalışıp çalışmadığını kontrol etmenizi sağlar. Testler sırasında, her bir CRUD işleminin düzgün çalıştığından emin olmalısınız. Ayrıca, hata yönetimi ve güvenlik açıklarını da kontrol etmeniz gerekir.

Sonuç

Bu makalede, ASP.NET Core Web API ve PostgreSQL kullanarak bir CRUD API’si geliştirmenin temel adımlarını ele aldık. Bu adımları izleyerek kendi CRUD API’lerinizi oluşturabilir ve geliştirebilirsiniz. Daha fazla bilgi ve örnek için fatihsoysal.com sitesini ziyaret edebilirsiniz. Ayrıca, bu İngilizce makale de size yardımcı olabilir.

Umarım bu makale faydalı olmuştur. Sorularınız veya önerileriniz varsa, lütfen yorumlarda belirtin.

#Etiketler

#ASP.NET Core #Web API #PostgreSQL #CRUD #RESTful API #C# #.NET #Veritabanı #Programlama #Geliştirme