Module: Hanami::Interactor::Interface

Defined in:
lib/hanami/interactor.rb

Overview

Interactor interface

Since:

  • 0.3.5

Instance Method Summary collapse

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:

Raises:

  • (NoMethodError) —

    if this isn’t implemented by the including class.

Since:

  • 0.3.5



262
263
264
 
# File 'lib/hanami/interactor.rb', line 262

def call
  _call { super }
end

#initialize(*args) ⇒ Hanami::Interactor

Initialize an interactor

It accepts arbitrary number of arguments. Developers can override it.

Examples:

Override #initialize

require 'hanami/interactor'

class UpdateProfile
  include Hanami::Interactor

  def initialize(user, params)
    @user   = user
    @params = params
  end

  def call
    # ...
  end
end

Parameters:

  • args (Array<Object>) —

    arbitrary number of arguments

Returns:

Since:

  • 0.3.5



183
184
185
186
187
 
# File 'lib/hanami/interactor.rb', line 183

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