# File actionpack/lib/action_dispatch/routing/url_for.rb, line 217
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 173
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 - Указывает хост, к которому должен быть направлен link. Если :only_path ложно, этот параметр должен быть предоставлен явно или через default_url_options.

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

• :domain - Указывает домен ссылки, используя 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, передается модулю Routes.

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 116
def url_options
  default_url_options
end

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