Skip to content

module Athena::Framework::Arguments::Resolvers::Interface #

Argument value resolvers handle resolving the arguments for a controller action from a request, or other source.

Custom resolvers can be defined by creating a service that implements this interface, and is tagged with ATH::Arguments::Resolvers::TAG, optionally with a priority to determine the order in which the resolvers are executed.

@[ADI::Register(tags: [{name: ATH::Arguments::Resolvers::TAG, priority: 10}])]
struct CustomResolver
  include Athena::Framework::Arguments::Resolvers::Interface

  # :inherit:
  def supports?(request : ATH::Request, argument : ATH::Arguments::ArgumentMetadata) : Bool
    # Define the logic that determines if `self` is able to resolve a value for the given request/argument.
    # This resolver would handle resolving a value for action arguments whose type is `MyCustomType`.
    argument.type == MyCustomType
  end

  # :inherit:
  def resolve(request : ATH::Request, argument : ATH::Arguments::ArgumentMetadata)
    # Return the resolved value. It could either come from the request itself, an injected service, or hardcoded.
    # `#resolve` is only executed if `#supports?` returns `true`.
    MyCustomType.new "foo"
  end
end

Direct including types

Athena::Framework::Arguments::Resolvers::DefaultValue Athena::Framework::Arguments::Resolvers::Enum Athena::Framework::Arguments::Resolvers::Request Athena::Framework::Arguments::Resolvers::RequestAttribute Athena::Framework::Arguments::Resolvers::UUID

Methods#

abstract #resolve(request : ATH::Request, argument : ATH::Arguments::ArgumentMetadata)#

Returns a value resolved from the provided request and argument.

View source

abstract #supports?(request : ATH::Request, argument : ATH::Arguments::ArgumentMetadata) : Bool#

Returns true if self is able to resolve a value from the provided request and argument.

View source