在Ruby on Rails中使用Rails Active Resource的教程

简介

当今的应用程序不仅需要和基于浏览器的客户端互操作，还需要和其他应用程序互操作。为实现互操作性，web 应用程序通常提供一个 web 服务 API。web 服务 API 通过一个网络（比如 Internet）提供对应用程序 的远程访问。直到最近，web 服务 API 还使用重型、复杂的基于 SOAP 的 web 服务集成，这种 web 服务，不仅没有什么优点，而且还需要很长时间才能实现。带有基于 Representational State Transfer (REST) 服务的 Rails 框架有一种更简单、更快捷的方法通过 Active Resource 来实现和使用 web 服务。

在 Rails 实现了 RESTful 以后，现在只需通过一个 Rails 动作就能提供一个特定资源的不同内容类型（或者表示）。这种方法有以下好处：

• 一个资源的各种表示状态。
• 对不基于浏览器的 HTML 客户端的附加支持在 Controller 视图中得到了简化。
• 应用程序之间以及与新客户端之间的互操作性。

在本文中，您将了解 REST、SOAP、Rails Active Resource，以及如何提高多个应用程序之间的互操作性。

Ruby on Rails

Ruby on Rails（也称为 Rails 或 RoR）是一个用 Ruby 语言编写的开源 web 应用程序框架。Ruby on Rails 旨在帮助开发人员更轻松快捷地开发和部署 web 应用程序，与其他语言和框架相比，Rails 框架进行了几个假设。其目的是使用敏捷开发的方法，实现快速开发。

Rails 框架合并了以下几个包：

• Active Record：一个对象关系映射层，用于数据库相关访问和功能；
• Action Pack：一个控制器和视图功能管理器；
• Action Mailer：一个电子邮件处理器；
• Active Support
• Active Resource：提供 web 服务（即 Action Web 服务）。

Web 服务

Web 服务是使用开放协议通信的应用程序组件，它们可以被其他应用程序使用。web 服务是简单 APIs ，可以使用 HTML 进行访问，并在承载请求服务的远程系统上执行。web 服务是不同平台上、以不同语言编写、不同系统上的各种应用程序的关键集成点。

REST 不是一个协议；它是利用 World Wide Web 的技术和协议的大型联网软件的一种架构风格。REST 描述如何定义和处理分布式数据对象（或资源），强调简单的信息交换和可伸缩性。REST 架构描述该该架构上应用的 6 个约束。

另一方面，SOAP 是一个协议规范，用于在计算机网络中交换 web 服务的实现中的结构化信息。它依赖 XML 作为其消息格式，通常依赖其他应用程序层协议（RPC 和 HTTP）进行消息协商和传输。SOAP 可以形成 web 服务协议堆栈的基础层，提供用于在其上构建 web 服务的基础消息传递框架。
REST 与 SOAP

下表展示了 REST 和 SOAP 之间的一些区别。

REST 依赖一个单一的应用程序协议（HTTP）、几个 URI、以及几种通过 XML 标准化的数据格式。它采用成熟的 HTTP 方法（比如 GET 和 POST）来指挥应用程序。REST 开发人员使用 URI 来创建一个公共基础，以便应用程序使用 HTTP 和 XML 来共享数据，而不是为应用程序创建一种机器可读的标准方法来发现和使用远程系统上的应用程序组件（这是 SOAP 用于 web 服务的方法）。REST 开发人员使用 XML 文档而不是应用程序方法调用来告诉分布式程序如何相互使用数据。

REST 支持者指出，使用 SOAP 协议直接访问远程程序的功能必定会遇到 DCOM 和 Common Object Request Broker Architecture 等之前分布式计算架构所遇到的互操作性问题。

Active Resource

在对 web 应用程序在服务器和客户机应用程序之间的通信采用 RESTful 方法之前，SOAP 和其他 XML-RPC 形式被用于通过一个 API 进行通信。Rails 2 引入的 Active Resource 替代了 Action Web Service。Active Resource 完全理解 RESTful 路由和 XML 表示。它是一个类，用于将 RESTful 资源映射为 Rails 应用程序中的模型。Active Resource 提供一些工具来快速、轻松地使用遵守 Rails RESTful URI 结构和协议约定的基于 REST 的 web 服务。Active Resource 将来自任何合格服务的响应映射到富 Ruby 对象。Active Resource 还提供轻松执行基本的 CRUD 功能需要的全部生命周期方法。

CRUD 操作分别对应 HTTP 方法 POST、GET、PUT 和 DELETE。而且，Active Resource 对这些 HTTP 方法中的每个方法都有一个方法。它们接收与 CRUD 相同的参数，但返回收到的 XML 的一个哈希表。Active Resource 对象本质上是 REST web 服务器的前端。它通过向服务器回调 HTTP 调用并将 XML 结果解析回一个 Ruby 对象中来获取并修改它的数据。

清单 1 展示了一个最小 Active Resource 示例。假设有一个图书馆应用程序，每个类别作为一个不同的客户端，且 Indian History 是其中一个类别。
清单 1. Active Resource 示例

class IndianHistory < ActiveResource::Base
self.site = “http://indian-history.com”
end

ActiveResource 拥有与 Active Record 相同的方法。在上面的代码样例中，类 IndianHistory 正继承自 ActiveResource Base。在第二行中，self.site 持有包含 IndianHistory 图书的 URI 的站点值。在本例中，这个 URI 是 http://indian-history.com（假设这个 URI 是带有必要模型和控制器动作的另一个 Rails 应用程序）。

现在，这个类被映射到站点值定位的 RESTful 资源，您现在可以操作 IndianHistory 类的资源。要获取 Indian History 下的所有图书列表，您将调用它的 find 方法，它类似于 Active Record find 方法。

>> books = IndianHistory.find (:all)

这个 Active Resource 模块类似于 Active Record 模块；它们拥有相同的风格。

假设您正在寻找标题为 “Akbar” 的图书，可以使用以下代码：

>> books = IndianHistory.find(:all, :params => { :title => “Akbar”}}

与 Active Record find 方法中的常规 :conditions 子句不同，本示例使用了 :params，且 URL 是 GET http://indian-history.com/indian_histories.xml?title=Akbar。

Active Resource 不仅限于检索数据。您可以使用所有 CRUD 操作。在脚本/控制台中，您可以使用：

>> IndianHistory.create (:title => “Jhansi Stories”, :amount => 233.00, :available => 0)

上述代码行将使用提供的数据向 create 动作中存在清单 2 中的代码的控制器创建一个 HTTP POST。
清单 2. Create

class IndianHistoryController < ActiveResource::Base
def create
@book = IndianHistory.new (params [:indian_history])
respond_to do |format|
if @book.save
flash[:notice] = “New title added successfully”
format.html { redirect_to(@book) }
format.xml { render :xml => @book, :status => :created}
else
format.html { render :action => “new” }
format.xml { render :xml => @book.errors, :status => :unprocessable_entity}
end
end
end

end

如果图书记录成功保存，将返回新创建的、状态码为 HTTP 201 的记录，并将使用新创建的记录重定向视图。

同样，您也可以更新和删除记录，主要您拥有执行管理的权限和访问权。

对于 Update 操作，在脚本/控制台中使用：
清单 3. Update

>> book= IndianHistory.find (2)
>> book.available = 1
>> book.save
>> book = IndianHistory.find (2)
>> book.available # => 1

您更新了图书的可用性并保存记录。ActiveResource 和 ActiveRecord 之间有一个细微差别：ActiveResource 中没有方法 save 和 update。

最后，下面的语句将从数据库移除记录。

>> IndianHistory.delete(2)

除了上面介绍的基本操作外，Active Resource 还允许通过设置一个 HTTP 头部来 支持 HTTP 基本身份验证。假如用户名和密码被设置且在身份验证失败时抛出错误，则客户机和服务器连接的安全检查就能通过每个连接上的 Active Resource 身份验证来完成。基本的身份验证也可以轻松实现。

结束语

在本文中，您了解了 web 服务、REST、SOAP 和 Rails Active Resource。一个简单的示例向您展示了 CRUD 操作。

Ruby on Rails Active Resource 包以一种 RESTful 方式提供多个 web 应用程序之间的轻松通信。除了 CRUD 操作外，它还允许您创建自定义动作。