NodeJS Express PUT İsteği Hakkında Bilmeniz Gereken Her Şey

NodeJS çalışma zamanı ortamı, verimli olay güdümlü mimarisi ve JavaScript temeli sayesinde modern web uygulamaları oluşturmak için popüler bir seçim haline geldi. Bu ekosistem içinde, Express, geliştirme için sağlam ve düzenli bir yaklaşım sunan, öne çıkan bir web çerçevesi olarak öne çıkıyor.

Etkili web API'lerinin temel taşlarından biri, kaynaklarla nasıl etkileşim kurulduğunu belirleyen HTTP yöntemlerinin kullanılmasıdır. PUT yöntemi bu bağlamda önemli bir rol oynar ve geliştiricilerin mevcut kaynaklar üzerinde hedeflenen güncellemeler yapmasını sağlar.

NodeJS Express ile PUT istekleri yapmaya daha derinlemesine dalmadan önce, NodeJS ve Express'in ayrı ayrı ne olduğunu tam olarak anlayalım.

NodeJS Nedir?

NodeJS, JavaScript'in web tarayıcılarının dışında çalışmasına izin vererek kalıpları kıran, açık kaynaklı bir yazılımdır. Bu esneklik, farklı işletim sistemlerine yayılır ve onu geliştiriciler için çok yönlü bir araç haline getirir. Bu belge, NodeJS'in sunduklarına derinlemesine dalmakta, yeteneklerini ve yazılım geliştirmeye yaklaşımımızı nasıl değiştirdiğini incelemektedir.

NodeJS'in Temel Özellikleri

Olay Güdümlü Mimarisi

Geleneksel web sunucularının aksine, NodeJS iş parçacıkları kullanmaz. Bunun yerine, birden fazla isteği verimli bir şekilde işlemek için bir olay döngüsüne güvenir. Bu olay güdümlü yaklaşım, NodeJS'i sohbet uygulamaları veya gerçek zamanlı veri akışı gibi yüksek hacimli eşzamanlı bağlantılarla ilgilenen uygulamalar için ideal hale getirir.

JavaScript Her Yerde

NodeJS, kodu yürütmek için Google Chrome'a güç veren V8 JavaScript motorunu kullanır. Bu, geliştiricilerin hem ön uç hem de arka uç geliştirmesi için JavaScript kullanmasına olanak tanır ve birden fazla dil öğrenme ve yönetme ihtiyacını azaltır.

Engellemeyen G/Ç

NodeJS, engellemeyen bir G/Ç modeli kullanır. Bu, yavaş işlemlerin (bir veritabanından okuma gibi) bitmesini beklemeden diğer istekleri işlemeye başlaması anlamına gelir. Bunun yerine, yavaş işlem arka planda tamamlanırken bir sonraki isteğe geçer. Bu, sunucuyu duyarlı ve verimli tutar.

Zengin Ekosistem ve NPM

NodeJS, npm (Node Package Manager) adlı devasa bir paket yöneticisine katkıda bulunan geniş ve aktif bir topluluğa sahiptir. NPM, çeşitli işlevler için çok çeşitli önceden yazılmış modüller sunarak, geliştiricilere yeniden kullanılabilir kod bileşenleri sağlayarak zaman ve çaba tasarrufu sağlar.

Ölçeklenebilirlik

NodeJS uygulamaları kolayca yatay olarak ölçeklenebilir. Bu, artan trafiği işlemek için daha fazla çalışan sunucu ekleyebileceğiniz anlamına gelir ve NodeJS'i büyük ve karmaşık uygulamalar oluşturmak için uygun hale getirir.

Express Nedir?

Express, diğer adıyla ExpressJS, geliştiricilerin web uygulamaları ve API'leri daha kolay oluşturmasını sağlayan, NodeJS için popüler bir web çerçevesidir. Doğrudan NodeJS'in temel işlevleriyle çalışmaya kıyasla daha uygun ve yapılandırılmış bir yaklaşım sağlayan bir soyutlama katmanı görevi görür. Bu, tekrarlayan kodda (hazır kod) önemli bir azalmaya yol açar ve geliştiricilerin uygulamalarının temel mantığına odaklanmasına ve geliştirme sürecini hızlandırmasına olanak tanır.

ExpressJS'in Temel Özellikleri

Yönlendirme

ExpressJS, URL'leri gelen istekleri işleyen belirli işlevlere eşleyen rotaları tanımlamada mükemmeldir. Bu organizasyon, uygulama kodunuzu daha okunabilir ve bakımı kolay hale getirir.

Ara Katman Yazılımı

ExpressJS'in temel gücü, ara katman yazılımı işlevselliğidir. Ara katman yazılımı, istekleri ve yanıtları kesen, günlüğe kaydetme, kimlik doğrulama veya statik dosya sunma gibi ortak görevleri, istek son hedefine ulaşmadan önce gerçekleştirmenize olanak tanıyan mini uygulamalar gibi davranır.

Şablon Motorları

ExpressJS, EJS, Pug veya Handlebars gibi çeşitli şablon motorlarıyla sorunsuz bir şekilde entegre olur. Bu motorlar, HTML'yi sunucu tarafında oluşturulan içerikle birleştirerek dinamik HTML sayfaları oluşturmanıza olanak tanır.

Hata İşleme

ExpressJS, hata işlemede yapılandırılmış bir yaklaşım sağlar. Uygulamanızın genel kullanıcı deneyimini iyileştirerek, hataları zarif bir şekilde yakalamak ve yanıtlamak için özel hata işleyicileri tanımlayabilirsiniz.

Topluluk ve Ekosistem

ExpressJS, büyük ve aktif bir geliştirici topluluğundan yararlanır. Bu, web uygulamaları oluştururken geliştiricilere zaman ve çaba tasarrufu sağlayan çok sayıda hazır ara katman yazılımı, kitaplık ve kaynak anlamına gelir.

NodeJS Express PUT İstekleri Nasıl Yapılır?

PUT isteklerini çalıştırabildiğinizden emin olmak için, öncelikle sisteminizde NodeJS ve NPM'nin yüklü olduğundan emin olmanız gerekir.

Önkoşullar

İlk olarak, bir proje dizini oluşturun ve NPM kullanarak içinde bir NodeJS projesi başlatın:

mkdir nodejs-put-request
cd nodejs-put-request
npm init -y

Ardından, ExpressJS çerçevesini projeniz için bir bağımlılık olarak yükleyin:

npm install express

Adım 1 - Bir PUT Rotası Oluşturma

Proje dizininizde, server.js adlı bir dosya oluşturun. Bu dosya, ExpressJS uygulama mantığını içerecektir. Aşağıdaki kod parçacığı, temel bir PUT rotasını göstermektedir:

const express = require('express');

const app = express();
const port = 3000;

// Bellek içi veri deposu (üretim için bir veritabanı ile değiştirin)
let data = {
  id: 1,
  name: "John Doe",
  age: 30
};

// ID'ye göre verileri güncellemek için PUT rotası
app.put('/api/data/:id', (req, res) => {
  const id = req.params.id;
  const updatedData = req.body;

  // Güncellemeden önce verilerin varlığını doğrulayın
  if (data.id !== parseInt(id)) {
    return res.status(404).send("Veri bulunamadı");
  }

  // Nesne yayma sözdizimini kullanarak veri özelliklerini güncelleyin
  data = { ...data, ...updatedData };

  res.json(data);
});

app.listen(port, () => {
  console.log(`Sunucu ${port} portunda dinliyor`);
});

Kod Açıklaması

1. Express'i içe aktarıyoruz ve bir Express uygulama örneği oluşturuyoruz.
2. Örnek bir veri nesnesi bir yer tutucu görevi görür (bir veritabanı üretimde kullanılacaktır).
3. PUT rotası (/api/data/:id) URL'den bir ID parametresi yakalar.
4. Güncelleme girişiminde bulunmadan önce verilerin varlığı doğrulanır.
5. Veriler bulunursa, istek gövdesinden gelen güncellenmiş veriler, nesne yayma sözdizimi (...) kullanılarak mevcut veri nesnesiyle birleştirilir.
6. Son olarak, güncellenmiş veriler yanıtta JSON olarak geri gönderilir.

Adım 2 - Bir PUT İsteği Gönderme (Apidog Kullanarak)

Bir PUT isteği göndermeyi simüle etmek için, Apidog gibi bir araç kullanabilirsiniz.

Yapmanız gerekenler şunlardır:

1. HTTP yöntemini PUT olarak ayarlayın.
2. URL'yi http://localhost:3000/api/data/1 olarak tanımlayın (1'i istenen ID ile değiştirin).
3. Gövde sekmesinde, içerik türünü JSON olarak ayarlayın ve güncellemek istediğiniz verileri sağlayın (örneğin, {"name": "Jane Doe"}).
4. İsteği gönderin.

Aşağıdaki bölüm, Apidog'un sundukları hakkında daha fazla bilgi verecektir.

Önemli Hususlar ve En İyi Uygulamalar

Bu örnek, NodeJS Express ile PUT istekleri yapmaya yönelik temel bir gösterim olarak hizmet vermektedir. Gerçek dünya uygulamalarınıza ek özellikler eklemeyi unutmayın:

• Hata İşleme: Güncelleme süreci sırasında olası sorunları zarif bir şekilde yönetmek için sağlam hata işleme mekanizmaları uygulayın.
• Doğrulama: Gelen verilerin tanımladığınız şemaya ve kısıtlamalara uygun olduğundan emin olmak için doğrulayın.
• Veritabanı Entegrasyonu: Üretim uygulamaları için, kalıcı veri depolama için MongoDB veya PostgreSQL gibi bir veritabanı çözümü entegre edin.
• Ara Katman Yazılımı: Daha güvenli ve iyi yapılandırılmış bir uygulama için kimlik doğrulama, yetkilendirme ve günlüğe kaydetme gibi görevleri ele almak üzere ExpressJS içindeki ara katman yazılımı işlevlerini keşfedin.

Apidog - Bir PUT İsteği Yapma

Daha önce tanıtıldığı gibi, tüm API yaşam döngüsü için eksiksiz araçlara sahip kapsamlı bir API geliştirme aracı olan Apidog ile PUT isteğini kısa sürede yapabilirsiniz.

İlk olarak, NodeJS Express PUT isteği için yeni bir istek oluşturmak için Yeni İstek düğmesine tıklayın.

Ardından, isteği bir PUT isteğine dönüştürdüğünüzden emin olun. Görüntüdeki vurgulanmış kutuda, erişmek istediğiniz API uç noktasını ekleyin.

PUT isteğiniz için gerekli ayrıntıları ekleyerek devam edin.

Uygulamanız için Apidog ile JavaScript Kodu Oluşturun

NodeJS ve Express JavaScript programlama dili kullanılarak yazıldığından, dil hakkında bilgi sahibi olmanız gerekir. Neyse ki, Apidog'un bir kod oluşturma özelliği var.

İlk olarak, ekranın sağ üst köşesinde bulunan </> düğmesini bulun. Düğmeyi bulmakta zorlanıyorsanız, yukarıdaki resme başvurabilirsiniz.

İhtiyacınız olan istemci tarafı programlama dilini seçerek devam edin. Hangi JavaScript kitaplığına daha aşina olduğunuzu seçme gücüne sahipsiniz.

Tek yapmanız gereken kodu IDE'nize kopyalayıp yapıştırmak ve NodeJS uygulamanıza uyduğundan emin olmak için düzenlemeye devam etmek! Ancak, yukarıdaki resimde gösterildiği gibi Unirest kullanmak istiyorsanız, buradaki makaleye başvurabilirsiniz:

Sonuç

NodeJS Express, geliştiricilerin hedeflenen kaynak güncellemeleri için PUT isteklerini sorunsuz bir şekilde entegre eden sağlam ve çok yönlü API'ler oluşturmasını sağlar. Bu kılavuz, NodeJS Express uygulamalarında PUT isteklerini işlemekle ilgili temel kavramları inceledi. Bir proje oluşturma, bir PUT rotası oluşturma ve Postman kullanarak bir isteği simüle etme adımlarını izledik.

Unutmayın, bu bir temel görevi görür. Gerçek dünya uygulamaları, kapsamlı ve güvenli bir geliştirme yaklaşımı için hata işleme, veri doğrulama, veritabanı entegrasyonu ve ara katman yazılımı gibi en iyi uygulamaları içermelidir. NodeJS Express içinde PUT isteklerinde ustalaşarak, web uygulamalarınızda ve API'lerinizde kaynakları etkili bir şekilde yönetebilir ve güncelleyebilirsiniz.