通过 Rails 在 Web 应用程序中使用 Ajax（1）
|
- UID
- 1066743
|
通过 Rails 在 Web 应用程序中使用 Ajax（1）
如果没有听说过 Rails，那么欢迎您外星旅行归来，近几年大概只有那个地方没有听说过 Ruby on Rails 了。Rails 最吸引人的地方是能够很快地建立功能完备的应用程序并运行起来。Rails 为 Ajax 而内置集成的 Prototype.js 库可以轻松快速地创建所谓的富 Internet 应用程序。
本文将逐步引导您创建 Rails 应用程序。然后深入分析如何利用 Ajax 特性编写从服务器上读写数据的 JavaScript 代码。
从容起步 Ajax 之旅——Ajax 技术资源中心什么是 Ajax？Ajax（Asynchronous JavaScript and XML）是一种编程技术，它允许结合 XML 和 JavaScript 用于 Web 应用程序，从而打破页面刷新的范式，使您的用户快速方便的与 Web 应用程序交互。
您想了解如何构建基于 Ajax 的应用吗？developerWorks 中国网站上有非常多的关于 Ajax 的文章、教程和技巧，通过“Ajax 技术资源中心”，您可以非常快捷地找到能帮助您完成与 Ajax 相关的应用开发的技术参考资源。
如果您刚刚接触 Ajax 技术，您可以从技术资源中心的 了解到 Ajax 开发所必需的基础知识和基本技能。如果您已经是 Ajax 高手，您也可以从 找到让你技艺更进一步的参考资源。
关于 Rails 的一点说明那么到底什么是 Rails 呢？Rails 是建立在 Ruby 编程语言上的一种 Web 应用程序平台。Ruby 存在大约有 10 年了。和 Perl 以及 Python 一样，它也是一种开放源码的敏捷编程语言，完全支持面向对象编程。
Rails 作为一种应用程序框架，强调使用正确的 Web 应用程序模式，即模型-视图-控制器（MVC）。在这里，系统的模型部分通常用一组映射到数据库表的 ActiveRecord 对象表示。控制器部分是一个 Ruby 类，其方法可以对模型执行各种操作。视图一般就是通过 ERB 模板（ERB 是 Ruby 内置的文本模板包）生成的超文本标记语言代码（HTML），形式上和 PHP 或 JavaServer Pages（JSP）代码生成的 HTML 类似。视图也可以是可扩展标记语言（XML）、文本、JavaScript 代码、图片或者其他东西。
用户从 Rails Web 应用程序请求页面时，URL 通过路由系统发送，后者将请求发送给控制器。控制器从模型请求数据并发送给视图完成格式化。
创建 Rails 应用程序时，系统自动生成一些目录和基本文件。包括随系统安装的 JavaScript 文件目录（包括 Prototype.js 库）、视图、模型和控制器目录，甚至还有存放从其他开发人员那里下载的插件的目录。
开始使用 Rails创建 Rails 应用程序最简单的办法就是使用一个预先打好包的 Rails 系统。如果平台是 Microsoft® Windows®，建议您使用 Instant Rails。在 Macintosh 机器上我非常喜欢 Locomotive 2 应用程序。这些应用程序都包括 Rails 框架、Ruby 语言、Web 服务器和 MySQL。下载了这么多东西（确实是这样）之后，创建 Rails 应用程序仅仅是举手之劳了。
本文将创建一个新的菜谱应用程序，称为Recipe，只需要一个表。 显示了 Recipe 应用程序的数据库迁移。
清单 1. 数据库迁移1
2
3
4
5
6
7
8
9
10
11
12
13
14
| class CreateRecipes < ActiveRecord::Migration
def self.up
create_table ( :recipes,  ptions => 'TYPE=InnoDB' ) do |t|
t.column :name, :string, :null => false
t.column :description, :text, :null => false
t.column :ingredients, :text, :null => false
t.column :instructions, :text, :null => false
end
end
def self.down
drop_table :recipes
end
end
|
数据库中只有一个表：recipes。包含五个字段：name、description、ingredients、instructions，还有一个字段是 Rails 基础设施自动维护的唯一标识符。
建立好数据库表之后，接下来就要为它包装一个 ActiveRecord 对象。该对象如 所示。
清单 2. Recipe 模型1
2
3
4
5
6
| class Recipe < ActiveRecord::Base
validates_presence_of :name
validates_presence_of :description
validates_presence_of :ingredients
validates_presence_of :instructions
end
|
ActiveRecord 基类负责所有基本的数据库访问：查询表、插入、更新和删除记录。这里只要为每个字段增加验证就够了。我告诉 Rails 每个字段不能为空。
Ajax 表单创建 Recipe 应用程序的第一步是向数据库中添加菜谱。首先介绍在 Rails 中创建基本 HTML 表单的标准方法。如 中的 RecipesController 类所示。
清单 3. Recipes_controller.rb1
2
3
4
5
6
7
8
9
10
11
12
| class RecipesController < ApplicationController
def add
@recipe = Recipe.new
if request.post?
@recipe.name = params[:recipe][:name]
@recipe.description = params[:recipe][:description]
@recipe.ingredients = params[:recipe][:ingredients]
@recipe.instructions = params[:recipe][:instructions]
@recipe.save
end
end
end
|
只有一个方法 add，它首先创建一个空的 Recipe 对象。然后当客户机发出请求时添加参数并保存数据。
该页面的 ERB 模板如 所示。
清单 4. Add.rhml1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| <html>
<body>
<%= error_messages_for 'recipe' %><br/>
<%= start_form_tag %>
<table>
<tr><td>Name</td>
<td><%= text_field :recipe, :name %></td></tr>
<tr><td>Description</td>
<td><%= text_area :recipe, :description, :rows => 3 %></td></tr>
<tr><td>Ingredients</td>
<td><%= text_area :recipe, :ingredients, :rows => 3 %></td></tr>
<tr><td>Instructions</td>
<td><%= text_area :recipe, :instructions, :rows => 3 %></td></tr>
</table>
<%= submit_tag 'Add' %>
<%= end_form_tag %>
</body>
</html>
|
页面首先显示 recipe 对象的错误消息。如果用户发布的数据没有通过 Recipe 模型对象的验证就会设置这些消息。然后依次为 <form> 标记、每个字段的 text_field 和 text_area 项、<submit> 标记和表单末尾。
这是非常标准的 Rails。安全可靠，可用于各种浏览器，清晰地映射到为客户机创建的 HTML。但我需要的是 Web 2.0，就是说 Ajax。那么，该如何修改呢？
控制器端的 add() 方法彻底变了，如 所示。
清单 5. Recipes_controller.rb1
2
3
4
5
6
7
8
9
10
11
| class RecipesController < ApplicationController
def add
end
def add_ajax
Recipe.create( { :name => params[:recipe][:name],
:description => params[:recipe][:description],
:ingredients => params[:recipe][:ingredients],
:instructions => params[:recipe][:instructions] } )
end
end
|
add() 方法不再做任何事，因为有一个新的方法 add_ajax() 处理客户机返回的数据。
对于模板来说，不需要做大的修改，如 所示。
清单 6. add.rhtml 的开始部分1
2
3
4
5
6
7
8
9
10
11
| <html>
<head>
<%= javascript_include_tag :defaults %>
</head>
<body>
<div id="counter"></div>
<%= form_remote_tag :url => { :action => 'add_ajax' },
:complete => 'document.forms[0].reset();',
:update => 'counter' %>
<table>
<tr><td>Name</td>
|
文件开始在 HTML 中增加了 head 部分，其中包含对 Rails 默认 JavaScript 文件的引用。这就是 Prototype.js 系统，完成 Ajax 工作的大部分。
然后添加了 <div> 标记 counter，保存从 Ajax 请求返回的结果。并不是非常必要，但给用户一些反馈也不错。
最后，将原来的 start_form_tag 改为 form_remote_tag。form_remote_tag 有几个参数，其中最重要的是 url，它指定向何处发送数据。第二个是一个完整的处理程序，其中的 JavaScript 代码在 Ajax 请求完成时执行。这里重置表单以便让用户输入新的菜谱。然后使用 update 参数告诉 Rails 把 add_ajax 动作的输出发送到何处。
add_ajax() 方法还需要一个模板。如 所示。
清单 7. Add_ajax.rhtml1
| <%= Recipe.find(:all).length %> recipes now in database
|
如此而已。但并不完全是。这仅仅是从标准 HTML 表单迁移到 Rails 中的 Ajax 表单。 显示了准备提交的 Ajax 表单。
图 1. Ajax 表单 接下来是更加动态的交互，比如使用 Ajax 动态搜索。 |
|
|
|
|
|
