2.2 REST 架构

概要：

本课时结合 Rails 路由（routes），详解 Rails 如何实现 REST 架构。

知识点：

REST
CRUD

正文

2.2.1 什么是 REST

REST，Representational State Transfer，更准确地表述应该是：具有代表性的状态转移。这是一种软件架构风格。说它是风格，表明它不具备约束。你可以破坏它，不按照它的风格去实现。但是，REST 拥有简洁的设计理念，按照它的设计可以在开发中获得益处。

Rails 是按照 REST 风格设计的，从1.2版本起，Rails 就开始按照 REST 架构管理资源。

如何管理呢？Rails 从以下三个方面对资源进行定义：

直观简短的资源地址：URI，比如：http://example.com/resources/。
可传输的资源：Web 服务接受与返回的互联网媒体类型，比如：JSON，XML ，YAML 等。
对资源的操作：Web 服务在该资源上所支持的一系列请求方法（比如：POST，GET，PUT或DELETE）。

在我们的代码里，我想你已经在上一节创建的项目里体验到了如何增加，修改，和删除一个商品。

以上引述于http://zh.wikipedia.org/wiki/REST，并结合 Rails 做了解释。这里还有一篇文章，推荐阅读：如何获取（GET）一杯咖啡——星巴克REST案例分析

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/	列出 URI，以及该资源组中每个资源的详细信息（后者可选）。	使用给定的一组资源替换当前整组资源。	在本组资源中创建/追加一个新的资源。该操作往往返回新资源的URL。	删除整组资源。
单个资源的URI，比如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 手册中的 routes 章节。

阅读

REST服务开发实战

为啥REST如此重要？