Decorator パターン — 機能を動的に追加する

# app/models/user.rb（一部抜粋）
class User < ApplicationRecord
  # 260行目あたりから表示系メソッドが始まる
  def display_name
    name.presence || email.split("@").first
  end
 
  def formatted_joined_at
    joined_at.strftime("%Y年%m月%d日")
  end
 
  def avatar_url
    if avatar.attached?
      Rails.application.routes.url_helpers.rails_blob_url(avatar)
    else
      "https://via.placeholder.com/100?text=#{display_name[0]}"
    end
  end
 
  def membership_badge
    case membership_type
    when "premium" then "👑 プレミアム会員"
    when "corporate" then "🏢 法人会員"
    else "一般会員"
    end
  end
 
  def profile_completion_rate
    fields = [:name, :bio, :phone_number, :avatar]
    filled = fields.count { |f| send(f).present? }
    (filled.to_f / fields.length * 100).to_i
  end
 
  # さらに続く...
end

# app/models/user.rb — モデルに表示ロジックが混入している
class User < ApplicationRecord
  validates :email, presence: true
 
  # ドメインロジック（正しい）
  def premium?
    membership_type == "premium"
  end
 
  def can_access_premium_content?
    premium? && !subscription_expired?
  end
 
  # 表示ロジック（モデルに書くべきでない）
  def display_name
    name.presence || email.split("@").first
  end
 
  def avatar_url
    if avatar.attached?
      Rails.application.routes.url_helpers.rails_blob_url(avatar)
    else
      "https://via.placeholder.com/100?text=#{display_name[0]}"
    end
  end
 
  def formatted_joined_at
    joined_at.strftime("%Y年%m月%d日")
  end
 
  def membership_badge
    case membership_type
    when "premium" then "👑 プレミアム会員"
    when "corporate" then "🏢 法人会員"
    else "一般会員"
    end
  end
 
  def profile_completion_rate
    fields = [:name, :bio, :phone_number, :avatar]
    filled = fields.count { |f| send(f).present? }
    (filled.to_f / fields.length * 100).to_i
  end
end

# Gemfile
gem "draper"

bundle install
rails generate decorator User
# app/decorators/user_decorator.rb が生成される

# app/decorators/user_decorator.rb
class UserDecorator < Draper::Decorator
  delegate_all  # 元のUserモデルのメソッドは全て委譲
 
  # 表示ロジックだけここに書く
  def display_name
    object.name.presence || object.email.split("@").first
  end
 
  def avatar_url
    if object.avatar.attached?
      h.rails_blob_url(object.avatar)
    else
      h.image_url("default_avatar.png")
    end
  end
 
  def formatted_joined_at
    object.joined_at.strftime("%Y年%m月%d日")
  end
 
  def membership_badge
    case object.membership_type
    when "premium"   then "プレミアム会員"
    when "corporate" then "法人会員"
    else "一般会員"
    end
  end
 
  def profile_completion_rate
    fields = [:name, :bio, :phone_number, :avatar]
    filled = fields.count { |f| object.send(f).present? }
    (filled.to_f / fields.length * 100).to_i
  end
end

# app/controllers/users_controller.rb
class UsersController < ApplicationController
  def show
    @user = User.find(params[:id]).decorate
    # または: @user = UserDecorator.decorate(User.find(params[:id]))
  end
 
  def index
    @users = User.all.decorate
    # コレクション全体を一括でデコレートできる
  end
end

<%# app/views/users/show.html.erb %>
<div class="profile">
  <img src="<%= @user.avatar_url %>" alt="<%= @user.display_name %>">
  <h1><%= @user.display_name %></h1>
  <span class="badge"><%= @user.membership_badge %></span>
  <p>登録日: <%= @user.formatted_joined_at %></p>
  <div class="progress" style="width: <%= @user.profile_completion_rate %>%">
    プロフィール完成度: <%= @user.profile_completion_rate %>%
  </div>
  <%# モデルのメソッドも委譲されるのでそのまま使える %>
  <% if @user.premium? %>
    <span>プレミアムコンテンツ利用中</span>
  <% end %>
</div>

# app/decorators/user_decorator.rb
require "delegate"
 
class UserDecorator < SimpleDelegator
  # SimpleDelegatorを継承すると、元オブジェクトの全メソッドが自動委譲される
  # def_delegatorsを明示的に書く必要がない
 
  def display_name
    name.presence || email.split("@").first
    # SimpleDelegatorのおかげで name, email が直接呼べる
  end
 
  def membership_badge
    case membership_type
    when "premium"   then "プレミアム会員"
    when "corporate" then "法人会員"
    else "一般会員"
    end
  end
 
  def formatted_joined_at
    joined_at.strftime("%Y年%m月%d日")
  end
 
  # 元のオブジェクトへのアクセスは __getobj__ で
  def original_user
    __getobj__
  end
end

# 使う側
user = User.find(params[:id])
decorated = UserDecorator.new(user)
 
decorated.display_name       # => "田中ケンタ"
decorated.premium?           # => true（SimpleDelegatorが委譲）
decorated.email              # => "kenta@example.com"
decorated.is_a?(User)        # => false（注意！）
decorated.__getobj__.is_a?(User) # => true

# 管理者向けには追加情報を表示
class AdminUserDecorator < UserDecorator
  def display_name
    "#{super} (ID: #{id})"  # UserDecoratorのdisplay_nameを拡張
  end
 
  def admin_notes
    internal_notes.presence || "ノートなし"
  end
 
  def last_login_summary
    return "未ログイン" unless last_login_at
 
    days_ago = ((Time.current - last_login_at) / 1.day).to_i
    "#{days_ago}日前（#{last_login_at.strftime('%m/%d %H:%M')}）"
  end
end

# コントローラでの使い分け
class UsersController < ApplicationController
  def show
    user = User.find(params[:id])
 
    @user = if current_user.admin?
              AdminUserDecorator.new(user)
            else
              UserDecorator.new(user)
            end
  end
end

<%# テンプレートは同じものを使える %>
<h1><%= @user.display_name %></h1>
<%# 管理者なら "田中ケンタ (ID: 42)"、一般なら "田中ケンタ" %>
 
<% if @user.respond_to?(:admin_notes) %>
  <p>管理メモ: <%= @user.admin_notes %></p>
<% end %>

# app/decorators/user_api_decorator.rb
class UserApiDecorator < SimpleDelegator
  def as_json(options = {})
    {
      id: id,
      display_name: name.presence || email.split("@").first,
      email: email,
      membership_label: membership_label,
      joined_at: joined_at.iso8601
    }
  end
 
  private
 
  def membership_label
    case membership_type
    when "premium"   then "プレミアム会員"
    when "corporate" then "法人会員"
    else "一般会員"
    end
  end
end

# コントローラ
class Api::V1::UsersController < ApplicationController
  def show
    user = User.find(params[:id])
    render json: UserApiDecorator.new(user).as_json
  end
end

# ログ機能をDecoratorで追加
class LoggingUserDecorator < SimpleDelegator
  def initialize(user, logger: Rails.logger)
    super(user)
    @logger = logger
  end
 
  def update_profile(attributes)
    @logger.info("[User] プロフィール更新開始 user_id=#{id}")
    result = __getobj__.update(attributes)
    if result
      @logger.info("[User] プロフィール更新成功 user_id=#{id}")
    else
      @logger.warn("[User] プロフィール更新失敗 user_id=#{id} errors=#{errors.full_messages}")
    end
    result
  end
end

# config/application.rb
module MyApp
  class Application < Rails::Application
    # Middlewareスタックは、リクエスト/レスポンスを包むDecoratorの連鎖
    config.middleware.use Rack::Attack        # レート制限Decorator
    config.middleware.use Rack::Cors          # CORSヘッダーDecorator
    config.middleware.insert_before 0, Rack::Deflater  # 圧縮Decorator
  end
end

# カスタムMiddlewareを作ると、Decoratorパターンそのもの
class RequestTimingMiddleware
  def initialize(app)
    @app = app  # 次のMiddleware（またはアプリ本体）を「包む」
  end
 
  def call(env)
    started_at = Time.current
    status, headers, body = @app.call(env)  # 本体への委譲
    elapsed = Time.current - started_at
 
    Rails.logger.info("Request took #{(elapsed * 1000).round}ms")
    headers["X-Request-Time"] = elapsed.to_s
 
    [status, headers, body]
  end
end

# spec/decorators/user_decorator_spec.rb
require "rails_helper"
 
RSpec.describe UserDecorator do
  # Draperのspec用ヘルパーを使う
  include Draper::ViewContext
 
  let(:user) { create(:user, name: "田中ケンタ", membership_type: "premium") }
  let(:decorated) { user.decorate }
 
  describe "#display_name" do
    context "名前が登録されている場合" do
      it "登録名を返す" do
        expect(decorated.display_name).to eq("田中ケンタ")
      end
    end
 
    context "名前が未登録の場合" do
      let(:user) { create(:user, name: nil, email: "kenta@example.com") }
 
      it "メールアドレスの@より前を返す" do
        expect(decorated.display_name).to eq("kenta")
      end
    end
  end
 
  describe "#membership_badge" do
    context "プレミアム会員の場合" do
      it "プレミアム会員を返す" do
        expect(decorated.membership_badge).to eq("プレミアム会員")
      end
    end
 
    context "一般会員の場合" do
      let(:user) { create(:user, membership_type: "general") }
 
      it "一般会員を返す" do
        expect(decorated.membership_badge).to eq("一般会員")
      end
    end
  end
 
  describe "#profile_completion_rate" do
    context "全フィールドが埋まっている場合" do
      let(:user) { create(:user, :with_full_profile) }
 
      it "100を返す" do
        expect(decorated.profile_completion_rate).to eq(100)
      end
    end
  end
end

# アンチパターン：深すぎるDecorator
user = LoggingDecorator.new(
  CachingDecorator.new(
    AdminUserDecorator.new(User.find(1))
  )
)
# どのDecoratorがどのメソッドを持っているか追えない