Módulo http de Node.js

Java FileMódulos integrados 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

const http = require('http');

// 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

  1. require('http')- Importar el módulo http de Node.js
  2. http.createServer()- Crear una instancia del servidor HTTP
  3. Función callback(req, res) => {...}- Maneja cada solicitud HTTP
    • req- Objeto de solicitud, contiene la información de la solicitud enviada por el cliente
    • res- Objeto de respuesta, se utiliza para enviar la respuesta al cliente
  4. res.writeHead()- Establecer las cabeceras de respuesta
  5. res.end()- Finalizar la respuesta y enviar los datos
  6. server.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 http = require('http');

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 solicitud
  • req.headers: Objeto de cabeceras de solicitud
  • req.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 respuesta
  • res.write(data): Escribir el cuerpo de la respuesta
  • res.end([data]): Finalizar la respuesta, opcionalmente enviar los últimos datos
  • res.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

const http = require('http');

// 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

const http = require('http');

// 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 http = require('http');

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 http = require('http');

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

  1. Manejo de errores: Siempre maneja los eventos de error en las solicitudes y respuestas
  2. Consideraciones de rendimiento: Para aplicaciones de alta concurrencia, considera usar un grupo de conexiones
  3. Seguridad:
    • Valida todas las entradas
    • Establece cabeceras de seguridad adecuadas
    • Limita el tamaño del cuerpo de la solicitud para prevenir ataques DoS
  4. Usa flujos (streams): Para transferencias de archivos grandes, usa procesamiento por flujos
  5. 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.

Java FileMódulos integrados de Node.js

Otras extensiones