Class: Grape::Router

Inherits:
Object
  • Object
show all
Defined in:
lib/grape/router.rb,
lib/grape/router/route.rb,
lib/grape/router/pattern.rb,
lib/grape/router/base_route.rb,
lib/grape/router/greedy_route.rb,
lib/grape/router/mustermann_pattern.rb

Defined Under Namespace

Classes: BaseRoute, GreedyRoute, MustermannPattern, Pattern, Route

Constant Summary collapse

DEFAULT_RESPONSE_HEADERS = 
Grape::Util::Header.new.merge('X-Cascade' => 'pass').freeze
DEFAULT_RESPONSE_BODY = 
['404 Not Found'].freeze

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Router

Returns a new instance of Router.



13
14
15
16
17
18
 
# File 'lib/grape/router.rb', line 13

def initialize
  @neutral_map = []
  @neutral_regexes = []
  @map = Hash.new { |hash, key| hash[key] = [] }
  @optimized_map = Hash.new { |hash, key| hash[key] = // }
end

Class Method Details

.normalize_path(path) ⇒ Object

Deprecated.

Use Util::PathNormalizer.call instead.



6
7
8
9
10
11
 
# File 'lib/grape/router.rb', line 6

def self.normalize_path(path)
  Grape.deprecator.warn(
    '`Grape::Router.normalize_path` is deprecated. Use `Grape::Util::PathNormalizer.call` instead.'
  )
  Grape::Util::PathNormalizer.call(path)
end

Instance Method Details

#append(route) ⇒ Object 



35
36
37
 
# File 'lib/grape/router.rb', line 35

def append(route)
  @map[route.request_method] << route
end

#associate_routes(greedy_route) ⇒ Object 



39
40
41
42
 
# File 'lib/grape/router.rb', line 39

def associate_routes(greedy_route)
  @neutral_regexes << greedy_route.to_regexp(@neutral_map.length)
  @neutral_map << greedy_route
end

#call(env) ⇒ Object 



44
45
46
47
48
49
50
51
 
# File 'lib/grape/router.rb', line 44

def call(env)
  with_optimization do
    input = Grape::Util::PathNormalizer.call(env[Rack::PATH_INFO])
    method = env[Rack::REQUEST_METHOD]
    response, route = identity(input, method, env)
    response || rotation(input, method, env, route)
  end
end

#compile! ⇒ Object 



20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
# File 'lib/grape/router.rb', line 20

def compile!
  return if @compiled

  @union = Regexp.union(@neutral_regexes)
  @neutral_regexes = nil
  (Grape::HTTP_SUPPORTED_METHODS + ['*']).each do |method|
    next unless @map.key?(method)

    routes = @map[method]
    optimized_map = routes.map.with_index { |route, index| route.to_regexp(index) }
    @optimized_map[method] = Regexp.union(optimized_map)
  end
  @compiled = true
end

#recognize_path(input) ⇒ Object 



53
54
55
56
57
58
 
# File 'lib/grape/router.rb', line 53

def recognize_path(input)
  any = with_optimization { greedy_match?(input) }
  return if any == default_response

  any.endpoint
end