# File actionpack/lib/action_dispatch/routing/url_for.rb, line 222
def route_for(name, *args)
  public_send(:"#{name}_url", *args)
end

Позволяет вызывать прямой или обычный именованный маршрут.

resources :buckets

direct :recordable do |recording|
  route_for(:bucket, recording.bucket)
end

direct :threadable do |threadable|
  route_for(:recordable, threadable.parent)
end

Это сохраняет контекст исходного вызывающего объекта о том, возвращать ли путь или полный URL-адрес, например:

threadable_path(threadable)  # => "/buckets/1"
threadable_url(threadable)   # => "http://example.com/buckets/1"

# File actionpack/lib/action_dispatch/routing/url_for.rb, line 178
def url_for(options = nil)
  full_url_for(options)
end

Генерирует URL-адрес на основе предоставленных параметров, default_url_options, и маршрутов, определенных в config/routes.rb.

• :only_path - Если true, возвращается относительный URL. По умолчанию false.

• :protocol - Протокол подключения. По умолчанию "http".

• :host - Указывает хост, к которому должен быть направлен URL. Если :only_path равно false, этот параметр должен быть предоставлен явно или через default_url_options.

• :subdomain - Указывает поддомен URL, используя tld_length для разделения поддомена и хоста. Если false, удаляет все поддомены из части хоста URL.

• :domain - Указывает домен URL, используя tld_length для разделения домена и хоста.

• :tld_length - Количество меток, из которых состоит TLD, используется только если :subdomain или :domain заданы. По умолчанию ActionDispatch::Http::URL.tld_length, что, в свою очередь, по умолчанию равно 1.

• :port - Дополнительно укажите порт для подключения.

• :anchor - Имя якоря, которое будет добавлено к пути.

• :params - Параметры запроса, которые будут добавлены к пути.

• :path_params - Параметры запроса, которые будут использоваться только для именованных динамических сегментов пути. Если не используются, они будут отброшены.

• :trailing_slash - Если true, добавляет слеш в конце, как в "/archive/2009/".

• :script_name - Указывает путь приложения относительно корня домена. При наличии, добавляет путь приложения.

Любой другой ключ (:controller, :action, и т.д.) предоставленный url_for передается модулю Маршруты.

url_for controller: 'tasks', action: 'testing', host: 'somehost.org', port: '8080'
# => 'http://somehost.org:8080/tasks/testing'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', anchor: 'ok', only_path: true
# => '/tasks/testing#ok'
url_for controller: 'tasks', action: 'testing', trailing_slash: true
# => 'http://somehost.org/tasks/testing/'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', number: '33'
# => 'http://somehost.org/tasks/testing?number=33'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp"
# => 'http://somehost.org/myapp/tasks/testing'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp", only_path: true
# => '/myapp/tasks/testing'

Пропущенные ключи маршрутов могут быть заполнены из параметров текущего запроса (например, :controller, :action, :id, и любые другие параметры, размещенные в пути). Учитывая, что текущее действие достигнуто через GET /users/1:

url_for(only_path: true)                        # => '/users/1'
url_for(only_path: true, action: 'edit')        # => '/users/1/edit'
url_for(only_path: true, action: 'edit', id: 2) # => '/users/2/edit'

Обратите внимание, что параметр :id не был предоставлен первому вызову url_for, и хелпер использовал значение из пути маршрута. Любой параметр пути, неявно используемый url_for, всегда может быть переопределен, как показано в последних вызовах url_for.

# File actionpack/lib/action_dispatch/routing/url_for.rb, line 118
def url_options
  default_url_options
end

Переопределенный в контроллере хук для добавления информации о запросе с помощью default_url_options. Логика приложения не должна включаться в url_options.