ASP.NET Core ile C# Web Uygulaması Oluşturmak

Varsayılan Uygulamayı Çalıştırma

Tim, geliştiricilerin kutudan ne çıktığını göstermek için varsayılan uygulamayı çalıştırarak başlar. Çalıştırıldığında, proje API'yi derler, gerekli NuGet paketlerini indirir ve bir web sayfası başlatır. Bu başlangıç kurulumu herhangi bir modifikasyon olmadan API'nin temel yapısını ve işlevselliğini gösterir.

API ile Etkileşim

Başlatılan web sayfası Swagger tarafından desteklenir, şu an OpenAPI olarak bilinmektedir. Swagger, kullanıcı dostu bir arayüz sunarak API ile etkileşime geçmeyi sağlar. Hem geliştiricilerin hem de geliştirici olmayan kişilerin API uç noktalarını kolayca anlamalarını ve test etmelerini sağlar. Bu arayüz API'nin çalışma şeklini görselleştirme ve belgeleri amacıyla özellikle faydalıdır.

Swagger'ı Keşfetmek

Swagger, API'deki mevcut uç noktaları sergiler. Varsayılan kurulumu, önceden yapılandırılmış uç noktalarından biri olan "hava durumu tahmini" uç noktasıdır. Bu uç noktaya tıklayarak ve "Deneme" özelliğini kullanarak, kullanıcılar API çağrısını yapabilir ve yanıtı görebilirler. Bu yanıt, API'den geri dönen verilerin nasıl olduğunu göstermek amacıyla JSON formatında bir hava durumu tahmini içerir.

Tim, 8:32'de, ham JSON verilerinin tarayıcıdan doğrudan okunması zor olabileceğini, ancak Swagger'ın belge üzerindeki kaplamasıyla çok daha kolay anlaşılır hale geldiğini vurgular. Belgeleme, uç noktayı kullanma yöntemi (GET, POST, vb.), döndürülen verilerin yapısını ve gerekli parametreleri içeren ayrıntılı bilgiler sağlar.

JSON Belgelemesi ve API Versiyonlaması

Swagger ayrıca Tim'in 9:10'da işaret ettiği bir JSON dosyası sağlar ve bu dosya API'yi makinelere okunabilir bir formatta belgeler. Bu belge, API ile etkileşime girecek diğer uygulamalar için önemli olup, mevcut uç noktaları, veri şemalarını ve beklenen yanıtları açıklamaktadır.

Tim, 9:29'da API'lerde versiyonlama önemini vurgular. Varsayılan kurulumu bir versiyon göstergesine de sahiptir, potansiyel birden fazla API sürümüne işaret eder. Versiyonlama, geriye dönük uyumluluğun korunması için hayati öneme sahiptir. API'ye yapılan değişikliklerin mevcut istemcileri kırma olasılığında, geliştiricilerin kullanıcılarını rahatsız etmeden yeni özellikler veya değişiklikler sunmasına olanak tanır.

API'lerin Amacı

Tim, çoğu uygulamanın veri çevresinde döndüğünü, yani geri alma, manipülasyon ve görüntüleme olduğunu vurgular. API'ler, kullanıcı arayüzü ile alttaki veriler arasında bir aracı olarak hizmet vererek, veri erişimini güvenli ve etkin bir yöntem sağlar. Bu merkezileştirme birkaç nedenle önemlidir:

1. Güvenlik: API'ler veri erişimi için güvenli bir yöntem sunar. Mobil ve istemci tarafı uygulamaları veritabanlarına doğrudan bağlanmamalı, bu da istemci kodu içinde veritabanı kimlik bilgilerini yerleştirerek önemli güvenlik risklerine yol açar.

2. Soyutlama: API'ler veri katmanını kullanıcı arayüzünden soyutlar, farklı istemci uygulamalarının (mobil uygulamalar, web uygulamaları, masaüstü uygulamaları) aynı veri kaynağı ile etkileşimde bulunmasına izin vererek veritabanını veya onun kimlik bilgilerini açığa çıkarmadan.

Farklı Çerçevelerde Çeşitlilik

Tim, API'lerin belirli framework veya dillerle sınırlı olmadığını belirtiyor. Örneğin, bir C# API'ye, Angular, React veya Vue gibi JavaScript frameworkleri tarafından erişilebilir ve bu, API'lerin çapraz platform yeteneklerini gösterir.

1. Program.cs Genel Bakış

Tim, Program.cs'yi inceler ve bunun web uygulamasını oluşturduğunu, denetleyiciler ve Swagger (OpenAPI) gibi hizmetleri yapılandırdığını belirtir. Kod, uygulamayı oluşturmadan ve çalıştırmadan önce gerekli hizmetleri kurar.

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

2. Ortam Yapılandırması

Tim, ortam ayarlarının launchSettings.json içinde nasıl yapılandırıldığını açıklıyor. Varsayılan ortam, yerel test için "Geliştirme" olarak ayarlanmış ve Swagger etkinleştirilmiştir. Üretimde, güvenlik nedeniyle Swagger genellikle devre dışı bırakılır, ancak geliştirme kontrolü kaldırılarak etkinleştirilebilir.

{
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "WebApplication": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

3. HTTPS Yönlendirmesi ve Denetleyiciler

Tim, HTTPS yönlendirmesi ve denetleyicilerin eşleştirilmesine dikkat çeker. Bu yapılandırma, API yollarının düzgün şekilde yapılandırılmasını sağlar. HTTP istek ve yanıt yollarında açıklık sağlamak için "api" öneki kullanmayı tercih eder, bu önek değiştirilebilir ve API yollarının farklı olmasını sağlar.

4. Hava Durumu Tahmin Denetleyicisi

Tim, rota ayarlarını öne çıkararak WeatherForecastController.cs'ye derinlemesine iniyor. Varsayılan rota /weatherforecast olup, prefiks olarak "api" eklemek üzere değiştirilebilir. Denetleyici, verileri almak için HTTP GET kullanır ve belirtilen yol üzerinden erişilebilir.

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

public class WeatherForecast
{
    public DateTime Date { get; set; }

    public int TemperatureC { get; set; }

    public string? Summary { get; set; }
}

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

public class WeatherForecast
{
    public DateTime Date { get; set; }

    public int TemperatureC { get; set; }

    public string? Summary { get; set; }
}

5. HTTP Fiilleri ve Yönlendirme

Tim, HTTP fiillerinin (GET, POST, PUT, DELETE) API uç noktalarını nasıl tanımladığını açıklar. GET isteği için, tarayıcı denetleyicideki belirtilen yöntemi çağırır. Diğer fiiller, test için Postman gibi araçlar gerektirir.

REST API

Tim Corey, REST'i (Temsili Durum Transferi) ve prensiplerini tanıtır.

1. REST Nedir: REST, ağ uygulamaları tasarımı için bir mimari stildir. Durumsuz iletişime dayanır ve operasyonları gerçekleştirmek için standart HTTP yöntemlerini (GET, POST, PUT, DELETE) kullanır.

2. RESTful Prensipler: RESTful API'ler kaynakları temsil etmek için URL desenleri kullanır. Örneğin, /users tüm kullanıcıları getirirken, /users/5 ID'si 5 olan belirli bir kullanıcıyı getirir.

3. REST Uyumluluğu: Tim, tam REST uyumluluğunun sağlanmasının zor olabileceğini belirtir çünkü REST başlangıçta teorik bir modeldi. Ancak, REST prensiplerine uymak, daha sezgisel ve tutarlı API'lara yol açabilir.

Tim, REST uyumluluğunu hedeflerken, pratik hususların API tasarımını yönlendirmesi gerektiğini, kullanılabilirlik ve işlevselliği sağlaması gerektiğini vurgular.

Minimal API Uygulaması

Corey, ASP.NET Core'da API geliştirme için basitleştirilmiş bir yaklaşım olan Minimal API'leri tanıtır:

1. Minimal API'leri Kurma: Tim, projeyi oluştururken "Denetleyicileri Kullan" seçeneğinin işaretini kaldırarak bir Minimal API projesi oluşturmayı gösterir.

2. Basitleştirilmiş Kod: Minimal API'ler, kontrolcüler ve yönlendirme niteliklerine olan ihtiyaçı ortadan kaldırarak, geliştiricilerin Program.cs içinde app.MapGet(), app.MapPost() gibi yöntemlerle doğrudan uç noktaları tanımlamasına olanak tanır.

3. Kod Örneği: Tim, tek bir kod satırının bir uç nokta tanımladığı bir kod örneği sunar. GET isteğini minimal yapılandırma ile bir uç noktaya nasıl eşleyeceğini gösterir.

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

Minimal API'ler, özellikle daha küçük uygulamalar veya mikro hizmetler için geliştirmeyi basitleştirmek üzere tasarlanmıştır.