Class: ActionDispatch::Routing::RouteSet

362
363
364
365
366
367
368
369
370
371

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 362

def add_route(app, conditions = {}, requirements = {}, defaults = {}, name = nil, anchor = true)
  raise ArgumentError, "Invalid route name: '#{name}'" unless name.blank? || name.to_s.match(/^[_a-z]\w*$/i)

  path = build_path(conditions.delete(:path_info), requirements, SEPARATORS, anchor)
  conditions = build_conditions(conditions, valid_conditions, path.names.map { |x| x.to_sym })

  route = @set.add_route(app, path, conditions, defaults, name)
  named_routes[name] = route if name
  route
end

265
266
267

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 265

def append(&block)
  @append << block
end

598
599
600
601

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 598

def call(env)
  finalize!
  @router.call(env)
end

292
293
294
295
296
297
298

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 292

def clear!
  @finalized = false
  named_routes.clear
  set.clear
  formatter.clear
  @prepend.each { |blk| eval_block(blk) }
end

312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 312

def define_mounted_helper(name)
  return if MountedHelpers.method_defined?(name)

  routes = self
  MountedHelpers.class_eval do
    define_method "_#{name}" do
      RoutesProxy.new(routes, self._routes_context)
    end
  end

  MountedHelpers.class_eval <<-RUBY
    def #{name}
      @#{name} ||= _#{name}
    end
  RUBY
end

258
259
260
261
262
263

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 258

def draw(&block)
  clear! unless @disable_clear_and_finalize
  eval_block(block)
  finalize! unless @disable_clear_and_finalize
  nil
end

358
359
360

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 358

def empty?
  routes.empty?
end

273
274
275
276
277
278
279
280
281
282
283
284

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 273

def eval_block(block)
  if block.arity == 1
    raise "You are using the old router DSL which has been removed in Rails 3.1. " <<
      "Please check how to update your routes file at: http://www.engineyard.com/blog/2010/the-lowdown-on-routes-in-rails-3/"
  end
  mapper = Mapper.new(self)
  if default_scope
    mapper.with_default_scope(default_scope, &block)
  else
    mapper.instance_exec(&block)
  end
end

552
553
554

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 552

def extra_keys(options, recall={})
  generate_extras(options, recall).last
end

286
287
288
289
290

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 286

def finalize!
  return if @finalized
  @append.each { |blk| eval_block(blk) }
  @finalized = true
end

560
561
562

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 560

def generate(options, recall = {}, extras = false)
  Generator.new(options, recall, self, extras).generate
end

556
557
558

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 556

def generate_extras(options, recall={})
  generate(options, recall, true)
end

300
301
302
303

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 300

def install_helpers(destinations = [ActionController::Base, ActionView::Base], regenerate_code = false)
  Array(destinations).each { |d| d.module_eval { include Helpers } }
  named_routes.install(destinations, regenerate_code)
end

308
309
310

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 308

def mounted_helpers
  MountedHelpers
end

269
270
271

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 269

def prepend(&block)
  @prepend << block
end

603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 603

def recognize_path(path, environment = {})
  method = (environment[:method] || "GET").to_s.upcase
  path = Journey::Router::Utils.normalize_path(path) unless path =~ %r{://}

  begin
    env = Rack::MockRequest.env_for(path, {:method => method})
  rescue URI::InvalidURIError => e
    raise ActionController::RoutingError, e.message
  end

  req = @request_class.new(env)
  @router.recognize(req) do |route, matches, params|
    params.each do |key, value|
      if value.is_a?(String)
        value = value.dup.force_encoding(Encoding::BINARY) if value.encoding_aware?
        params[key] = URI.parser.unescape(value)
      end
    end

    dispatcher = route.app
    while dispatcher.is_a?(Mapper::Constraints) && dispatcher.matches?(env) do
      dispatcher = dispatcher.app
    end

    if dispatcher.is_a?(Dispatcher) && dispatcher.controller(params, false)
      dispatcher.prepare_params!(params)
      return params
    end
  end

  raise ActionController::RoutingError, "No route matches #{path.inspect}"
end

571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 571

def url_for(options)
  finalize!
  options = (options || {}).reverse_merge!(default_url_options)

  handle_positional_args(options)

  user, password = extract_authentication(options)
  path_segments  = options.delete(:_path_segments)
  script_name    = options.delete(:script_name)

  path = (script_name.blank? ? _generate_prefix(options) : script_name.chomp('/')).to_s

  path_options = options.except(*RESERVED_OPTIONS)
  path_options = yield(path_options) if block_given?

  path_addition, params = generate(path_options, path_segments || {})
  path << path_addition
  params.merge!(options[:params] || {})

  ActionDispatch::Http::URL.url_for(options.merge!({
    :path => path,
    :params => params,
    :user => user,
    :password => password
  }))
end

329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356

# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 329

def url_helpers
  @url_helpers ||= begin
    routes = self

    helpers = Module.new do
      extend ActiveSupport::Concern
      include UrlFor

      @_routes = routes
      class << self
        delegate :url_for, :to => '@_routes'
      end
      extend routes.named_routes.module

      # ROUTES TODO: install_helpers isn't great... can we make a module with the stuff that
      # we can include?
      # Yes plz - JP
      included do
        routes.install_helpers(self)
        singleton_class.send(:redefine_method, :_routes) { routes }
      end

      define_method(:_routes) { @_routes || routes }
    end

    helpers
  end
end