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:
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:
{
"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:
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:
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:
{
"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.