Hono JS ve Drizzle ile Hızlı REST API Dosya Yükleme
Merhaba! Bu yazıda, Hono JS ve Drizzle kullanarak hızlı ve verimli bir REST API dosya yükleme sistemi nasıl oluşturabileceğinizi adım adım açıklayacağım. Hono, performansı yüksek, hafif bir Node.js framework’üdür. Drizzle ise PostgreSQL için yazılmış, modern ve kullanımı kolay bir ORM (Object-Relational Mapper)’dir. Bu ikiliyi kullanarak, güçlü ve ölçeklenebilir bir dosya yükleme sistemini kolayca geliştirebilirsiniz. Daha önce benzer projelerde fatihsoysal.com adresindeki yazılarımı inceleyebilirsiniz.
Kurulum ve Hazırlık
Öncelikle, projemizi başlatalım. Node.js ve npm (veya yarn) kurulu olduğundan emin olun. Ardından, aşağıdaki komutlarla Hono ve Drizzle’ı projemize ekleyelim:
npm init -y
npm install hono drizzle pg
Daha sonra, Drizzle için gerekli konfigürasyonları yapmamız gerekiyor. PostgreSQL veritabanınızın ayarlarını drizzle.config.ts dosyasında belirtin. Bu dosya örneği şöyle olabilir:
import { drizzle } from 'drizzle-orm/postgres-js';
import { Pool } from 'pg';
import * as schema from './schema'; // Drizzle şemanız
const pool = new Pool({
user: 'your_db_user',
host: 'your_db_host',
database: 'your_db_name',
password: 'your_db_password',
port: 5432, // veya veritabanınızın portu
});
export const db = drizzle(pool, { schema });
Bu örnekte, your_db_user, your_db_host, your_db_name ve your_db_password değerlerini kendi veritabanı bilgilerinizle değiştirmeniz gerekiyor. Ayrıca ./schema dosyasında Drizzle şemanızı tanımlarsınız. Bu şema dosyasında tablolarınızı ve sütunlarınızı belirleyeceksiniz. Dosya yükleme işlemi için, muhtemelen bir dosya adı ve dosya yolunu saklayacak bir tablo oluşturmanız gerekecektir.
Dosya Yükleme API’sini Oluşturma
Şimdi, Hono ile dosya yükleme API’mızı oluşturabiliriz. Aşağıdaki kod, bir dosyayı yükleyen ve veritabanına kaydeden bir endpoint tanımlar:
import { Hono } from 'hono';
import { db } from './drizzle.config';
import { files } from './schema'; // Şema dosyasından 'files' tablosunu içe aktarın
const app = new Hono();
app.post('/upload', async (c) => {
const file = await c.req.file(); // Hono'nun file middleware'ini kullanarak dosyayı alın
if (!file) {
return c.json({ message: 'Dosya seçmediniz.' }, 400);
}
// Dosyayı sunucuya kaydedin (örneğin, geçici bir dizine)
const filePath = /tmp/${file.name};
await Deno.writeFile(filePath, file.data);
// Dosya bilgilerini veritabanına kaydedin
await db.insert(files).values({ filename: file.name, path: filePath }).returning();
return c.json({ message: 'Dosya başarıyla yüklendi.' });
});
export default app;
Bu kodda, öncelikle Hono’nun c.req.file() fonksiyonunu kullanarak gelen dosyayı alıyoruz. Ardından dosyayı geçici bir dizine kaydediyoruz. Son olarak, dosya adını ve yolunu Drizzle kullanarak veritabanına ekliyoruz. Hata yönetimi ve güvenlik önlemleri eklemek çok önemlidir. Örneğin, dosya türünü kontrol ederek zararlı dosyaların yüklenmesini engelleyebilirsiniz. Ayrıca, dosya isimlerini temizleyerek güvenlik açıklarını önleyebilirsiniz.
Sonuç
Bu makalede, Hono JS ve Drizzle kullanarak hızlı ve verimli bir REST API dosya yükleme sistemi oluşturmayı öğrendiniz. Bu sistem, performansı yüksek ve ölçeklenebilir bir çözüm sunar. Ancak, gerçek dünya uygulamalarında daha gelişmiş hata yönetimi, güvenlik önlemleri ve dosya yönetimi stratejilerine ihtiyacınız olacaktır. Bu öğreticiyi temel alarak, ihtiyaçlarınıza uygun bir dosya yükleme sistemi geliştirebilirsiniz. Umarım faydalı olmuştur!
Daha fazla bilgi için aşağıdaki kaynaklara göz atabilirsiniz:
#Etiketler: Hono JS, Drizzle, REST API, Dosya Yükleme, Node.js, JavaScript, Veritabanı, PostgreSQL, ORM, API, Web Geliştirme, Tutorial, Öğretici
