Ruby on Rails 4.0 发布说明

Chapters

1. 升级到 Rails 4.0
2. 创建 Rails 4.0 应用程序
   • 存储 Gems
   • 使用最新版本
3. 主要功能
   • 升级
   • ActionPack
   • 安全性
4. 功能提取为gems
5. 文档
6. Railties
   • 显著更改
   • 弃用
7. Action Mailer
   • 显著更改
   • 弃用
8. Active Model
   • 显著变化
   • 弃用
9. Active Support
   • 显著变化
   • 弃用
10. Action Pack
    • 显著变化
    • 弃用
11. Active Record
    • 显著变化
    • 弃用
12. 致谢

1 升级到 Rails 4.0

如果您正在升级现有应用程序，在进行升级之前，最好有良好的测试覆盖率。您还应该首先升级到 Rails 3.2（如果尚未升级），并确保您的应用程序在升级到 Rails 4.0 之前仍然按预期运行。在升级 Ruby on Rails指南中提供了升级时需要注意的事项列表。

2 创建 Rails 4.0 应用程序

# 您应该已经安装了 'rails' RubyGem
$ rails new myapp
$ cd myapp

2.1 存储 Gems

Rails 现在使用应用程序根目录中的 Gemfile 来确定您的应用程序启动所需的 Gems。这个 Gemfile 由 Bundler gem 处理，然后安装所有依赖项。它甚至可以将所有依赖项本地安装到您的应用程序中，以便它不依赖于系统 Gems。

更多信息：Bundler 主页

2.2 使用最新版本

Bundler 和 Gemfile 使得使用新的专用 bundle 命令冻结您的 Rails 应用程序变得非常容易。如果您想直接从 Git 存储库进行捆绑，可以传递 --edge 标志：

$ rails new myapp --edge

如果您有一个 Rails 存储库的本地检出，并希望使用它生成一个应用程序，可以传递 --dev 标志：

$ ruby /path/to/rails/railties/bin/rails new myapp --dev

3 主要功能

3.1 升级

• Ruby 1.9.3 (提交记录) - 优先使用 Ruby 2.0；要求 1.9.3+
• 新的弃用策略 - 在 Rails 4.0 中，弃用的功能将成为警告，并将在 Rails 4.1 中被移除。
• ActionPack 页面和动作缓存 (提交记录) - 页面和动作缓存被提取到一个单独的 gem 中。页面和动作缓存需要太多手动干预（在底层模型对象更新时手动过期缓存）。相反，请使用俄罗斯套娃缓存。
• ActiveRecord 观察者 (提交记录) - 观察者被提取到一个单独的 gem 中。观察者仅在页面和动作缓存中需要，并且可能导致混乱的代码。
• ActiveRecord 会话存储 (提交记录) - ActiveRecord 会话存储被提取到一个单独的 gem 中。在 SQL 中存储会话是昂贵的。相反，请使用 cookie 会话、内存缓存会话或自定义会话存储。
• ActiveModel 大规模赋值保护 (提交记录) - Rails 3 大规模赋值保护已弃用。相反，请使用强参数。
• ActiveResource (提交记录) - ActiveResource 被提取到一个单独的 gem 中。ActiveResource 的使用不广泛。
• 移除 vendor/plugins (提交记录) - 使用 Gemfile 来管理已安装的 Gems。

3.2 ActionPack

• 强参数 (提交记录) - 仅允许更新模型对象的允许参数 (params.permit(:title, :text)).
• 路由关注点 (提交记录) - 在路由 DSL 中，提取出常见的子路由 (comments from /posts/1/comments 和 /videos/1/comments).
• ActionController::Live (提交记录) - 使用 response.stream 流式传输 JSON。
• 声明性 ETags (提交记录) - 添加控制器级别的 etag 添加，这将成为动作 etag 计算的一部分。
• 俄罗斯套娃缓存 (提交记录) - 缓存视图的嵌套片段。每个片段都会根据一组依赖项（缓存键）过期。缓存键通常是模板版本号和模型对象。
• Turbolinks (提交记录) - 仅提供一个初始的 HTML 页面。当用户导航到另一个页面时，使用 pushState 更新 URL，并使用 AJAX 更新标题和内容。
• 将 ActionView 与 ActionController 解耦 (提交记录) - ActionView 已从 ActionPack 解耦，并将在 Rails 4.1 中移动到一个单独的 gem 中。

• 不依赖于 ActiveModel (提交记录) - ActionPack 不再依赖于 ActiveModel。

  通用

• ActiveModel::Model（提交）- ActiveModel::Model是一个混入模块，使普通的Ruby对象可以与ActionPack无缝配合使用（例如用于form_for）。

• 新的作用域API（提交）- 作用域必须始终使用可调用对象。

• 模式缓存转储（提交）- 为了提高Rails的启动时间，不再直接从数据库加载模式，而是从转储文件加载模式。

• 支持指定事务隔离级别（提交）- 选择可重复读取或改进性能（减少锁定）哪个更重要。

• Dalli（提交）- 使用Dalli内存缓存客户端作为内存缓存存储。

• 通知开始和结束（提交）- Active Support工具包会向订阅者报告开始和结束通知。

• 默认线程安全（提交）- Rails可以在多线程应用服务器中运行，无需额外配置。

注意：请确保您使用的gem是线程安全的。

• PATCH动词（提交）- 在Rails中，PATCH替代了PUT。PATCH用于对资源进行部分更新。

3.3 安全性

• 匹配不捕获全部（提交）- 在路由DSL中，匹配要求指定HTTP动词。
• 默认转义HTML实体（提交）- 在erb中呈现的字符串会被转义，除非使用raw包装或调用html_safe。
• 新的安全头（提交）- Rails会在每个HTTP请求中发送以下头部：X-Frame-Options（通过禁止浏览器将页面嵌入到框架中来防止点击劫持），X-XSS-Protection（要求浏览器停止脚本注入）和X-Content-Type-Options（防止浏览器将jpeg文件打开为exe文件）。

4 功能提取为gems

在Rails 4.0中，一些功能已经被提取为gems。您只需将提取的gems添加到您的Gemfile中，即可恢复功能。

• 基于哈希和动态查找方法（GitHub）
• Active Record模型中的批量赋值保护（GitHub，Pull Request）
• ActiveRecord::SessionStore（GitHub，Pull Request）
• Active Record观察者（GitHub，Commit）
• Active Resource（GitHub，Pull Request，Blog）
• Action Caching（GitHub，Pull Request）
• Page Caching（GitHub，Pull Request）
• Sprockets（GitHub）
• 性能测试（GitHub，Pull Request）

5 文档

• 指南以GitHub Flavored Markdown格式重写。

• 指南具有响应式设计。

6 Railties

请参阅更改日志以获取详细更改信息。

6.1 显著更改

• 新的测试位置test/models，test/helpers，test/controllers和test/mailers。相应的rake任务也已添加。(Pull Request)

• 您应用程序的可执行文件现在位于bin/目录中。运行rake rails:update:bin以获取bin/bundle，bin/rails和bin/rake。

• 默认启用线程安全

• 通过传递--builder（或-b）给rails new来使用自定义构建器的能力已被删除。考虑使用应用程序模板代替。(Pull Request)

6.2 弃用

• config.threadsafe!已弃用，建议使用config.eager_load，它提供了更精细的控制，可以对什么进行急加载。

• Rails::Plugin已经被移除。不要将插件添加到vendor/plugins，而是使用带有路径或git依赖项的gems或bundler。

7 Action Mailer

请参阅更改日志以获取详细更改信息。

7.1 显著更改

7.2 弃用

8 Active Model

请参阅更改日志以获取详细更改信息。

8.1 显著变化

• 添加了ActiveModel::ForbiddenAttributesProtection，一个简单的模块，用于在传递非允许属性时保护属性免受批量赋值。

• 添加了ActiveModel::Model，一个混入模块，使Ruby对象能够与Action Pack无缝配合使用。

8.2 弃用

9 Active Support

详细更改请参阅Changelog。

9.1 显著变化

• 在ActiveSupport::Cache::MemCacheStore中用dalli替换了已弃用的memcache-client gem。

• 优化了ActiveSupport::Cache::Entry，以减少内存和处理开销。

• 现在可以根据区域设置定义不同的词形变化。singularize和pluralize接受额外的区域设置参数。

• 如果接收对象未实现方法，Object#try现在将返回nil而不是引发NoMethodError，但您仍然可以通过使用新的Object#try!来获得旧的行为。

• 当给定无效日期时，String#to_date现在会引发ArgumentError: invalid date，而不是NoMethodError: undefined method 'div' for nil:NilClass。它现在与Date.parse相同，并且接受比3.x更多的无效日期，例如：

  # ActiveSupport 3.x
  "asdf".to_date # => NoMethodError: undefined method `div' for nil:NilClass
  "333".to_date # => NoMethodError: undefined method `div' for nil:NilClass
  
  # ActiveSupport 4
  "asdf".to_date # => ArgumentError: invalid date
  "333".to_date # => Fri, 29 Nov 2013
  

  Copy

9.2 弃用

• 弃用ActiveSupport::TestCase#pending方法，请改用minitest的skip方法。

• 由于缺乏线程安全性，ActiveSupport::Benchmarkable#silence已被弃用。它将在Rails 4.1中被删除，没有替代方法。

• 弃用ActiveSupport::JSON::Variable。请为自定义JSON字符串文字定义自己的#as_json和#encode_json方法。

• 弃用兼容性方法Module#local_constant_names，请改用Module#local_constants（返回符号）。

• 弃用ActiveSupport::BufferedLogger。请使用ActiveSupport::Logger或Ruby标准库中的日志记录器。

• 弃用assert_present和assert_blank，改用assert object.blank?和assert object.present?。

10 Action Pack

详细更改请参阅Changelog。

10.1 显著变化

• 更改开发模式下异常页面的样式表。此外，在所有异常页面中还显示引发异常的代码行和片段。

10.2 弃用

11 Active Record

详细更改请参阅Changelog。

11.1 显著变化

• 改进了编写change迁移的方式，不再需要旧的up和down方法。

  • drop_table和remove_column方法现在是可逆的，只要提供了必要的信息。remove_column方法以前接受多个列名；现在请使用remove_columns（不可逆）。change_table方法也是可逆的，只要其块不调用remove、change或change_default。
  • 新的reversible方法可以指定在迁移上或下运行的代码。请参阅Migration指南
  • 新的revert方法将还原整个迁移或给定的块。如果向下迁移，则正常运行给定的迁移/块。请参阅Migration指南

• 添加了对PostgreSQL数组类型的支持。任何数据类型都可以用于创建数组列，并具有完整的迁移和模式转储支持。

• 添加了Relation#load，用于显式加载记录并返回self。

• Model.all现在返回ActiveRecord::Relation，而不是记录数组。如果确实需要数组，请使用Relation#to_a。在某些特定情况下，这可能会在升级时导致问题。

• 添加了ActiveRecord::Migration.check_pending!，如果存在未完成的迁移，则会引发错误。

• 为ActiveRecord::Store添加了自定义编码器的支持。现在可以像这样设置自定义编码器：

  store :settings, accessors: [ :color, :homepage ], coder: JSON
  

  Copy

• mysql和mysql2连接默认会设置SQL_MODE=STRICT_ALL_TABLES，以避免数据丢失。可以在database.yml中指定strict: false来禁用此功能。

• 移除了IdentityMap。

• 移除了自动执行EXPLAIN查询的功能。选项active_record.auto_explain_threshold_in_seconds不再使用，应该将其删除。

• 添加了ActiveRecord::NullRelation和ActiveRecord::Relation#none，实现了关系类的空对象模式。

• 添加了create_join_table迁移助手，用于创建HABTM连接表。

• 允许创建PostgreSQL hstore记录。

11.2 弃用

• 弃用了旧式的基于哈希的查找器API。这意味着以前接受“查找选项”的方法不再接受。

• 除了find_by_...和find_by_...!之外，所有动态方法都已弃用。以下是如何重写代码：

  • find_all_by_...可以使用where(...)来重写。
  • find_last_by_...可以使用where(...).last来重写。
  • scoped_by_...可以使用where(...)来重写。
  • find_or_initialize_by_...可以使用find_or_initialize_by(...)来重写。
  • find_or_create_by_...可以使用find_or_create_by(...)来重写。
  • find_or_create_by_...!可以使用find_or_create_by!(...)来重写。

12 致谢

请参阅Rails的完整贡献者列表，感谢所有为Rails付出了许多时间的人，使其成为一个稳定而强大的框架。向他们致以崇高的敬意。

反馈

欢迎您帮助改进本指南的质量。

如果您发现任何拼写错误或事实错误，请贡献您的意见。 要开始，请阅读我们的 文档贡献 部分。

您还可能会发现不完整的内容或过时的内容。 请为主要内容添加任何缺失的文档。请先检查 Edge 指南，以验证问题是否已经修复或尚未修复。 请参阅 Ruby on Rails 指南准则 以了解样式和规范。

如果您发现需要修复但无法自行修复的问题，请 提交问题。

最后但同样重要的是，欢迎您在 官方 Ruby on Rails 论坛 上讨论有关 Ruby on Rails 文档的任何问题。