Introducción a Clientes HTTP Declarativos

En el contexto de arquitecturas distribuidas, la comunicación entre microservicios requiree una gestión eficiente de las solicitudes HTTP. Spring Cloud OpenFeign ofrece una capa de abstracción que permite definir clientes web mediante interfaces Java anotadas. Esta herramienta encapsula la complejidad de las llamadas HTTP, permitiendo que los desarrolladores invoquen métodos remotos con la misma simplicidad que las llamadas locales, ocultando los detalles de la conexión subyacente.

Configuración Inicial del Proyecto

Para comenzar a utilizar esta funcionalidad, es necesario incorporar las librerías adecuadas en el gestor de dependencias. Se requieren tanto el starter de OpenFeign como el balanceador de carga.

Dependencias Maven

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

Definición del Contrato Remoto

Se debe crear una interfaz que represente el cliente. Esta interfaz utiliza la anotación @FeignClient para identificar el servicio objetivo y la ruta base. Los métodos dentro de la interfaz se mapean a endpoints específicos mediante anotaciones de solicitud HTTP.

@FeignClient(name = "servicio-pedidos", path = "/api/pedidos")
public interface ClienteRemotoPedidos {

    @RequestMapping("/buscarPorIdentificador/{idUsuario}")
    List<Usuario> obtenerPorIdentificador(@PathVariable Long idUsuario);

    @RequestMapping("/obtenerPuerto")
    Integer obtenerPuertoServicio();
}

Activación del Escaneo

Finalmente, en la clase principal de la aplicación Spring Boot, se debe habilitar el escaneo de clientes Feign añadiendo la anotación @EnableFeignClients.

Optimización del Pool de Conexiones

Por defecto, Feign puede crear una nueva conexión para cada solicitud, lo cual impacta el rendimiento. Para mitigar esto, se recomienda integrar OkHttp, que permite gestionar un pool de conexiones persistente.

Librería Adicional

<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-okhttp</artifactId>
</dependency>

Activación en Configuración

En el archivo de propiedades o YAML, se debe habilitar explícitamente el uso de OkHttp:

feign:
  okhttp:
    enabled: true

Mejores Prácticas de Modularización

En sistemas complejos, es aconsejable extraer los clientes Feign, las clases DTO y las configuraciones comunes a un módulo independiente (por ejemplo, feign-api). Este arteacto se comparte entre los microservicios consumidores.

Un problema común surge cuando el módulo compartido tiene una estructura de paquetes diferente a la aplicación principle. Si los clientes están en com.arquitectura.demo.feign y la aplicación en com.arquitectura.demo.orden, el escaneo automático no los encontrará.

Para resolverlo, se debe especificar explícitamente los paquetes a escanear en la anotación de habilitación:

@EnableFeignClients(basePackages = "com.arquitectura.demo.feign")

Gestión de Registros y Logs

OpenFeign permite configurar el nivel de detalle de los registros para depurar las comunicaciones. Esto puede hacerse mediante clases de configuración Java o propiedades.

Configuración vía Bean

Se define una clase de configuración que expone un bean con el nivel de log deseado.

public class AjustesFeignComunes {
 
    @Bean
    public Logger.Level nivelRegistroFeign(){
        return Logger.Level.BASIC; 
    }
}

Esta cofniguración puede aplicarse globalmente en la anotación @EnableFeignClients usando el atributo defaultConfiguration, o localmente en un cliente específico mediante el atributo configuration en @FeignClient.

Configuración vía Propiedades

Alternativamente, se puede definir el nivel de log directamente en el archivo de configuración:

# Configuración específica para el servicio de usuarios
feign.client.config.servicio-usuarios.logger-level=FULL
# Configuración global por defecto
#feign.client.config.default.logger-level=FULL

Niveles Disponibles

• NONE: Sin registros (valor por defecto).
• BASIC: Registra método, URL, estado y tiempo de ejecución.
• HEADERS: Incluye información de cabeceras de solicitud y respuesta.
• FULL: Detalle completo incluyendo cuerpos de solicitud, respuesta y metadatos.