Class: ActionDispatch::Routing::RouteSet

Inherits:
Object
  • Object
show all
Defined in:
lib/action_dispatch/routing/route_set.rb

Overview

:stopdoc:

Defined Under Namespace

Modules: MountedHelpers Classes: Config, CustomUrlHelper, Dispatcher, Generator, NamedRouteCollection, StaticDispatcher

Constant Summary collapse

PATH =

strategy for building URLs to send to the client

->(options) { ActionDispatch::Http::URL.path_for(options) }
UNKNOWN =
->(options) { ActionDispatch::Http::URL.url_for(options) }
DEFAULT_CONFIG =
Config.new(nil, false)
RESERVED_OPTIONS =
[:host, :protocol, :port, :subdomain, :domain, :tld_length,
:trailing_slash, :anchor, :params, :only_path, :script_name,
:original_script_name, :relative_url_root]

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(config = DEFAULT_CONFIG) ⇒ RouteSet

Returns a new instance of RouteSet.



365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
# File 'lib/action_dispatch/routing/route_set.rb', line 365

def initialize(config = DEFAULT_CONFIG)
  self.named_routes = NamedRouteCollection.new
  self.resources_path_names = self.class.default_resources_path_names
  self.default_url_options = {}

  @config                     = config
  @append                     = []
  @prepend                    = []
  @disable_clear_and_finalize = false
  @finalized                  = false
  @env_key                    = "ROUTES_#{object_id}_SCRIPT_NAME"

  @set    = Journey::Routes.new
  @router = Journey::Router.new @set
  @formatter = Journey::Formatter.new self
  @polymorphic_mappings = {}
end

Instance Attribute Details

#default_scopeObject

Returns the value of attribute default_scope.



335
336
337
# File 'lib/action_dispatch/routing/route_set.rb', line 335

def default_scope
  @default_scope
end

#default_url_optionsObject

Returns the value of attribute default_url_options.



337
338
339
# File 'lib/action_dispatch/routing/route_set.rb', line 337

def default_url_options
  @default_url_options
end

#disable_clear_and_finalizeObject

Returns the value of attribute disable_clear_and_finalize.



336
337
338
# File 'lib/action_dispatch/routing/route_set.rb', line 336

def disable_clear_and_finalize
  @disable_clear_and_finalize
end

#env_keyObject (readonly)

Returns the value of attribute env_key.



338
339
340
# File 'lib/action_dispatch/routing/route_set.rb', line 338

def env_key
  @env_key
end

#formatterObject

Returns the value of attribute formatter.



335
336
337
# File 'lib/action_dispatch/routing/route_set.rb', line 335

def formatter
  @formatter
end

#named_routesObject

Returns the value of attribute named_routes.



335
336
337
# File 'lib/action_dispatch/routing/route_set.rb', line 335

def named_routes
  @named_routes
end

#polymorphic_mappingsObject (readonly)

Returns the value of attribute polymorphic_mappings.



338
339
340
# File 'lib/action_dispatch/routing/route_set.rb', line 338

def polymorphic_mappings
  @polymorphic_mappings
end

#resources_path_namesObject

Returns the value of attribute resources_path_names.



336
337
338
# File 'lib/action_dispatch/routing/route_set.rb', line 336

def resources_path_names
  @resources_path_names
end

#routerObject

Returns the value of attribute router.



335
336
337
# File 'lib/action_dispatch/routing/route_set.rb', line 335

def router
  @router
end

#setObject Also known as: routes

Returns the value of attribute set.



335
336
337
# File 'lib/action_dispatch/routing/route_set.rb', line 335

def set
  @set
end

Class Method Details

.default_resources_path_namesObject



342
343
344
# File 'lib/action_dispatch/routing/route_set.rb', line 342

def self.default_resources_path_names
  { new: "new", edit: "edit" }
end

.new_with_config(config) ⇒ Object



346
347
348
349
350
351
352
353
354
355
356
357
358
359
# File 'lib/action_dispatch/routing/route_set.rb', line 346

def self.new_with_config(config)
  route_set_config = DEFAULT_CONFIG

  # engines apparently don't have this set
  if config.respond_to? :relative_url_root
    route_set_config.relative_url_root = config.relative_url_root
  end

  if config.respond_to? :api_only
    route_set_config.api_only = config.api_only
  end

  new route_set_config
end

Instance Method Details

#add_polymorphic_mapping(klass, options, &block) ⇒ Object



605
606
607
# File 'lib/action_dispatch/routing/route_set.rb', line 605

def add_polymorphic_mapping(klass, options, &block)
  @polymorphic_mappings[klass] = CustomUrlHelper.new(klass, options, &block)
end

#add_route(mapping, name) ⇒ Object

Raises:

  • (ArgumentError)


574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
# File 'lib/action_dispatch/routing/route_set.rb', line 574

def add_route(mapping, name)
  raise ArgumentError, "Invalid route name: '#{name}'" unless name.blank? || name.to_s.match(/^[_a-z]\w*$/i)

  if name && named_routes[name]
    raise ArgumentError, "Invalid route name, already in use: '#{name}' \n" \
      "You may have defined two routes with the same name using the `:as` option, or " \
      "you may be overriding a route already defined by a resource with the same naming. " \
      "For the latter, you can restrict the routes created with `resources` as explained here: \n" \
      "https://guides.rubyonrails.org/routing.html#restricting-the-routes-created"
  end

  route = @set.add_route(name, mapping)
  named_routes[name] = route if name

  if route.segment_keys.include?(:controller)
    ActiveSupport::Deprecation.warn(<<-MSG.squish)
      Using a dynamic :controller segment in a route is deprecated and
      will be removed in Rails 6.1.
    MSG
  end

  if route.segment_keys.include?(:action)
    ActiveSupport::Deprecation.warn(<<-MSG.squish)
      Using a dynamic :action segment in a route is deprecated and
      will be removed in Rails 6.1.
    MSG
  end

  route
end

#add_url_helper(name, options, &block) ⇒ Object



609
610
611
# File 'lib/action_dispatch/routing/route_set.rb', line 609

def add_url_helper(name, options, &block)
  named_routes.add_url_helper(name, options, &block)
end

#api_only?Boolean

Returns:

  • (Boolean)


393
394
395
# File 'lib/action_dispatch/routing/route_set.rb', line 393

def api_only?
  @config.api_only
end

#append(&block) ⇒ Object



413
414
415
# File 'lib/action_dispatch/routing/route_set.rb', line 413

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

#call(env) ⇒ Object



831
832
833
834
835
# File 'lib/action_dispatch/routing/route_set.rb', line 831

def call(env)
  req = make_request(env)
  req.path_info = Journey::Router::Utils.normalize_path(req.path_info)
  @router.serve(req)
end

#clear!Object



437
438
439
440
441
442
443
444
# File 'lib/action_dispatch/routing/route_set.rb', line 437

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

#define_mounted_helper(name, script_namer = nil) ⇒ Object



459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
# File 'lib/action_dispatch/routing/route_set.rb', line 459

def define_mounted_helper(name, script_namer = nil)
  return if MountedHelpers.method_defined?(name)

  routes = self
  helpers = routes.url_helpers

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

  MountedHelpers.class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
    def #{name}
      @_#{name} ||= _#{name}
    end
  RUBY
end

#draw(&block) ⇒ Object



406
407
408
409
410
411
# File 'lib/action_dispatch/routing/route_set.rb', line 406

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

#eager_load!Object



383
384
385
386
387
# File 'lib/action_dispatch/routing/route_set.rb', line 383

def eager_load!
  router.eager_load!
  routes.each(&:eager_load!)
  nil
end

#empty?Boolean

Returns:

  • (Boolean)


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

def empty?
  routes.empty?
end

#extra_keys(options, recall = {}) ⇒ Object

Generate the path indicated by the arguments, and return an array of the keys that were not used to generate it.



758
759
760
# File 'lib/action_dispatch/routing/route_set.rb', line 758

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

#finalize!Object



431
432
433
434
435
# File 'lib/action_dispatch/routing/route_set.rb', line 431

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

#find_relative_url_root(options) ⇒ Object



785
786
787
# File 'lib/action_dispatch/routing/route_set.rb', line 785

def find_relative_url_root(options)
  options.delete(:relative_url_root) || relative_url_root
end

#find_script_name(options) ⇒ Object



781
782
783
# File 'lib/action_dispatch/routing/route_set.rb', line 781

def find_script_name(options)
  options.delete(:script_name) || find_relative_url_root(options) || ""
end

#generate_extras(options, recall = {}) ⇒ Object



762
763
764
765
766
# File 'lib/action_dispatch/routing/route_set.rb', line 762

def generate_extras(options, recall = {})
  route_key = options.delete :use_route
  path, params = generate(route_key, options, recall)
  return path, params.keys
end

#mounted_helpersObject

Contains all the mounted helpers across different engines and the ‘main_app` helper for the application. You can include this in your classes if you want to access routes for other engines.



455
456
457
# File 'lib/action_dispatch/routing/route_set.rb', line 455

def mounted_helpers
  MountedHelpers
end

#optimize_routes_generation?Boolean

Returns:

  • (Boolean)


777
778
779
# File 'lib/action_dispatch/routing/route_set.rb', line 777

def optimize_routes_generation?
  default_url_options.empty?
end

#path_for(options, route_name = nil) ⇒ Object



789
790
791
# File 'lib/action_dispatch/routing/route_set.rb', line 789

def path_for(options, route_name = nil)
  url_for(options, route_name, PATH)
end

#prepend(&block) ⇒ Object



417
418
419
# File 'lib/action_dispatch/routing/route_set.rb', line 417

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

#recognize_path(path, environment = {}) ⇒ Object



837
838
839
840
841
842
843
844
845
846
847
848
849
850
# File 'lib/action_dispatch/routing/route_set.rb', line 837

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

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

  req = make_request(env)
  recognize_path_with_request(req, path, extras)
end

#recognize_path_with_request(req, path, extras, raise_on_missing: true) ⇒ Object



852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
# File 'lib/action_dispatch/routing/route_set.rb', line 852

def recognize_path_with_request(req, path, extras, raise_on_missing: true)
  @router.recognize(req) do |route, params|
    params.merge!(extras)
    params.each do |key, value|
      if value.is_a?(String)
        value = value.dup.force_encoding(Encoding::BINARY)
        params[key] = URI.parser.unescape(value)
      end
    end
    req.path_parameters = params
    app = route.app
    if app.matches?(req) && app.dispatcher?
      begin
        req.controller_class
      rescue NameError
        raise ActionController::RoutingError, "A route matches #{path.inspect}, but references missing controller: #{params[:controller].camelize}Controller"
      end

      return req.path_parameters
    elsif app.matches?(req) && app.engine?
      path_parameters = app.rack_app.routes.recognize_path_with_request(req, path, extras, raise_on_missing: false)
      return path_parameters if path_parameters
    end
  end

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

#relative_url_rootObject



389
390
391
# File 'lib/action_dispatch/routing/route_set.rb', line 389

def relative_url_root
  @config.relative_url_root
end

#request_classObject



397
398
399
# File 'lib/action_dispatch/routing/route_set.rb', line 397

def request_class
  ActionDispatch::Request
end

#url_for(options, route_name = nil, url_strategy = UNKNOWN) ⇒ Object

The options argument must be a hash whose keys are symbols.



794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
# File 'lib/action_dispatch/routing/route_set.rb', line 794

def url_for(options, route_name = nil, url_strategy = UNKNOWN)
  options = default_url_options.merge options

  user = password = nil

  if options[:user] && options[:password]
    user     = options.delete :user
    password = options.delete :password
  end

  recall = options.delete(:_recall) { {} }

  original_script_name = options.delete(:original_script_name)
  script_name = find_script_name options

  if original_script_name
    script_name = original_script_name + script_name
  end

  path_options = options.dup
  RESERVED_OPTIONS.each { |ro| path_options.delete ro }

  path, params = generate(route_name, path_options, recall)

  if options.key? :params
    params.merge! options[:params]
  end

  options[:path]        = path
  options[:script_name] = script_name
  options[:params]      = params
  options[:user]        = user
  options[:password]    = password

  url_strategy.call options
end

#url_helpers(supports_path = true) ⇒ Object



478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
# File 'lib/action_dispatch/routing/route_set.rb', line 478

def url_helpers(supports_path = true)
  routes = self

  Module.new do
    extend ActiveSupport::Concern
    include UrlFor

    # Define url_for in the singleton level so one can do:
    # Rails.application.routes.url_helpers.url_for(args)
    proxy_class = Class.new do
      include UrlFor
      include routes.named_routes.path_helpers_module
      include routes.named_routes.url_helpers_module

      attr_reader :_routes

      def initialize(routes)
        @_routes = routes
      end

      def optimize_routes_generation?
        @_routes.optimize_routes_generation?
      end
    end

    @_proxy = proxy_class.new(routes)

    class << self
      def url_for(options)
        @_proxy.url_for(options)
      end

      def full_url_for(options)
        @_proxy.full_url_for(options)
      end

      def route_for(name, *args)
        @_proxy.route_for(name, *args)
      end

      def optimize_routes_generation?
        @_proxy.optimize_routes_generation?
      end

      def polymorphic_url(record_or_hash_or_array, options = {})
        @_proxy.polymorphic_url(record_or_hash_or_array, options)
      end

      def polymorphic_path(record_or_hash_or_array, options = {})
        @_proxy.polymorphic_path(record_or_hash_or_array, options)
      end

      def _routes; @_proxy._routes; end
      def url_options; {}; end
    end

    url_helpers = routes.named_routes.url_helpers_module

    # Make named_routes available in the module singleton
    # as well, so one can do:
    # Rails.application.routes.url_helpers.posts_path
    extend url_helpers

    # Any class that includes this module will get all
    # named routes...
    include url_helpers

    if supports_path
      path_helpers = routes.named_routes.path_helpers_module

      include path_helpers
      extend path_helpers
    end

    # plus a singleton class method called _routes ...
    included do
      redefine_singleton_method(:_routes) { routes }
    end

    # And an instance method _routes. Note that
    # UrlFor (included in this module) add extra
    # conveniences for working with @_routes.
    define_method(:_routes) { @_routes || routes }

    define_method(:_generate_paths_by_default) do
      supports_path
    end

    private :_generate_paths_by_default
  end
end