ASP.NET Core ile Web API Geliştirme Rehberi

ASP.NET Core ile Web API Geliştirme Rehberi

ASP.NET Core, geliştiricilere bağımsız, bulut tabanlı ve mobil uygulamalar için modern web uygulamaları oluşturma olanağı sunar. ASP.NET Core ile Web API geliştirmek, özellikle verilerin istemciye sunulması ve farklı platformlar arasında iletişim sağlanması gerektiğinde önemli bir çözümdür. Bu rehberde, ASP.NET Core ile bir Web API oluşturmanın temel adımlarını adım adım keşfedeceğiz.

ASP.NET Core Nedir?

ASP.NET Core, Microsoft tarafından geliştirilen ve platform bağımsız olarak çalışan bir açık kaynaklı web çerçevesidir. ASP.NET Core, yüksek performanslı web uygulamaları oluşturmanızı sağlarken aynı zamanda optimizasyon, güvenlik ve ölçeklenebilirlik gibi konularda destek sunar. ASP.NET Core ile geliştirilen Web API'''ler, RESTful servisler üzerinden verilerinizi yönetmenize ve sunmanıza olanak tanır.

Başlangıç Adımları

Geliştirme Ortamının Hazırlanması

ASP.NET Core ile geliştirme yapmaya başlamak için öncelikle uygun bir geliştirme ortamı kurmanız gerekmektedir. Bunun için:

1. Visual Studio’nun en son sürümünü indirip yükleyin. Alternatif olarak, Visual Studio Code da kullanabilirsiniz.

1. .NET Core SDK’yı sisteminize kurduğunuzdan emin olun.

Yeni Bir Web API Projesi Oluşturma

Visual Studio ortamında yeni bir Web API projesi oluşturmak için şu adımları izleyin:

1. Visual Studio'''yu açın ve ''�Create a new project''� seçeneğine tıklayın.

1. Proje türü olarak ''�ASP.NET Core Web Application''� seçeneğini seçin ve ''�Next''�e tıklayın.
   

3. Proje adınızı girdikten ve konumunu belirledikten sonra, bir sonraki ekranda ''�API''� şablonunu seçin.

API Mimarisi ve CRUD İşlemleri

Bir API geliştirdiğinizde, genellikle CRUD (Create, Read, Update, Delete) işlemlerini gerçekleştirecek yapıya ihtiyaç duyarsınız. Bu işlemleri ASP.NET Core ile nasıl gerçekleştirebileceğinizi ele alalım:

1. Model Oluşturma

Proje yapınızda bir klasör oluşturup içerisine bir model sınıf oluşturabilirsiniz. Örneğin, bir ''�Product''� modeliniz olsun:

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

2. Veritabanı Bağlantısı

ASP.NET Core projeleri genellikle Entity Framework Core kullanılarak veritabanı ile etkileşim kurar. Aşağıdaki adımlarla bir veritabanı bağlama işlemini gerçekleştirebilirsiniz:

1. ''�Startup.cs''� dosyasında ConfigureServices methoduna veri tabanınızı ekleyin:

services.AddDbContext(options =>
    options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

2. Bağlantı cümleciğinizi appsettings.json dosyasında belirtin:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=YOUR_SERVER;Database=YOUR_DATABASE;Trusted_Connection=True;"
  }
}

3. CRUD API Endpoint'''lerinin Geliştirilmesi

Controller dosyasında CRUD işlemleri için gerekli endpoint'''leri oluşturun. Basit bir örnek olarak ''�ProductsController''�:

[Route("api/[controller]")]
[ApiController]
public class ProductsController : ControllerBase
{
    private readonly AppDbContext _context;

    public ProductsController(AppDbContext context)
    {
        _context = context;
    }

    [HttpGet]
    public async Task>> GetProducts()
    {
        return await _context.Products.ToListAsync();
    }

    [HttpGet("{id}")]
    public async Task> GetProduct(int id)
    {
        var product = await _context.Products.FindAsync(id);
        if (product == null)
        {
            return NotFound();
        }
        return product;
    }

    [HttpPost]
    public async Task> PostProduct(Product product)
    {
        _context.Products.Add(product);
        await _context.SaveChangesAsync();
        return CreatedAtAction(nameof(GetProduct), new { id = product.Id }, product);
    }

    [HttpPut("{id}")]
    public async Task PutProduct(int id, Product product)
    {
        if (id != product.Id)
        {
            return BadRequest();
        }

        _context.Entry(product).State = EntityState.Modified;
        await _context.SaveChangesAsync();
        return NoContent();
    }

    [HttpDelete("{id}")]
    public async Task DeleteProduct(int id)
    {
        var product = await _context.Products.FindAsync(id);
        if (product == null)
        {
            return NotFound();
        }

        _context.Products.Remove(product);
        await _context.SaveChangesAsync();
        return NoContent();
    }
}

Yayına Alma ve Bulut Çözümleri

Geliştirmenin ardından API'''nizi yayına almak isteyebilirsiniz. Bunun için ASP.NET Core uygulamanızı bir sunucuya deploy etmelisiniz. Yüksek ölçeklenebilirlik ve kesintisiz hizmet için bulut sunucu çözümleri ideal bir seçim olabilir. Ayrıca, fiziksel kaynakların tamamına erişim gereksinimi duyuyorsanız dedicated sunucu hizmetlerinden faydalanabilirsiniz. Eğer uygulamanızın yurt dışı lokasyonlardan da erişilebilir olmasını istiyorsanız, yurtdışı lokasyon sanal sunucu seçeneklerini göz önünde bulundurabilirsiniz.

Bu rehberde ASP.NET Core ile Web API geliştirme konusuna giriş yaptık. Projenizin gereksinimlerine göre özelleştirme yaparak ve yeni özellikler ekleyerek uygulamanızın kapsamını genişletebilirsiniz. Unutmayın, doğru bir yapı ve düzenli güncellemeler ile güçlü ve güvenilir web API'''ler geliştirmek her zaman mümkündür.