Spec-Zone.ru › Ruby on Rails 5.1

модуль ActionDispatch::Routing::Redirection

Публичные методы экземпляров

redirect(*args, &block) Показать исходный код
# File actionpack/lib/action_dispatch/routing/redirection.rb, line 185
def redirect(*args, &block)
  options = args.extract_options!
  status  = options.delete(:status) || 301
  path    = args.shift

  return OptionRedirect.new(status, options) if options.any?
  return PathRedirect.new(status, path) if String === path

  block = path if path.respond_to? :call
  raise ArgumentError, "redirection argument not supported" unless block
  Redirect.new status, block
end

Перенаправить любой путь на другой путь:

get "/stories" => redirect("/posts")

Это перенаправит пользователя, игнорируя определённые части запроса, включая строку запроса и т. д. `/stories`, `/stories?foo=bar` и т. д. все перенаправляются на `/posts`.

Вы также можете использовать интерполяцию в переданном аргументе перенаправления:

get 'docs/:article', to: redirect('/wiki/%{article}')

Обратите внимание, что если вы возвращаете путь без ведущей косой черты, то URL предваряется переменной окружения SCRIPT_NAME. Обычно это '/', но может быть другим в подключенном движке или когда приложение развернуто в подкаталоге веб-сайта.

В качестве альтернативы, вы можете использовать один из других синтаксисов:

Версия `redirect` с блоком позволяет легко инкапсулировать любую логику, связанную с перенаправлением. Либо параметры и запрос предоставляются в качестве аргументов, либо только параметры, в зависимости от того, сколько аргументов принимает ваш блок. В качестве возвращаемого значения требуется строка.

get 'jokes/:number', to: redirect { |params, request|
  path = (params[:number].to_i.even? ? "wheres-the-beef" : "i-love-lamp")
  "http://#{request.host_with_port}/#{path}"
}

Обратите внимание, что синтаксис `do end` для блока перенаправления не сработает, так как Ruby передаст блок в get вместо redirect. Используйте { ... } вместо этого.

Версия `redirect` с параметрами позволяет предоставить только те части URL, которые нужно изменить, она также поддерживает интерполяцию пути, аналогично первому примеру.

get 'stores/:name',       to: redirect(subdomain: 'stores', path: '/%{name}')
get 'stores/:name(*all)', to: redirect(subdomain: 'stores', path: '/%{name}%{all}')
get '/stories', to: redirect(path: '/posts')

Это перенаправит пользователя, изменив только указанные части запроса, например, параметр `path` в последнем примере. `/stories`, `/stories?foo=bar`, перенаправляются на `/posts` и `/posts?foo=bar` соответственно.

Наконец, объект, который отвечает на вызов, может быть предоставлен `redirect`, позволяя повторно использовать общие маршруты перенаправления. Метод `call` должен принимать два аргумента, параметры и запрос, и возвращать строку.

get 'accounts/:name' => redirect(SubdomainRedirector.new('api'))

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API