Ana içeriğe atla

Asp.Net Core Api - Swagger Kurulumu

Önceki yazılarımda Asp.Net Web Api Swagger kurulumundan bahsetmiştim. Şimdi sıra geldi .Net Core Api için swagger ı kolayca nasıl kurabiliriz ve apimizi dökümante edip kolayca testlerini gerçekleştirebiliriz kısmına.


Aşağıdaki adımları izleyerek .Net Core uygulamamıza swagger kurulumunu yapabiliriz.

1. Sırası ile ilgili menüyü izliyoruz ve Nuget Package Manager ı açıyoruz. Tools > NugetPackageManager > Manage Nuget Package Manager for Solution

2.Arama barına "Swashbuckle.AspNetCore" yazıp aratıyor ve ilk çıkan Nuget Package ı yüklüyoruz.

3. Yükleme tamamlandı şimdi sıra gerekli kodları Startup.cs dosyasına yerleştirip projemizde swagger ı çalışır hale getirme işleminde.

4. Startup.cs dosyamızı açıp aşağıda bold olarak belirtilen kısımlar kod dosyamıza ekleniyor.


       public void ConfigureServices(IServiceCollection services)
        {
            //Swagger döküman tanımını yapıyoruz.
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "WebApplication1", Version = "v1" });
            });

            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }


  // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseHsts();
            }

           //swagger kullanımı aktif ediliyor.
            app.UseSwagger();

           //swagger arayüz tanımı yapılıyor.
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "Web Uygulamamızın Adı");
            });

            app.UseHttpsRedirection();
            app.UseMvc();
        }

İlgili kod dosyamızı son hali aşağıdaki görseldeki gibi olacak.



5. Artık projemiz swagger ile çalışmaya hazır. Projemizi çalıştırıyoruz ve localhost url mize /swagger yazıyoruz ve aşağıdaki gibi bir ekran karşımıza çıkıyor. Artık swagger alt yapısını kullanarak api mizi geliştirmeye devam edebiliriz.





Bu blogdaki popüler yayınlar

Cannot resolve the collation conflict between "Turkish_CI_AS" and "SQL_Latin1_General_CP1_CI_AS" in the equal to operation.

iki ayrı veri tabanı içindeki tablolar ile işlem yapılmak istendiğinde eğer dil sorunu çıkıyor ise sorgumuzun sonuna 'COLLATE TURKISH_CI_AS' sözcüğünü ekleyerek sorunu çözebiliriz.Örnek : SELECT * FROM veritabani1.dbo.URUN u1 INNER JOIN veritabani2.dbo.URUNLER u2 ON u1.kod = u2.kod COLLATE TURKISH_CI_AS umarım faydalı olmuştur.

SQL DATEADD() Fonksiyonu(Sql de tarihe ay,gün,yıl ekleme)

Kullanım Kalıbı : DATEADD (datepart , number , date ) . datepart ksımına month,year,day vs artırmak istediğimiz tarih birimini yazıyoruz. . number ksımına arttırmak istediğimiz miktarı yazıyoruz. . date kısmına da hangi tarih e ekleneceğini belirtiyoruz. Örnek olarak şu an ki tarihten 1 ay sonrasını görmek için : Şu anki tarih '10-1-2011' olsun(gün,ay,yıl) Sorgu : SELECT DATEADD(MONTH,+1,GETDATE()) Çıktı alacağımız tarih : '10-2-2011' şekinde olacaktır.

Microsoft SQL Server, Error: 18456

sql server da authentication sorunu. genelde sql server kurulumundan sonra sql serverda bir kullanıcı açıldığında şifre ve kullanıcı adı girmenize rağmen girişi kabul etmez. bu durumda önce kullanıcınızın properties status kısmından enabled olup olmadığına bakın. eğer bu enable ise sql server sunucu üzerinde sağ tuş yapıp properties 'den Security sekmesinden "Sql Server And Windows Authentication Mode" seçilmeli ve ardından sql server servisleri yeniden başlatılmalıdır değişikliklerin kayıt edilmesi için. işte sql server artık hem windows authentication ile hemde sql authentication ile çalışabilir artık. Umarım faydalı olur.