Call

Services can only be called via .call and .call! methods.

The .call method will only fail if it catches an exception in the input arguments. Internal and output attributes, as well as methods for failures — all this will be collected in the result.

The .call! method will fail if it catches any exception.

Via .call

UsersService::Accept.call(user: User.first)

Via .call!

UsersService::Accept.call!(user: User.first)

Result

All services have the result of their work. For example, in case of success this call:

service_result = UsersService::Accept.call!(user: User.first)

Will return this:

#<Servactory::Result:0x0000000107ad9e88 @user="...">

And then work with thе result in this way:

Notification::SendJob.perform_later(service_result.user.id)

Info

From outside the service, can get information about its input, internal, and output attributes.

It is valuable, when implementing complex class handling, for example.

For example, the following attributes are described in a service:

class BuildFullName < ApplicationService::Base
  input :first_name, type: String
  input :middle_name, type: String, required: false
  input :last_name, type: String

  internal :prepared_full_name, type: String

  output :full_name, type: String

  # ...
end

Get information about them in the following ways:

BuildFullName.info

# => <Servactory::Info::Result:0x00000001118c7078 @inputs=[:first_name, :middle_name, :last_name], @internals=[:prepared_full_name], @outputs=[:full_name]>

BuildFullName.info.inputs

# => [:first_name, :middle_name, :last_name]

BuildFullName.info.internals

# => [:prepared_full_name]

BuildFullName.info.outputs

# => [:full_name]