31 Mayıs 2018 Perşembe

Asp.Net Web Api - Swagger Dökümantasyon Alt Yapısı Ekleme


Backend tarafında rest api alt yapısı geliştirirken en büyük problemlerden biri şüphesiz ki bu API endpointlerini kullanacak kişilerle çok iyi iletişim kurabilecek bir dökümantasyon oluşturmak ve tabi bunun yanında kendi apilerini test caseler dışında kod yazmadan minimum efort ile manuel test edecek bir ortam olması.

Daha önce .Net ile Rest Api geliştirirken Microsoft un sunduğu Help Page alt yapısından bahsetmiştim, buraya tıklayarak bu yazıma ulaşabilirsiniz. Microsoft bu tarafta bize her ne kadar hem yardım dökümanı oluşturma ve test edebilme üzerine güzel nuget package lar sunsa da , bu işi daha profesyonel, görsel ve fonksiyonel bir şekilde swagger ile yapabiliyoruz.

Peki .Net Web Api projemizde swagger alt yapısını nasıl kullanabiliriz ?

(Normalde swagger ın .Net e özel nuget ı olsa da uygulaması biraz zahmetli ve uzun olduğu için ben kendi bulduğum kurulumu çok basit bir nuget package üzerinden anlatıyor olacağım.)

Bu işlem oldukça kolay aşağıdaki adımları izlememiz yeterli.
1-) İlk olarak swagger için gerekli xml dökümantasyon sistemini projemizde aktif etme işlemini yapıyoruz.
 Bunun için projemize sağ tuş tıklayarak 'Properties' seçeneğine tıklıyoruz. Ardından 'Build' sekmesine geçip, 'XML Documentation File' check ini işaretliyoruz.

2-) Sonrasında projemize sağ tuş tıklayıp - > 'Manage Nuget Packages' seçeneğine tıklıyoruz.

3-) Browse Sekmesine 'Swashbuckle' yazıp aratıyoruz.

4-) İlk çıkan kayda tıklayıp 'Install' diyoruz.

5-) Ardından projemizi çalıştırıp url ye ek olarak /swagger yazıyoruz.

6-) Ve swagger kütüphanemiz hazır :)


Yunus Emre Web Developer

Morbi aliquam fringilla nisl. Pellentesque eleifend condimentum tellus, vel vulputate tortor malesuada sit amet. Aliquam vel vestibulum metus. Aenean ut mi aucto.

11 Mayıs 2018 Cuma

Angular5 Build Prod with base href


In normally angular2 and higher version projects building for prod with following command;



ng build --prod 


But sometimes we need to subdomain like domainname.com/subdomainname/ , in this situation we need to use base-href command to deploy properly otherwise it won't be work without console error.

To use base-href and define subdomain whichs is work like a directory, we just need to use following command:


ng build --prod --base-href /subdomainname/



with this command , we can solve this issue and deploy our project without any problem..
Yunus Emre Web Developer

Morbi aliquam fringilla nisl. Pellentesque eleifend condimentum tellus, vel vulputate tortor malesuada sit amet. Aliquam vel vestibulum metus. Aenean ut mi aucto.

5 Mayıs 2018 Cumartesi

angular5 projemize nasıl html editor ekleriz ?


Angular5 projemize basit bir html editor implemente etmek için aşağıdaki aşamalrı uygulamamız yeterlidir.



1. cmd ekranını açıyor ve proje dosyamızı açıyoruz.

örnek : cd /projedosyamız
cd /projedosyamız

2. proje dosyamızda node package manager yardımı ile ngx editör pluginini indiriyoruz.

npm install ngx-editor --save

3. app.module.ts dosyamızda import kısmına plugin tanımını yapıyoruz.

import { NgxEditorModule } from 'ngx-editor';
@NgModule({
  imports: [ NgxEditorModule ]
})


4. ve son olarak ilgili modülü kullanmak istediğimiz html dosyamıza aşağıdaki kod parçası ile ekliyoruz.

<app-ngx-editor [(ngModel)]="htmlContent"></app-ngx-editor>




Kaynak : https://www.npmjs.com/package/ngx-editor




Yunus Emre Web Developer

Morbi aliquam fringilla nisl. Pellentesque eleifend condimentum tellus, vel vulputate tortor malesuada sit amet. Aliquam vel vestibulum metus. Aenean ut mi aucto.