NodeJS, MongoDB ve Angular 8 ile Full Stack Proje Oluşturmak

Selamlar,

Bu makalede, NodeJs ile oluşturduğumuz servisler ile MongoDB’den çektiğimiz kayıtları, Angular 8 bir sayfada göstereceğiz.

Bu uygulama, Mac OsX (Catalina 10.15) ortamında kodlanacaktır. Öncelikle makinanızda Homebrew yok ise, bash’e aşağıdaki komutun yazılması ile kurulur.

  • # Eğer va ise Homebrew paket yöneticisini aşağıdaki komut ile update edelim.

  • # Homebrew’e MongoDB yükleme komutunu verelim.

  • # root dizininde /data/db klasörü oluşturulur (Yönetici olarak) : Aşağıda görülen “username” kısmına, kendi kullanıcı adınızı giriniz(Örnekler: borakasmer). MongoDb’de ilgili db yolu, default olarak bu izin verilen ve tanımlanan path’dir.
  • mongod : “data/db” eğer standart root altına tanımlanmış ve ilgili user için yetki verilmiş ise, monogoDb bu komut ile ayağa kaldırılır.

  • NOT: [CATALINA] Mac’de, en son gelen CATALINA işletim sistemi kurulu ise, root’a herhangi bir folder yaratılamaz. Çünkü artık readonly’dir :) Bu projede, “data/db” klasörü, “/Users/borakasmer” altına taşınmış ve aşağıdaki komut ile “mongod” komutu çağrılmıştır. “–dpath” ile, mongoDB’nin çalışacağı root dışındaki database’in yolu tanımlanmıştır.
  • sudo mongod –dbpath /Users/borakasmer/data/db

1.Yol :

Eğer her seferinde yukarıdaki komut yerine “mongod” komutu yazılarak işlem yapılması istenir ise:

  • “nano ~/.bash_profile” : Komutu ile profile dosyası açılır.
  • “alias mongod=”echo <YourPassword> | sudo -S mongod –dbpath <YourPath>” : İçerisine aşağıdaki komut eklenir. <YourPassword> yerine makina açılış şifreniz ve <YourPath> yerine “data/db” folder’ının taşındığı path yazılır. Örneğin bu projede ‘/Users/borokasmer/data/db’ yazılmıştır.
  • Ctrl + O
  • Enter

2.Yol (Tercihen): İlk yol, yukarıda görüldüğü gibi Password’ün “.bash_profile”‘a yazılmasından güvenlik açığına neden olmaktadır. Bu yol için, Furkan Kalkan‘a ayrıca teşekkür ederim.

1-) .bash_profile: Yukarıda eklenen satır, aşağıdaki gibi değiştirilir: Görüldüğü üzere, “sudo” ile çalıştırılan “mongod” komutu için gereken “Password” kaldırılmıştır.

2-) Geldik “mongod” komutu yazıldığında şifrenin istenmemesinin sağlanmasına. Öncelikle “mongod” komutunun gerçek path’i, aşağıdaki komut ile bulunur: İçinde “bin/mongod” geçen path alınır.

3-) Şimdi sıra geldi “mongod” komutu için, “borakasmer” user’ına “NOPASSWD” yetkisinin verilmesine. Kendi username’inizi bulmak için, aşağıda görüldüğü gibi “whoami” komutunu kullanabilirsiniz.

Password isteğinin sudo mongod komutu için kaldırılması amacı ile, “sudoers” dosyası aşağıdaki komut ile “visudo” kullanılarak değiştirilir.

  • Aşağıda görüldüğü gibi “# root and users in group wheel can run anything on any machine as any user”‘ açıklamasının olduğu yere, klavyenin aşağı ok tuşuna basılarak gelinir.
    • Not: Ekranda en aşağıda gözüktüğüne bakmayın.
  • Cursur’u, yazılacak boş alana getirip “A” tuşuna basılır.
  • Sonra “ESC” tuşuna basılarak, visudo’nun “INSERT” komutunun girilmesine hazır hale getirilir.
  • borakasmer ALL=(root) NOPASSWD: /usr/local/Cellar/mongodb-community/4.2.0/bin/mongod” komutu yazılarak, borakasmer’in sudo ile çalışan mongod komutu için, şifre istememesi sağlanır.
  • Satırın sonunda “:” tuşuna basılır.
  • Sizden bir komut isteyecektir. Çıkış için “wa” komutu yazılır.
  • “Enter” tuşuna basılarak, sudoers dosyası kaydedilip çıkılır.

Böylece “mongod” komutu yazıldığında, aslında ==>”sudo mongod –dbpath /Users/borakasmer/data/db” komutu şifre girilmeden çalıştırılmış olunur.

Makinanızda NodeJs yok ise, buradaki link’den indirebilirsiniz.

Bu projede IDE olara Visual Studio Code(1.29.1) kullanılmıştır.

MongoDB’yi ayağa kaldırma: Terminalde, aşağıdaki komut yazılarak mongoDB ayağa kaldırılır. Default port’u: “localhost:27017”‘dir.

Aşağıdaki komut yazılarak mongo Shell’e geçilir.

Amaç: MongoDb’de, örnek amaçlı document yaratmak.

users.js: Elimizde, örneğin aşağıda görülen kayıt gibi onlarca datanın bulunduğu bir users.js dosyası olsun. İlgili dosya, bu link‘den indirilebilir.

  1. Adım : People DB oluşturmak: Mongo Shell ortamında, aşağıdaki komut ile ilgili user.js’deki tüm kayıtlar, MongoDB altında People adında bir database ve onun altında Users collection’ının içine doldurulur. Her şeyi tek komut ile yapmak, paha biçilemez :)

Bakalım mongoDB çalışıyor mu ?

  • “use people” : People database’i kullanılacak anlamına gelmektedir.
  • “db.users.findOne()”: users tablosundaki(dökümanındaki), ilk kayıt getirilir.
  • “db.drobDatabase()” : Oluşturulan People DB’si, silinir. Siz silmeseniz de olur. Spor amaçlı, silinip tekrar oluşturulmuştur.
  • “mongoimport –db people –collection users –jsonArray users.js” : Komutu ile mongoDB’ye People DB’si tekrardan oluşturulmuştur.
  • “db.users.find()” : Tüm user datası getirilmiştir.

Sık sorulan sorulardan biri de MongoDB için Mac’de veya PC’de hangi Visual Manager Tool’un kullanıldığıdır. Ben Mac’de ve Pc’de de aynı uygulamayı kullanıyorum. Bu örnekte Robomongo kullanılmıştır. Yeni adı Robo 3T olmuştur. İndirme link’i ve ekran görüntüsü aşağıdaki gibidir. Tamamen ücretsizdir :)

https://robomongo.org/download

Öncelikle, eğer makinanızda “Express” global olarak kurulu değil ise, aşağıdaki komut ile sadece proje içerisine eklenir. Neden bu uygulamada “Express” tercih ettim de “NestJs” tercih etmedim. Çünkü bana çok daha basit ve yalın geldi. Ama çok daha kapsamlı projelerde “NestJs” tercih edilebilir.

Not: Express kütüphanesini global olarak makinanıza kurmak isterseniz, aşağıdaki komut satırını yazmanız gerekmektedir.

service.js(1): NodeJs’i test amaçlı yazılan function, aşağıdaki gibidir:

  • “var express = require(“express”)” : Express kütüphanesi tanımlanır.
  • “app.get(‘/’, function (req, res) {” : Ana root’da direk ==>”http://localhost:9480/” çağrılır ise bu function çalışır.
  • “res.send(“Selam Millet @coderBora”)” : Geriye result olarak, yukarıdaki mesajı dönecektir.
  • “app.listen(9480)” : NodeJs’de default port atamak, bu kadar basittir :)

Yukarıdaki kod, aşağıda görüldüğü gibi Debug segmesinden Environment, Node.js seçilerek çalıştırılabilir.

Şimdi gelin NodeJs’i mongoDB’ye bağlayan ve tüm kaydı bir list olarak dönen kodu yazalım.

NodeJs’de mongoDB’ye bağlanmak için, bu örnekte mongoose kullanılmıştır. Aşağıdaki komut ile ilgili kütüphane indirilir.

Users.js‘den gelen örnek data, aşağıdaki gibidir:

service.js(2): Aşağıda görüldüğü gibi MongoDB üzerinde, people DB’sine bağlanılmıştır.

  • “var mongoose = require(“mongoose”)” : mongoose kütüphanesi projeye eklenir.
  • “mongoose.connect(‘mongodb://localhost/people’)” : MongoDB‘de ==> People database’ine bağlanılır.
  • “var humanSchema = new mongoose.Schema({” : Bu bizim view modelimizdir.
  • * “var Human = mongoose.model(‘Human’, humanSchema,’users’)” : Burada Human nesnesine, tanımlı ‘humanSchema” view modeli ile mongoDB’deki ‘users’ collection’ı eşleştirilerek atanmıştır.
  • * “app.get(“/people”, function (req, res) {” : NodeJs’de routing bu kadar basittir :) “/people” keyword’ü ile, ana root’un sonuna people yazılarak, ilgili function’a erişilir.
  • “Human.find(function (err,doc){” Tüm kayıdın çekildiği komut, mongoose kütüphanesinde find()‘dır.
  • “res.send(doc)” : Gelen tüm kayıt, geri dönülür.

Sonuç :  Yukarıdaki servisin çıktısının bir kısmı, aşağıdaki gibidir.

Gelin şimdi özel bir kolon ekleyelim. Kısacası mongodb’den dönmeyen bir kolonu, araya girip biz ekleyelim. Name alanındaki, “first” ve “last” alanlarını birleştirip “fullName” kolonuna ekleyelim.

  • “humanSchema” : İlgili modele “fullName” property’si eklenmiştir.
  • “doc.forEach(function (item)” : Servisden tüm kayıtlar çekildikten sonra, içinde gezilir.
  • “item.fullName=item._doc.name.first+ ‘ ‘ + item._doc.name.last : fullName alanına, name objesinin first ve last propertyleri birleştirilerek atanır.

Sonuç : Aşağıda görüldüğü gibi, DB’de olmayan fullName alanı, first ve last alanları birleştirilerek doldurulmuştur.

getPeopleListBypaging(): Girilen sayfa sayısı ve herbir sayfada olması gereken satır sayısı, parametre olarak gönderilir. Kısacası paging işleminin yapıldığı method budur.
  • “var page” : Bulunulan sayfa parametre olarak gönderilir.
  • “rowCount” : Bir sayfadaki toplam satır sayısı.
  • “skip() – var skip = page * rowCount” : Seçilen sayfaya göre toplam kayıt sayısı bulunur ve o eleman sayısı kadar atlanıp, sayfada gösterilir.
  • “.limit(rowCount)” : Çekilecek kayıt sayısı belirlenir.
  • “.exec()” İçine konan function çalıştırılır. Aşağıdaki örnekte isim(first) ve soy(last) ismi birleştirip fullName alanına atanmıştır.

Şimdi gelin isterseniz username ve last(soyadı) bilgisine göre filitre yapan Nodejs functionlarını yazalım. 2 farklı parametre alma şekli, bu functionlarda gösterilmiştir.

getpeopleByUsername: Aranan kişinin, kullanıcı adına göre filitrelendiği methoddur. Burada ilgili parametre “/:name” şeklinde karşılanmaktadır.

  • “var query = { username: req.params.name }” : Username’e göre filitrelemenin yapıldığı satırdır. Gelen parametre req.params.name şeklinde alınmaktadır.

getpeopleByLastname : Aranan kişinin, soyadına göre filitrelendiği methoddur. Burada ilgili parametre url parameter’dır. Url tarafından “?lastname=ryan” şeklinde çağrılmaktadır.

  • “var query = { “name.last”: req.query.lastname };” : Soyad’a göre filitrelemenin yapıldığı satırdır. Gelen parametre, req.query.lastname şeklinde alınmaktadır.

last(Soyada)’a Göre Örnek Sorgu :

Username’e Göre Örnek Sorgu :

Şimdi sıra geldi Document’a Insert yapan functiona:

body-parser : Öncelikle request.body’ye gelen sınıfın (human) parse edilip alınabilmesi için, ilgili kütüphanenin aşağıdaki gibi uygulamaya eklenmesi gerekmektedir.

body-parse, projeye aşağıdaki gibi implemente edilir.

Insert MongoDB  insertPeople(): Aşağıda görüldüğü gibi, asenkron Insert bir function yazılmıştır.

  • Kaydetma amaçlı gönderilen Human model ==> body-parse sayesinde, req.body şeklinde alınır.
  • “var person = new Human(req.body)” : Kaydedilecek yeni person document oluşturulur.
  • “var result = await person.save()” : Gönderilen data mongoDB’ye kaydedilir.

Not : res.send(result)” şeklinde başarılı olduğuna dair geri dönüş, ilerde bize sorun çıkarıcaktır. İlgili geri dönüş angular 8 tarafında hata olarak alhılanacaktır. Bunun önüne geçmek için “return res.status(200).json({ status: “succesfully delete” })” şeklinde bir geri dönüş yapılabilir.

Postman üzerinden NodeJs insertPeople() function’ına, aşağıdaki gibi yeni bir document post edilir.

Update MongoDB : updatePeople(): Aşağıda görüldüğü gibi asenkron Update bir function yazılmıştır.

  • “var updatePerson = new Human(req.body)” : Servise gelen güncel data, updatePerson modele alınır.
  • “const person = await Human.findOne({ username: updatePerson.username })” : Güncellenecek olan document, unique “username” ile bulunur.
  • await person.updateOne(updatePerson) : Asenkron olarak güncelleme işlemi yapılır.

Postman üzerinden NodeJs updatePeople() function’ına, aşağıdaki gibi güncellenecek document post edilir.

Delete MongoDB : deletePeople(): Aşağıda görüldüğü gibi, Delete bir function yazılmıştır.

  • “Human.findOneAndRemove({ username: deletePerson.username })” : Silinecek document, username’e göre bulunup silinmiştir.
  • “.then(function (doc) {” : Silinecek document’in bulunup bulunmadığı, doc parametresinden anlaşılmıştır.
  • “if(doc) return res.status(200).json({ status: “succesfully delete” })” : İlgili document’in bulunduğu ve doğru şekilde silindiği anlamına gelir.
  • “else return res.send(“no document found!”)” : Böyle bir document’ın bulunamaması durumunda, ilgili mesaj dönülür.

Postman üzerinden, NodeJs deletePeople() function’ına, aşağıdaki gibi silinecek kayıt post edilir.

Postman üzerinden NodeJs deletePeople() function’ına, aşağıdaki gibi olmayan (borsoft12) username’li bir kayıt post edilerek silinmeye çalışılmış ve “no documnet found!” hatası alınmıştır.

1-Arama : getpeopleStartsWith() Şimdi sıra geldi aranan kelime ile başlayan isimlere ait kayıtların getirilmesine. Aşağıda görüldüğü gibi regex kullanılmıştır. Aranan kelimenin başına “^” konması ile aranan kelime ile başlıyan tüm kayıtlar getirilmiştir. Örnek  ==> ismi name.first “^ar” ile başlıyan kayıtlar getirilir.

2-Arama, Sıralama, Limit, Atalama : getpeopleContainsOrderTopWith() Bu functionda da “name.first”, yani isminin içinde aranan kelime geçen (name), belli bir sayıdaki (top) tüm kayıtlar, ilk kayıt atlanmak şartı (skip(1)) ile isme göre tersten sıralanarak (sort) getirilmiştir. Aşağıda görüldüğü gibi regex kullanılmıştır. Örnek  ==> ismi name.first “ar” içinde geçen, ilk kayıt hariç, toplam 2 kayıt getirilmiştir.

  • “var query = { “name.first”: { $regex: req.params.name } }” : İçinde name parametresi geçen kayıtlar, filitrelenmiştir.
  • “var top = parseInt(req.params.top)” : Çekilecek olan kayıt sayısı, top parametresinden sayısal (int) değerine çevrilerek alınmıştır.
  • “.sort(‘-name.first’) : İsme göre tersten sıralanmıştır.
  • “skip(1)” : ilk kayıt atlanmıştır.
  • “limit(top)” : Toplam çekilecek kayıt sayısı belirlenmiştir.

Angular 8 Ara yüz : Sıra geldi tüm bu servislerin kullanılacağı ara yüze. Aşağıdaki komut ile yeni bir Angular 8 projesi (HumanResource) oluşturulur.

İlk sayfa, tüm kayıtlı çalışanların listelendiği sayfadır. Bu projede, bootstrap ile çalışılacağı için “<head></head>” tagları arasına aşağıdaki css ve script kodları yazılmıştır.

Index.html:

Model/(Person): Yeni bir model sınıfı aşağıdaki gib oluşturulup, model klasörü altına konur.

Service / personService: Aşağıda görüldüğü gibi NodeJs services’den people() servisi buradan çağrılır.

  • baseUrl: string = “http://localhost:9480/people” : NodeJs’den ilk çağrılacak, tüm personelin çekildiği servis yoludur.
  • headers: new HttpHeaders({ ‘Content-Type’: ‘application/json’ }) : Servise ile Json formatında içerik alınacağı tanımlanır.
  • public getPeopleList(): Observable<Person>  : NodeJs people() servisinden, Observable şeklinde data çeken methoddur.
  • .pipe() : Methodlar birbiri ardına sıraya konur.
  • retry(1) : Hata olması durumunda, işleme 1 kere daha tekrar edilirin havalı yolu:)
  • errorHandel(): Hatanın, server-side’dan mı yoksa client-side’dan mı olduğu belirlenip, consola yazdırılır.

İlgili personService, aşağıda görüldüğü gibi app.module.ts’e eklenir.

app/app.module.ts: [FormsModule, HttpClientModule] imports‘a eklenir. PersonService de providers’a eklenir.

app.component.ts: Aşağıda görüldüğü gibi [Dependency Injection] ile PersonService constructor’da alınmıştır.

  • “this.service.getPeopleList().subscribe((data: any:[]) => {” : İlgili data, servisden çekildiği zaman, subscribe nesnesi şeklinde geri dönülmektedir.
  • “this.peopleList = data.slice(0,5);” :Tüm çekilen datanın, [] array peopleList’e, ilk 5 kaydı aktarılır. Yani proje ilk ayağa kalktığı zaman ilk 5 kayıt ekrana basılır.

İlk örnek için app.component.html, aşağıdaki gibidir.

app.component.html :

Uygulama çalıştırıldığında ilk servis isteği,  NodeJS üzerinde “http://localhost:9480/people” adresine yapılır. Ve “No ‘Access-Control-Allow-Origin‘” no-cors hatası alınır. Bunun nedeni request çekilen url ile nodeJs’in portlardan dolayı aynı domain üzerinde görünmemesidir. Çözüm cors kütüphanesinin aşağıdaki gibi kurulmasıdır.

service.js : Cors hatasına düşmemek için, alttaki satırlar eklenir.

.

Paging : Sıra geldi, sayfa üzerinde paging yapmaya.

personService.ts(2)‘e aşağıdaki paging methodu eklenir. Sayfalama yapılacak NodeJs methodu çağrılır. Her sayfa için static 5 kayıt çekilmektedir.

Not: Bu “5” değerinin, bir config dosyadan okunması çok daha sağlıklı olacaktır.

app.component: Sayfa üzerine önceki ve sonraki buttonları konacaktır. İlgili buttonlar tıklanınca, alttaki methodlar çağrılacaktır. Sayfa sayısı Next() butonunda 1 artarken, Preview() butonunda 1 azalır, ancak 0’dan düşük olamaz. Ayrıca currentPagecount=1 ise yani ilk sayfada ise, isPreviewActive=false değeri atanır. Böylece “Önceki” buttonu, pasif hale getirilir. Next() methodunda eğer hiçbir kayıt gelmez ise, “currentPagecount”  değeri “-1” yapılarak eski haline geri getirilir. Kısaca sayfa sayısı, kayıt yok ise arttırılmaz. Ayrıca “isNextActive” değişkenine false değeri atanarak, “Sonraki” buttonun pasif hale gelmesi sağlanır.

app.component.html: Header kısmı, aşağıdaki gibi değiştirilir.

  • [disabled]=”!isPreviewActive” : İlk sayfada, false değeri atanarak geri buttonunun tıklanamaması sağlanır.
  • disabled]=”!isNextActive” : Son sayfada ise, false değeri atanarak ileri buttonunun tıklanamaması sağlanır.

Edit : Sıra geldi seçilen kaydın düzenlenmesine.

personService.ts: Aşağıda görüldüğü gibi güncelleme yapılacak Person model, Nodejs servisine post edilmiştir.
  • “pipe()”: Methodları bir sıraya konur.
  • retry(1)”: Hata olması durumunda, son bir tekrar daha yapılır.

app.component.html (Güncelleme):

  • “<div *ngIf=”!isEdit”>” : Aşağıda görüldüğü gibi resim ve başlık yeni bir div’in içine alınıp, “isEdit” değişkenine bağlanmıştır. Güncellenme anında, bu div gizlenecektir.
  • “<table class=”table table-dark” *ngIf=”isEdit”>” : Yeni bir table eklenerek, güncellenecek personModel için ilgili bazı alanlar bu tablonun içine konmuştur. Sadece çalışanın, unvan’ı, adı, soyadı ve email’inin değiştirilmesi amaçlanmıştır.
  •  “<button type=”button” class=”btn btn-success btn-sm move-right” (click)=”Edit(people)”>Edit</button>” : Soldaki edit buttonuna basılınca, “Edit(people)” methodu çağrılmaktadır. Edit() methodu makalenin devamında anlatılacaktır.
  • “<input type=”text” [(ngModel)]=”personModel.name.title”>” : Tüm input alanlar, makalenin devamında anlatılacak olan personModel‘in propertylerine two way binding “[(ngModel)]” şeklinde bağlanmıştır.
    • Bu demek oluyor ki, input alanlarda yapılan bir değişiklik, listelenen grid içerisindeki alanlarda da anlık olarak gözlemlenebilecektir.
  • “<input type=”button” value=”Kaydet” (click)=”Save()” class=”btn btn-success”>” : Tıklanma durumunda, Save() methodu çağrılmıştır.

Not: Makalenin çok daha uzamaması için, alanlarla ilgili input validationlar yapılmamıştır.

app.component.ts:

  • Edit() işlemi olduğu zaman, sayfanın üstünde yazan title ve resmin gizlenmesi için “isEdit=true” değeri atanır.
  • Güncellenecek modele, (“personModel=data“) seçilen yani edit buttonuna basılan satırdaki person data atanır.
  • Save() işleminde, ilgili servise güncellenecek data(personModel) gönderilir.
  • “this.personModel = null” ==> gönderilen model temizlenir. Bu şeklide, düzenleme için kullanılan input alanların içerisi boşaltılır.
  • “this.isEdit = false” : Tekrar sayfanın üstündeki başlık ve resmin geri getirilip, güncelleme tablosunun kaldırılması için isEdit ==> false değeri atanır.

Not: service.cs(NodeJs) (Güncelleme): Aşağıda görüldüğü gibi, ilgili servisin dönüşünde bir string açıklama döndürmek “res.send(“succesfully saved”)“, client side tarafta hata olarak algılandı. Bunun önüne geçmek için, dönüş tipi değiştirilerek, “true” değeri dönülmüştür.

 

Arama :

Gelin bir örnek de arama için yapalım: Girilen harflerle adı başlayan tüm kayıtları getirelim. Aşağıda görüldüğü gibi NodeJs’deki “getpeopleStartsWith()” çağrılmış ve Observable<Person> şeklinde kayıt dönülmüştür.

personService.ts:

app.component.html : Aşağıda görüldüğü gibi dataların listelendiği tablonun head’ine, “userSearchInput” adında bir search box konmuştur. İlgili input’a, app.component.ts tarafında erişilecektir.

app.component.ts: Öncekine göre bazı değişikliklere gidilmiştir. Tüm kod yazılmamıştır. Sadece değişen ve eklenen yerler yazılmıştır. Yeni eklenen özellik, kişilerin isme göre aranmasıdır.

  • Birçok “rxjs” ve “rxjs/operators” kütüphanesi sayfanın başına eklenmiştir.
  • “AppComponent implements AfterViewInit” : Artık “OnInit“‘den değil “AfterViewInit“‘den türetilmiştir. Nedeni, sayfanın tamamen yüklenmesinin beklenmesi ve “userSearchInput” input elementine erişilebilmesindendir.
  • “@ViewChild(‘userSearchInput’, { static: false }) userSearchInput: ElementRef” : Html sayfada konan “userSearchInput” id’li element’e, app.component.ts tarafından erişilir.
  • “isGetPeople:boolean=false” : Aramada input alandan harfler silinirken, 3 karakterden az olması durumunda tüm kayıdın sadece 1 defa çekilmesini sağlayan bir değişkendir.
  • “ngAfterViewInit() {” : Tüm sayfanın yüklenmesi bittikten sonra, çağrılan function’dır.
  • “this.getPeople()” : En başta, tüm kayıt çekilip ekrana basılır.
  • “fromEvent(this.userSearchInput.nativeElement, ‘keyup’).pipe(” : “userSearchInput” html elementinin “keyup” eventi yakalanıp, “pipe()” ile birden fazla method işleme konmuştur.
  • “map((event: any) => {” Input alana girilen karakter alınır.
  • “event.target.value.length < 3 && !this.isGetPeople ? this.getPeople() : null” : Name alanına girilen karakter sayısı, 3’den az ise tüm kayıdın çekildiği “getPeople()” methodu çağrılır. “isGetPeople” değişkeni, eğer tüm kayıt birkere çağrılmış ise her karakter silme işleminde peş peşe tekrardan çağrılmasının önüne geçilmek amacı ile konmuştur.
  • “, filter(res => res.length > 2)” : Girilen karakter sayısı, 2’den fazla ise işleme devam edilir.
  • “, debounceTime(250)” : Herbir tuşa basıldığında 250milisaniye beklenmektedir. Amaç hızlıca girilen karakterler için, birkere search işlemi yapmaktır. Aksi taktirde, girilen her bir karakter için arama sorgusu yapılacak, ve bu durumda büyük bir zaman – performans kaybına gidilecektir.
  • “, distinctUntilChanged()” : Bu method sonradan kaldırılmıştır. Bir önce aranmış kayıdın aynısı girilir ise, engel olmaktadır.
  • “this.service.searchPeopleByName(text).subscribe((res) => {” : Yukarıdaki tüm aşamalar geçilmiş ise, girilen karakter ile ismi başlıyan tüm kayıtlar çekilir.
  • “getPeople() {” : Methoduna “this.isGetPeople=true” şeklinde değişkene değer atanarak, aram kutucuğunda karakter silme durumunda tüm kayıt çekilmiş ise tekrardan çekilmesi engellenmiş ve böylece büyük bir performans kaybı gidilmesi önlenmiştir.

Insert : Yeni Kayıt

Öncelikle gelin Angular’da servis tarafını yazalım:

Service / personService.ts: Aşağıda görüldüğü gibi NodeJs tarafında insertPeople() function’ına kaydedilecek Person model, post edilmektedir.

  • httpOptions : Header’da post olarak gönderilecek “Person” datasının tipi, json olarak tanımlanmıştır.
  • “return this.httpClient.post<Person>(this.inserteUrl, JSON.stringify(data), this.httpOptions)” : Yeni girilen “Person” model, “insertPeople()” NodeJs methoduna json olarak gönderilir.
  • pipe() : retry() ve catchError() methodları birleştirilip bir sıraya konur.
  • retry(1): Hata çıkması durumunda bir tekrar yapılır.
  • getPeopleList() : Yukarıda önceden yazılan bu method, ihtiyaç doğrultusunda değiştirilmiştir. “desc” paramteresinin “true” olması durumunda, NodeJs’in “peopleDesc()” metodu ile, yeni bir kayıt eklendiğinde, kayıtlara mongo’nun her bir document için atadığı “_id” değerine göre, tersten sıralanıp çekilmesi sağlanmıştır. Böylece son kayıt yani yeni girilen kayıt, en başa gelmektedir.

NodeJs/service.js : Yeni bir kayıt eklendiğinde, çekilen listede en başta gelmesi için NodeJs’e eklenmiş yeni bir methoddur. Normalde Person model’de “_id” alanı yoktur. İlgili alan, mongoDB tarafında atanmaktadır. Burda da tersten sıralama amacı ile “.sort(‘-_id’)” kullanılmıştır.

Şimdi sıra geldi Html sayfanın doldurulduğu app.component’e. Sadece yeni eklenen ve değiştirilen kısımlar aşağıda yazılmıştır.

app.component.ts :

  • “isInsert” : Bu değişken yeni bir kayıt girişi olucağı zaman “true” değerini almakta, böylece edit için açılan alanlar haricinde yeni bir kayıt girmek için ekstra gerekli olan “UserName” ve “Gender” comboları açılmaktadır. Ayrıca kaydet button’u, bu değişkene göre “Insert” ya da “Update” işlemine karar vermektedir.
  • “optionSelect [ ]” : “Gender” combosunun dolacağı 2 olasılık, bir dizi olarak kodda tanımlanmıştır.
  • “personModel” : Güncellenecek, ya da yeni girilecek modeldir.
  • “name” : Her yeni kayıt girişi için personModel’in, boş bir şablonunun çıkarılması gerekmektedir. Sonradan ayrıca tanımlanan Person sınıfının alt sınıfı olan “name” nesnesi boş olarak yaratılıp, person sınıfına atılmaktadır.
  • “isEdit” : Güncelleme buttonuna basıldığı zaman, editlenecek alana ait propertylerin sayfada gözükmesini ve Kaydet button’una basıldığı zaman “Güncelleme” işleminin yapılmasını sağlıyan bir değişkendir.

  • clickInsert() : New Record buttonuna basılınca, çağrılan methoddur. Yeni boş bir Person() model oluşturulur. Name alanı için “name()” sınıfı boş oluşturulup, “personModel“‘e atanır.
    • “this.isInsert = !this.isInsert” Tıklanma durumunda , eğer alanlar gösteriliyorsa gizlenir, gizleniyor ise gösterilir.
    • “this.isEdit = false”: Bu bir güncelleme işi değildir. Yani Insert işidir.
  • Edit() : Yeni eklenen tek satır budur. “this.isInsert = false” . Yeni kayıt girmek için görünen özel alanları gizler.
    • “this.isEdit = (this.personModel == data || this.isInsert==true) ? !this.isEdit : this.isEdit” : Eğer güncelleme buttonuna ardı ardına basılır ise, güncellenme amacı ile açılan alanlar kapanıp açılır. Eğer farklı kayıtlar için Edit tuşuna basılır ise, kapanma işlemi olmadan farklı kayıtların detay bilgisi ekrana basılır. Eğer önce yeni bir kayıt ekranına girilmiş ise, Edit tuşuna basılınca UserName ve Gender alanları gizlenir.
  • Save() : “isEdit” true ise “Güncelleme”, değil ise yani “isInsert” true ise “Kaydetme” işlemi yapılır.
    • this.service.insertPeople() : Yeni kayıt işleminden sonra ==> “this.getPeople(true)” tekrardan tüm person kaydı “-_id” alanına göre tersden sıralanarak alınmış ve böylece son kayıt üste gelmiştir.
  • “this.personModel = null; this.isInsert = false” : Tekrardan personmodel boşaltılmış, böylece FrontEnd tarafında doldurulan html alanların boşaltılması sağlanmıştır. Ayrıca isInsert ‘e false değeri atanarak, üstte açılan tüm alanların kapanması sağlanmıştır.

Model/Person: Aşağıda görüldüğü gibi, ilgili sınıfı new()’lenerek yaratılabilmesi için constructor() tanımlanmıştır. Not:  this.gender = “male” tanımlamasında amaç, Cinsiyet combosunun doldurulması anında, default değer olarak “male” seçeneğinin gelmesi daha model oluşturulurken sağlanmıştır. “Ağaç yaşken eğilir” :)

Model / Name : Person modelinin subclass’ı, Person sınıfının boş bir şablon şeklinde new ()’lene bilmesi için ayrıca tanımlanmıştır.

app.component.html: Yeni kayıt girişi yani, insert için gerekli güncellemeler yapılmıştır.

  • “<div *ngIf=”!isEdit && !isInsert”>” : Eğer Kaydetme ya da Güncelleme işi yok ise ilgili div gizlenir.
  • “<table class=”table table-dark” *ngIf=”isEdit || isInsert”>” : Kaydetme ya da Güncellem işi yok ise ilgili tablo gizlenir.
  • “<input type=”button” value=”Kaydet” (click)=”Save()” class=”btn btn-success”>” : Yeni bir kaydın girildiği ya da güncellendiği buttondur. Tıklanma anında “Save()” methodu çağrılmaktadır.
  • “<tr *ngIf=”isInsert”>” : “UserName” ve “Gender” alanları sadece Insert, yani yeni bir kayıt girişi için kullanılır.
  • “<button type=”button” class=”btn btn-success btn-sm move-right” (click)=”clickInsert()”>New Record</button>” : Yeni Kayıt buttonuna basılınca, eğer yeni personModel’inin dolacağa alanlar gizli ise gösterilir. Gözüküyor ise gizlenir. Tıklanma anında çağrılan method, yukarıda anlatılan “clickInsert()” methodudur.

Delete : Silme

Sıra geldi silme işlemine. Herbir kayıdın soluna “Edit” butonunun yanına, “Delete buttonu yukarıdaki gibi konulur. (click) eventinde “Delete()” function’ı ==> “username” parametresi ile çağrılır. Amaç, seçilen kaydın tekil username’e göre silinmesidir.

app/app.component.ts:

Service/personService.ts: Aşağıda görüldüğü gibi silmek amaçlı tıklanan “Person”, NodeJs üzerindeki “deletePeople()” servisine gönderilerek silinir.

  • “retry(1)” : Hata olamsı durumunda, bir seferlik tekrarlanır.

app/app.component.ts: Seçilen “Person”, silme onayı alındıktan sonra servise gönderilerek silinir. Silinmenin başarılı olması durumunda, “getPeople()” methodu çağrılarak tüm kayıtlar yeniden çekilip sıralanır.

Geldik bir makalenin daha sonuna. Bu makalede NodeJS ve MongoDB’ye bir giriş yaparken, Angular 8 ile de nasıl entegre edebileceğimizi gördük. MongoDB 4, hem kolay kullanım hem de performansı ile kıritik olmayan datalar ile çalışmak için tam bir biçilmiş kaftan. Ayrıca Robo 3T de, mongoDb için gerçekten çok başarılı ücretsiz ve kullanışlı bir ide. NodeJS’i, .Net Core  WebApi servisine çok benzeyen bir teknoloji olarak görüyorum. Kapsamlı projelerde kullanımı giderek zorlaşsa da, routing ve express ile kolay entegrasyonu beni bazı şeylerde neden bu kadar uğraşıyormusuz, tek satırla nasıl da işler bitiyormuş gibi düşüncelere sokmadı değil. Makale içinde OsX environment’da NodeJs ve MongoDB ile nasıl çalışılabileceği hakkında, küçük tiyolar vermeye çalıştım. Daha sırada NodeJS Sawagger entegrasyonu, security tokenization, validationlar, microservice ler gibi birçok konu var. Bunları da ya bir ebook ya da makale olarak size aktarmaya çalışacağım.

Yeni bir makalede görüşmek üzere hepinize hoşçakalın.

Source Code : https://github.com/borakasmer/MongoDB-Nodej-Angular8-FullStack-Project

Kaynaklar :

Herkes Görsün:

Bunlar da hoşunuza gidebilir...

Bir cevap yazın

E-posta hesabınız yayımlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir