Ruby on Rails 中文 Wiki

Rails

Wed, 02 Jul 2008 04:24:37 Z

test

Rails2_0新特性_为environment_rb前部加载挂钩

Sun, 08 Jun 2008 05:52:28 Z

如果您一直在寻求由 environment.rb 读取前对 Rails 程序进行设置的方式，今天有答案了。

如果一个 config/preinitializer.rb 的文件存在，Rails 将在读取 environment.rb 文件之前先加载这个文件。通过这个方法使您在加载插件之前可以使程序读取 Rails 的类代码。

Rails2_0重要更新以及新特性

Sun, 08 Jun 2008 05:51:49 Z

感谢 Yudi 提供本系列文档

Rails 2.0 重要更新以及新特性系列是针对 Ryan Daigle 的Rails2.0总结所做的中文翻译。这个项目的唯一目的是希望帮助大家在Rails 2.0发布后以最方便的途径了解所有重大和有意义的更新。

当然Edge Rails的更新不仅仅是这些，Ryan作为Rails开发团队的核心一直尽心尽力的为大家做最好的总结。他的 Peepcode Rails2.0 单在美国已经售出超过1000份。

希望对将版本升级到 Rails 2.0 的开发人员有所帮助。
下面是系列的列表：（按照时间排序）

更多 Rails2 相关

这里是 robbin 的Rails2 总结，非常好。

Rails2_0新特性_filters的更新

Sat, 07 Jun 2008 06:03:09 Z

Controller 里刚刚被更新的 filters 功能也许会为您现存的代码带来一点变动。现在，false 输出将不再停止当前运行的进程，真正停止进程的主角换为了 rendering 或 redirecting。

如果您深入的去理解，通过在 filter 里的 render/redirect 来停止一个进程更加符合逻辑，因为它们在每个进程里只能被使用一次，这样更加能够指明这个进程将不再需要调用其他资源。

那么之前，您也许会拥有一个类似下面的 filter ：

def must_be_logged_in
  if(not user_logged_in?)
    redirect_to login_url
    return false
  end
end

您现在可以通过 rendering 或 redirecting 来取代输出 false：

def must_be_logged_in
  redirect_to login_url if not user_logged_in?
end

头一次看到的时候我以为这个方法可能会捣乱我们原先设置的 filter，但是在对自己的代码进行总结后我发现任何时候输出 false 的时候早已经进行了 render 或者 redirect。不过还不太确定每个人都是如此 …

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_Fixtures变得简单了

Sat, 07 Jun 2008 06:01:31 Z

现在有众多的 fixture插件尝试着使您的 test fixtures 变得更加简单。而大多数插件都通过不同的方式达到了目的。

它们之间最好最特别的 fixture 插件 Rathole “整合进了 rails 之中”http://dev.rubyonrails.org/changeset/8036 。让我们来总结一下它的功能，以便您来使用：

让我们为示例建立下面的 model：

class Company < ActiveRecord::Base; has_many :employees; end
class Employee < ActiveRecord::Base; belongs_to :company end

上面所示的是一个公司和它的员工之间简单的一对多关系。但是当我们设置 fixtures 的时候，很多不重要的元素使得我们不得不去亲自设定处于混乱的 id。而且这样的问题由于数据量的增长变得越来越严重。
companies.yml

yfactorial:
  id: 1
  name: yFactorial, LLC
  created_at: <%= Time.now %>
  updated_at: <%= Time.now %>

employees.yml

ryan:
  id: 1
  name: Ryan Daigle
  company_id: 1
  created_at: <%= Time.now %>
  updated_at: <%= Time.now %>

通过 Rathole 的特性，您不必再亲自解开相互交缠引用着的 id, 也不必设置 auto-magic date 列的值。请注意当您的 fixture 成熟后会变成什么：
companies.yml

yfactorial:
  name: yFactorial, LLC

employees.yml

    
ryan:
  name: Ryan Daigle
  company: yfactorial

请特别记下以下提到的两组 fixtrue 之间的不同：

您不必为每条记录设置 id。这个进程被自动化以后会为记录形成一组hash数组（于是由 “yFactorial” 形成的integer hash将被作为记录的 id）
不必再设置 auto-magic 日期的值了。一切 created_xx 和 updated_xx 区域将自动由 Time.now 填补。
当引用其他记录的id时（即 employees.company_id），您只需要输入 fixture 名称，系统会使用“浓缩”后的数据作为id。这个方法使得我能够将 company_id: employees.yml 中的一行数据更改为 yfactorial。

记录：由于每一条记录的主键都经过了计算（形成 fixture 名称的数组），fixture不需要提前知道其主键值以被读取。如此便消除了很多递归式的附属关系，以及可能容易形成的数据排列问题。

然而，在您通过 join table 来管理复杂的 has_and_belongs_to_many 的关系网时，外键值（Foreign key）的联系也得到了特别的优化。那么我们假设一个 company 与 industry_associations 之间存在 has_and_belongs_to_many 的关系：

class Company < ActiveRecord::Base
  has_and_belongs_to_many :industry_associations,
                          :join_table => 'company_industry_associations'
end
class IndustryAssociation < ActiveRecord::Base
  has_and_belongs_to_many :companies,
                          :join_table => 'company_industry_associations'
end

现在我们不必再撰写我们自己的 company_industry_associations.yml fixture 文件，而是直接在 companies.yml 文件中指明所属 industry_associations 的外键：
companies.yml

yfactorial:
  name: yFactorial, LLC
  industry_associations: ruby, webservices

假设我们拥有一个记录了 ruby 和 webservices 的 industry_associations.yml fixture 文件，系统将自动为您建立 habtm1 的 join table。

这对你们 fixture 用户们（当然我也是其中之一）来说真是天大的好处。也许还没尝试过 fixture 的朋友们再来看看？真得是非常强大的功能 – 感谢 John 为此所做的贡献！

请看看底部关于插件的 README文档，上面详细介绍了如何设定默认值，以及如何获取其他 fixture 的主键值

注释

即 has_and_belongs_to_many? 的缩写。

Rails2_0新特性_Rails Validation现在允许_为空

Sat, 07 Jun 2008 05:56:38 Z

这是一个很小的更新，但很值得一提。种类繁多的 activerecord validation method 现在接受 :allow_blank 选项。通过 :allow_blank 当值为 nil 或空白的 string 时，validation 也会通过。

class Post < ActiveRecord::Base
  validates_length_of :meta, :maximum => 3, :allow_blank => true
end

p = Post.new(:meta => "")
p.valid?  #=> true

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_设置插件加载顺序

Sat, 07 Jun 2008 05:55:27 Z

无论在任何时候，您都可以准确设置启动 rails 程序所需要的插件，而不是通过存在于 environment.rb 里的这段代码来痛苦的加载 vender/plugins 目录中的所有插件：

# Only load the plugins named here, by default all plugins in vendor/plugins are loaded 
# 只加载这里列出的插件，默认时加载 vendor/plugins 中的所有插件。（默认时下面代码被设定为 comment）
config.plugins = %W( exception_notification ssl_requirement )

问题是，当您设置特定几个插件的加载顺序时，单单为了设置加载顺序您又要列出所有需要的插件名称。

不过，现在这个问题可以通过在 config.plugin 里使用 :all 符号来代替重新列出需要的插件。

config.plugins = [ :exception_notification, :ssl_requirement, :all ]

这样您可以更加方便的控制插件加载顺序。如果您想将部分插件放到最后，则可以将 :all 插在加载顺序的中间：

config.plugins = [ :exception_notification, :all, :ssl_requirement ]

Rails2_0新特性_Exception Handling的升级

Sat, 07 Jun 2008 05:54:03 Z

根据不同的 application exception 提供不同的解决方式（比如 redirect user 或 render 特定的页面）是很常见的设计模式。在这个更新系列之前我们经常需要在 controller 里超量加载 rescue_action_in_public method:

class PostsController < ApplicationController
  def rescue_action_in_public(exception)
    case(exception)
      when ActiveRecord::RecordNotFound then render :file => '/bad_record'
      when NoMethodError then render :file => '/no_method'
      else render :file => '/error'
    end
  end
end

很容易发现这段代码立即被扩展成了多组乱了套的 if/else 声明。

现在我们拥有了一套非常简洁的方法来通过新的 rescue_from 来铺展不同的 exception 与 handler 脉络。 rescue_from 使一个 exception 的类型与一个 handler 的方法名称直接栓到一起，使得exception的处理变得更加简单易懂：

class PostsController < ApplicationController

  # 从 exception 到 handler methods 的声明
  rescue_from ActiveRecord::RecordNotFound, :with => :bad_record
  rescue_from NoMethodError, :with => :show_error

  def bad_record; render :file => '/bad_record'; end
  def show_error(exception); render :text => exception.message; end

end

请记住，exception handler methods 既可以作为无实参的 method, 也可以添加一个问题形式的 exception 作为实参（如上面的 show_error 所示）。

您也可以使用 block 或者 proc 来设置 rescue_from 里的 exception处理方式：

class PostsController < ApplicationController

  # 从 exception 到 handler methods 的声明
  rescue_from(ActiveRecord::RecordNotFound) { |e| render :file => '/bad_record' }
  rescue_from NoMethodError, :with => proc { |e| render :text => e.message }

end

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_网站签名防护的改进

Sat, 07 Jun 2008 05:45:32 Z

今日讨论 Rails 安全性的话题越来越热，因此 Rails 将 CsrfKiller 插件加入了核心部分

Csrf Killer? 插件为所有的非GET¹请求中的form 添加了一个独特的session token 一栏。这一栏内容确保了接收到的请求必须是来自于授权用户的 session²

现在轮到默认功能了。如果您只想应用默认的行为则不必设置任何东西。然而您仍然可以通过以下示例针对自己的设定来进行调整：

class PostsController < ApplicationController

  protect_from_forgery :secret => '2kdjnaLI8', :only => [:update, :delete, :create]
  ...
end

如果您已经使用 edge Rails 的默认 cookie 的 session存贮，那么您则不必设置 :secret 密钥。

protect_from_forgery :only => [:update, :delete, :create]

如果您没有使用 cookie 的 session 存贮，则可以改变用来建立独特蜜月的 digest method (默认method是 ‘SHA1’)。

protect_from_forgery :secret => '2kaienna9ea90djnaLI8', :digest => 'MD5'

当系统接收到外部请求的时候，如果请求无法满足当前session的签名保护标签，系统将会输出一个来自 ActionController::InvalidAuthenticityToken 的 exception。也许这段代码在将来会有新的错误输出语法？
注意：鉴别请求的签名保护功能只在一下情况中可以被应用：

非-GET 请求，所以请确定改变状态的请求属于 PUT/POST/DELETE 请求之一。

对于html以及Ajax请求。如果您想扩展 verifiable_request_format? 则需要先覆盖它。

skip_before_filter :verify_authenticity_token

如果您想在全网站范围中取消这项功能，只要将下列添加到 application.rb:

self.allow_forgery_protection = false

注释

HTTP 动词包括： GET/PUT/POST/DELETE
更多使用方法请去 CSRF

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_Rails日志记录变利索点儿了

Sat, 07 Jun 2008 05:42:19 Z

Edge Rails 刚刚发布了一个使用缓存的日志记录器。看起来，它可以把 Rails 的日志整理的更加利索。

新的日志记录器现在成为了默认，尽管您可以通过更改 environment.rb 将它更改到从前：

config.logger = Logger.new('/path/to/log', Logger::DEBUG)

不过我不太认同您这样做…

Rails2_0新特性_新的Rails数据库接口

Sat, 07 Jun 2008 05:41:03 Z

如果您的 Edge Rails 程序不支持 My SQL?, Postgre SQL? 或 SQLite 以外的任何数据库，那么您将需要确保在本机上安装了正确的gem。正如现在，Rails 核心开发人员在近期制作了一系列新的 Rails 数据库接口，并以gem发布。这一系列中的任何一个都应当解决您一直以来的数据库接口问题：

gem install activerecord-oracle-adapter
gem install activerecord-sqlserver-adapter
gem install activerecord-firebird-adapter
gem install activerecord-frontbase-adapter
gem install activerecord-openbase-adapter
gem install activerecord-sybase-adapter

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_Partial也有了Layout

Sat, 07 Jun 2008 05:40:28 Z

如果您时常将不同 Rails views 中的重复代码放到 partials里，也许您也会察觉到我们还可以针对那些partials继续 DRY¹。于是现在我们又有了一个新的工具来帮助 partials 成为 view-世界里的第一等公民： partial layout 。这个工具的使用正如同我们为 render call 中添加一个 :layout 选项般简单：

<!-- in posts/show.html.erb -->
<%= render :partial => 'header', :layout => 'boxed', :locals => {:post => @post} %>

<!-- in posts/_boxed.html.erb -->
<div class='box'>
  <div id='post_header_<%= post.id %>'><%= yield %></div>
</div>

<!-- in posts/_header.html.erb -->
<%= post.title %> published on <%= post.published_at %>

请注意叫做 ‘boxed’ 的partial layout依然保留了 _ 前缀的命名传统，并且这个 partial layout 也存在于同一个文件夹里² 。同时，也请注意任何传入 partial render 的临时变量对于整个 partial layout 也会开放。（此例中是post）您将通过使用 yield 将 partial 的内容传递到 layout，正如您在 master templates 中所做的那样。

那么在上面的环境中，post/show.html.erb 的渲染结果将为：

<div class='box'>
  <div id='post_header_1'>Post Title published on August 3rd, 2007</div>
</div>

您也可以通过渲染 partial layout 中的部分代码块来保持 layout 个连贯性，从而不再需要把 content 分割成一份份的 partial：

<!-- in posts/show.html.erb -->
<% render(:layout => 'boxed', :locals => {:post => @post}) do %>
  <%= post.title %> published on <%= post.published_at %>
<% end %>

快进行您自己的 DRY 吧！

注脚

DRY 即 Don’t Repeat Yourself （不要撰写重复的代码），是pragmatic programmer系列宣传的思想主旨
它不不像其他的 master layouts 一般拥有自己的专属文件夹

Rails2_0新特性_使用rake查看路由列表

Sat, 07 Jun 2008 05:37:15 Z

在需要的时候，您可以亲自查看程序中的路由是如何被定义的。现在，rake task扩展了新的功能，使路由的显示变得更加直观和方便。

只要运行：

rake routes

瞧，所有被定义的路由都会被整齐的摆进下面顺序编排的列表：

路由名称， HTTP method，路由路径，路由要求

作为一个实例，这里是我电脑中的输出：

all_articles       GET  /articles;all/      {:action=>"all", :controller=>"articles"}
search_articles GET  /articles;search/   {:action=>"search", :controller=>"articles"}

对于没有使用 edge rails 的朋友们，为程序添加这个rake task也是非常的容易：

curl http://svn.rubyonrails.org/rails/trunk/railties/lib/tasks/routes.rake > lib/tasks/routes.rake

这个task对于大量应用了路由魔法的RESTful应用程序尤其有用。现在您可以好好的偷窥这些路由魔法背后秘密了。

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_Fixtures堆积

Sat, 07 Jun 2008 05:35:58 Z

如果您已经厌倦了建立 Fixtures 堆积时不断的引用 fixture method 的话，今天是您的幸运日！

过去不断重复输入的日子已经结束了：

fixtures :states
..
assert_equal [states(:nc), states(:va)], State.find(:all)

而这里您可以一次引用多个fixture的快捷语法：

fixtures :states
..
assert_equal states(:nc, :va), State.find(:all)

是革命性的升级么？不是。有用的升级？是的。

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

Rails2_0新特性_带回性感的一面

Sat, 07 Jun 2008 05:34:37 Z

还记得那些如此吸引你的 migration 吗？的确，它们现在已经是主流了。在这里我不会再重复它们那些已经被阐述的特性 – 然而值得一提的是Rails已经把这性感一面带进了它的代码中。

现在您可以：

create_table "users", :force => true do |t| 
  t.integer :group_id, :employer_id
  t.string :first, :last
  t.timestamps
end

上面的示例中，我们在 group_id 与 employer_id 中选择了 integer 列，在 first 与 last 中选择了 string 列。timestamps 变魔术般的为您创建 created_at 与 updated_at。

The list of supported column types are: 支持中的序列有：

string
text
integer
float
decimal
datetime
timestamp
time
date
binary
boolean

还等什么呢，立即玩转您的 record，还回它性感的一面吧！

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客