ThinkChat2.0新版上线,更智能更精彩,支持会话、画图、阅读、搜索等,送10W Token,即刻开启你的AI之旅 广告
# 2.2 REST 架构 ## 概要: 本课时结合 Rails 路由(routes),详解 Rails 如何实现 REST 架构。 ## 知识点: 1. REST 1. CRUD ## 正文 ### 2.2.1 什么是 REST [REST](http://zh.wikipedia.org/wiki/REST),Representational State Transfer, 更准确地表述应该是:具有代表性的状态转移。这是一种软件架构风格。说它是风格,表明它不具备约束。你可以破坏它,不按照它的风格去实现。但是,REST 拥有简洁的设计理念,按照它的设计可以在开发中获得益处。 Rails 是按照 REST 风格设计的,从[1.2版本](http://weblog.rubyonrails.org/2007/1/19/rails-1-2-rest-admiration-http-lovefest-and-utf-8-celebrations/)起,Rails 就开始按照 REST 架构管理资源。 如何管理呢?Rails 从以下三个方面对资源进行定义: 1. 直观简短的资源地址:URI,比如:[http://example.com/resources/。](http://example.com/resources/。) 1. 可传输的资源:Web 服务接受与返回的互联网媒体类型,比如:JSON,XML ,YAML 等。 1. 对资源的操作:Web 服务在该资源上所支持的一系列请求方法(比如:POST,GET,PUT或DELETE)。 在我们的代码里,我想你已经在上一节创建的项目里体验到了如何增加,修改,和删除一个商品。 以上引述于[http://zh.wikipedia.org/wiki/REST](http://zh.wikipedia.org/wiki/REST),并结合 Rails 做了解释。这里还有一篇文章,推荐阅读:[如何获取(GET)一杯咖啡——星巴克REST案例分析](http://www.infoq.com/cn/articles/webber-rest-workflow) REST是资源管理的模式,和 SOAP 和 XML-RPC 相比更加简洁,下一节,我们介绍Rails 是如何管理资源的。 ### 2.2.2 CRUD,资源的增删改查 首先,我们在 Rails 中定义一个资源,我们在 routes 中使用 resources 这个方法: ~~~ Rails.application.routes.draw do ... resources :products ~~~ 我们运行这个命令: ~~~ % rake routes | grep product products GET /products(.:format) products#index POST /products(.:format) products#create new_product GET /products/new(.:format) products#new edit_product GET /products/:id/edit(.:format) products#edit product GET /products/:id(.:format) products#show PATCH /products/:id(.:format) products#update PUT /products/:id(.:format) products#update DELETE /products/:id(.:format) products#destroy ~~~ Rails 为我们提供了7个方法,他们在 `app/controllers/products_controller.rb` 这个文件中。 当我们 GET `/products` 这个地址时,调用的是 `index` 方法,当我们 POST `/products` 地址时,Rails 会按照 REST 的模式,把请求转入到 `create` 方法内。我们看一下这个表: HTTP 请求方法在RESTful Web 服务中的典型应用 | 资源 | GET | PUT | POST | DELETE | |-----|-----|-----|-----|-----| | 一组资源的URI,比如[http://example.com/resources/](http://example.com/resources/) | 列出 URI,以及该资源组中每个资源的详细信息(后者可选)。 | 使用给定的一组资源替换当前整组资源。 | 在本组资源中创建/追加一个新的资源。 该操作往往返回新资源的URL。 | 删除整组资源。 | | 单个资源的URI,比如[http://example.com/resources/142](http://example.com/resources/142) | 获取 指定的资源的详细信息,格式可以自选一个合适的网络媒体类型(比如:XML、JSON等) | 替换/创建 指定的资源。并将其追加到相应的资源组中。 | 把指定的资源当做一个资源组,并在其下创建/追加一个新的元素,使其隶属于当前资源。 | 删除指定的元素。 | 所以,向 `PATCH` 或 `PUT` 的地址是一个具体的资源,比如 `/products/1`,而 Rails 会把请求转移到 `update` 方法中。值得注意的是:在之前的 Rails 版本中,用的是 `PUT` 动作,4.0 后引入`PATCH`,稍微不同的是,patch 可以表示更新或局部更新,但在使用上,和 `PUT` 无异。[[1](http://guides.rubyonrails.org/4_0_release_notes.html#general)] `:format` 表示我们可以接受和响应对应的 format 请求。比如 `/products/1` 响应的是 html,而 `/products/1.json` 响应的是 json。 我们可以关闭这种响应,只需要 `resources :products, format: false`。 或者更改响应,只接受和响应 json,如:`resources :products, format: 'json'`。 在实践中,这对 API 的设计非常方便,比如页面上 ajax 调用 `/api/users/1/status`,约束它只返回 json 格式。 从现在开始,我们的代码主要集中在 app 文件夹内。下一节,我们将深入 Rails 的 routes 中,看看实践中经常遇到的情况,以及如何解决。你也可以请先阅读以下 [Rails 手册](http://guides.rubyonrails.org/routing.html#singular-resources) 中的 routes 章节。 ### 阅读 [REST服务开发实战](http://www.infoq.com/cn/articles/dt-rest-service) [为啥REST如此重要?](http://www.csdn.net/article/2013-08-01/2816424-Why-REST-is-so-important)