module ActionDispatch::Routing::Mapper::Resources

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1512
def collection(&block)
  unless resource_scope?
    raise ArgumentError, "can't use collection outside resource(s) scope"
  end

  with_scope_level(:collection) do
    path_scope(parent_resource.collection_scope, &block)
  end
end

Чтобы добавить маршрут в коллекцию:

resources :photos do
  collection do
    get 'search'
  end
end

Это позволит Rails распознавать пути, такие как /photos/search с GET и маршрутизировать к действию поиска PhotosController. Это также создаст вспомогательные функции маршрута search_photos_url и search_photos_path.

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1622
def draw(name)
  path = @draw_paths.find do |_path|
    File.exist? "#{_path}/#{name}.rb"
  end

  unless path
    msg  = "Your router tried to #draw the external file #{name}.rb,\n" \
           "but the file was not found in:\n\n"
    msg += @draw_paths.map { |_path| " * #{_path}" }.join("\n")
    raise ArgumentError, msg
  end

  route_path = "#{path}/#{name}.rb"
  instance_eval(File.read(route_path), route_path.to_s)
end

Загружает другой файл маршрутов с заданным name , расположенный в каталоге config/routes. В этом файле вы можете использовать обычный DSL маршрутизации, но не окружайте его блоком Rails.application.routes.draw.

# config/routes.rb
Rails.application.routes.draw do
  draw :admin                 # Loads `config/routes/admin.rb`
  draw "third_party/some_gem" # Loads `config/routes/third_party/some_gem.rb`
end

# config/routes/admin.rb
namespace :admin do
  resources :accounts
end

# config/routes/third_party/some_gem.rb
mount SomeGem::Engine, at: "/some_gem"

ВНИМАНИЕ: Используйте эту функцию с осторожностью. Наличие нескольких файлов маршрутов может отрицательно повлиять на обнаружение и читаемость. Для большинства приложений — даже тех, которые имеют несколько сотен маршрутов — разработчикам проще иметь один файл маршрутов.

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1644
def match(path, *rest, &block)
  if rest.empty? && Hash === path
    options  = path
    path, to = options.find { |name, _value| name.is_a?(String) }

    raise ArgumentError, "Route path not specified" if path.nil?

    case to
    when Symbol
      options[:action] = to
    when String
      if to.include?("#")
        options[:to] = to
      else
        options[:controller] = to
      end
    else
      options[:to] = to
    end

    options.delete(path)
    paths = [path]
  else
    options = rest.pop || {}
    paths = [path] + rest
  end

  if options.key?(:defaults)
    defaults(options.delete(:defaults)) { map_match(paths, options, &block) }
  else
    map_match(paths, options, &block)
  end
end

Сопоставляет шаблон URL-адреса с одним или несколькими маршрутами. Для получения дополнительной информации см. match.

match 'path' => 'controller#action', via: :patch
match 'path', to: 'controller#action', via: :post
match 'path', 'otherpath', on: :member, via: :get

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1533
def member(&block)
  unless resource_scope?
    raise ArgumentError, "can't use member outside resource(s) scope"
  end

  with_scope_level(:member) do
    if shallow?
      shallow_scope {
        path_scope(parent_resource.member_scope, &block)
      }
    else
      path_scope(parent_resource.member_scope, &block)
    end
  end
end

Чтобы добавить маршрут участника, добавьте блок участника в блок ресурса:

resources :photos do
  member do
    get 'preview'
  end
end

Это распознает /photos/1/preview с GET и маршрутизирует к действию предварительного просмотра PhotosController. Это также создаст вспомогательные функции preview_photo_url и preview_photo_path.

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1580
def namespace(path, options = {})
  if resource_scope?
    nested { super }
  else
    super
  end
end

См. ActionDispatch::Routing::Mapper::Scoping#namespace.

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1304
def resource(*resources, &block)
  options = resources.extract_options!.dup

  if apply_common_behavior_for(:resource, resources, options, &block)
    return self
  end

  with_scope_level(:resource) do
    options = apply_action_options options
    resource_scope(SingletonResource.new(resources.pop, api_only?, @scope[:shallow], options)) do
      yield if block_given?

      concerns(options[:concerns]) if options[:concerns]

      new do
        get :new
      end if parent_resource.actions.include?(:new)

      set_member_mappings_for_resource

      collection do
        post :create
      end if parent_resource.actions.include?(:create)
    end
  end

  self
end

Иногда у вас есть ресурс, который клиенты всегда ищут без ссылки на ID. Распространенный пример, /profile всегда показывает профиль текущего пользователя. В этом случае вы можете использовать единственный ресурс для сопоставления /profile (а не /profile/:id) с действием show:

resource :profile

Это создает шесть различных маршрутов в вашем приложении, все они отображаются на контроллер Profiles (обратите внимание, что контроллер назван по множественному числу):

GET       /profile/new
GET       /profile
GET       /profile/edit
PATCH/PUT /profile
DELETE    /profile
POST      /profile

Если вы хотите, чтобы экземпляры модели работали с этим ресурсом через идентификацию записей (например, в form_with или redirect_to), вам нужно будет вызвать resolve:

resource :profile
resolve('Profile') { [:profile] }

# Enables this to work with singular routes:
form_with(model: @profile) {}

Параметры

Принимает те же параметры, что и resources

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1470
def resources(*resources, &block)
  options = resources.extract_options!.dup

  if apply_common_behavior_for(:resources, resources, options, &block)
    return self
  end

  with_scope_level(:resources) do
    options = apply_action_options options
    resource_scope(Resource.new(resources.pop, api_only?, @scope[:shallow], options)) do
      yield if block_given?

      concerns(options[:concerns]) if options[:concerns]

      collection do
        get  :index if parent_resource.actions.include?(:index)
        post :create if parent_resource.actions.include?(:create)
      end

      new do
        get :new
      end if parent_resource.actions.include?(:new)

      set_member_mappings_for_resource
    end
  end

  self
end

В Rails, маршрут ресурса обеспечивает сопоставление между HTTP-глаголами и URL-адресами и действиями контроллера. По соглашению, каждое действие также сопоставляется с определенными операциями CRUD в базе данных. Одна запись в файле маршрутизации, такая как

resources :photos

создает семь различных маршрутов в вашем приложении, все они отображаются на контроллер Photos.

Resources также может быть вложен бесконечно с помощью этого синтаксиса блока:

resources :photos do
  resources :comments
end

Это генерирует следующие маршруты комментариев:

GET       /photos/:photo_id/comments
GET       /photos/:photo_id/comments/new
POST      /photos/:photo_id/comments
GET       /photos/:photo_id/comments/:id
GET       /photos/:photo_id/comments/:id/edit
PATCH/PUT /photos/:photo_id/comments/:id
DELETE    /photos/:photo_id/comments/:id

Параметры

Принимает те же параметры, что и match, а также:

:path_names

Позволяет изменить компонент сегмента действий edit и new. Действия, которые не указаны, не изменяются.

resources :posts, path_names: { new: "brand_new" }

В приведенном выше примере /posts/new теперь изменится на /posts/brand_new.

:path

Позволяет изменить префикс пути для ресурса.

resources :posts, path: 'postings'

Ресурс и все сегменты теперь будут маршрутизироваться к /postings вместо /posts.

:only

Генерировать маршруты только для указанных действий.

resources :cows, only: :show
resources :cows, only: [:show, :index]

:except

Генерировать все маршруты, кроме указанных действий.

resources :cows, except: :show
resources :cows, except: [:show, :index]

:shallow

Генерирует неглубокие маршруты для вложенных ресурсов. При размещении на родительском ресурсе генерирует неглубокие маршруты для всех вложенных ресурсов.

resources :posts, shallow: true do
  resources :comments
end

То же самое, что и:

resources :posts do
  resources :comments, except: [:show, :edit, :update, :destroy]
end
resources :comments, only: [:show, :edit, :update, :destroy]

Это позволяет использовать URL-адреса для ресурсов, которые в противном случае были бы глубоко вложенными, например, комментарий к сообщению в блоге, как /posts/a-long-permalink/comments/1234, сократить до /comments/1234.

Установите shallow: false на дочернем ресурсе, чтобы игнорировать параметр shallow родителя.

:shallow_path

Добавляет префикс к вложенным неглубоким маршрутам с указанным путем.

scope shallow_path: "sekret" do
  resources :posts do
    resources :comments, shallow: true
  end
end

У ресурса comments здесь будут сгенерированы следующие маршруты:

post_comments    GET       /posts/:post_id/comments(.:format)
post_comments    POST      /posts/:post_id/comments(.:format)
new_post_comment GET       /posts/:post_id/comments/new(.:format)
edit_comment     GET       /sekret/comments/:id/edit(.:format)
comment          GET       /sekret/comments/:id(.:format)
comment          PATCH/PUT /sekret/comments/:id(.:format)
comment          DELETE    /sekret/comments/:id(.:format)

:shallow_prefix

Добавляет префикс к именам вложенных неглубоких маршрутов с указанным префиксом.

scope shallow_prefix: "sekret" do
  resources :posts do
    resources :comments, shallow: true
  end
end

У ресурса comments здесь будут сгенерированы следующие маршруты:

post_comments           GET       /posts/:post_id/comments(.:format)
post_comments           POST      /posts/:post_id/comments(.:format)
new_post_comment        GET       /posts/:post_id/comments/new(.:format)
edit_sekret_comment     GET       /comments/:id/edit(.:format)
sekret_comment          GET       /comments/:id(.:format)
sekret_comment          PATCH/PUT /comments/:id(.:format)
sekret_comment          DELETE    /comments/:id(.:format)

:format

Позволяет указать значение по умолчанию для необязательного сегмента format или отключить его, указав false.

:param

Позволяет переопределить имя параметра по умолчанию :id в URL.

Примеры

# routes call +Admin::PostsController+
resources :posts, module: "admin"

# resource actions are at /admin/posts.
resources :posts, path: "admin/posts"

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1691
def root(path, options = {})
  if path.is_a?(String)
    options[:to] = path
  elsif path.is_a?(Hash) && options.empty?
    options = path
  else
    raise ArgumentError, "must be called with a path and/or options"
  end

  if @scope.resources?
    with_scope_level(:root) do
      path_scope(parent_resource.path) do
        match_root_route(options)
      end
    end
  else
    match_root_route(options)
  end
end

Вы можете указать, на что Rails должен маршрутизировать “/” с помощью метода root:

root to: 'pages#main'

Для параметров см. match, так как root использует его внутренне.

Вы также можете передать строку, которая будет расширена

root 'pages#main'

Вы должны поместить корневой маршрут в начало config/routes.rb, потому что это означает, что он будет сопоставлен первым. Поскольку это самый популярный маршрут большинства приложений Rails, это выгодно.