Filtrar registros por contenido de texto es una de las tareas más comunes cuando construyes una API con Spring Data JPA. Con los query methods y los keywords Containing y Not puedes recuperar datos sin escribir una sola línea de SQL, y aquí te muestro cómo hacerlo con una tabla de pizzas y sus ingredientes.

¿Cómo filtrar registros que contengan un texto con Containing?

La idea es buscar dentro de la columna description de la tabla pizza para devolver solo aquellas que incluyan un ingrediente específico. Para eso, en el repositorio defines un método que retorne una lista de PizzaEntity siguiendo la convención de Spring Data.

¿Por qué usar findBy en vez de queryBy o searchAllBy?

Spring Data JPA acepta varios prefijos equivalentes: findBy, getAllBy, queryBy o searchAllBy. Todos funcionan igual, pero la convención más usada es findBy, así que es la opción recomendada para mantener tu código legible y alineado con el estándar de la comunidad.

El método queda así:

java List<PizzaEntity> findByAvailableTrueAndDescriptionContainingIgnoreCase(String description);

Aquí combinas dos condiciones: que la pizza esté disponible (AvailableTrue) y que su descripción contenga el texto recibido como parámetro. El sufijo ContainingIgnoreCase es clave porque ignora si escribes mozzarella, MOZZARELLA o Mozzarella.

¿Qué hace ContainingIgnoreCase en Spring Data JPA? Genera una consulta SQL con LIKE que busca coincidencias parciales sin distinguir entre mayúsculas y minúsculas, usando internamente la función UPPER sobre la columna y el parámetro.

¿Cómo conectar el repositorio con el servicio y el controlador?

En la capa de servicio expones un método público que delega al repositorio:

java public List<PizzaEntity> getWith(String ingredient) { return this.pizzaRepository .findByAvailableTrueAndDescriptionContainingIgnoreCase(ingredient); }

Luego en el PizzaController defines un endpoint que reciba el ingrediente como PathVariable:

java @GetMapping("/with/{ingredient}") public List<PizzaEntity> getWith(@PathVariable String ingredient) { return this.pizzaService.getWith(ingredient); }

Al probar en Postman con GET /with/mozzarella, la respuesta incluye todas las pizzas con mozzarella en su descripción: pepperoni, goat cheese, meat lovers y cualquier otra que tenga ese ingrediente.

¿Cómo excluir registros con el keyword Not?

Y aquí viene lo interesante: invertir la lógica es tan simple como agregar la palabra Not antes de Containing. El método cambia totalmente su comportamiento sin que toques una sola línea de SQL.

java List<PizzaEntity> findByAvailableTrueAndDescriptionNotContainingIgnoreCase(String description);

Esto te devuelve las pizzas disponibles cuya descripción no contenga el ingrediente que mandes. El servicio se llama getWithout y el endpoint queda como /without/{ingredient}.

¿Cómo traduce Spring Data el keyword Not a SQL? Lo convierte en una cláusula NOT LIKE con UPPER aplicado a la columna y al parámetro, ajustando el dialecto según la base de datos que estés usando.

Al consultar GET /without/mozzarella aparecen pizzas como margarita, margarita vegana o avocado festival, justo las que no incluyen ese ingrediente.

¿Qué SQL genera Spring Data por debajo?

La consulta resultante luce así:

sql SELECT * FROM pizzas WHERE available = true AND UPPER(description) NOT LIKE UPPER(?) ESCAPE '?';

Spring Data se encarga de traducir tu query method al dialecto específico de tu motor de base de datos, así que el mismo código funciona en MySQL, PostgreSQL u otros sin que tengas que modificarlo.

¿Qué keywords de query methods conviene dominar?

Estos son los elementos esenciales que viste en acción:

• findBy como prefijo estándar para iniciar un query method.
• AvailableTrue para filtrar por un campo booleano sin pasar parámetros.
• Containing o Contains para búsquedas tipo LIKE %valor%.
• IgnoreCase para ignorar mayúsculas y minúsculas en la comparación.
• Not como modificador que invierte cualquier condición.

Combinar estos keywords te da un poder enorme para construir consultas expresivas sin escribir SQL manualmente. Y esto es solo el inicio: en la siguiente clase verás keywords útiles para trabajar con listas y fechas. ¿Qué otro filtro te gustaría resolver con query methods? Cuéntamelo en los comentarios.