DEV Community: Edgar Rios Navarro

Optimizando el Testing de APIs con Karate

Edgar Rios Navarro — Sat, 08 Aug 2026 23:29:30 +0000

En el ecosistema actual de microservicios, la validación manual de endpoints mediante herramientas como curl o Postman representa un cuello de botella que compromete la agilidad y la fiabilidad. Ante este desafío, surge la necesidad de implementar soluciones de testing automatizado que sean, a la vez, robustas y accesibles. Un ejemplo reciente de esta transición se encuentra en la implementación de una arquitectura basada en Quarkus y Redis, donde se ha integrado Karate DSL para elevar la estrategia de pruebas de integración.

El valor diferencial de Karate DSL

Karate DSL se posiciona como una herramienta disruptiva en el testing de APIs al utilizar el formato Gherkin (BDD). Su principal ventaja técnica reside en la capacidad de ejecutar peticiones HTTP directamente desde archivos .feature, eliminando la necesidad de escribir código Java boilerplate. Esto no solo simplifica el mantenimiento, sino que transforma las pruebas en documentación viva, inteligible para perfiles técnicos y funcionales por igual.

Ejemplo práctico: Validación de persistencia en Redis

En el proyecto de referencia —un servicio que gestiona contadores persistidos en Redis—, la implementación de Karate permitió definir escenarios de prueba altamente legibles. A continuación, se muestra cómo se estructuró la validación de un flujo básico:

Feature: Gestión de contadores en Redis

  Scenario: Crear y recuperar un contador
    Given url 'http://localhost:8080/increments'
    And request { key: 'visitas', value: 10 }
    When method POST
    Then status 201

    Given path 'visitas'
    When method GET
    Then status 200
    And match response == { key: 'visitas', value: 10 }

Aspectos destacados de esta implementación:

Aserciones declarativas: La potencia de la sintaxis match permite validar tipos de datos y estructuras de JSON con una precisión que supera a los enfoques tradicionales, sin añadir complejidad lógica al test.
Ciclo de vida integrado: La ejecución se integra de forma nativa en el build de Gradle, garantizando que cada modificación del código sea validada automáticamente en cada ciclo de integración.
Escalabilidad: Al separar la lógica de negocio de la lógica de prueba, el repositorio se mantiene limpio y las pruebas actúan como una especificación ejecutable del contrato de la API.

Conclusión

La adopción de Karate DSL en entornos Java modernos, como Quarkus, demuestra ser una estrategia efectiva para equipos que buscan elevar sus estándares de calidad. Al reducir la carga cognitiva del testing y fomentar un enfoque BDD, se logra un balance óptimo entre velocidad de desarrollo y fiabilidad del sistema.

Para aquellos interesados en profundizar en esta configuración, el código fuente completo y la estructura de pruebas están disponibles en el siguiente repositorio: https://github.com/edgargs/example-quarkus-redis-karate.

Jira Java API

Edgar Rios Navarro — Wed, 13 Aug 2025 15:22:22 +0000

Jira provee un REST API, del que se abordó en el post anterior: https://dev.to/e240683/cliente-jira-mediante-cookie-5f3n. Pero también, provee un Java API.

Para este caso, importar dos librerías específicas:

jira-rest-java-client-core
fugue

Luego, implementar la autenticación (mediante cookie).

Finalmente, invocar la búsqueda del Issue y acceder a sus propiedades.

Documentación

https://developer.atlassian.com/server/jira/platform/java-apis/

Cliente Jira mediante Cookie

Edgar Rios Navarro — Thu, 06 Mar 2025 17:08:27 +0000

Aunque acceder a Jira mediante Cookie es una funcionalidad deprecada, sigue siendo una alternativa en entornos restrictivos al uso del Token.

En Typescript existe una librería recomendada por su reducido tamaño:
https://github.com/UrielCh/jira-api/

El fork que utiliza la opción de Cookie lo subí al siguiente repositorio: https://github.com/edgargs/jira-api/tree/feature/client-cookie

Este bloque de código, demuestra el cambio en la creación del cliente.

const domain:string = Deno.env.get("JRA_DOMAIN")!;
const cookie:string = Deno.env.get("JRA_COOKIE") || '';

const jira = new JiraClient(domain, { COOKIE: cookie });

El valor del cookie se obtiene de la sesión activa en el navegador web.

Procesar miles de registros con Spring-Batch

Edgar Rios Navarro — Tue, 26 Sep 2023 22:51:33 +0000

Pongamos como contexto, que se necesita leer desde una base de datos origen y grabar en otra base de datos distinta. Con el propósito de realizar resúmenes y cuadres diarios.

Lo más eficiente será no depender de algún ORM. Por lo que se recomienda emplear JDBC.

Spring-Batch provee un JdbcPagingItemReader el cual, al recuperar los registros de manera paginada no ocupará memoria en retener todo el resultado de la consulta.

También tenemos un JdbcBatchItemWriter para grabar los registros, que los grabarán usando la capacidad batch del driver.

Documentación

https://docs.spring.io/spring-batch/docs/current/reference/html/readersAndWriters.html#database

https://docs.spring.io/spring-batch/docs/current/reference/html/scalability.html#scalability

MySQL usar tipo SET para validar

Edgar Rios Navarro — Tue, 04 Jul 2023 15:00:57 +0000

Cuando diseñamos un sistema y tenemos una lista restringida de opciones, el modelo ER nos mostrará una relación de 'muchos a muchos'.

Consideremos el caso de Usuario - Roles:

El diagrama nos indica que debemos crear tres tablas.

Como alternativa, en MySQL nos proporciona el tipo SET.

Dicho campo acepta ninguno, uno o más valores de la lista.

mysql> insert into user(email,name,password) 
values('a@greatsolutions.consulting','A','A');
Query OK, 1 row affected (0.04 sec)

mysql> insert into user(email,name,password,roles) 
values('b@greatsolutions.consulting','B','B','');
Query OK, 1 row affected (0.04 sec)

mysql> insert into user(email,name,password,roles) 
values('c@greatsolutions.consulting','C','C','editor,user');
Query OK, 1 row affected (0.04 sec)

Por el contrario, nos da error cuando intentamos insertar un valor diferente.

mysql> insert into user(email,name,password,roles) 
values('d@greatsolutions.consulting','D','D','root');
ERROR 1265 (01000): Data truncated for column 'roles' at row 1
mysql>

Documentación

https://dev.mysql.com/doc/refman/8.0/en/set.html

Autoincrement en Oracle

Edgar Rios Navarro — Wed, 21 Jun 2023 16:41:48 +0000

Consideremos el script original, basado en la versión 11g:

---------
-- 11g --
---------
CREATE TABLE ORDERS (
    ID NUMBER NOT NULL,
    ...
);
/

ALTER TABLE ORDERS 
ADD CONSTRAINT PK_ID PRIMARY KEY (ID);
/

CREATE SEQUENCE SEQ_ORDERS
 START WITH     1000
 INCREMENT BY   1
 NOCACHE
 NOCYCLE;
/

CREATE OR REPLACE TRIGGER TRG_I_ORDERS
BEFORE INSERT
   ON ORDERS
   FOR EACH ROW
BEGIN
   :NEW.ID = SEQ_ORDERS.NEXTVAL
END;
/

Anteriormente, se empleaba un trigger para incrementar el ID: recuperar el valor de un sequence y asignarlo al campo.

Desde la versión 12c, obtenemos la misma funcionalidad con IDENTITY Column.

---------
-- 12c --
---------

CREATE TABLE ORDERS(
    ID NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    ...
);
/

Documentación

Oracle:Database:identity_clause

Procesar una transacción completamente con TRANSACT-SQL

Edgar Rios Navarro — Fri, 28 Apr 2023 14:06:29 +0000

Consideremos que, la cadena XML se genera en el servidor de aplicación. Se emplea la configuración de Spring para usar JAXB2.

Debemos asignar una lista de detalle (listCollectionSpendReport) a la entidad que vamos a persistir (collection). Nótese que, previamente se grababa la entidad y luego, uno por uno, los detalles.

El procedimiento almacenado, recibe los datos de la entidad principal y una cadena de los detalles. Luego, son casteados en formato XML y recorridos en una sentencia SELECT para ser insertados en la tabla correspondiente.

Documentación

http://docs.spring.io/spring-ws/site/reference/html/oxm.html

Enviar geoposición desde el backend con Primefaces y Gmaps.

Edgar Rios Navarro — Fri, 14 Apr 2023 13:48:57 +0000

Este ejemplo muestra como interactuar con información del backend y el frontend. Específicamente, enviar una posición y mostrarla en un mapa (google maps).

Recuperamos la latitud y longitud (posiblemente desde la base de datos) en el controller.

La posición lo almacenamos en variables de javascript. En la página web, también tendremos dos input's para mostrar cómo va cambiando la posición al mover el marker.

Creamos el mapa y colocamos el marker. Agregamos los eventos para mostrar la posición actual.

Documentación

https://developers.google.com/maps/documentation/javascript/examples/

Procesar una transacción remota (XML) mediante un procedimiento almacenado

Edgar Rios Navarro — Fri, 10 Mar 2023 15:50:29 +0000

Para enviar información (transaccional) hacia una base de datos centralizada, prodríamos emplear un servicio web: recibe los datos y los persiste de forma autónoma, segura y confiable. Pero como alternativa, es invocar un procedimiento almacenado remoto.

Consideremos la limitante que no podemos enviar la información en formato JSON. La versión del motor no lo soporta: Oracle 11g. La solución será emplear el formato XML.

No pasemos por alto los riesgos de enviar la información no cifrada (el sistema está en una red privada o no), el tamaño de los datos y el costo de procesamiento del servidor.

Este ejemplo nuestra cómo generar el formato XML en el cliente. Se etiqueta los bean's con la anotación @XmlRootElement.

El procedimiento para interpretar el xml y grabar las tablas correspondientes. La solución es válida para todas las base de datos relacionales (como Postgres y Sql Server), aunque el código varía entre ellas.

Documentación

https://github.com/edgargs/Ejemplo-2016-01.git
http://howtodoinjava.com/jaxb/jaxb-exmaple-marshalling-and-unmarshalling-list-or-set-of-objects/
http://viralpatel.net/blogs/oracle-xmltable-tutorial/

JTable Color Header

Edgar Rios Navarro — Sat, 28 Jan 2023 16:12:39 +0000

A diferencia de las aplicaciones web, personalizar grillas (tablas) en Java Swing requiere de mucho más código. Pero podemos ayudarnos con clases utilitarias.

1) Original

Consideremos este ejemplo:

2) Column Group

Para agregar la capacidad de agrupar columnas, emplearemos una clase llamada ColumnGroup. Reconoce el título y las columnas que debe agrupar.

ColumnGroup columnGroup = null;

int[] columns = {8,9};
columnGroup = new ColumnGroup("Precio Venta " + "S/.", columns);

UtilityTable.initSelectList(jTable, tableModel, ConstantsVentas.columnsList, 
columnGroup );

3) Color Header

También podemos cambiar el color de columnas específicas. Ello lo conseguimos indicando en la clase FarmaColumnData, el color de fondo.

Documentación

https://docs.oracle.com/javase/tutorial/uiswing/components/table.html
https://github.com/edgargs/table-color-header.git

Mock Service with Groovy

Edgar Rios Navarro — Thu, 08 Dec 2022 12:30:18 +0000

Cuando dependemos de una servicio de tercero, nos encontraremos con la situación que dicho servicio no está disponible por un tiempo. Para eliminar esa dependencia, podemos crear un MockService por nuestra cuenta.

En el ecosistema de Groovy, existe una librería que nos facilita: RatPack.

En una solo archivo, configuramos los métodos y las respuestas. Es posible agregarle lógica, pero la intención es que tengamos respuesta.

@Grab("io.ratpack:ratpack-groovy:1.3.3")
import static ratpack.groovy.Groovy.ratpack
ratpack {
  handlers {
    path("Transaccion.asmx/getAffiliationSearch") {
      byMethod {
        get {
          response.contentType "text/xml"
          response.send '''<?xml version="1.0" encoding="utf-8"?>
            <ArrayOfStAffiliationSearch xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="https://mifarmaws02.orbisfarma.com.mx/">
                <stAffiliationSearch>
                    <transactionid>183477976581</transactionid>
                    <cardnumber>D007330811</cardnumber>
                    <accountnumber>D007330811</accountnumber>
                    <cardname>VILMA ALEJANDRINA</cardname>
                    <cardlastname>FERNANDEZ@RUIZ</cardlastname>
                    <cardbirthdate>19641008</cardbirthdate>
                    <cardgender>F</cardgender>
                    <carddoctor />
                    <cardcontactpreferences>1</cardcontactpreferences>
                    <cardemail />
                    <cardphone />
                    <cardcellphone />
                    <cardaddress>| | | | | |</cardaddress>
                    <cardrelated>8601080650271</cardrelated>
                    <cardfields>0</cardfields>
                    <errorid>0</errorid>
                    <message />
                    <transactiondate>2022-11-24 18:00:00</transactiondate>
                </stAffiliationSearch>
            </ArrayOfStAffiliationSearch>'''

groovy mock-service.groovy

Al consultar:

Documentación

https://ratpack.io/

Mapping with SCHEMA

Edgar Rios Navarro — Sat, 15 Oct 2022 23:58:43 +0000

Una mala práctica en la configuración de aplicaciones, es usar el owner del esquema para acceder a la base de datos.
Es recomendable crear una cuenta de usuario y otorgar los permisos necesarios y específicos.

Pongamos como ejemplo:

ESQUEMA: REGIONALIZACION
USUARIO: MSPRODUCTOSWOW
PERMISOS:

-- Oracle
GRANT SELECT, INSERT, UPDATE 
ON REGIONALIZACION.LGT_PROD_LOCAL_OFERTA_AUX 
TO MSPRODUCTOSWOW

Empleando las anotaciones de Jakarta Persistence, definimos el mapping de nuestra Entity: name/schema.

import jakarta.persistence.*;

@Table(name = "LGT_PROD_LOCAL_OFERTA_AUX", schema = "REGIONALIZACION")
public record WOWProduct(@EmbeddedId WOWProductId id,
                         float porcDctoOferta,
                         LocalDateTime fecIniVigOferta,
                         LocalDateTime fecFinVigOferta,
                         String usuCreaProdLocOfe,
                         LocalDateTime fecCreaProdLocOfe) {
}

Nótese que podemos usar record, incluso para definir una llave compuesta.

@Embeddable
record WOWProductId(
        @Column(name = "COD_GRUPO_CIA") String codGrupoCia,
        @Column(name = "COD_LOCAL") String codLocal,
        @Column(name = "COD_OFERTA") String codOferta,
        @Column(name = "COD_PROD") String codProd) {
}

Ejecutamos nuestro proyecto basado en #Micronaut:

Y al listar los productos:

Documentación

https://micronaut-projects.github.io/micronaut-data/latest/guide/#sqlAnnotations
https://github.com/edgargs/mn-jdbc-schema