Action Dispatch `Routing` `PolymorphicRoutes`

多态 URL 助手是用于在给定 Active Record 模型实例时智能解析到命名路由调用的方法。它们应该与 ActionController::Resources 结合使用。

当您想要生成指向 RESTful 资源的正确 URL 或路径而不必知道所讨论记录的确切类型时，这些方法很有用。

嵌套资源和/或命名空间也受支持，如示例所示

polymorphic_url([:admin, @article, @comment])

结果为

admin_article_comment_url(@article, @comment)

在框架中的使用

多态 URL 助手在整个 Rails 框架中使用在许多地方

url_for，因此您可以使用记录作为参数，例如 url_for(@article);
ActionView::Helpers::FormHelper 使用 polymorphic_path，因此您可以编写 form_with(model: @article) 而不必为表单操作指定 :url 参数;
redirect_to（实际上使用 url_for），因此您可以在控制器中编写 redirect_to(post);
ActionView::Helpers::AtomFeedHelper，因此您不必显式指定提要项的 URL。

带前缀的多态助手

除了 polymorphic_url 和 polymorphic_path 方法之外，还可以使用一些带前缀的助手作为 action: "..." 的快捷方式。这些是

edit_polymorphic_url, edit_polymorphic_path
new_polymorphic_url, new_polymorphic_path

示例用法

edit_polymorphic_path(@post)           # => "/posts/1/edit"
polymorphic_path(@post, format: :pdf)  # => "/posts/1.pdf"

与挂载的引擎一起使用

如果您正在使用挂载的引擎并且您需要使用指向引擎的路由的 polymorphic_url，请将引擎的路由代理作为第一个参数传递给该方法。例如

polymorphic_url([blog, @post])  # calls blog.post_path(@post)
form_with(model: [blog, @post]) # => "/blog/posts/1"

方法

P

polymorphic_path,
polymorphic_url

实例公共方法

polymorphic_path(record_or_hash_or_array, options = {}) 链接

返回给定记录的 URL 的路径组件。

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/routing/polymorphic_routes.rb, line 133
def polymorphic_path(record_or_hash_or_array, options = {})
  if Hash === record_or_hash_or_array
    options = record_or_hash_or_array.merge(options)
    record  = options.delete :id
    return polymorphic_path record, options
  end

  if mapping = polymorphic_mapping(record_or_hash_or_array)
    return mapping.call(self, [record_or_hash_or_array, options], true)
  end

  opts   = options.dup
  action = opts.delete :action
  type   = :path

  HelperMethodBuilder.polymorphic_method self,
                                         record_or_hash_or_array,
                                         action,
                                         type,
                                         opts
end

polymorphic_url(record_or_hash_or_array, options = {}) 链接

为给定记录构建对命名 RESTful 路由的调用，并返回生成的 URL 字符串。例如

# calls post_url(post)
polymorphic_url(post) # => "http://example.com/posts/1"
polymorphic_url([blog, post]) # => "http://example.com/blogs/1/posts/1"
polymorphic_url([:admin, blog, post]) # => "http://example.com/admin/blogs/1/posts/1"
polymorphic_url([user, :blog, post]) # => "http://example.com/users/1/blog/posts/1"
polymorphic_url(Comment) # => "http://example.com/comments"

选项

:action - 指定命名路由的动作前缀：:new 或 :edit。默认情况下没有前缀。
:routing_type - 允许的值是 :path 或 :url。默认值为 :url。

还包括 url_for 中的所有选项。这些包括诸如 :anchor 或 :trailing_slash 之类的东西。示例用法如下所示

polymorphic_url([blog, post], anchor: 'my_anchor')
  # => "http://example.com/blogs/1/posts/1#my_anchor"
polymorphic_url([blog, post], anchor: 'my_anchor', script_name: "/my_app")
  # => "http://example.com/my_app/blogs/1/posts/1#my_anchor"

对于所有这些选项，请参阅 url_for 的文档。

功能

# an Article record
polymorphic_url(record)  # same as article_url(record)

# a Comment record
polymorphic_url(record)  # same as comment_url(record)

# it recognizes new records and maps to the collection
record = Comment.new
polymorphic_url(record)  # same as comments_url()

# the class of a record will also map to the collection
polymorphic_url(Comment) # same as comments_url()