Notas de la versión CispalMocks 1.0.0
Primera versión estable de CispalMocks: cliente REST de escritorio para consumir servicios reales, grabar sus interacciones en stubs compatibles con WireMock y levantar un servidor mock local que responde exactamente igual cuando el servicio no está disponible.
Qué trae la versión 1.0.0
Organiza APIs, versiones y operaciones en carpetas estándar en disco. Sin bases de datos binarias: cada archivo es JSON limpio y versionable en Git, con soporte para múltiples ventanas, bloqueo multi-proceso y copias de seguridad.
Envío de peticiones en todos los métodos REST (GET, POST, PUT, DELETE, PATCH). Cuerpos en JSON, XML, form URL-encoded, multipart (con subida de archivos) y binario. Variables de entorno {{variable}} y autenticación heredable (Basic, Bearer, API Key y OAuth2 client credentials). Los secretos se almacenan en el Llavero nativo del sistema operativo.
Con ● Grabar activo, cada llamada guarda la interacción en formato de stubs de WireMock. Como Proxy de grabación se coloca delante del servicio real con modo fallback automático que conmuta a las grabaciones en caso de caída del upstream.
Servidor local ligero que responde en el puerto elegido. Coincidencia semántica con tolerancia al orden en JSON y queries, detección de campos volátiles (fechas ISO, UUID, JWT), recarga automática de cambios en menos de 2 segundos y diagnóstico asistido en respuestas 404.
Permite almacenar múltiples respuestas para un mismo endpoint (casos positivos y de error). Selección dinámica mediante cabecera X-CispalMocks-Variant y conmutador global de Modo Fallo para simular caídas de servicio.
Reglas de coincidencia avanzadas con patrones numéricos, UUIDs, expresiones regulares personalizadas y proyección de valores recibidos dinámicamente en el cuerpo de la respuesta.
Scripts Before y Post para calcular firmas HMAC, inyectar cabeceras y encadenar llamadas. Ejecución en sandbox aislado con límites de 5 s y 256 MB.
Importación de contratos OpenAPI 3.0/3.1 y comandos cURL de DevTools. Exportación nativa a carpetas o zips compatibles con WireMock 3 y Docker. Generador de modelos en TypeScript, Java (Lombok o records) y JSON Schema desde cualquier respuesta.
Librería en Maven Central para integrar las grabaciones directamente dentro de tu aplicación Java. Se activa por configuración (CISPALMOCKS_ENABLED=true) sin alterar tu código fuente ni añadir dependencias pesadas.
Requisitos y límites conocidos
- Java: Los instaladores (.msi, .dmg, .deb) incluyen su propio entorno Java en tiempo de ejecución. El archivo
cispalmocks-1.0.0.jarrequiere un JDK o JRE versión 21 o superior. - Firma digital: Los instaladores no cuentan con certificado comercial de pago. Consulta la guía de cómo abrir la app la primera vez para macOS (Gatekeeper) y Windows (SmartScreen).
- Tiempo de arranque: La aplicación inicia en menos de 5 segundos. En macOS la primera apertura del jar puede demorar ligeramente mientras el sistema analiza las librerías nativas extraídas.
- Línea de comandos (CLI): El modo servidor sin interfaz gráfica está planificado para la versión 1.1.