gem install tzinfo builder memcache-client rack rack-test rack-mount erubis mail text-format thor bundler i18n
gem install rails --pre


这里会遇到一个rack-mount依赖问题，可以通过手动安装0.4.0版的rack-mount解决：

sudo gem install rack-mount -v=0.4.0

升级应用

rails_upgrade(http://github.com/rails/rails_upgrade)是Rails官方的Rails3升级辅助插件，它提供了几个Rake任务帮助你轻松完成升级。

1. 执行 rails:upgrade:backup 备份会被Rails 3覆盖的文件，比如：application_controller.rb会被重命名为application_controller.rb.rails2
2. 执行 rake rails:upgrade:routes 生成Rails 3格式的routes.rb，以及rake rails:upgrade:gems生成新的Gemfile
3. 在你的程序目录执行: rails . 注意不要覆盖routes.rb和Gemfile

接下来要做的就是将备份的rails2文件合并到新生成的文件中，再次启动应用，如果幸运的话，你的应用现在已经运行在Rails 3 beta上了，注意检查Log中的Deprecated Warning，并将其替换为Rails 3的方式，关于Rails 3的新特性请参看Release Notes：http://guides.rails.info/3_0_release_notes.html

ActionView

Rails 3重写了View Helper，并作废了以前的link_to_function, link_to_remote, remote_form_for等AJAX Helper，而改为为link_to, form_for增加:remote => true来实现。

link_to_function(text, function) => link_to(text, ‘#’, function)
link_to_remote(text, {:url => url}) => link_to(text, url, :remote => true)
remote_form_for(object) => form_for(object, :remote => true)

Passenger

Passenger从2.2.9版本开始支持Rails 3，如果你的版本小于2.2.9，请先升级，另外需要注意的是，Rails 3会在你的应用目录下创建一个config.ru文件，如果需要以development模式运行你的应用，需要做点改变：

1. 在你的apache配置中加入： RackEnv development
2. 删除config.ru，这样passenger会继续使用RailsEnv

jQuery

Rails 3默认是使用Prototype的，如果要使用jQuery，jquery-ujs（http://github.com/rails/jquery-ujs.git）项目提供了jQuery版本的rails.js，下载并替换默认的rails.js，然后在 application.html.erb的head部分增加:


<meta name="csrf-token" content="<%= form_authenticity_token %>" />
<meta name="csrf-param" content="authenticity_token" />


Paperclip

Paperclip目前还不支持Rails 3，不过Github上已经有了一个Rails 3的分支，我们可以直接使用这个分支：


git submodule add -b rails3 git://github.com/thoughtbot/paperclip.git vendor/plugins/paperclip
git submodule init


但是这个分支目前工作也不正常，还需要打一个补丁：


# in lib/paperclip/attachment.rb at line 293
def callback which #:nodoc:
  # replace this line...
  # instance.run_callbacks(which, @queued_for_write){|result,obj| result == false }
  # with this:
  instance.run_callbacks(which, @queued_for_write)
end


此处参考：http://jameswilding.net/2010/02/07/paperclip-on-rails-3-beta/

基本用法

基本用法想必大家都知道了，Rails默认的Locale文件夹在config/locales下，假设你要支持中文和英语，那么你需要在这个文件夹下放置en.yml和zh.yml。



# zh.yml

zh:

  submit: '提交'

 create: '创建'

#en.yml

en:

  submit: 'Submit'

  create: 'Create'



Rails 会自动加载config/locales目录下的locale文件，如果你的locale文件放在别的地方，那么你可以通过修改I18n.load_path来加载它：



# in config/initializer/locale.rb

I18n.load_path += Dir[ File.join(RAILS_ROOT, 'lib', 'locale', '*.{rb,yml}') ]



使用很简单，你可以进入Console进行测试：



> I18n.t 'submit'

=> "Submit"

> I18n.locale = 'zh'

=> "zh"

> I18n.t('submit')

=> "提交"



试图中更加简单，你可以直接调用t方法：



<%= t 'submit' %>

传递变量

有些时候，我们的字符串中可能需要包含变量，只需要将其放在两个大括号内就可以了：

# zh.yml



zh:

  hello: "你好, {{name}}"



打开console：



> I18n.t 'hello', :name => 'Rails'

=> "你好，Rails!"



单复数处理

实际上，中文不存在这个问题，这个问题主要存在于字母语言，解决方法是：



# en.yml

en:

  post:

    one: '1 post'

    other: '{{count}} posts'



然后在console中测试：



> I18n.t 'post', :count => 1

=> "1 post"

> I18n.t 'post', :count => 5

=> "5 posts"



时间和日期

时间和日期的翻译稍微复杂，需要用到rails-i18n项目下rails/locale文件夹下的zh-CN.yml文件，由于文件太大，就不贴出来了，有了这个文件，现在你就可以：


> I18n.l Date.today, :format => 'long'

=> "2009年1月08日"

> I18n.l Time.now, :format => 'default'

=> "2009年1月08日 星期四 20:37:58 CST"

> I18n.time_ago_in_words(Time.now)

=> "一分钟内"

> I18n.time_ago_in_words(48.minutes.ago)

=> "大约一小时"


数字

假设你已经有了上面的那个文件:



> number_to_currency(100)

=> "$100.00"

> I18n.locale = 'zh'

=> "zh"

> number_to_currency(100)

=> "CNY 100.00"



你只需要将CNY换成人民币的符号就可以了。

ActiveRecord

ActiveRecord也很简单，假设你有一个user model，它有两个属性login和email，那么需要在zh.yml中定义：



zh:

  activerecord:

    models:

      user: "用户"

    attributes:

      user:

        login: "用户名"

        email: "电邮"



这样就OK了:



> u = User.create

false

> u.errors.full_messages

['用户名不能为空字符', '电邮不能为空字符']



根据请求设定语言

要设置应用的默认语言，可以通过

config.i18n.default_locale = :zh

如果要根据用户浏览器的设置选择语言，需要在application.rb中加一个before_filter:



class ApplicationController

  before_fiter :set_language

  def set_language

    request_language = request.env['HTTP_ACCEPT_LANGUAGE']

    request_language = request_language.nil? ? nil : request_language[/[^,;]+/]

    I18n.locale = request_language if request_language && File.exist?("#{RAILS_ROOT}/config/locales/#{request_language}.yml")

  end

end

参考：

• http://rails-i18n.org/wiki/pages/i18n-rails-guide
• http://media.railscasts.com/videos/138_i18n.mov
• http://blog.ashchan.com/archive/2008/11/24/rails-i18n-activerecord-model-human-name-made-easy/
• http://i18n-demo.phusion.nl/

先升级到2.1，然后建一个新应用

$ sudo gem update rails
$ rails demo210
$ cd demo210

然后建一个post model：

$ script/generate model post title:string body:text published_at:datetime
$ rake db:migrate

现在我本机的时间是：2008-06-03 15:55:00，然后让我们进入Console，创建一个新的Post：

>> post = Post.create(:published_at => Time.now)
>> post.published_at
=> Tue, 03 Jun 2008 07:55:00 UTC +00:00

变成了7:55，没错，因为我本地的时区设置是UTC，而我们比UTC快了8小时，现在让我们将时区修改到上海，然后再来看看published_at：

>> Time.zone.name
=> “UTC”
>> Time.zone = ‘Asia/Shanghai’
=> “Asia/Shanghai”
>> post.reload
>> post.published_at
=> Tue, 03 Jun 2008 15:55:00 CST +08:00

可以看到，现在时间已经变成了东八区，这是怎么实现的呢？实际上Rails在数据库中保存的依然是UTC时间，我们可以通过column_before_type_cast来查看它:

>> post.published_at_before_type_cast
=> “2008-06-03 07:55:00″

也就是说published_at实际上是根据原始的UTC时间加上当前时区的设置重新计算出来的。

关于Rails 2.1的其它特性，可以参看官方Blog给出的介绍链接，基本上只看代码就能明白怎么回事。

什么是Story？

Story是BDD中的概念，我们可以简单的将它看作是对应用特性的描述（feature），举个例子，比如我们现在要设计一个提款机的程序，那么以下两个story是必不可少的：

1. 用户能够取出钱来
2. 银行职员可以放钱进去

如何定义Story？

但是我们该如何描述一个Story呢？BDD对Story的结构进行了规范，下面给出Story的定义模板，这也是RSpec支持的格式：

Title (one line describing the story)

Narrative:
As a [role]
I want [feature]
So that [benefit]

Acceptance Criteria: (presented as Scenarios)

Scenario 1: Title
Given [context]
And [some more context]…
When [event]
Then [outcome]
And [another outcome]…

Scenario 2: …

我们可以看到，一个Story由2个部分组成：定义及场景，Story的定义包含3个部分：role（角色），feature（特性）以及benefit（结果），为了对结果进行度量，Story包含了许多的Scenario（场景），每个Scenario包含上下文，时间以及输出，有些抽象？让我们来看个例子，还以上面的取款机程序为例子，那么”用户能够取出钱来”的Story就可以这样定义：

Story: 允许用户取钱

作为一个用户
我想要从ATM取款
这样当银行下班之后我也可以得到现金

Scenario: 账户有足够的余额
Given 一张余额为 1000 块的卡
And 卡是有效的
And ATM机有足够现金
When 用户请求取款 100 块
Then ATM应该吐出 100 块现金
And 用户账户应该被扣除 100 块
And 卡应该被吐出

Scenario: 账户余额不足
Given 一张余额为50块的卡
And 卡是有效的
And ATM机有足够现金
When 用户请求取款100块
Then 提示用户余额不足
And ATM不应吐出钞票
And 用户账户余额应该为50
And 卡应该被吐出

应用RSpec测试Story

那么我们该如何使用RSpec来测试这个Story呢？假设我们将上面的Story保存为一个名为atm的文件，那么现在只需要定义一个atm.rb文件，并将他们保存在一个目录下，我们就可以通过atm.rb来运行这个Story了，atm.rb文件如下：

require ‘rubygems’
require ‘spec/story’

steps_for(:atm) do

# Given the string PeepCode
Given(“一张余额为 $credit 块的卡”) do |credit|
@origal = @credit = credit.to_i
end

Given(“卡是有效的”) do
end

Given(“ATM机有足够现金”) do
end

# When the string is reversed
When(“用户请求取款 $taken 块”) do |taken|
@credit = @credit – taken.to_i
end

# Then the result should be edoCpeeP
Then(“用户账户应该被扣除 $taken 块”) do |taken|
@credit.should == (@origal – taken.to_i)
end

Then(“ATM应该吐出 100 块现金”) do
end

Then(“卡应该被吐出”) do
end
end

with_steps_for(:atm) do
run “atm”
end

运行结果：

$ ruby atm.rb
Running 2 scenarios

Story: 允许用户取钱

作为一个用户
我想要从ATM取款
这样当银行下班之后我也可以得到现金

Scenario: 账户有足够的余额

Given 一张余额为 1000 块的卡
And 卡是有效的
And ATM机有足够现金

When 用户请求取款 100 块

Then ATM应该吐出 100 块现金
And 用户账户应该被扣除 100 块
And 卡应该被吐出

Scenario: 账户余额不足

Given 一张余额为50块的卡 (PENDING)
And 卡是有效的
And ATM机有足够现金

When 用户请求取款100块 (PENDING)

Then 提示用户余额不足 (PENDING)
And ATM不应吐出钞票 (PENDING)
And 用户账户余额应该为50 (PENDING)
And 卡应该被吐出

2 scenarios: 1 succeeded, 0 failed, 1 pending

Pending Steps:
1) 允许用户取钱 (账户余额不足): 一张余额为50块的卡
2) 允许用户取钱 (账户余额不足): 用户请求取款100块
3) 允许用户取钱 (账户余额不足): 提示用户余额不足
4) 允许用户取钱 (账户余额不足): ATM不应吐出钞票
5) 允许用户取钱 (账户余额不足): 用户账户余额应该为50

我们可以看到，第一个场景的测试获得了通过，而第二个场景则处于挂起状态，现在想必你已经对RSpec Story有了一个大概的了解，不过RSpec Story目前还处于试验阶段，因此不推荐应用到真实项目中，不过作为一种新的开发方式，保持一定的关注度还是有必要的。

参考：

• What’s in a story?
• David Chelimsky（RSpec作者）的Blog

理论总是过于抽象，让我们通过一个例子来看看ARes究竟是如何工作的，假设我们要开发一个类似于豆瓣那样的书评网站（我们为它申请了一个 shuping.com的域名），但为了不在一开始就让事情变得不可收拾，在第一个迭代周期内，我们只打算让用户做两件事情：提交/编辑书目，提交/编辑 /删除评论，也就是说我们只需要创建2个Resource：book和comment：

map.resources :books do |book|
  book.resources :comments
end

现在，我们已经具有了一组REST风格的URI，用户可以通过/books/new来创建新书目，或者通过/books/: book_id/comments/new来提交对书目的新评论，这对于使用浏览器的普通用户来说没什么问题，只要我们有一位足够优秀的UI设计师，用户应该不会在这一过程中感到任何的不快。但我们的目标并不局限于此，我们希望我们的数据能够被应用到更广泛的领域，同时，我们也希望用户能够通过更多的方式来向我们提交数据，而不仅仅只是通过我们自己的网站，因此，我们向第三方开发者开放了我们的REST API，他们可以通过：

• GET /books，获取所有书目
• POST /books，创建新书目
• GET /books/1.xml，获取编号为1的书目
• PUT /books/1.xml，修改编号为1的书目
• DELETE /books/1.xml，删除编号为1的书目

但是作为应用的开发者，他们应该如何来使用我们的API呢，要使用我们的API，他们需要：

• 创建一条到我们服务器的HTTP连接
• 构造一个请求报文
• 发送请求报文到我们的REST URI
• 解析得到的响应，处理可能的错误

不过幸运的是，有了ARes，他们不需要真的这么做，现在让我们将角色切换到为我们的书评网站开发应用的第三方开发者，假设我们要使用书评网的数据，那么，我们首先需要定义一个ARes类：

class Book < ActiveResource::Base
  self.site = "http://shuping"
end

接下来，我们就可以像ActiveRecord那样来使用我们的ActiveResource类了。

获取书目信息

要从书评网获取书目信息，可以使用find方法：

books = Book.find(:all)

现在，我们已经得到了书评网最新的书目信息，那么ARes是如何帮助我们做到这些的呢？实际上它替我们向书评网发送了一条GET请求：

GET http://shuping.com/books.xml

<books type="array">
  <book>
    <title>Agile Web Development with Rails</title>
  </book>
</books>

并将得到的XML报文重新组装为本地的Book对象。

但要注意，ARes没有提供ActiveRecord的find_by函数，不过我们可以通过向find传递:params来实现同样的功能，下面是一些复杂的find操作：

Book.find(:first, :params => {:title => 'TDD'})
# GET http://shuping/books.xml?title=TDD
Book.find(:first, :from => :popular)
# GET http://shuping/books/popular.xml
Book.find(:first, :from => '/yzhang/books.xml')
# GET http://shuping/yzhang/books.xml

同样的，我们也可以使用save方法创建一条新书目：

book = Book.new(:title => "Programming Ruby")
book.new? # true
book.save # true
book.id # 2

这相当于向书评网发送了一条 POST请求：

POST http://shuping.com/books

POST的内容就是我们新建的书目的XML表示，而返回的XML响应则通过Location字段指示了新资源在远端服务器上的位置：

Location: http://shuping.com/books/3.xml

ARes会根据返回的响应自动为我们更新新书目的id字段，因此，我们可以看到，在保存成功后，新书目的id变为了2，除了find和save，我们也可以更新一个已存在的书目或者删除错误添加的书目：

book = Book.find(2)
book.authors = "Dave Thomas, Andrew Hunter"
book.new? # false
book.save # PUT http://shuping.com/books/1.xml
book.destroy # DELETE http://shuping.com/books/1.xml
book.exist? # false
Book.exist?(2) # false

错误处理

上面的代码，我们假设了所有的数据都是正确的，但在现实世界中，错误往往是难以避免的，因此，一个稳固的应用必须考虑到可能的错误，首先我们来看看如果我们试图保存一个没有名称的新书目会发生什么情况：

book = Book.new
book.save # false
book.errors.full_messages # => ["Title can't be blank"]
book.errors.on :title # => Title can't be blank

就像我们所想的，保存失败了，并且同ActiveRecord一样，我们可以通过errors来向告诉用户失败的原因，但除了Validation失败，我们还需要面对其它可能出现的错误，比如请求的资源不存在，我们将会遭遇一个404响应，因此，要正确的处理这些错误，我们必须先了解它们，ARes可能产生的错误包括：

• 200 - 399，有效的响应，没有异常产生
• 404，请求的资源不存在，引发ActiveResource::ResourceNotFound异常
• 409，资源存在冲突，引发ActiveResource::ResourceConflict异常
• 422，无效的资源（如Validation失败），引发ActiveResource::ResourceInvalid异常
• 401 - 499，其它客户端错误，引发ActiveResource::ClientError异常
• 500 - 599，其它服务端错误，引发ActiveResource::ServerError异常

通常情况下，我们只需要考虑404，409，422错误即可，因此安全的代码看起来应该是下面这个样子：

begin
  book = Book.find(1)
rescue ActiveResource::ResourceNotFound
  redirect_to :action => 'not_found'
rescue ActiveResource::ResourceConflict, ActiveResource::ResourceInvalid
  redirect_to :action => 'new'
end

资源嵌套

大家一定已经注意到了，我们的书评网定义了两个资源，但是前面的例子都只演示了如何操作Book资源，而没有涉及嵌套在Book中的comment资源，实际上，这相当的简单，我们只需这样定义comment.rb：

class Comment < ActiveResource::Base
  self.site = "http://shuping/books/:book_id"
end

大家应该注意到，在Site URI中包含了一个:book_id的symbol，ARes会负责将它替换为真实的user_id，当然我们需要将它传递给ARes：

comment = Comment.new(:body => 'test', :book_id => 1)
comment.save #true, POST http://shuping/books/1/comments
comment.id # 1
# GET http://shuping/books/1/comments/1
comment = Comment.find(1, :params => {:book_id => 1})
comment.body # test

自定义方法

现在，让我们再次回到我们的书评网站，假设我们的网站大受欢迎（虽然这不太可能），那么，相信我们很快就需要面临这样一个问题：垃圾评论。为了应对垃圾评论，我们决定采用最为稳妥的方式，人工审核，因此我们需要为comment controller扩展一个moderate方法：

book.resources :comments :member => {:moderate => :put}

现在，我们可以通过PUT /books/1/comments/1/moderate来人工批准一条评论，但问题随之也就来了，毕竟我们自己的人手有限，因此我们计划让我们的联盟网站来和我们一起审核评论，但是它们应该如何通过ARes来调用moderate方法呢，其实很简单：

comment = Comment.find(1, :params => {:book_id => 1})
comment.put(:moderate) # PUT http://shuping/books/1/comments/1/moderate
# true

最后，我们的书评网站必然是需要认证的，ARes提供了简单的方式来支持HTTP认证：

class Book < ActiveResource::Base
  self.site = "http://yzhang:password@shuping/"
end

参考：REST & ActiveResource

map.resources :projects, :collection => {:rss => 'get'}
map.resources :projects, :member => {:close => 'post'}
map.resources :projects, :new => {:validate => 'post'}

:collection 扩展针对资源集合（collection）的路由，它指向一个形如 #{action} => #{method}的Hash，其中method可以是get/post/put/delete，而action就是你要扩展的方法，产生的路由为 /projects/rss（Edge Rails，Rails1.2.3为/projects;rss），因此GET /projects/rss将被影射到ProjectsController#r
ss，同时还有一个URL Helper：rss_projects_path。

:member同:collection类似，不过它扩展针对单个资源的路由，因此它产生的路由为/projects/1/close（Edge Rails，Rails1.2.3为/projects/1;close），它也有一个URL Helper：close_project_path。

:new也差不多，不过它针对的是那些已创建但尚未被保存的资源。

参考：

• Rails API文档
• RESTful Rails Development PDF

以Blog系统为例，假设每个用户拥有一个Profile，以及多个Blog，那么我们可以这样建立资源的嵌套关系，修改route.rb:

# profile
GET /users/1/profile = ProfilesController#show
GET /users/1/profile/new = ProfilesController#new
GET /users/1/profile/edit = ProfilesController#edit
POST /users/1/profile = ProfilesController#create
PUT /users/1/profile = ProfilesController#update
DELETE /users/1/profile = ProfilesController#destroy
# Blogs
GET /users/1/blogs = BlogsController#index
GET /users/1/blogs/1 = BlogsController#show
GET /users/1/blogs/1/edit = BlogsController#edit
GET /users/1/blogs/new = BlogsController#new
POST /users/1/blogs = BlogsController#create
PUT /users/1/blogs/1 = BlogsController#update
DELETE /users/1/blogs/1 = BlogsController#destroy