Biz geliştiriciler için herhangi bir uygulama geliştirirken verilerle çalışmak çok olağan bir durumdur. Bu işlem genellikle RESTful API’ler ile gerçekleştirilir. Ancak, API’lerin geliştirilmesi zaman alıcı ve karmaşık bir işlem olabilir. JSON Server, bu sorunu çözmek için oluşturulmuş bir araçtır. JSON Server, RESTful API hizmeti sağlayan ve JSON dosyalarını veritabanı olarak kullanan bir araçtır. Fake API olarakta bilinir.

JSON Server, geliştiricilere verileri yönetmek için basit bir yol sunar. JSON formatındaki bir dosyayı bir API’ye dönüştürür ve bu API’ye HTTP istekleri göndererek, belirli işlemleri gerçekleştirmenizi sağlar. JSON Server kullanarak, bir web uygulaması geliştirirken sunucu tarafındaki verileri doğrudan dosyalar üzerinden elde edebilirsiniz.

JSON Server’ın Kurulumu ve Kullanımı

JSON Server kurulumu ve kullanımı açısından basit bir araçtır. Aşağıdaki adımları takip ederek basit bir şekilde kurulumu ve konfigürasyonunu sağlayabilirsiniz.

Adım 1: Node.js’in Kurulumu

JSON Server, Node.js üzerinde çalışır. Bu nedenle, ilk olarak Node.js’i kurmanız gerekiyor. Node.js’i indirmek ve kurmak için nodejs.org adresini ziyaret edebilirsiniz.

Adım 2: JSON Server’ın Kurulumu

JSON Server’ı kurmak için, Node.js’in paket yöneticisi olan npm’i kullanabilirsiniz. Aşağıdaki komutu kullanarak JSON Server’ı yükleyin:

1
npm install -g json-server

Bu komut, JSON Server’ı global olarak yükleyecektir. “-g” parametresi, JSON Server’ın tüm projelerinizde kullanılabilmesini sağlar.

Adım 3: JSON Dosyasının Oluşturulması

JSON Server’ın kullanımı için bir JSON dosyasına ihtiyacınız var. Bu dosya, JSON Server’ın dönüştürmesi gereken verileri içermelidir. Örnek olarak, db.json isimli aşağıdaki gibi bir JSON dosyası oluşturabilirsiniz:

1
2
3
4
5
6
{
"books": [
{ "id": 1, "title": "The Hobbit", "author": "J.R.R Tolkien" },
{ "id": 2, "title": "Dune : Dessert Planet", "author": "Frank Herbert" }
]
}

Bu dosya, “books” adında bir veri kaynağına sahip bir JSON dosyasıdır. Her bir kaynak, bir dizi nesne içerir.

Adım 4: JSON Server’ın Başlatılması

JSON Server’ı başlatmak için, aşağıdaki komutu kullanabilirsiniz:

1
json-server --watch db.json

Bu komut, JSON Server’ı başlatır ve “db.json” dosyasını veri kaynağı olarak kullanır. “–watch” parametresi, dosyanın değiştiğinde JSON Server’ın otomatik olarak yeniden başlatılmasını sağlar.

Adım 5: JSON Server’ın Kullanımı

JSON Server’ın başarılı bir şekilde başlatıldığını doğrulamak için, tarayıcınızda “http://localhost:3000/books“ adresini ziyaret edin. Bu adres, “books” kaynağına bir GET isteği gönderir ve kaynağın tüm verilerini döndürür.

Ayrıca, JSON Server’ın sunduğu diğer HTTP metodlarını da kullanabilirsiniz. Örneğin, aşağıdaki gibi bir POST isteği göndererek, “books” kaynağına yeni bir öğe ekleyebilirsiniz:

1
2
3
4
5
6
7
POST /books HTTP/1.1
Content-Type: application/json

{
"title": "The Witcher",
"author": "Andrzej Sapkowski"
}

Bu istek, “books” kaynağına yeni bir öğe ekler ve yeni öğenin ID’sini döndürür. Ve nihayetinde db.json dosyasının içeriği aşağıdaki gibi değişir:

1
2
3
4
5
6
7
{
"books": [
{ "id": 1, "title": "The Hobbit", "author": "J.R.R Tolkien" },
{ "id": 2, "title": "Dune : Dessert Planet", "author": "Frank Herbert" },
{ "id": 3, "title": "The Witcher", "author": "Andrzej Sapkowski" }
]
}

JSON Server Kullanırken İstek Oluşturabileceğiniz HTTP Methodları

HTTP Metodu Açıklama Örnek Kullanım
GET Kayıtların okunmasını istemek için kullanılır GET /books
GET /books/1
POST Kayıt oluşturmak veya güncellemek için kullanılır POST /books
POST /books/1
PUT Kayıtları güncellemek için kullanılır PUT /books/1
PATCH Kayıtların belirli özelliklerini güncellemek için kullanılır PATCH /books/1
DELETE Kayıtları silmek için kullanılır DELETE /books/1
  • GET /books: Tüm kitap kayıtlarını getirir.
  • GET /books/1: ID’si 1 olan kitabın detaylarını getirir.
  • POST /books: Yeni bir kitap kaydı oluşturur.
  • POST /books/1: ID’si 1 olan kitabın kaydını günceller.
  • PUT /books/1: ID’si 1 olan kitabın tüm bilgilerini günceller.
  • PATCH /books/1: ID’si 1 olan kitabın belirli özelliklerini günceller.
  • DELETE /books/1: ID’si 1 olan kitap kaydını siler.

Sonuç

Özet olarak, JSON Server, geliştiricilerin RESTful API’lerini oluşturmak için basit bir yol sunar ve verileri yönetmek için JSON dosyalarını kullanır. Kurulumu ve kullanımı kolaydır. GET, POST, PUT ve DELETE gibi HTTP isteklerini kullanarak veriler üzerinde işlemler yapabilirsiniz.

JSON Server, küçük ölçekli projelerde çok kullanışlı olabilir fakat büyük projelerde gerçek bir veritabanı sistemi kullanmak daha önemlidir. Ancak bir uygulama henüz geliştirilme aşamasında ise uygulamanın davranışını simüle edebilmek ve gelitşirme sürecini hızlandırmak için JSON Server kullanımı oldukça avantajlı olabilir.

Bu makalede, JSON Server’ın ne olduğu, nasıl kurulduğu ve nasıl kullanıldığı hakkında bilgiler vermeye çalıştım. Faydalı olması dileğiyle, iyi çalışmalar dilerim.