Minimal Api .Net 6’in yeni api dizaynıdır. Geleneksel .Net api özelliklerinden farklı olup yeni bir alternatif sağlar. Kullanmakta olduğumuz WEB API modeli MVC’den türetilmiş, controllers ve action metotlarından oluşur, bununla birlikte model binding, datalar için validasyon ve filters gibi birçok özellik sağlar.

.Net ile api oluşturmanın belli kuralları olduğundan günümüz teknoloji dillerine göre daha kompleks kalmasına neden oluyordu. Daha yalın ve minimalist apilerin populeritesi de artmakta olduğu için ve microservis mimarisinin de bu anlamda büyük ölçüde ilerlemesinden dolayı Microsoft kolları sıvıyor ve geniş kapsamlı karmaşık uygulamalar yani monolitik API yerine birçok küçük web servis hizmeti olacak şekilde yeni bir api patternı tasarlamaya başlıyor.

Günümüzde popüler olarak kullanılan Javascript,Node, Python gibi dillerin de projeler yapıları minimal hatta tek bir dosya uygulamaları bulunuyor. Zamanla .Net de bu dünyayı görerek daha yalın projelere ve daha küçük yapıları oluşturmak üzere geliştirmeler yapıyor ve Minimal API’ler ile daha hafifi ve sade bir api modeli ile karşımıza çıkıyor.

Minimal Apiler gene aynı HTTP web servis mantığı ile farklı http requestleri alıp geriye bir response döndürmesidir. Bunun içinde MapGet, MapPost gibi metotlar kullanılır.

Minimal Api Kullanımı

Minimal Api‘nin kullanımı sytanxı aşağıdaki gibidir.

Minimal api’nin en sade kullanımıdır. Get çağrısı ile birlikte ki bunu bize app.MapGet metotu sağlıyor. Bu metodun ilk parametresi ile bir endpoint belirliyoruz. Daha sonra lamba expresion ile response olarak geriye ne döndürmek istiyoruz onu tanımlıyoruz.

Minimal Api ile yaratılan API’ler sınırlı özelliklerinin olması işlevsiz olduğu anlamına gelmez. Bu API’ler .Net API’lerin birçok özelliğine sahiptir. Kullanabildiğimiz özelliklerinden bir tanesi de Dependecy Injection.

.Net core ile daha sık kullandığımız DI nesnelerini, .Net 6’dan önce startup.cs class’i içerisinde tanımlıyorduk ve bu servisleri kullanacağımız controller classlarda çağrıyorduk.

Minimal Api’de yapı biraz daha sadeleşmiş durumda, kullanacağımız servisleri program.cs içerisinde tanımladıktan sonra (.Net 6 ile birlikte startup classı kaldırıldı. Tüm configurasyon ve tanımlama işlemleri program.cs içerisinde yapılıyor.) Minimal apinin MapGet, MapPost, MapPut metotlarının delegate parametresinde tanımlamamız yeterli oluyor.

Örnek;

IOderService application içerisinde tanımladığımız DI servisimiz, lambda expression içerisinde tanımladığımız bu nesneyi minimal api parametre olarak görmez yani sizin post requestiniz bu nesneyi sizden beklemez. Application ayağa kaldığında bunun bir implementasyon olduğunu anlar. Bu şekilde kolaylıkla kullanacağımız servisi metot içerisinde implemente etmiş olduk.

The post .Net Core Minimal API Nedir? appeared first on Dinamik Network.

Sizlere typescript projesi nasıl oluşturulur? Oluşturduktan sonra Typescriptte kullanılan temel tiplerden bahsedicem. Typescripttin en sevdiğim özelliklerinden bir tanesi temel ve custom tiplerle temiz kod yazmamızı sağlamasıdır. Ayrıca javascriptte gözden kaçırdığımız hataları typescript ile daha hızlı bir şekilde tespit edebilmemiz.

         Typescript projesi nasıl oluşturulur?

Ben proje oluşumunu Visual Studio Code üzerinden yapıcam. VS Code indirmek için buraya tıklayabilirsiniz. Projeyi oluşturmadan önce makinamıza ilk önce node.js yüklüyoruz. Node.js’i bu adresden indirebilirsiniz. İndirme işlemi tamamlandıktan sonra typescript’i indirelim. Bunun için command prompt açıp yükleme komutunu yazıyoruz.

npm install -g typescript

Yükleme işlemi tamamlandıktan sonra VS Code içerisinden proje dosyasını oluşturalım. Projede şuan için html ve .ts uzantılı iki dosya oluşturdum. .ts uzantılı dosyamız Typescript’tir 🙂

VS Code içerisinde oluşturduğumuz projeyi run edebilmek için node.js den biraz yardım alalım. Visual Studio Code içerisinden terminal’i açıyoruz. Projeye package.json dosyasını oluşturmak için npm init komutu yazıyoruz.

Ardından npm install –save-dev lite-server ile dev ortamını oluşturuyoruz. package.json içerisinde start: lite-server satırını ekleyip programa start verebiliriz.

Npm Lite-server ile programı başlattığımızda yapacağımız tüm değişiklikler için html, javascript dosyalarını yeniden okur anlık olarak değişikliklerin hepsini canlı olarak görmemizi sağlar. Böylelikle Projemizi kapatıp tekrar başlatmamıza gerek kalmaz. 🙂 

{
  "name": "typescript_example",
  "version": "1.0.0",
  "description": "test",
  "main": "helper.js",
  "scripts": {
    "test": "test",
    "start" : "lite-server"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "lite-server": "^2.5.4"
  }
}<span id="mce_marker" data-mce-type="bookmark" data-mce-fragment="1">​</span>

İşlemler tamamlandıysa çalıştırmayı npm start komutuyla yapıyoruz. Şimdi Typescript’i javascript diline çevirelim.

helper.ts içerisinde toplama işlemi yapan bir fonksiyon yazalım.

function Add(number1,number2) {
    const total = number1 + number2;
    return total;
}

console.log(Add(5,6));

Tekrar terminali açıyoruz. tsc helper.ts komutunu çalıştıralım ve karşımızda typescriptin javascript versiyonu .js dosyayı 🙂

Typescript kullanabilmek için html ‘de oluşturduğumuz .js dosyasını kaynak olarak kullanın. Browser .ts dosyasını okuyamaz ve kodlarınız da çalışmamış olur. Bir sonraki yazımda TypeScript temel tiplerden bahsedicem.

Proje oluşturma kısmında anlayışılmayan kısımlar için yazabilir, hata alırsanız yardımcı olmaya çalışabilirim.

The post Typescript nedir? appeared first on Dinamik Network.

SQL Server, T-SQL hakkında ilk yazımı yazıyorum. Esasında ilk başta temel yapılardan başlamayı düşünmüştüm ancak bu sefer farklı bir başlangıç yapmak istedim. Bu sebeple bu yazıyı okuyan kişilerin MS-SQL hakkında temel bilgileri bildiklerini varsayıyorum.

Bu yazıda piyasada Code Generator olarak bilinen yapıyı kendimiz oluşturacağız. Code Generator ne demek diyecek olursanız bizim Entity‘lerimizi kolayca üretmeyi sağlayan bir exedir. Entity nedir diye soracak olursanız da veritabanı üzerindeki tablolarımızın modelleridir diyebiliriz. Code Generator denen exe esasında arka tarafında birazdan yazacağımız bir SQL bloğu çalıştırmakta, sonuçlarını göstermektedir.

C# Entity Class Oluşturma

Evet, artık başlayalım. SQL Server’ı açalım. SQL Server verisyonum 2017 Developer Edition. Entity oluşturmak istediğim tablo da LogRecord tablosu. Aşağıdaki resimde de görebileceğiniz gibi çok olmasa da hatırı sayılabilecek alan sayısı olduğunu söylenebilir.

Şimdi bu kısımda SQL Server bize View’leri sayesinde yardımcı olacak. SQL Server’ın özel viewleri hakkında detaylı bilgiyi aşağıdaki linkten edinebilirsiniz.

https://docs.microsoft.com/en-us/sql/relational-databases/system-catalog-views/catalog-views-transact-sql?view=sql-server-ver15

Şimdi önce kolonlarımızı getirtelim. Aşağıdaki sorgu bize bu konuda yardımcı olacaktır.

SELECT * FROM sys.all_columns WHERE object_id = (SELECT OBJECT_ID ('LogRecord'))

Resimde sonuçlarını da görelim.

Artık kolonlarla ilgili olarak gerekli bilgiye sahibiz. Kolonların veri yapılarından kaynaklı olarak sahip oldukları özellikler de bu viewden bize gelmektedir. Şimdi bu tablodan bize system_type_id ve user_type_id isimli alanlar döndü. Yani aslında biz bu kolonların tiplerini de biliyoruz ama id değeri olarak biliyoruz. Bunların ne olduklarını bulabilmemiz için aşağıdaki sorgu bize yardımcı olacaktır.

SELECT * FROM sys.types

Sorgu sonucunu aşağıdaki resimde görebiliriz.

SQL Server üzerindeki tüm tipler ile ilgili bilgiler bu view üzerindedir. Şimdi tek yapmamız gereken sorguyu ayarlamak. Sorgumuzu parça parça yazıp geliştireceğiz. Şimdi bize lazım olan parçalar 2 view üzerinde olduğuna göre JOIN işlemi ile başlayabiliriz.

Şimdi sıra ihtiyacımız olan alanlar ile bu sorguyu düzenlemekte. Sorguyu aşağıdaki gibi düzenleyelim.

SQL Server – C# Veri Tipleri

Sorgumuz fena bir yere gelmedi aslında. Elimizde alan isimleri ve veri tipleri var ancak bu tipler SQL tipleri. Bizim oluşturacağımız entity hangi programlama dili içinse onun karşılığı veri tipini bulmalıyız. Esasında programlama dilleri içerisinde veri tipleri benzerlik göstermektedir. Ben C# programlama dilini baz alarak hareket edeceğim. C# veri tipleri ile ilgili detaylı bilgiye aşağıdaki linkten ulşabilirsiniz.

https://social.msdn.microsoft.com/Forums/tr-TR/379a88e0-ebd5-4666-9b73-e16f77698a38/c-deikenler-veri-tipleri?forum=csharptr

Şimdi sorgumuzun sondan bir önceki düzenlemesini yapalım. Sizin tablonuzda farklı tipler varsa yukarıdaki linkten yararlanarak C# karşılığını bulabilirsiniz. Ben sorgumu aşağıdaki hale getirdim.

Şimdi elimizde bir şeyler var. İsimler ve veri tipleri elimizde. Entity üzerinde değer setlenirken hiç bir kontrol yapmayacağım için Auto-implemented propertie haline getirmem yeterli olacaktır. Auto-implemeneted propertie kavaramının detaylı açıklamasına aşağıdaki linkten ulaşabilirsiniz.

https://docs.microsoft.com/tr-tr/dotnet/csharp/programming-guide/classes-and-structs/auto-implemented-properties

Sorguyu aşağıdaki hale getiriyoruz.

Şu an elimizde tablonun kolonları yani propertieleri var. Bu kadar yapmışken sınıfını da ayarlayalım. Sorguyu son kez değiştiriyorum.

Artık entitymiz hazır. Sorgu sonucunu alıp class yaratabiliriz. Bir DB üzerindeki tüm tabloları bu şekilde hızlıca Entity haline getirip modellerimizi hazırlayabilir, proje ya da projelerimize hızlıca entegre edebiliriz.

Bir sonraki yazıda yeniden görüşmek dileğiyle… Diğer T-SQL konularına ulaşmak için tıklayın.

The post SQL Server ile C# Entity Class Oluşturma appeared first on Dinamik Network.