Route is an internal class used to wrap a single route attributes.
Plugins should not depend on any method on this class or instantiate new Route objects. Instead use the factory method, Rack::Mount::RouteSet#add_route to create new routes and add them to the set.
Valid rack application to call if conditions are met
A hash of conditions to match against. Conditions may be expressed as strings or regexps to match against.
A hash of values that always gets merged into the parameters hash
Symbol identifier for the route used with named route generations
# File lib/rack/mount/route.rb, line 27 def initialize(app, conditions, defaults, name) unless app.respond_to?(:call) raise ArgumentError, 'app must be a valid rack application' ' and respond to call' end @app = app @name = name ? name.to_sym : nil @defaults = (defaults || {}).freeze @conditions = {} conditions.each do |method, pattern| next unless method && pattern pattern = Regexp.compile("\\A#{Regexp.escape(pattern)}\\Z") if pattern.is_a?(String) if pattern.is_a?(Regexp) pattern = Utils.normalize_extended_expression(pattern) pattern = RegexpWithNamedGroups.new(pattern) pattern.extend(GeneratableRegexp::InstanceMethods) pattern.defaults = @defaults end @conditions[method] = pattern.freeze end @named_captures = {} @conditions.map { |method, condition| next unless condition.respond_to?(:named_captures) @named_captures[method] = Hash[condition.named_captures.map { |k, v| [k.to_sym, v.last - 1] }].freeze } @named_captures.freeze @has_significant_params = @conditions.any? { |method, condition| (condition.respond_to?(:required_params) && condition.required_params.any?) || (condition.respond_to?(:required_defaults) && condition.required_defaults.any?) } if @conditions.has_key?(:path_info) && !Utils.regexp_anchored?(@conditions[:path_info]) @prefix = true @app = Prefix.new(@app) else @prefix = false end @conditions.freeze end
# File lib/rack/mount/route.rb, line 98 def generate(method, params = {}, recall = {}, options = {}) if method.nil? result = Hash[@conditions.map { |m, condition| [m, condition.generate(params, recall, options)] if condition.respond_to?(:generate) }] return nil if result.values.compact.empty? else if condition = @conditions[method] if condition.respond_to?(:generate) result = condition.generate(params, recall, options) end end end if result @defaults.each do |key, value| params.delete(key) if params[key] == value end end result end
# File lib/rack/mount/route.rb, line 84 def generation_keys @conditions.inject({}) { |keys, (_, condition)| if condition.respond_to?(:required_defaults) keys.merge!(condition.required_defaults) else keys end } end
# File lib/rack/mount/route.rb, line 79 def prefix? @prefix end
# File lib/rack/mount/route.rb, line 94 def significant_params? @has_significant_params end