Module: Hanami::Interactor::LegacyInterface

Defined in:

lib/hanami/interactor.rb

Overview

Interactor legacy interface

Since:

• 0.3.5

Instance Method Summary

• #call ⇒ Hanami::Interactor::Result

  Triggers the operation and return a result.

• #initialize(*args) ⇒ Object

Instance Method Details

#call ⇒ Hanami::Interactor::Result

Triggers the operation and return a result.

All the instance variables will be available in the result.

ATTENTION: This must be implemented by the including class.

Examples:

Expose instance variables in result payload

require 'hanami/interactor'

class Signup
  include Hanami::Interactor
  expose :user, :params

  def initialize(params)
    @params = params
    @foo    = 'bar'
  end

  def call
    @user = UserRepository.new.create(@params)
  end
end

result = Signup.new(name: 'Luca').call
result.failure? # => false
result.successful? # => true

result.user   # => #<User:0x007fa311105778 @id=1 @name="Luca">
result.params # => { :name=>"Luca" }
result.foo    # => raises NoMethodError

Failed precondition

require 'hanami/interactor'

class Signup
  include Hanami::Interactor
  expose :user

  def initialize(params)
    @params = params
  end

  # THIS WON'T BE INVOKED BECAUSE #valid? WILL RETURN false
  def call
    @user = UserRepository.new.create(@params)
  end

  private
  def valid?
    @params.valid?
  end
end

result = Signup.new(name: nil).call
result.successful? # => false
result.failure? # => true

result.user   # => #<User:0x007fa311105778 @id=nil @name="Luca">

Bad usage

require 'hanami/interactor'

class Signup
  include Hanami::Interactor

  # Method #call is not defined
end

Signup.new.call # => NoMethodError

Returns:

• (Hanami::Interactor::Result) —

  the result of the operation

Raises:

• (NoMethodError) —

  if this isn’t implemented by the including class.

Since:

• 0.3.5

# File 'lib/hanami/interactor.rb', line 271

def call
  _call { super }
end

#initialize(*args) ⇒ Object

Since:

• 0.3.5

# File 'lib/hanami/interactor.rb', line 185

def initialize(*args, **kwargs)
  super
ensure
  @__result = ::Hanami::Interactor::Result.new
end