Rails 패턴: 서비스 객체

Ruby on Rails는 웹 애플리케이션 개발을 위한 강력한 프레임워크입니다. Rails의 구조적 패턴 중 하나인 서비스 객체는 코드의 가독성과 유지보수성을 높이는 데 큰 도움을 줍니다. 이 글에서는 서비스 객체의 개념, 사용 이유, 구현 방법, 그리고 몇 가지 예제를 통해 서비스 객체를 깊이 있게 살펴보겠습니다.

서비스 객체란?

서비스 객체는 특정 비즈니스 로직을 캡슐화하는 클래스입니다. Rails 애플리케이션에서 모델, 뷰, 컨트롤러의 역할을 분리하여 코드의 재사용성을 높이고, 테스트를 용이하게 합니다. 서비스 객체는 일반적으로 다음과 같은 경우에 사용됩니다:

복잡한 비즈니스 로직을 처리할 때
여러 모델에 걸쳐 작업을 수행할 때
컨트롤러의 책임을 줄이고 싶을 때

서비스 객체의 장점

서비스 객체를 사용하면 다음과 같은 장점을 누릴 수 있습니다:

코드의 가독성 향상: 비즈니스 로직이 명확하게 분리되어 있어 이해하기 쉽습니다.
유지보수 용이: 특정 기능이 변경되더라도 서비스 객체만 수정하면 되므로 유지보수가 간편합니다.
테스트 용이: 서비스 객체는 독립적으로 테스트할 수 있어 테스트 커버리지를 높일 수 있습니다.

서비스 객체 구현하기

서비스 객체를 구현하는 방법은 간단합니다. 다음은 기본적인 서비스 객체의 구조입니다:

class MyService
  def initialize(params)
    @params = params
  end

  def call
    # 비즈니스 로직
  end
end

위의 예제에서 initialize 메서드는 서비스 객체가 필요로 하는 매개변수를 초기화합니다. call 메서드는 실제 비즈니스 로직을 수행하는 메서드입니다.

서비스 객체 예제

이제 간단한 예제를 통해 서비스 객체를 구현해 보겠습니다. 사용자의 이메일을 통해 비밀번호를 재설정하는 기능을 구현해 보겠습니다.

class PasswordResetService
  def initialize(email)
    @user = User.find_by(email: email)
  end

  def call
    return false unless @user

    @user.send_password_reset_email
    true
  end
end

위의 PasswordResetService 클래스는 사용자의 이메일을 받아 해당 사용자를 찾고, 비밀번호 재설정 이메일을 전송하는 기능을 수행합니다. call 메서드는 사용자가 존재하지 않을 경우 false를 반환하고, 이메일을 성공적으로 전송했을 경우 true를 반환합니다.

서비스 객체 사용하기

서비스 객체를 사용하는 방법은 매우 간단합니다. 컨트롤러에서 서비스 객체를 호출하여 비즈니스 로직을 수행할 수 있습니다. 다음은 컨트롤러에서 서비스 객체를 사용하는 예제입니다:

class PasswordResetsController < ApplicationController
  def create
    service = PasswordResetService.new(params[:email])
    if service.call
      flash[:notice] = "비밀번호 재설정 이메일이 전송되었습니다."
      redirect_to root_path
    else
      flash[:alert] = "해당 이메일을 가진 사용자를 찾을 수 없습니다."
      render :new
    end
  end
end

위의 예제에서 create 메서드는 사용자가 입력한 이메일을 기반으로 PasswordResetService를 호출합니다. 서비스 객체의 call 메서드가 성공적으로 실행되면 사용자에게 성공 메시지를 보여주고, 실패할 경우 오류 메시지를 표시합니다.

서비스 객체의 테스트

서비스 객체는 독립적으로 테스트할 수 있어 테스트 작성이 용이합니다. 다음은 RSpec을 사용하여 PasswordResetService를 테스트하는 예제입니다:

require 'rails_helper'

RSpec.describe PasswordResetService do
  let(:user) { create(:user) }

  context '사용자가 존재할 때' do
    it '비밀번호 재설정 이메일을 전송한다' do
      service = PasswordResetService.new(user.email)
      expect(service.call).to be true
      expect(ActionMailer::Base.deliveries.count).to eq(1)
    end
  end

  context '사용자가 존재하지 않을 때' do
    it 'false를 반환한다' do
      service = PasswordResetService.new('nonexistent@example.com')
      expect(service.call).to be false
    end
  end
end

위의 테스트는 사용자가 존재할 때와 존재하지 않을 때의 두 가지 경우를 테스트합니다. 각각의 경우에 대해 서비스 객체가 올바르게 동작하는지 확인합니다.

서비스 객체의 모범 사례

서비스 객체를 사용할 때 몇 가지 모범 사례를 따르는 것이 좋습니다:

단일 책임 원칙: 서비스 객체는 하나의 비즈니스 로직만 처리해야 합니다. 여러 기능을 하나의 서비스 객체에 넣지 않도록 주의하세요.
명확한 메서드 이름: 서비스 객체의 메서드는 그 기능을 명확하게 설명해야 합니다. call 외에도 execute, perform 등의 이름을 사용할 수 있습니다.
예외 처리: 서비스 객체 내에서 발생할 수 있는 예외를 적절히 처리하여 안정성을 높이세요.

결론

서비스 객체는 Rails 애플리케이션에서 비즈니스 로직을 효과적으로 관리하는 데 유용한 패턴입니다. 코드의 가독성과 유지보수성을 높이고, 테스트를 용이하게 만들어 줍니다. 이 글에서 소개한 내용을 바탕으로 서비스 객체를 활용하여 더 나은 Rails 애플리케이션을 개발해 보세요!