Módulo http de Node.js
De Node.jshttpEl módulo es uno de los módulos centrales integrados de Node.js, permite a los desarrolladores crear servidores y clientes HTTP. A través de este módulo, podemos manejar fácilmente solicitudes y respuestas HTTP, y construir aplicaciones web o servicios API.
httpEl módulo proporciona la capacidad de crear servidores y realizar solicitudes HTTP, y es la base para construir aplicaciones web. Admite el protocolo HTTP/1.1 y ofrece una amplia API para manejar diversas operaciones relacionadas con HTTP.
Crear un servidor HTTP
Usandohttpel módulo, crear un servidor es muy sencillo; a continuación se muestra un ejemplo básico:
Ejemplo
// Crear servidor HTTP
const server = http.createServer((req, res) => {
// Establecer cabeceras de respuesta
res.writeHead(200, {'Content-Type': 'text/plain'});
// Enviar datos de respuesta
res.end('Hello, World!\n');
});
// Escuchar en el puerto 3000
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
Análisis del código
require('http')- Importar el módulo http de Node.jshttp.createServer()- Crear una instancia del servidor HTTP- Función callback
(req, res) => {...}- Maneja cada solicitud HTTPreq- Objeto de solicitud, contiene la información de la solicitud enviada por el clienteres- Objeto de respuesta, se utiliza para enviar la respuesta al cliente
res.writeHead()- Establecer las cabeceras de respuestares.end()- Finalizar la respuesta y enviar los datosserver.listen()- Iniciar el servidor para escuchar en el puerto especificado
Manejar solicitudes HTTP
El servidor HTTP debe poder manejar diferentes tipos de solicitudes; a continuación veamos cómo analizar la información de la solicitud:
Ejemplo
const server = http.createServer((req, res) => {
// Obtener el método, la URL y las cabeceras de la solicitud
const { method, url, headers } = req;
// Registrar la información de la solicitud
console.log(`Recibida ${method}solicitud, ruta: ${url}`);
console.log('Cabeceras de solicitud:', headers);
// Procesar según el método de la solicitud
if (method === 'GET') {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Esta es una solicitud GET\n');
} else if (method === 'POST') {
let body = '';
// Recopilar datos POST
req.on('data', chunk => {
body += chunk;
});
// Recepción de datos completada
req.on('end', () => {
console.log('Datos POST:', body);
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Datos recibidos\n');
});
} else {
res.writeHead(405, {'Content-Type': 'text/plain'});
res.end('Método no permitido\n');
}
});
server.listen(3000);
Propiedades comunes del objeto de solicitud (req)
req.method: Método de solicitud HTTP (GET, POST, PUT, DELETE, etc.)req.url: Ruta URL de la solicitudreq.headers: Objeto de cabeceras de solicitudreq.httpVersion: Versión del protocolo HTTP
Métodos comunes del objeto de respuesta (res)
res.writeHead(statusCode, headers): Establecer el código de estado y las cabeceras de la respuestares.write(data): Escribir el cuerpo de la respuestares.end([data]): Finalizar la respuesta, opcionalmente enviar los últimos datosres.setHeader(name, value): Establecer las cabeceras de respuesta
Realizar solicitudes HTTP
httpEl módulo no solo puede crear servidores, también puede actuar como cliente para realizar solicitudes HTTP:
Ejemplo
// Realizar solicitud GET
http.get('http://jsonplaceholder.typicode.com/posts/1', (res) => {
let data = '';
// Recibir datos
res.on('data', (chunk) => {
data += chunk;
});
// Recepción de datos completada
res.on('end', () => {
console.log('Datos de respuesta:', JSON.parse(data));
});
}).on('error', (err) => {
console.error('Error en la solicitud:', err);
});
Realizar solicitudes POST
Ejemplo
// Opciones de la solicitud
const options = {
hostname: 'jsonplaceholder.typicode.com',
port: 80,
path: '/posts',
method: 'POST',
headers: {
'Content-Type': 'application/json',
}
};
// Crear solicitud
const req = http.request(options, (res) => {
let data = '';
res.on('data', (chunk) => {
data += chunk;
});
res.on('end', () => {
console.log('Respuesta:', JSON.parse(data));
});
});
// Manejar errores
req.on('error', (err) => {
console.error('Error en la solicitud:', err);
});
// Escribir datos de la solicitud
const postData = JSON.stringify({
title: 'foo',
body: 'bar',
userId: 1
});
req.write(postData);
req.end();
Casos de uso prácticos
1. Crear una API RESTful
Ejemplo
const server = http.createServer((req, res) => {
const { method, url } = req;
// Manejo simple de rutas
if (method === 'GET' && url === '/api/users') {
res.writeHead(200, {'Content-Type': 'application/json'});
res.end(JSON.stringify([{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}]));
} else if (method === 'POST' && url === '/api/users') {
let body = '';
req.on('data', chunk => body += chunk);
req.on('end', () => {
const newUser = JSON.parse(body);
// Aquí se puede guardar en la base de datos
res.writeHead(201, {'Content-Type': 'application/json'});
res.end(JSON.stringify({id: Date.now(), ...newUser}));
});
} else {
res.writeHead(404, {'Content-Type': 'text/plain'});
res.end('Not Found\n');
}
});
server.listen(3000);
2. Servidor proxy
Ejemplo
const proxy = http.createServer((clientReq, clientRes) => {
// Realizar una solicitud al servidor de destino
const options = {
hostname: 'example.com',
port: 80,
path: clientReq.url,
method: clientReq.method,
headers: clientReq.headers
};
const proxyReq = http.request(options, (proxyRes) => {
// Reenviar la respuesta del servidor de destino al cliente
clientRes.writeHead(proxyRes.statusCode, proxyRes.headers);
proxyRes.pipe(clientRes);
});
// Reenviar el cuerpo de la solicitud del cliente
clientReq.pipe(proxyReq);
});
proxy.listen(8080);
Mejores prácticas
- Manejo de errores: Siempre maneja los eventos de error en las solicitudes y respuestas
- Consideraciones de rendimiento: Para aplicaciones de alta concurrencia, considera usar un grupo de conexiones
- Seguridad:
- Valida todas las entradas
- Establece cabeceras de seguridad adecuadas
- Limita el tamaño del cuerpo de la solicitud para prevenir ataques DoS
- Usa flujos (streams): Para transferencias de archivos grandes, usa procesamiento por flujos
- Considera un framework: Para aplicaciones complejas, considera usar frameworks como Express, Koa, etc.
Resumen
De Node.jshttpEl módulo proporciona la capacidad básica para construir aplicaciones web. Aunque ahora hay muchos frameworks más avanzados disponibles, entenderhttpel principio de funcionamiento del módulo es crucial para cualquier desarrollador de Node.js. Al dominar este módulo central, podrás comprender mejor el mecanismo de funcionamiento de las aplicaciones web y construir soluciones personalizadas según tus necesidades.
Módulos integrados de Node.js