依存性の注入をRubyのサンプルコードで初心者向けに説明する

require 'net/smtp'

# メール通知のロジックを実装
class EmailService
  def initialize(from, smtp_server, port = 587)
    @from = from
    @smtp_server = smtp_server
    @port = port
  end

  def send(to, subject, message)
    msg = <<~MESSAGE
      From: #{@from}
      To: #{to}
      Subject: #{subject}

      #{message}
    MESSAGE

    Net::SMTP.start(@smtp_server, @port) do |smtp|
      smtp.send_message msg, @from, to
    end
  rescue StandardError => e
    puts "Failed to send email: #{e.message}"
  end
end

# 通知の送信を実装
class NotificationService
  def initialize
    # EmailService クラスのインスタンスを NotificationService クラス内で直接生成している
    @emailer = EmailService.new('noreply@example.com', 'smtp.example.com')
  end

  def notify(user_email, subject, message)
    @emailer.send(user_email, subject, message)
  end
end

# 使用例
notification_service = NotificationService.new
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

require 'net/smtp'
# EmailServiceクラスは変更なし
class EmailService
  def initialize(from, smtp_server, port = 587)
    @from = from
    @smtp_server = smtp_server
    @port = port
  end

  def send(to, subject, message)
    msg = <<~MESSAGE
      From: #{@from}
      To: #{to}
      Subject: #{subject}

      #{message}
    MESSAGE

    Net::SMTP.start(@smtp_server, @port) do |smtp|
      smtp.send_message msg, @from, to
    end
  rescue StandardError => e
    puts "Failed to send email: #{e.message}"
  end
end

class NotificationService
　# EmailService クラスのインスタンスを直接生成せず、引数として受け取る
  def initialize(sender)
    @sender = sender
  end

  def notify(user_contact, subject, message)
    @sender.send(user_contact, subject, message)
  end
end

# 使用例
email_service = EmailService.new('noreply@example.com', 'smtp.example.com')
# email_service を引数として渡す
notification_service = NotificationService.new(email_service)
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

# 依存性の注入を使っていない場合
class NotificationService
  def initialize
    # SMTPサーバのホスト名を変更する場合、第2引数の 'smtp.example.com' も修正が必要になってしまう
    @emailer = EmailService.new('noreply@example.com', 'smtp.example.com')
  end

  def notify(user_email, subject, message)
    @emailer.send(user_email, subject, message)
  end
end

# 使用例
notification_service = NotificationService.new
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

# 依存性の注入を使っている場合
class NotificationService
　# EmailServiceクラスのインスタンスを引数で受け取る
  def initialize(sender)
    @sender = sender
  end

  def notify(user_contact, subject, message)
    @sender.send(user_contact, subject, message)
  end
end

# SMTPサーバのホスト名を 'smtp.example.com' から 'new_smtp.example.com' へ変更する
email_service = EmailService.new('noreply@example.com', 'new_smtp.example.com')

# ホスト名が変わったとしても email_service を引数として渡せばいいだけ
notification_service = NotificationService.new(email_service)
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

# 依存性の注入を使っていない場合
class NotificationService
  def initialize
    # NotificationService クラス内で EmailService クラスのインスタンスを生成（＝依存している）
    @emailer = EmailService.new('noreply@example.com', 'smtp.example.com')
  end

  def notify(user_email, subject, message)
    @emailer.send(user_email, subject, message)
  end
end

# 使用例
notification_service = NotificationService.new
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

require 'twilio-ruby'
# 新たにSMS通知の機能も実装
class SmsService
  def initialize(api_key, password)
    @api_key = api_key
    @password = password
    @client = Twilio::REST::Client.new(api_key, password)
  end

  def send(user_phone_number, subject, message)
    begin
      message = "[#{subject}] #{message}"

      @client.messages.create(
        from: '+15555555555',
        to: user_phone_number,
        body: message
      )
    rescue Twilio::REST::RequestError => e
      puts Failed to send sms: #{e.message}"
    end
  end
end

# 依存性の注入を使っている場合
class NotificationService
　# 引数が EmailService クラスのインスタンスでも SmsService クラスのインスタンスでも変わらない
  def initialize(sender)
    @sender = sender
  end

  def notify(user_contact, subject, message)
    @sender.send(user_contact, subject, message)
  end
end

SmsService.new(ENV['TWILIO_API_KEY'], ENV['TWILIO_PASSWORD'])

# email_service ではなく sms_service を引数として渡せば後は同じ
notification_service = NotificationService.new(sms_service)
notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')

# 依存性の注入を使っていない場合
describe NotificationService do
  it '通知の送信に成功する' do
    # EmailService の実際のインスタンスが生成されるため、メールサーバーへの接続が発生しうる
    notification_service = NotificationService.new

    # テスト実行時に実際にメールを送信しないよう、Net::SMTP をモックするなどの工夫が必要
    # ↑はEmailServiceクラスの内部挙動に依存してしまっている
    allow(Net::SMTP).to receive(:start).and_return(true)

    expect(notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')).to be_truthy
  end
end

# 依存性の注入を使う場合
describe NotificationService do
  it '通知の送信に成功する' do
    # double メソッドで EmailService クラス自体をモック化
    mock_email_service = double('EmailService')
    # mock_email_service が send メソッドを受け取った時に true を返すよう設定
    allow(mock_email_service).to receive(:send).and_return(true)

    notification_service = NotificationService.new(mock_email_service)
    expect(notification_service.notify('user@example.com', 'Welcome!', 'Welcome to our service!')).to be_truthy
  end
end