¿Cómo crear un nuevo Service Object en Rails?
El desarrollo de aplicaciones en Rails puede ser sofisticado, pero incorporar un Service Object para manejar la gestión de estados ofrece una estructura más organizada. En este artículo, exploraremos cómo lograrlo utilizando un enfoque práctico y bien estructurado.
¿Qué es un Service Object?
Un Service Object en Rails es un patrón usado para encapsular lógica de negocio que no pertenece a un modelo o controlador específico. Esto es útil para evitar la sobrecarga de los controladores y modelos, a la vez que facilita el mantenimiento y la escalabilidad del código.
¿Por qué crear un Service Object para la gestión de tareas?
La principal razón para crear un Service Object para gestionar los estados de las tareas es establecer una capa intermedia. Esto permite que los componentes externos modifiquen los estados sin tener que interactuar directamente con el modelo de tarea. Aunque inicialmente la lógica pueda parecer básica, este enfoque es esencial para escalar la funcionalidad en el futuro.
Desarrollo del Service Object
Comencemos creando una prueba para nuestro nuevo servicio. En la carpeta spec/services/task
, duplicamos un servicio existente, por ejemplo send_email_spec
, y lo nombramos trigger_event_spec
. En esta prueba, nos enfocaremos en verificar que nuestro servicio cambie correctamente el estado de la tarea y persista la transición.
Creación de la prueba
Utilizaremos un fragmento del código como referencia:
require "rails_helper"
RSpec.describe TriggerEvent do
subject { described_class.new(task, event) }
let(:task) { create(:task) }
let(:event) { "start" }
context "cuando se llama a trigger_event" do
it "cambia el estado de la tarea a 'in_process'" do
expect { subject.call }.to change { task.status }.to("in_process")
end
it "registra una transición" do
expect { subject.call }.to change { task.transitions.count }.by(1)
end
end
end
En este código, estamos asegurando que dos importantes verificaciones ocurran:
- El estado de la tarea cambia a "in_process".
- Se registra una nueva transición.
Implementación del Service Object
Después de crear la prueba, procedemos a la implementación del Service Object. Dentro de app/services/task/
, duplicamos el servicio send_email.rb
y lo renombramos a trigger_event.rb
. Cambiamos la lógica para que coincida con nuestros requisitos.
class TriggerEvent
def initialize(task, event)
@task = task
@event = event
end
def call
@task.send("#{@event}!")
end
end
En este ejemplo simple, utilizamos Ruby para invocar dinámicamente métodos en la tarea. La metaprogramación facilita futuras expansiones, permitiendo añadir seguridad, políticas de acceso, o conexiones adicionales con otros servicios.
Probando el Service Object
Finalmente, validamos nuestro Service Object ejecutando las pruebas. Navegamos a la consola de comandos y ejecutamos:
rspec spec/services/task/trigger_event_spec.rb
Esperamos ver resultados de éxito que confirmen que nuestro servicio funciona correctamente.
¿Qué tal si ampliamos nuestras habilidades?
Este es el momento perfecto para llamar a la acción. Ahora que has aprendido cómo crear un Service Object para gestionar el cambio de estados de una tarea, te desafío a crear uno para gestionar la creación de un código post-tarea. Este ejercicio consolidará tu comprensión y mejorará tu habilidad en Rails. ¡Buena suerte!
¿Quieres ver más aportes, preguntas y respuestas de la comunidad?