`
zhangym124
  • 浏览: 344350 次
  • 性别: Icon_minigender_1
  • 来自: 杭州
社区版块
存档分类
最新评论

由表及里解析Rails路由(转)

阅读更多

转自 http://hlee.iteye.com/blog/571330

 

原文链接:Rails Routing from the Outside In

translation_keywords = {:Routing => “路由”, :Routes => “路径”}

本篇向导涵盖了用户可见部分的Rails路由特性.阅读本文之后,您应该可以:

  • 理解路由的目的
  • 看懂routes.rb文件中的代码
  • 使用经典的hash风格或者现在比较流行的Restful风格构造你自己的路径
  • 断定一个路径会映射到哪一个controller和action
`

路由的双重作用

Rails的路由是一个双重的机制 - 你既能把树木变成纸张,也能把纸张变成树木.更准确的说,它既能将进入服务器的HTTP请求连接到你的controller,也能帮助你(在View内)生成URL而不需要使用硬编码的字符串.

从URL到代码

当你的Rails应用接收到HTTP请求后,比如:

GET /patients/17

Rails的路由引擎就是把请求分发到你的应用中合适点的那些代码.具体到这个例子,应用程序比较可能会运行patients controller中的show action,并展示id是17的patient的详细信息.

从代码到URL

路由也可以反过来作用.如果你的应用包含了以下代码

@patient = Patient.find(17)

<%= link_to “Patient Record”, patient_path(@patient) %>

那么,路由引擎就会把这段代码解释成这样的URL: http://example.com/patients/17.这样使用路由,比起硬编码URL,可以降低你的应用程序的脆弱程度(增加程序健壮性),并且可以增加代码的可读性,使你的程序更容易被理解.

Patient需要被声明成为resource才可以使用这种形式的路径转换

`

快速浏览Routes.rb

Rails的路由有两个组陈部分:作为Rails一部分的路由引擎,还有包含有你的应用程序真正路径的config/routes.rb文件.讲授可以把什么东西放到routes.rb里面去是本文的目的,不过在此之前我们先概览一下.

处理文件

从格式上讲,routes.rb只不过是被传递给ActionController::Routing:routes.draw的一个大大的 block. 这个文件里也可以有注释,不过大多数情况下,应该是移行移行的代码,每一行代表你应用程序的一条路径.路径有五种主要类型:

  • RESTful路径
  • 命名路径
  • 嵌套路径
  • 常规路径
  • 默认路径

每一个类型的路径都会在随后详细阐述. 当有请求进入时, routes.rb文件自顶向下出路.请求会被分发到第一个匹配的路径.如果没有匹配的路径,Rails会返回给调用者一个HTTP 404.

RESTful路径

RESTful路径沾了Rails内建REST机制的光,只用一句单独的声明就包含了很多路由信息.一个RESTful路径看起来是这样的:

map.resources :books

命名路径

命名路径在处理请求的同时,也可以给你的代码提供非常具有可读性的链接.这是一个典型的命名路径:

map.login ‘/login’, :controller => ’sessions’, :action => ‘new’

嵌套路径

嵌套路径可以让你在一个resource里面包含另一个resource.你待会儿就会知道它是怎么被转化成URL(绝对路径 http://niuwa.org/index.html)和path(相对路径 /index.html)的.举例来说,如果你的应用包含很多部分,每个部分属于一个包(assembly),你也许可以这么写:

map.resources :assemblies do |assemblies| assemblies.resources :parts end

常规路径

在很多应用中,你会看到非RESTful的路由,它们显式的链接URL和action.例如:

map.connect ‘parts/:number’, :controller => ‘inventory’, :action => ’show’

默认路径

默认路径十一个安全网,抓住那些没有匹配上其他路径的请求.很多Rails应用都会包含这两条默认路径:

map.connect ‘:controller/:action/:id’ map.connect ‘:controller/:action/:id.:format’

这两个默认路径是你创建Rails应用的时候自动生成的.你可以为你的应用里面的所有东西使用RESTful的路径,那你就有可能想去掉这两条默认路径.在你去掉它们之前请确保你没有用到它们.

`

RESTful路由:Rails的默认方式

RESTful路由是目前Rails的标准路由方式,并且它也是你在新建的应用中首先使用的方式.要理解RESTful路有可能要花上一点时间,不过这样 的努力是值得的;你的代码会变得更容易阅读,并且当你使用这种路由方式的时候,你会跟Rails配合的很好,而不是跟Rails对着干.

什么是REST?

RESTful路由的基础是由Roy Fielding的博士论文提出的,参见: Architectural Styles and the Design of Network-based Software Architectures . 幸运的是,你不需要看懂整篇博士论文就可以理解Rails中的REST是怎么回事.REST是Representational State Transfer(基于表现的状态转移)的缩写.对我们来说,主要有两点:

  • 使用资源定位符(对我们来说就是URL)来表示资源
  • 在系统的不同组件之间转移表现状态

举例来说,对于Rails应用中这样的一个请求:

DELETE /phote/17

会被理解成是操作ID是17的photo,并且指示出了期望的操作 - 删除该资源.REST是web应用架构的一种自然的方式,并且Rails进一步使用约定(convention)隐藏了RESTful的某些复杂性使之更加自然(大概是指用起来更简单).

CRUD,动词和action

在RAils中,一个RESTful路径提供了HTTP动词(也就是GET, PUT等等),controller actions和(隐含的)CRUD数据库操作之间的的映射.路由文件中一个单独的入口如下所示:

map.resources :photos

在你的应用中创建了七个不同的路径:

 

HTTP verb URL controller action used for
GET /photos Photos index display a list of all photos
GET /photos/new Photos new return an HTML form for creating a new photo
POST /photos Photos create create a new photo
GET /photos/1 Photos show display a specific photo
GET /photos/1/edit Photos edit return an HTML form for editing a photo
PUT /photos/1 Photos update update a specific photo
DELETE /photos/1 Photos destroy delete a specific photo

对这些路径(由之前的resource定义生成的),resource的id可以在相应的controller action中使用params[:id]得到.

如果你一直在你的应用程序里面使用RESTful路径,你应该删除routes.rb中的默认路径,这样就会迫使Rails使用HTTP动词和路径间的映射.

URL和Path

创建RESTful路径会在你的应用程序里面生成一堆helper:

  • photos_url和photos_path映射到index和create两个action
  • new_photo_url和new_photo_path映射到new action
  • edit_photo_url和edit_photo_path映射到edit action
  • photo_url和photo_path映射到show, update和destroy三个action

因为路由同时使用HTTP动词和path二者分发请求,因此这七个RESTful路由生成的路径只有4对helper.

在这里,以_url结尾的helper生成应用程序能理解的整个URL(包含主机名),而以_path结尾的helper仅生成从应用程序根目录开始的path(不包含主机名).例如:

photos_url # => “http://www.example.com/photos”

photos_path # => “/photos”

同时定义多个资源

如果你需要为多个资源创建路径,你可以使用一次map.resources调用就定义它们:

map.resources :photos, :books, :videos

跟这样定义的效果是一样的:

map.resources :photos map.resources :books map.resources :videos

单数形式资源

你也可以应用RESTful路由定义单数形式的资源.这是,你需要使用map.resource代替刚才的map.resources,这时生成的路径会略有不同:

map.resource :geocoder

创建六个不同的路径:

 

HTTP verb URL controller action used for
GET /geocoder/new Geocoders new return an HTML form for creating the new geocoder
POST /geocoder Geocoders create create the new geocoder
GET /geocoder Geocoders show display the one and only geocoder resource
GET /geocoder/edit Geocoders edit return an HTML form for editing the geocoder
PUT /geocoder Geocoders update update the one and only geocoder resource
DELETE /geocoder Geocoders destroy delete the geocoder resource

虽然routes.rb中的资源名称是单数,但是对应的controller名称依然是复数.

一个单数形式的RESTful路径生成如下的helper:

  • new_geocoder_url和new_geocoder_path映射到new action
  • edit_geocoder_url和edit_geocoder_path映射到edit action
  • geocoder_url和geocode_path映射到create, update和destroy三个action

自定义资源

虽然使用RESTful路由约定对很多应用来说基本就足够了,不过还是有一些其他的方法自定义RESTful路径的工作方式.这些选项包括:

  • :controller
  • :singular
  • :requirements
  • :conditions
  • :as
  • :path_names
  • :path_prefix
  • :name_prefix
  • :only
  • :except

你也可以使用:member和:collection选项添加路径,这个在本文中稍后讨论.

使用:controller

:controller选项使你可以使用和公开的资源名称不同的controller名称,例如:

map.resources :photos, :controller => “images”

这样就会将对URL包含photo的请求发送到Images controller:

 

HTTP verb URL controller action used for
GET /photos Images index display a list of all images
GET /photos/new Images new return an HTML form for creating a new image
POST /photos Images create create a new image
GET /photos/1 Images show display a specific image
GET /photos/1/edit Images edit return an HTML form for editing a image
PUT /photos/1 Images update update a specific image
DELETE /photos/1 Images destroy delete a specific image

生成helper时会依据资源的名称,而不是controller的名称.因此,在这个例子里,就会得到photos_path,new_photo_path等等.

分享到:
评论

相关推荐

    rails路由之图文解释

    让你知道在rails中如何使用路由,路由与URL是如何对应的。

    rails 路由

    简要列出rails路由的方方面面简要列出rails路由的方方面面简要列出rails路由的方方面面简要列出rails路由的方方面面

    routing-filter 包裹了 Rails 路由系统的复杂野兽,在 Rails URL 识别和生成中提供了看不见的灵活性

    routing-filter 包裹了 Rails 路由系统的复杂野兽,在 Rails URL 识别和生成中提供了看不见的灵活性和强大功能 路由过滤器围绕着复杂的野兽,Rails 路由系统在 Rails URL 识别和生成中提供了看不见的灵活性和强大...

    Ruby on Rails路由拒绝服务漏洞

    本文发布Ruby on Rails路由拒绝服务漏洞,指出它影响到的系统、不受它影响的系统以及提供给用户厂商补丁下载的地址。

    route_translator, 将 Rails 应用程序路由转换为各种语言,无需担心.zip

    route_translator, 将 Rails 应用程序路由转换为各种语言,无需担心 RouteTranslator RouteTranslator是一个 gem,允许你使用简单的字典格式管理应用程序路由的翻译。它以 fork Raúl Murciano 插件的一个插件插件的...

    Ruby-Annotate注释Rails类模式和路由信息

    本文将深入探讨"Ruby-Annotate"工具,这是一个用于Rails项目的实用程序,能够自动为你的模型添加注释,显示有关数据库模式、关联和路由的信息。 **Ruby-Annotate** 是一个Ruby gem,它的主要功能是分析你的Rails...

    深入解析Rails测试策略:单元测试与功能测试的区别

    Ruby on Rails作为一个全栈服务器端框架,提供了一套强大的测试工具和约定,以支持不同类型的测试。单元测试和功能测试是Rails中两种主要的测试类型,它们在目的、范围和实现方式上有所不同。本文将详细探讨Rails中...

    rails_routing_guide

    Rails路由指南 Rails路由是Ruby on Rails框架中处理HTTP请求的部分,它负责将外部的URL映射到控制器的相应动作上。通过阅读本指南,您可以了解到如何理解routes.rb文件中的代码,如何创建和自定义路由,以及如何...

    Ruby on Rails:路由系统详解.docx

    Ruby on Rails:路由系统详解.docx

    Rails项目源代码

    Rails的路由系统将URL映射到控制器的行动上,如`/sign_up`可能对应`users#new`,用于创建新用户。`config/routes.rb`文件定义了所有路由规则,包括资源路由、命名路由和自定义路由。 6. **视图模板**: 视图使用...

    Rails 101 入门电子书

    #### 六、Rails的路由 - **概念介绍**: 路由是连接用户请求URL与应用程序逻辑的关键组件。 - **实现方式**: - 配置文件`config/routes.rb`。 - 常见的路由类型: 默认路由、命名路由、约束路由等。 #### 七、练习...

    grape-rails-routes:为 Grape with Rails 添加路由打印

    将 Grape API 路由装入 Rails 后,Grape API 路由通常不会打印在rake routes或/rails/info/routes 。 这个 gem 将 Grape 的路由打印功能添加到 Rails 中。 用法 将此行添加到您的Gemfile gem 'grape-rails-routes...

    The Rails 4 Way

    - **routes.rb文件**:这是Rails应用程序中配置路由规则的地方,通过编写不同的路由规则可以实现复杂的应用逻辑。 - **命名路由**:允许开发者通过名字引用路由,使得代码更具可读性,并且可以在路由规则改变时自动...

    Rails101_by_rails4.0

    为了确保读者能够通过实践加深理解,书中还安排了一系列练习作业,从最基础的“Hello World”开始,逐步过渡到更复杂的概念,如Rails的Routing(路由)机制。路由机制是Web应用中一个非常核心的概念,它定义了不同的...

    Rails

    5. **路由**:Rails的路由系统将URL映射到控制器的行动上,提供了一种灵活的方式来定义和管理应用的路由结构。 描述中提到的博文链接指向了一个ITEYE博客文章,尽管具体内容未提供,但通常这样的博客可能会包含...

    Rails 3 in Action

    《Rails 3 in Action》是2011年由Ryan Bigg撰写的一本关于Ruby on Rails框架的权威指南,专门针对当时最新的Rails 3.1版本进行了深入解析。这本书旨在帮助开发者充分利用Rails 3.1的强大功能,提升Web应用开发的效率...

    路由过滤器:路由过滤器围绕着Rails路由系统所包含的复杂野兽,在Rails URL识别和生成中提供了看不见的灵活性和强大功能

    路由过滤器 路由过滤器围绕着Rails路由系统所要面对的复杂的野兽,以实现Rails URL识别和生成中看不见的灵活性和强大功能。 尽管Rails的路由功能强大而强大,但是当您需要以稍微离开Rails约定铺平道路的方式来设计...

    rails学习教程

    通过`config/routes.rb`文件,你可以自定义路由规则,指定URL如何被解析。 五、Rails生成器 Rails提供了许多命令行工具,如`rails generate`,可以自动生成模型、控制器、迁移等,大大减少了手动编码的工作量。 六...

Global site tag (gtag.js) - Google Analytics