Node.js ile Gelişmiş CRUD API Geliştirme: Sequelize, PostgreSQL ve JWT Kimlik Doğrulama
Merhaba! Bu yazıda, Node.js, Sequelize ORM, PostgreSQL veritabanı ve JSON Web Token (JWT) kimlik doğrulama mekanizması kullanarak gelişmiş bir CRUD (Create, Read, Update, Delete) API’si nasıl oluşturulacağını adım adım açıklayacağım. Bu rehber, hem temel seviyedeki hem de daha deneyimli geliştiriciler için faydalı bilgiler içermektedir. Öncelikle projenin temel mimarisini ve her bir bileşenin rolünü ele alacağız. Sonrasında ise uygulamanın kodunu detaylı bir şekilde inceleyeceğiz.
Proje Kurulumu ve Yapılandırma
Öncelikle projemizi başlatmamız gerekiyor. Bunun için npm veya yarn kullanabiliriz. Projemizin temel bağımlılıklarını kurmak için package.json dosyasına aşağıdaki paketleri eklemeliyiz:
npm install express pg sequelize pg-hstore jsonwebtoken bcryptjs
Ardından, PostgreSQL veritabanınızı kurmanız ve config/config.json dosyasında veritabanı bağlantı bilgilerinizi yapılandırmanız gerekmektedir. Bu dosya, geliştirme, test ve üretim ortamları için farklı ayarlar içerebilir. Örneğin:
{
"development": {
"username": "postgres",
"password": "your_password",
"database": "your_database_name",
"host": "127.0.0.1",
"dialect": "postgres"
}
}
Sequelize’ı kullanarak modellerimizi tanımlayabiliriz. Örneğin, bir “Kullanıcı” modeli için:
const { DataTypes } = require('sequelize');
module.exports = (sequelize) => {
return sequelize.define('User', {
username: {
type: DataTypes.STRING,
allowNull: false,
unique: true
},
password: {
type: DataTypes.STRING,
allowNull: false
}
});
};
JWT Kimlik Doğrulama
Kullanıcıların kimlik doğrulaması için JWT kullanacağız. Kullanıcı giriş yaptığında, doğru kullanıcı adı ve şifre doğrulaması yapıldıktan sonra, bir JWT oluşturulacak ve kullanıcıya gönderilecektir. Sonraki isteklerde, kullanıcı bu JWT’yi Authorization başlığında gönderecektir. JWT’nin geçerliliği doğrulandıktan sonra, istek işleme devam edecektir.
JWT oluşturma ve doğrulama için jsonwebtoken ve bcryptjs paketlerini kullanacağız. bcryptjs şifreleme işlemleri için kullanılmaktadır. Güvenlik açısından, şifreleri doğrudan veritabanına kaydetmek yerine, hash’lenmiş hallerini kaydetmeliyiz.
CRUD İşlemleri
Sequelize’ın sağladığı metotları kullanarak CRUD işlemlerini kolayca gerçekleştirebiliriz. create, findAll, findOne, update ve destroy metotları, veri tabanına veri eklemek, veri okumak, veri güncellemek ve veri silmek için kullanılır. Bu metotlar, hata yönetimi ve doğrulama mekanizmaları ile birlikte kullanılmalıdır. Ayrıntılı örnekler için kod örneğine bakabilirsiniz.
Hata Yönetimi
Uygulamanızda hata yönetimi çok önemlidir. Hataları yakalamak ve kullanıcıya anlamlı mesajlar döndürmek, uygulamanızın güvenilirliğini artırır. Asenkron işlemler kullanıldığında, try...catch blokları ile hataları ele almalıyız. Ayrıca, HTTP durum kodlarını doğru bir şekilde kullanmak önemlidir.
Sonuç
Bu makalede, Node.js, Sequelize, PostgreSQL ve JWT kullanarak gelişmiş bir CRUD API’si oluşturmanın temel adımlarını ele aldık. Elbette, daha karmaşık uygulamalar için ek özellikler (örneğin, yetkilendirme, arama filtreleme, pagination) eklemeniz gerekebilir. Daha detaylı bilgi ve örnekler için fatihsoysal.com sitesini ziyaret edebilirsiniz. Ayrıca, Sequelize ve JWT belgelerine göz atmanızı öneririm. Umarım bu rehber size yardımcı olmuştur!
Daha fazla bilgi için aşağıdaki kaynaklara göz atabilirsiniz:
#Etiketler: Node.js, Sequelize, PostgreSQL, JWT, CRUD API, REST API, Kimlik Doğrulama, JavaScript, Backend Geliştirme, Veritabanı, API Geliştirme, JWT Kimlik Doğrulama, Hata Yönetimi