Arquitectura de servicios web para Oposiciones TAI: Guía Completa

¿Qué es una arquitectura de servicios web?

La arquitectura de servicios web es un modelo de diseño software que permite crear aplicaciones distribuidas cuyos componentes se comunican mediante una red utilizando protocolos y estándares abiertos.

Su objetivo es permitir que diferentes sistemas, aplicaciones y plataformas puedan intercambiar información independientemente del lenguaje de programación, sistema operativo o tecnología utilizada.

Los servicios web actúan como intermediarios que proporcionan funcionalidades accesibles mediante interfaces bien definidas.

Conceptos fundamentales

Para comprender la arquitectura de servicios web es necesario conocer los siguientes conceptos:

• Servicio web: componente software que ofrece una funcionalidad accesible mediante una red.
• Cliente: aplicación que solicita y consume un servicio.
• Proveedor: sistema que implementa y publica un servicio.
• Interfaz: definición de las operaciones disponibles y cómo utilizarlas.
• Mensaje: información intercambiada entre cliente y servicio.
• API: conjunto de operaciones que permiten la comunicación entre aplicaciones.

Funcionamiento de un servicio web

El funcionamiento básico de un servicio web sigue el siguiente modelo:

Cliente

   │

Solicitud

   │

Servicio Web

   │

Procesamiento

   │

Respuesta

   │

Cliente

El cliente envía una petición al servicio web indicando la operación que desea realizar y los datos necesarios.

El servicio procesa la solicitud y devuelve una respuesta con el resultado.

Arquitectura básica de servicios web

Una arquitectura tradicional de servicios web está formada por tres elementos principales:

El modelo clásico se conoce como:

Proveedor → Publica → Registro

Cliente → Busca → Registro

Cliente → Consume → Proveedor

Características de los servicios web

Las principales características son:

• Interoperabilidad: comunicación entre sistemas diferentes.
• Reutilización: permite utilizar funcionalidades existentes.
• Bajo acoplamiento: cliente y servicio dependen poco entre sí.
• Escalabilidad: permite aumentar capacidad según demanda.
• Accesibilidad: servicios disponibles mediante red.
• Estándares abiertos: uso de protocolos ampliamente aceptados.

Modelos de arquitectura de servicios web

Existen diferentes modelos según la tecnología utilizada:

• Servicios web SOAP.
• Servicios web REST.
• Arquitecturas orientadas a microservicios.

Servicios web SOAP

SOAP (Simple Object Access Protocol) es un protocolo estándar basado en XML para el intercambio de información entre aplicaciones.

SOAP define una estructura estricta para los mensajes y utiliza normalmente HTTP como protocolo de transporte.

Un mensaje SOAP tiene la siguiente estructura:

Envelope

 ├── Header

 └── Body

Componentes de SOAP

Características de SOAP

SOAP presenta las siguientes características:

• Basado en XML.
• Protocolo estandarizado.
• Alta seguridad mediante extensiones WS-*.
• Compatible con transacciones distribuidas.
• Mayor complejidad que REST.

Ventajas

• Alta formalización.
• Seguridad avanzada.
• Adecuado para entornos empresariales.
• Soporte para operaciones complejas.

Inconvenientes

• Mensajes más pesados.
• Mayor complejidad.
• Menor velocidad frente a REST.

WSDL (Web Services Description Language)

WSDL es un lenguaje basado en XML utilizado para describir un servicio web SOAP.

Define:

• Operaciones disponibles.
• Parámetros de entrada.
• Datos de salida.
• Ubicación del servicio.
• Protocolo utilizado.

Ejemplo conceptual:

Servicio:

Operación → ObtenerUsuario

Entrada → ID usuario

Salida → Datos usuario

REST (Representational State Transfer)

REST es un estilo arquitectónico para diseñar servicios web utilizando los principios del protocolo HTTP.

Los servicios REST se basan principalmente en recursos identificados mediante URLs.

Ejemplo:

GET /usuarios/25

Solicita la información del usuario con identificador 25.

Principios de REST

REST se basa en los siguientes principios:

Cliente-servidor

El cliente y el servidor están separados.

El cliente solicita recursos y el servidor los proporciona.

Sin estado (Stateless)

Cada petición contiene toda la información necesaria para procesarse.

El servidor no mantiene información de sesión entre peticiones.

Cacheable

Las respuestas pueden almacenarse temporalmente para mejorar rendimiento.

Interfaz uniforme

Los recursos se gestionan mediante operaciones estándar.

Sistema por capas

La arquitectura puede incluir intermediarios como proxies o balanceadores.

Métodos HTTP utilizados en REST

REST utiliza principalmente los métodos HTTP:

Ejemplo:

Formatos de intercambio de datos

Los servicios web necesitan un formato para intercambiar información.

Los más utilizados son:

XML

Formato basado en etiquetas.

Ejemplo:

<usuario>
    <nombre>Ana</nombre>
</usuario>

Características:

• Más pesado.
• Muy estructurado.
• Utilizado habitualmente por SOAP.

JSON

Formato ligero basado en pares clave-valor.

Ejemplo:

{
  "nombre": "Ana"
}

Características:

• Menor tamaño.
• Fácil procesamiento.
• Muy utilizado en APIs REST.

Comparación SOAP vs REST

API Gateway

Un API Gateway es un componente que actúa como punto de entrada único para múltiples servicios.

Sus funciones principales son:

• Enrutamiento de peticiones.
• Autenticación.
• Control de acceso.
• Limitación de tráfico.
• Monitorización.
• Transformación de mensajes.

Arquitectura:

Cliente

   │

API Gateway

   │

├── Servicio A

├── Servicio B

└── Servicio C

Microservicios

La arquitectura de microservicios divide una aplicación grande en pequeños servicios independientes.

Cada servicio:

• Tiene una responsabilidad concreta.
• Puede desarrollarse independientemente.
• Puede desplegarse por separado.
• Puede utilizar diferentes tecnologías.

Ejemplo:

Aplicación bancaria

 ├── Servicio usuarios

 ├── Servicio pagos

 ├── Servicio notificaciones

 └── Servicio informes

Ventajas

• Mayor escalabilidad.
• Despliegues independientes.
• Mayor flexibilidad tecnológica.

Inconvenientes

• Mayor complejidad.
• Necesidad de monitorización.
• Gestión de comunicación entre servicios.

Seguridad en servicios web

La seguridad de los servicios web incluye:

Autenticación

Permite comprobar la identidad del usuario o sistema.

Ejemplos:

• Usuario y contraseña.
• Tokens.
• Certificados digitales.

Autorización

Determina qué operaciones puede realizar un usuario.

Cifrado

Protege la información durante la comunicación.

Ejemplo:

• HTTPS mediante TLS.

Control de acceso

Limita el uso de determinados recursos.

Caso práctico: diseño de una API REST

Situación

Una universidad necesita crear una aplicación móvil para consultar información de alumnos.

Solución

Se desarrolla una API REST:

Aplicación móvil

        │

        │ HTTPS + JSON

        │

API REST

        │

Base de datos

Operaciones:

GET /alumnos

POST /alumnos

GET /alumnos/{id}

DELETE /alumnos/{id}

Ventajas:

• Compatible con diferentes plataformas.
• Fácil integración.
• Bajo consumo de recursos.

Ventajas e inconvenientes de los servicios web

Ventajas

• Interoperabilidad entre sistemas.
• Reutilización de funcionalidades.
• Integración sencilla.
• Independencia tecnológica.
• Escalabilidad.
• Facilitan arquitecturas distribuidas.

Inconvenientes

• Dependencia de la red.
• Problemas de seguridad.
• Mayor complejidad de integración.
• Necesidad de gestión de versiones.
• Posibles problemas de rendimiento.

Errores habituales

• Confundir SOAP con REST.
• Pensar que REST es un protocolo.
• Confundir API con servicio web.
• Asociar JSON exclusivamente con SOAP.
• Olvidar que SOAP utiliza XML.
• No diferenciar autenticación de autorización.
• Confundir WSDL con una API.

Cómo evitarlos

• Recordar que SOAP es un protocolo y REST un estilo arquitectónico.
• Asociar SOAP con XML y WSDL.
• Asociar REST con HTTP y JSON.
• Diferenciar siempre identificación y permisos.
• Entender el papel de las APIs como interfaces de comunicación.

Relaciones con otros temas

La arquitectura de servicios web está relacionada con:

• APIs.
• HTTP.
• JSON.
• XML.
• REST.
• SOAP.
• Microservicios.
• Bases de datos.
• Seguridad informática.
• Cloud Computing.
• Desarrollo web.

Conceptos clave para recordar

[!NOTE]

• Un servicio web permite la comunicación entre aplicaciones mediante una red.
• Su objetivo principal es la interoperabilidad.
• SOAP es un protocolo basado en XML.
• REST es un estilo arquitectónico basado principalmente en HTTP.
• SOAP utiliza WSDL como descripción del servicio.
• REST utiliza recursos identificados mediante URLs.
• Los métodos HTTP principales son:
  • GET → consultar
  • POST → crear
  • PUT/PATCH → modificar
  • DELETE → eliminar
• JSON es el formato más utilizado en APIs REST modernas.
• Los API Gateway centralizan el acceso a múltiples servicios.
• Los microservicios dividen una aplicación en servicios independientes.