Implementación de Búsqueda de Posts con Servicios en Rails

Curso de Creación de APIs con Ruby on Rails

Contenido del curso

Introducción

Proyecto

Cierre

33
Creación de APIs con Rails: Buenas Prácticas y Features Avanzados
00:43 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:006:06

Implementación de Búsqueda de Posts con Servicios en Rails

Curso de Creación de APIs con Ruby on Rails

Clase 17 de 33

Clase 17 / 33

Recursos

Implementa una búsqueda de posts en Rails que pase pruebas y mantenga un controlador ligero. Aquí verás cómo filtrar solo publicaciones publicadas, delegar la lógica a un service y usar SQL con comodines para lograr coincidencias flexibles, dejando la puerta abierta a la escalabilidad.

¿Cómo se implementa la búsqueda de posts publicados en Rails?

Para iniciar, la lógica vive en el método index del controlador. Primero se filtran los posts publicados. Luego, se toma el parámetro search de la petición y se valida que no sea nil y que esté present?. Si hay búsqueda, se delega al servicio.

# app/controllers/posts_controller.rb
class PostsController < ApplicationController
  def index
    posts = Post.published

    query = params[:search]
    if !query.nil? && query.present?
      posts = PostSearchService.search(posts, query)
    end

    @posts = posts
  end
end

Filtrar siempre por publicados primero.
Validar nil y present? antes de buscar.
Delegar la lógica al service para mantener el controller limpio.
Asegurar que las pruebas pasen antes de continuar.

¿Cómo se construye el filtro con SQL LIKE?

La búsqueda compara el title con el query usando LIKE y comodines %. La forma %consulta% indica: cualquier texto antes, la consulta en medio y cualquier texto después.

# app/servicios/post_search_service.rb
class PostSearchService
  def self.search(current_posts, query)
    current_posts.where("title LIKE '%#{query}%' ")
  end
end

LIKE permite coincidencias parciales en el título.
% funciona como comodín de búsqueda.
La consulta se aplica sobre el conjunto ya filtrado por publicados.

¿Por qué mover la lógica a un servicio de búsqueda?

Centralizar la lógica en un servicio simplifica el controller y encapsula la lógica de negocio. Esto facilita el mantenimiento y futuras modificaciones sin tocar el controlador.

¿Qué ventajas aporta esta arquitectura?

Controlador ligero y fácil de leer.
Lógica de búsqueda encapsulada en una sola clase.
Cambios futuros se aplican en un único lugar.
Mejora la organización del código y las pruebas automatizadas.

¿Qué hace el método search del servicio?

Recibe la colección actual de posts (ya filtrada por publicados) y el query. Devuelve los registros cuyo title coincide parcialmente con la cadena de búsqueda gracias a LIKE y %.

Método de clase: self.search.
Parámetros: current_posts y query.
Retorno: relación filtrada lista para el controller.

¿Cómo escalar la búsqueda y evitar problemas futuros?

Si el volumen de peticiones crece, conviene sustituir la búsqueda basada en base de datos por un servicio especializado como Elasticsearch. Las bases de datos relacionales no están diseñadas para queries de texto a gran escala, y migrar será sencillo porque la lógica está aislada en el service.

Sustitución transparente del motor de búsqueda.
Mejor rendimiento con alto tráfico.
Próximo tema: el problema de n más uno y su impacto en consultas.

¿Te gustaría ver variantes del service o casos de prueba para esta búsqueda? Cuéntame qué escenario quieres cubrir y lo trabajamos juntos.

Adrian Peralta

Hace 7 años

como puedo hacer debugging si mi controlador no pasa por el servicio?

usé byebug haciendo "p @posts" y poniendo byebug en el controller y en el servicio, pero no se detenía en el servicio. Problema: nombre archivo(separado con "_") != al nombre de clase ejecutando el test no mustra error, pero al ejecutar y hacer la busqueda aparece: {"error":"uninitialized constant PostsController::PostSearchService"}

como no se usan imports directos y cambiar de nombre a la carpeta "services" tampoco afecta el resultado, la única forma de descubrir el error es ejecutando el servidor? en la documentación de rails se explica como funciona esa relación (controlador-servicio/funcionExterna)?

Daniel Zambrano

Hace 7 años

Cuando trabajas en rails literalmente tus archivos deben nombrarse con underscores. Lo que puede ser que tengas es un error de en el nombre de la clase o del archivo.

No deberias necesitar hacer require ya que Rails lo hace por su propia cuenta.

Usualmente este error viene cuando usas spring in desarrollo, mi consejo:

spring stop

y vuelve a ejecutar tu codigo.

spring es magico en proyectos grandes, pero cuando estas seguro que tu nombre de archivo es correcto, el nombre de la clase es correcto, lo siguiente a probar seria el scope ( clases dentro de modulos) y de ahi spring

Daniel J. Pérez

Hace 3 años

Hola, Adrián; me sucedió lo mismo, fue porque no colocamos la carpeta services/ dentro de la carpeta app/ y estas dos carpetas estaban al mismo nivel. Debe quedar de la siguiente forma: app/services/posts_search_service.rb

Una de sus rutas de lectura automáticas (autoload_paths) de Rails es la carpeta app/, por lo tanto, si colocas una carpeta fuera de sus rutas de lectura automática, Rails ignorará la carpeta o el archivo que hayas agregado.

Introducción

API de blog con Ruby on Rails y TDD

Verificar herramientas antes del proyecto Rails

Proyecto

Creación de APIs con Rails: Proyecto Blog API paso a paso

Configuración de Gemas para Pruebas en Proyectos Rails

Configuración de Gemas en Proyectos Rails: Arspec, Factory Bot y Database Cleaner

Implementación de un Health Check Endpoint en API con RSpec

Diseño de Casos de Uso y Diagramas de Entidad para Aplicaciones

Diagrama entidad relación: usuario y post

Modelado de Aplicaciones con TDD en Rails

Validaciones y Pruebas TDD en Rails: Modelos USR y Post

Implementación de Endpoints para Listar y Mostrar Posts con TDD

Implementar controlador Posts con TDD

Pruebas TDD para crear y actualizar posts

Implementación de Métodos y Manejo de Excepciones en Rails API

Active Model serializers: control total de JSON en Rails

Búsqueda y Filtrado de Posts por Título con TDD

Implementación de Búsqueda de Posts con Servicios en Rails

Problema N+1 en Rails: Detección y Solución Eficaz

Identificación y solución del problema N+1 en Rails

Flujo de Autenticación en APIs con Tokens y Proveedores

Tests con RSpec para autenticación de tokens

Autenticación con Tokens: Implementación en Rails API

Autenticación de Usuarios en Controladores Rails

Autenticación y Seguridad en CRUD de Posts en Rails

Pruebas de Creación y Actualización con Autenticación en Rails

Probando API Ruby on Rails con Postman

Caching en Aplicaciones Web: Funciones y Niveles

Aceleración de Búsquedas en Rails con Caching

Background Jobs en Rails: Conceptos y Funcionalidades

Procesamiento en Background y Envío de Correos con Rails

Envío de Correos en Rails con ActionMailer y Background Jobs

Autenticación y Autorización con JWT y Auth0 en Aplicaciones Web

Cierre

Creación de APIs con Rails: Buenas Prácticas y Features Avanzados

Implementación de Búsqueda de Posts con Servicios en Rails