Class: Lotus::Routing::EndpointResolver Private

Inherits:

Object

• Object
• Lotus::Routing::EndpointResolver

Defined in:

lib/lotus/routing/endpoint_resolver.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Resolve duck-typed endpoints

Since:

• 0.1.0

Constant Summary

NAMING_PATTERN =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Since:

• 0.2.0

'%{controller}::%{action}'.freeze

ACTION_SEPARATOR =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Default separator for controller and action. A different separator can be passed to #initialize with the ‘:separator` option.

Examples:

require 'lotus/router'

router = Lotus::Router.new do
  get '/', to: 'articles#show'
end

See Also:

• #initialize
• #resolve

Since:

• 0.1.0

'#'.freeze

Instance Attribute Summary

• #action_separator ⇒ Object readonly private

Instance Method Summary

• #find(options) ⇒ Object private

  Finds a path from the given options.

• #initialize(options = {}) ⇒ Lotus::Routing::EndpointResolver constructor private

  Initialize an endpoint resolver.

• #resolve(options, &endpoint) ⇒ Endpoint private

  Resolve the given set of HTTP verb, path, endpoint and options.

Constructor Details

#initialize(options = {}) ⇒ Lotus::Routing::EndpointResolver

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Initialize an endpoint resolver

Examples:

Specify custom endpoint class

require 'lotus/router'

resolver = Lotus::Routing::EndpointResolver.new(endpoint: CustomEndpoint)
router   = Lotus::Router.new(resolver: resolver)

router.get('/', to: endpoint).dest # => #<CustomEndpoint:0x007f97f3359570 ...>

Specify custom Ruby namespace

require 'lotus/router'

resolver = Lotus::Routing::EndpointResolver.new(namespace: MyApp)
router   = Lotus::Router.new(resolver: resolver)

router.get('/', to: 'articles#show')
  # => Will look for: MyApp::Articles::Show

Specify custom pattern

require 'lotus/router'

resolver = Lotus::Routing::EndpointResolver.new(pattern: '%{controller}Controller::%{action}')
router   = Lotus::Router.new(resolver: resolver)

router.get('/', to: 'articles#show')
  # => Will look for: ArticlesController::Show

Specify custom controller-action separator

require 'lotus/router'

resolver = Lotus::Routing::EndpointResolver.new(separator: '@')
router   = Lotus::Router.new(resolver: resolver)

router.get('/', to: 'articles@show')
  # => Will look for: Articles::Show

Parameters:

• options (Hash) (defaults to: {}) —

  the options used to customize lookup behavior

Options Hash (options):

• :endpoint (Class) —

  the endpoint class that is returned by ‘#resolve`. (defaults to `Lotus::Routing::Endpoint`)

• :namespace (Class, Module) —

  the Ruby namespace where to lookup for controllers and actions. (defaults to ‘Object`)

• :pattern (String) —

  the string to interpolate in order to return an action name. This string SHOULD contain '%{controller}' and '%{action}', all the other keys will be ignored. See the examples below.

• :action_separator (String) —

  the sepatator between controller and action name. (defaults to ‘ACTION_SEPARATOR`)

Since:

• 0.1.0

# File 'lib/lotus/routing/endpoint_resolver.rb', line 96

def initialize(options = {})
  @endpoint_class   = options[:endpoint]         || Endpoint
  @namespace        = options[:namespace]        || Object
  @action_separator = options[:action_separator] || ACTION_SEPARATOR
  @pattern          = options[:pattern]          || NAMING_PATTERN
end

Instance Attribute Details

#action_separator ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Since:

• 0.1.0

# File 'lib/lotus/routing/endpoint_resolver.rb', line 33

def action_separator
  @action_separator
end

Instance Method Details

#find(options) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Finds a path from the given options.

Parameters:

• options (Hash) —

  the path description

Options Hash (options):

• :to (String, Proc, Class, Object#call) —

  the endpoint

• :namespace (String) —

  an optional namespace

Returns:

• (Object)

Since:

• 0.1.0

# File 'lib/lotus/routing/endpoint_resolver.rb', line 174

def find(options)
  options[:to]
end

#resolve(options, &endpoint) ⇒ Endpoint

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Resolve the given set of HTTP verb, path, endpoint and options. If it fails to resolve, it will mount the default endpoint to the given path, which returns an 404 (Not Found).

Examples:

Resolve to a Proc

require 'lotus/router'

router = Lotus::Router.new
router.get '/', to: ->(env) { [200, {}, ['Hi!']] }

Resolve to a class

require 'lotus/router'

router = Lotus::Router.new
router.get '/', to: RackMiddleware

Resolve to a Rack compatible object (respond to #call)

require 'lotus/router'

router = Lotus::Router.new
router.get '/', to: AnotherMiddleware.new

Resolve to a Lotus::Action from a string (see Lotus::Controller framework)

require 'lotus/router'

router = Lotus::Router.new
router.get '/', to: 'articles#show'

Resolve to a Lotus::Action (see Lotus::Controller framework)

require 'lotus/router'

router = Lotus::Router.new
router.get '/', to: Articles::Show

Resolve a redirect with a namespace

require 'lotus/router'

router = Lotus::Router.new
router.namespace 'users' do
  get '/home',           to: ->(env) { ... }
  redirect '/dashboard', to: '/home'
end

# GET /users/dashboard => 301 Location: "/users/home"

Parameters:

• options (Hash) —

  the options required to resolve the endpoint

Options Hash (options):

• :to (String, Proc, Class, Object#call) —

  the endpoint

• :namespace (String) —

  an optional routing namespace

Returns:

• (Endpoint) —

  this may vary according to the :endpoint option passed to #initialize

See Also:

• #initialize
• #find

Since:

• 0.1.0

# File 'lib/lotus/routing/endpoint_resolver.rb', line 160

def resolve(options, &endpoint)
  result = endpoint || find(options)
  resolve_callable(result) || resolve_matchable(result) || default
end