Clase 7 - Jueves, 24 de septiembre de 2026 (24 09 26) - Desarrollo de sistemas web backend
Desarrollo de Sistemas Web Backend con Node.js: Construcción de Servidores HTTP
Este documento constituye una guía técnica y académica exhaustiva sobre el desarrollo de servidores backend utilizando Node.js. Abarca desde la arquitectura fundamental cliente-servidor hasta la implementación avanzada de rutas, gestión de encabezados (headers), y manipulación de sistemas de archivos.
1. Introducción General
El desarrollo backend moderno se fundamenta en la capacidad de procesar peticiones y devolver respuestas de manera eficiente. En el ecosistema de Node.js, esto se logra a través de la construcción de servidores HTTP, evolucionando desde scripts básicos de lógica secuencial hacia arquitecturas robustas de API REST. Esta arquitectura es la más común para la comunicación entre el frontend y el backend, permitiendo el intercambio de datos estructurados, generalmente en formato JSON.
2. Marco Conceptual y Definiciones Clave
Para comprender la construcción de servidores, es esencial dominar los siguientes términos:
Conceptos Fundamentales
- Arquitectura Cliente-Servidor: Un modelo de diseño de aplicaciones donde las tareas se reparten entre los proveedores de recursos o servicios (servidores) y los demandantes (clientes).
- Request (Petición): Objeto que contiene toda la información enviada por el cliente hacia el servidor (URL, método, encabezados, cuerpo de datos).
- Response (Respuesta): Objeto que el servidor devuelve al cliente tras procesar la petición, incluyendo un código de estado y, opcionalmente, un cuerpo de datos.
- Puerto (Port): Un punto final de comunicación lógica. Los servidores escuchan en puertos específicos (ej. 3000, 3500, 3700). El rango disponible se extiende hasta el 65535, evitando los puertos conocidos del sistema.
- Localhost: Nombre que hace referencia a la dirección IP local de la propia máquina (127.0.0.1).
Librerías Nativas de Node.js
| Librería | Función |
http | Permite la creación del servidor y el manejo del protocolo de transferencia de hipertexto. |
url | Se utiliza para parsear (analizar) las cadenas de texto de las URLs y extraer sus componentes. |
fs (File System) | Permite interactuar con el sistema de archivos del servidor (leer, escribir, transmitir archivos). |
path | Facilita la construcción de rutas de archivos de forma segura y compatible entre diferentes sistemas operativos. |
3. Desarrollo del Tema: La Construcción del Servidor
3.1 Estructura Básica de un Servidor HTTP
Un servidor funcional mínimo en Node.js puede construirse con pocas líneas de código utilizando el método http.createServer. Este método requiere una función de callback (frecuentemente una función flecha) que recibe los objetos request (o req) y response (o res).
// Estructura mínima conceptual
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello World');
});
server.listen(3000, '127.0.0.1');
3.2 Los Métodos HTTP (Verbos)
Los métodos definen la acción que el cliente desea realizar. Según las convenciones y los RFC (Request for Comments) correspondientes, los más utilizados son:
- GET: Solicitar o pedir recursos (datos).
- POST: Enviar datos para crear un nuevo recurso.
- PUT: Modificar un recurso existente de forma completa.
- PATCH: Realizar modificaciones parciales a un recurso.
- DELETE: Eliminar un recurso.
- HEAD: Similar a GET, pero solo solicita los encabezados, sin el cuerpo de la respuesta.
3.3 Códigos de Estado de Respuesta
El servidor debe informar al cliente el resultado de su petición mediante códigos numéricos estandarizados:
| Categoría | Rango | Descripción | Ejemplo Común |
| Informativos | 100-199 | Procesos en curso. | 101 Switching Protocols |
| Éxito | 200-299 | Petición completada correctamente. | 200 OK, 201 Created |
| Redirección | 300-399 | El recurso se ha movido. | 301 Moved Permanently |
| Error del Cliente | 400-499 | Problema en la petición del usuario. | 400 Bad Request, 404 Not Found |
| Error del Servidor | 500-599 | El servidor falló al procesar. | 500 Internal Server Error |
4. Profundización: Lógica de Rutas y Encabezados
4.1 Análisis de la URL (Parsing)
Para que un servidor pueda responder de forma distinta según la dirección solicitada (ej. /productos vs /usuarios), se debe analizar la URL. Se utiliza url.parse(req.url) para extraer el pathname.
4.2 Gestión de Encabezados (Headers)
Los encabezados son metadatos que viajan en la petición y la respuesta.
- Content-Type: Indica al cliente qué tipo de datos está recibiendo (
application/json,text/html,image/x-icon). - User-Agent: Identifica el software (navegador, herramienta como Postman o comandos como CURL) que realiza la petición. Esto permite aplicar lógica de control, como bloquear el tráfico proveniente de herramientas específicas por motivos de compatibilidad o seguridad.
4.3 Asincronía en el Servidor
Se recomienda el uso de funciones asíncronas (async/await) en el servidor para evitar el bloqueo del hilo principal de procesamiento, especialmente cuando se realizan consultas a bases de datos o lecturas de archivos. Esto mejora el rendimiento y la capacidad de manejar múltiples peticiones simultáneas.
5. Ejemplos Prácticos y Casos Reales
Caso 1: Simulación de Base de Datos
En entornos de desarrollo inicial, se puede emular una base de datos mediante un arreglo de objetos JSON.
- Función
**pedirProductos**: Simula una consultaSELECT. Puede incluir lógica de error aleatoria (ej. 10% de probabilidad de fallo) para probar el manejo de errores 500. - Búsqueda por ID: El servidor divide la URL (usando
split('/')) para extraer un identificador y filtrar el arreglo de datos.
Caso 2: Filtrado por User-Agent
Un servidor puede inspeccionar el encabezado user-agent para restringir el acceso.
- Ejemplo: Si el
user-agentincluye la cadena "Postman", el servidor devuelve un error 403 o 404 personalizado, denegando el acceso a esa herramienta específica mientras permite la navegación desde navegadores convencionales.
Caso 3: Servir Archivos Estáticos (HTML e Imágenes)
Para enviar un archivo HTML completo:
- Se utiliza
path.joiny__dirnamepara construir la ruta absoluta del archivo. - Se emplea
fs.readFilepara cargar el contenido. - Se ajusta el
Content-Typeatext/html. - Se envía el contenido en el cuerpo de la respuesta.
6. Errores Comunes y Aclaraciones
- Confusión con
**res.end()**: Este método no solo cierra la comunicación, sino que es donde se envía el cuerpo final de la respuesta (el payload). - Olvido de Encabezados: No especificar el
Content-Typecorrecto puede causar que el navegador no renderice el HTML o no interprete el JSON correctamente. - Rutas Relativas vs. Absolutas: Usar rutas relativas al leer archivos puede fallar si el proceso de Node se inicia desde un directorio distinto. Se debe usar siempre
path.joincon__dirname. - El bloque
**finally**: Es opcional en una estructuratry-catch. Si se incluye, se ejecutará siempre, independientemente de si hubo un error o no.
7. Síntesis y Puntos Clave
- Node.js en el Backend: Permite usar JavaScript para lógica de servidor, facilitando la transición a desarrolladores de frontend.
- API REST: Es el estándar de facto para la comunicación front-back mediante objetos JSON.
- Importancia de los Códigos HTTP: Son fundamentales para que el cliente entienda qué sucedió sin necesidad de analizar el mensaje de texto.
- Modularización: Es una buena práctica separar la lógica de la base de datos (emulada o real) de la lógica del servidor HTTP.
- Control de Flujo: El uso de
if/elseoswitchbasado enmethodypathnameconstituye el sistema de enrutamiento básico de cualquier servidor.
8. Preguntas de Repaso
Nivel Básico
- ¿Cuál es la función principal de la librería
httpen Node.js? - ¿Qué diferencia hay entre el objeto
requesty el objetoresponse? - ¿Para qué sirve el puerto en una conexión de red?
Nivel Intermedio
- Explique la diferencia entre los códigos de estado 200, 404 y 500.
- ¿Por qué es importante analizar el
pathnamede una URL en el servidor? - ¿Cómo se puede identificar desde qué navegador se está conectando un usuario?
Nivel Avanzado
- Describa el proceso para servir un archivo HTML desde el disco duro usando las librerías
fsypath. - ¿Qué ventaja ofrece trabajar con funciones asíncronas (
async) al crear un servidor? - Simule la lógica necesaria para que un servidor solo acepte peticiones de tipo POST en la ruta
/registro.
9. Fechas importantes y avisos académicos
A partir del análisis de las fuentes, se detallan las siguientes indicaciones organizativas:
- Ejercicios de Práctica (Clase 4): Se encuentra disponible un PDF con ejercicios para consolidar conocimientos de las primeras cuatro clases. No son de entrega obligatoria, son de carácter operativo.
- Ejercicios de Práctica (Clase 5): Se subirá un material similar al de la clase 4, enfocado en funciones, NPM y temas modulares. No son de entrega obligatoria.
- Trabajo Práctico Unidad 1:
- Tipo: Cuestionario de 15 preguntas aleatorias sobre funciones, parámetros, lógica de bloques de código y estructura de Node.
- Fecha: Se ha dilatado el calendario debido a la ausencia del profesor en clases anteriores. No será la próxima clase, posiblemente la subsiguiente. Se confirmará mediante el cronograma en la plataforma.
- Trabajo Práctico Unidad 2:
- Tipo: Construcción de un sistema de backend completo (Servidores).
- Fecha estimada: Alrededor de las clases 8 o 9.
- Trabajo Práctico Unidad 3:
- Tipo: Desarrollo final del sistema.
- Fecha: Hacia el final del cuatrimestre.
- Aviso General: Las clases normales se extienden hasta las 20:00 - 20:10 aproximadamente. Posteriormente, el profesor ofrece un segmento optativo para evacuar dudas de clases anteriores o del día.
- Cronograma: El profesor se comprometió a dejar el cronograma completo y actualizado en la plataforma al finalizar la sesión.