• Ana Sayfa
  • Kütüphane
  • Arşiv
  • Twitter
  • Facebook
  • Youtube
  • Instagram
  • Github
  • Rss

Owin Self-Host ile Swagger Web API Tools Kullanımı

Web API  /  13.01.2018  /   2 dk.

Merhabalar bu makalede restfull apilerimizi dökümante yapabildiğimiz son zamanlarda standart haline gelen Swagger’ ı self- host bir api da nasıl kullanabileceğimizi inceleyeceğiz. Ben uygulamayı bir console application üzerinde host yapacağım için bir console application oluşturuyorum. Daha sonra Nuget üzerinen Install-Package Microsoft.AspNet.WebApi.OwinSelfHost ile Owin kütüphanesini ekliyoruz. Kütüphane yüklendikten sonra yeni Startup.cs classını ekliyoruz.

Web API

MapHttpRoute ayarlarımızı tanımlıyoruz. Startup sınıfımızı tamamladıktan sonra projemize ValuesController isminde bir class ekliyoruz.

Web API

ValuesController içerisine ilgili metotlarımız tanımlıyoruz. Metotlar üzerinde comment eklediğimizde Swagger başığında bu commentler listelenecektir.

ValuesController tanımlaması bittikten sonra Program.cs içerisinde servisi ayağa kaldırmalıyız.

Web API

Projeyi build yapıp çalıştıralım.

Web API

Web API

Web Api sorunsuz bir şekilde yalıştı. Şimdi Swagger entegrasyonunu hazırlayalım. Self-Host uygulaması için Swagger entegrasyonunu Swashbukle kütüphanesi ile yapacağım. Install-Package Swashbuckle.Core kodu ile projemize ekliyoruz. Kütüphane projeye ekledikten sonra proje üzerinde Properties => Build => Output Path bölümündeki XML documentation file seçeneğini işartliyoruz. Bu şekilde comment çıktılarının yüklenen xml dosyasının yolunu alabiliyoruz.

Web API

Daha sonra Startup.cs içerisinde GetXmlCommentPath metodu ile Xml output path i döndürüyoruz.

Web API

Configuration ayarlarında Swagger’ı çalıştırmalıyız.

Web API

IncludeXmlComments tanımına GetXmlCommentPath’ ı set ediyoruz. Bu şekilde Self-Host uygulamaya Swagger entegrasyonunu eklemiş oluyoruz. Bir sonraki makalede görüşmek üzere.

Not: Bu makale için düzeltme yada ekleme yapmak isterseniz buradan pull request yapabilirsiniz.

Etiketler
  • webapi
  • swagger
  • selfhosted
  • owin
  • .netcore
Kategori
Web API
paylaşım alanı
  • Twitter
  • Facebook
  • Pinterest
  • Google Plus
Abone
Email abonesi olabilirsin
SON YAZILAR
  • JavaScript Koşulları Nelerdir?
  • JavaScript Operatörleri Nelerdir?
  • JavaScript Nedir, Ne işe Yarar?
  • Web API - Action Based Routing
  • Web API - Convention Based Routing
  • Github Pages ve Jekyll ile Web Sitesi Yapmak
  • ASP.NET MVC & AdminLTE Kullanımı
  • Owin Self-Host ile Swagger Web API Tools Kullanımı
  • Visual Studio Code ile Asp.Net Core Web API ve EntityFramework.Core Kullanımı
  • Devexpress ile Report Designer kullanımı
Murat Süzen

C# ile uygulama geliştirir, Angular ile ilgilenir. Evli ve İstanbul'da yaşar. Araştırmadan kalan zamanlarda PS oynamayı çok sever.

Kategoriler
Devexpress (1)
Web API (4)
ASP.NET MVC (1)
Ruby (1)
Javascript (3)
Etiketler

Devexpress | csharp | entityframeworkcore | vscode | webapi | .netcore | swagger | selfhosted | owin | aspnet mvc | adminlte | jekyll | github pages | ruby | web api routing | javascript |

  • Ana Sayfa
  • Kütüphane
  • Arşiv

Bu sitedeki yazıların tüm hakkı ®Murat Süzen'e aittir. © 2019