Node.js HTTP Sunucu Oluşturma: http.createServer

http.createServer(), tek bir fonksiyondan, request handler'dan bir web sunucusu oluşturur. Node bu fonksiyonu gelen her istek için iki nesneyle çağırır: req (istemcinin gönderdiği method, URL ve header'lar) ve res (senin geri gönderdiğin). res üzerinde bir status code ve header'lar ayarla, sonra body ile res.end() çağır. server.listen(3000) 3000 portunda bağlantı kabul etmeye başlar.

const http = require('http');

const server = http.createServer((req, res) => {
    console.log(req.method, req.url);
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end(`You asked for ${req.method} ${req.url}`);
});

// GET /hello?name=Ada
server.listen(3000, () => {
    console.log('Listening on port 3000');
});

İlk istek You asked for GET /hello?name=Ada cevabını alır, Console da aynı method ve URL'yi yazdırır. İstek çubuğundan DELETE /anything gönder: aynı handler ona da cevap verir, çünkü düz bir http sunucusunun route'ları yoktur. Her istek o tek fonksiyondan geçer.

JSON göndermek ve status code ayarlamak

res.writeHead(status, headers) status code'u ve header'ları tek çağrıda ayarlar. JSON için Content-Type: application/json ayarla ve JSON.stringify()'ın sonucunu gönder; res.end() yalnızca bir string ya da Buffer kabul eder.

const http = require('http');

const users = [
    { id: 1, name: 'Ada' },
    { id: 2, name: 'Linus' },
];

function sendJson(res, status, data) {
    res.writeHead(status, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify(data));
}

const server = http.createServer((req, res) => {
    const url = new URL(req.url, 'http://localhost');
    const limit = Number(url.searchParams.get('limit')) || users.length;

    if (req.method === 'GET' && url.pathname === '/users') {
        return sendJson(res, 200, users.slice(0, limit));
    }
    sendJson(res, 404, { error: 'Not found' });
});

// GET /users?limit=1
server.listen(3000);

GET /users?limit=1 isteği [{"id":1,"name":"Ada"}] döndürür. req.url, path ile query string'in birleşimidir; new URL(req.url, 'http://localhost') onu pathname ve searchParams olarak ayırır (base sadece URL mutlak bir adres istediği için orada). GET /nothing gönder, status 404 olur.

İstekleri switch ile yönlendirmek

Küçük bir API için method ve path üzerinde bir switch'ten fazlası gerekmez. 'GET /users' gibi bir anahtar oluştur ve her route'a kendi case'ini ver:

const http = require('http');

const users = [{ id: 1, name: 'Ada' }];

function sendJson(res, status, data) {
    res.writeHead(status, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify(data));
}

function readBody(req) {
    return new Promise((resolve, reject) => {
        let data = '';
        req.on('data', (chunk) => {
            data += chunk;
        });
        req.on('end', () => resolve(data));
        req.on('error', reject);
    });
}

const server = http.createServer(async (req, res) => {
    const { pathname } = new URL(req.url, 'http://localhost');

    switch (`${req.method} ${pathname}`) {
        case 'GET /users':
            return sendJson(res, 200, users);

        case 'POST /users': {
            let body;
            try {
                body = JSON.parse(await readBody(req));
            } catch {
                return sendJson(res, 400, { error: 'Body must be JSON' });
            }
            const user = { id: users.length + 1, name: body.name };
            users.push(user);
            return sendJson(res, 201, user);
        }

        default:
            sendJson(res, 404, { error: `No route for ${req.method} ${pathname}` });
    }
});

// GET /users
server.listen(3000);

{"name": "Grace"} body'siyle POST /users gönder: cevap {"id":2,"name":"Grace"} ile 201'dir ve GET /users artık iki kullanıcıyı da listeler. Aynı POST'u hello body'siyle gönderirsen {"error":"Body must be JSON"} ile 400 alırsın.

POST body okumak

Node body'yi senin için ayrıştırmaz. req okunabilir bir stream'dir; body data event'leriyle parça parça gelir, tamamlandığında da end tetiklenir. Yukarıdaki readBody() parçaları bir string'de toplar ve bir promise döndürür, böylece handler onu await edebilir. req async iterable olduğu için bu döngü de aynı işi görür:

let data = '';
for await (const chunk of req) data += chunk;
const body = JSON.parse(data);

Gerçek bir sunucu boyutu da sınırlar (data.length bir sınırı geçince okumayı bırakıp 413 ile cevap verir) ve JSON.parse çağırmadan önce req.headers['content-type']'ı kontrol eder.

Sık yapılan hatalar

res.end()'i unutmak. Status ayarlayıp response'u hiç bitirmeyen bir dal, istemciyi zaman aşımına kadar bekletir.

Body'den sonra header ayarlamak. res.end() ya da ilk res.write() çalıştıktan sonra header'lar gönderilmiştir ve res.setHeader() ERR_HTTP_HEADERS_SENT fırlatır. Örneklerdeki gibi, erken response gönderdiğinde return kullan.

req.url'yi bir path ile karşılaştırmak. req.url query string'i de içerir, bu yüzden /users?limit=1 için req.url === '/users' false'tur. pathname'i karşılaştır.

Ne zaman Express kullanmalı

http modülü bir health check, bir webhook alıcısı ya da HTTP'nin nasıl çalıştığını öğrenmek için yeterlidir. /users/:id gibi route parametrelerine, JSON body ayrıştırmaya, middleware'e ve hata yönetimine ihtiyaç duyduğunda kendi küçük framework'ünü yazmaya başlarsın. Express, aynı req ve res nesneleri üzerine kurulu o framework'tür; Express routing aynı API'yi app.get() ve app.post() ile gösteriyor.