Ruby on Rails 4.2 发布全览与升级实战Active Job、异步邮件、Adequate Record、Web Console 与外键支持深度解析【免费下载链接】railsRuby on Rails项目地址: https://gitcode.com/GitHub_Trending/rai/rails本文依据本仓库 guides/source/4_2_release_notes.md 整理撰写。Rails 4.2 的发布说明覆盖 Active Job、异步邮件、Adequate Record、Web Console、外键支持等五大核心特性同时列出了升级到 4.2 时必须关注的不兼容变更以及 Railties、Action Pack、Action View、Action Mailer、Active Record、Active Model、Active Support 各组件的移除、弃用与值得注意的变化。读完本文你将掌握 4.2 时代引入的关键 API 的设计意图、升级陷阱和完整参数用法并通过对照本仓库当前源码理解这些 API 在后续版本中的延续与演化。阅读前提本仓库当前主干的RAILS_VERSION文件内容为8.2.0.alpha也就是说本仓库源码对应的是现代 Rails 主开发版本guides/source/4_2_release_notes.md 是一份随仓库保留的历史版本发布说明。因此文中凡标注“当前仓库源码”的部分均指现代实现用于佐证 API 的延续形态其余内容均为 Rails 4.2 这一时间点的历史事实。原文档中对官方 HTML 指南页的相对链接如upgrading_ruby_on_rails.html本文已统一转换为本仓库根目录下的 Markdown 相对路径。一、Rails 4.2 的五大核心特性Rails 4.2 的版本说明开篇总结了五个高光特性本文逐一展开。特性一句话概括主要受益组件Active Job统一的后台任务队列接口新增activejob/组件Asynchronous mails邮件通过队列异步发送Action MailerAdequate Recordfind/find_by与部分关联查询提速Active RecordWeb Console错误页内置交互式 Ruby 控制台Railties / Action PackForeign key support迁移 DSL 原生支持外键Active Record1. Active Job统一的后台任务接口Active Job 是 Rails 4.2 新增的框架它把 Resque、Delayed Job、Sidekiq 等排队系统统一封装成“一套公共接口”。用 Active Job API 编写的任务Job可以在所有受支持的后端队列上运行——切换后端只需要更换对应的 adapter。Active Job 开箱自带一个内联inline执行器让任务“立即执行”方便开发与测试。一个关键设计是任务参数序列化任务经常需要接收 Active Record 对象作为参数但 4.2 的做法不是把对象本身做 marshal 序列化而是借助新的 Global ID 库把对象引用编码为 URI入队时只传引用出队执行时再由 URI 反查真实对象。于是把 Active Record 对象直接塞进任务参数“就是能正常工作”全程无需手工序列化。例如如果trashable是一个 Active Record 对象下面这个任务无需任何序列化代码即可正确执行class TrashableCleanupJob ActiveJob::Base def perform(trashable, depth) trashable.cleanup(depth) end end从当前仓库的源码结构可以印证这套设计在数个大版本后依然健在activejob/lib/active_job/base.rb 等文件组成了任务的核心执行框架activejob/lib/active_job/arguments.rb 与serializers相关机制延续了“参数/对象序列化”的职责activejob/lib/active_job/queue_adapters 目录下列出了内置适配器async、inline、resque、delayed_job、backburner、queue_classic、sneakers、test等。其中inline_adapter.rb就是 4.2 时代默认的“立即执行”适配器。有一点值得注意Rails 4.2 时 Active Job 默认配的是inline任务立即同步执行而在现代 Rails 中默认适配器已演变为:async。对照 activejob/lib/active_job/queue_adapter.rb 可以看到注释与代码均写明默认队列适配器是:async在应用进程内用线程池执行任务。这正说明了“换 adapter 即可换后端”这一抽象从 4.2 延续至今。想完整了解 Job 的编写、队列配置、重试等用法可阅读本仓库的 Active Job 基础指南。2. 异步邮件Action Mailer 的deliver_later在 Active Job 之上Action Mailer 在 4.2 新增了deliver_later方法它把邮件投递包装成一个 Job 塞进队列由队列异步发送从而不再阻塞控制器或模型前提是队列本身是异步的当时默认的 inline 队列会阻塞。如果确实需要立即发出仍可使用deliver_now。两个 API 的对比如下# 立即发送同步阻塞当前线程 UserMailer.welcome(user).deliver_now # 异步发送入队后由后台队列执行发送 UserMailer.welcome(user).deliver_later从当前源码看deliver_later的现代形态承载了远比 4.2 初期更丰富的入队选项。见 actionmailer/lib/action_mailer/message_delivery.rbNotifier.welcome(User.first).deliver_later Notifier.welcome(User.first).deliver_later(wait: 1.hour) Notifier.welcome(User.first).deliver_later(wait_until: 10.hours.from_now) Notifier.welcome(User.first).deliver_later(priority: 10):wait延迟指定时长后再投递:wait_until在指定日期时间之后投递:queue把邮件投递到指定队列:priority以指定优先级入队。默认使用ActionMailer::MailDeliveryJob对应源码 actionmailer/lib/action_mailer/mail_delivery_job.rb投递到默认队列邮件类可以通过类级设置定制队列名deliver_later_queue_name或完全替换投递任务delivery_job例如class AccountRegistrationMailer ApplicationMailer self.delivery_job RegistrationDeliveryJob end3. Adequate Record常见查询最多提速 2 倍Adequate Record 是 Active Record 的一组性能改进目标是让常见的find、find_by调用以及部分关联查询最多快约 2 倍。其工作原理是把常见 SQL 查询缓存为 prepared statement预编译语句后续相似调用直接复用缓存的语句从而跳过大部分查询生成开销。需要强调的是缓存的是 SQL 语句本身而不是调用时传入的值——语句中保留了占位符真正传参仍发生在每次执行时。因此 Active Record 会在受支持的操作上自动利用该特性无需用户改任何代码。受支持的典型操作包括Post.find(1) # 首次调用生成并缓存 prepared statement Post.find(2) # 后续调用复用缓存的 prepared statement Post.find_by_title(first post) Post.find_by_title(second post) Post.find_by(title: first post) Post.find_by(title: second post) post.comments post.comments(true)同时文档明确列出了不会走缓存的场景模型带有 default scope默认作用域模型使用了单表继承single table inheritance, STIfind传入 id 列表例如# 不会缓存 Post.find(1, 2, 3) Post.find([1, 2])find_by传 SQL 片段Post.find_by(published_at ?, 2.weeks.ago)值得一提的是若在当前仓库的activerecord/lib下检索AdequateRecord已找不到独立同名模块——可以推断这套“以模块形式存在的预编译语句缓存”在后续主干中已被吸收或重构进其他查询缓存/预编译机制中本文描述的内容以 4.2 时代发布说明为准。4. Web Console错误页上的交互式控制台Rails 4.2 生成的新应用默认在Gemfile中引入 Web Console外部项目此处仅转述文档gem。它的能力有两点错误页内置交互式 Ruby 控制台可以在异常发生处的上下文里执行代码调试console视图/控制器辅助方法只要在某个视图或控制器里调用consolehelper就会在渲染完成后弹出一个携带“最终上下文”的交互式控制台。这条约定一直延续到了现代 Rails查看本仓库的应用生成器模板 railties/lib/rails/generators/rails/app/templates/Gemfile.tt仍然可以看到默认生成的应用会带上gem web-console注释即 “Use console on exceptions pages”。5. 外键支持迁移 DSL 原生增删外键4.2 之前在迁移里手工维护外键约束比较痛苦4.2 起迁移 DSL 支持新增与删除外键并且外键会被同步 dump 到schema.rb。当时只有mysql、mysql2与postgresql三个适配器支持外键。文档给出的基础用法# 给 articles.author_id 增加外键引用 authors.id add_foreign_key :articles, :authors # 给 articles.author_id 增加外键引用 users.lng_id add_foreign_key :articles, :users, column: :author_id, primary_key: lng_id # 删除 accounts.branch_id 上的外键 remove_foreign_key :accounts, :branches # 删除 accounts.owner_id 上的外键 remove_foreign_key :accounts, column: :owner_id从当前仓库的抽象层源码 activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb 可以看到add_foreign_key/remove_foreign_key至今仍是迁移 DSL 的正式入口并演化出一套更完整的选项。外键约束默认以fk_rails_identifier命名identifier 由来源表与列名确定性生成也可用:name自定义。例如add_foreign_key :articles, :authors # 生成的 SQL # ALTER TABLE articles ADD CONSTRAINT fk_rails_e74ce85cbc # FOREIGN KEY (author_id) REFERENCES authors (id)当前实现中常用选项一览可作为理解参数语义的完整参考部分选项是 4.2 之后扩展的选项含义与默认值:column来源表上的外键列名默认是to_table.singularize _id传数组可建复合外键:primary_key目标表上被引用的主键列名默认id传数组可建复合引用:name约束名默认fk_rails_identifier:on_deleteON DELETE动作合法值为:nullify、:cascade、:restrict:on_updateON UPDATE动作合法值同上:if_not_exists已存在时不再重复添加add_foreign_key:if_exists不存在时静默忽略删除remove_foreign_key:validate仅 PostgreSQL约束是否校验默认true:deferrable仅 PostgreSQL是否可延迟约束:to_tableremove_foreign_key专用的目标表名写法# 级联删除示例4.2 之后的典型演进形态 add_foreign_key :articles, :authors, on_delete: :cascade # 查询外键是否存在 foreign_key_exists?(:accounts, :branches)此外SchemaDumper对create_table使用force: :cascade从而在外键存在的情况下也能安全 reload schema见下文 Active Record “值得注意的变化”。二、升级到 Rails 4.2不兼容变更与应对清单版本说明专门列出“升级后可能需要立即处理”的变更。升级前应保证测试覆盖良好如果还未升到 4.1文档建议先升 4.1 并确认应用行为正常再升 4.2。完整升级步骤参见本仓库的 升级指南从 4.1 升级到 4.2 部分。1.render的字符串参数语义改变此前控制器动作里调用render foo/bar等价于render file: foo/bar渲染文件。Rails 4.2 起它被改为等价于render template: foo/bar渲染模板。若确实要渲染文件请改为显式写法# 之前含义等价于 file: render foo/bar # 4.2 之后语义为 template:如需渲染文件请显式声明 render file: foo/bar这一行为变化在 Action View 的说明中同样被强调见下文 Action View 一节。2.respond_with/ 类级respond_to移出 Railsrespond_with与对应的类级respond_to被迁往respondersgem2.0 版。要继续使用请在Gemfile中加gem responders, ~ 2.0代码写法保持不变# app/controllers/users_controller.rb class UsersController ApplicationController respond_to :html, :json def show user User.find(params[:id]) respond_with user end end注意实例级respond_to块内按 format 分支不受影响仍在 Rails 内可用# app/controllers/users_controller.rb class UsersController ApplicationController def show user User.find(params[:id]) respond_to do |format| format.html format.json { render json: user } end end end3.rails server默认监听地址改为localhost受 Rack 侧变更影响原文档引用了对应 commitrails server默认从监听0.0.0.0改为监听localhost。对本机常规开发基本无感因为http://127.0.0.1:3000与http://localhost:3000在本机照常可用。但影响是不再能从其他机器访问该开发服务器。典型场景是开发环境跑在虚拟机里、想从宿主机访问。此时请显式绑定rails server -b 0.0.0.0恢复旧行为的同时务必配好防火墙只允许网络内可信机器访问你的开发服务器。4.render的:status选项符号更名同样受 Rack 变更影响render方法:status可用的状态符号发生了变化HTTP 状态码变更306:reserved被移除413:request_entity_too_large更名为:payload_too_large414:request_uri_too_long更名为:uri_too_long416:requested_range_not_satisfiable更名为:range_not_satisfiable另外请牢记如果传给render的是未知符号响应状态会默认落到 500。5. HTML 消毒器sanitizer整体重写4.2 用基于 Loofah 与 Nokogiri 的全新实现替换了旧 HTML 消毒器。新消毒器更安全消毒能力更强、更灵活但由于算法改变某些病态输入的消毒输出可能与旧版不同。如果业务强依赖旧消毒器的精确输出可以往Gemfile加rails-deprecated_sanitizergem 恢复旧行为。该 gem 为 opt-in不会发出弃用警告且官方仅对 Rails 4.2 提供支持不会为 Rails 5.0 维护。因此长期方案仍是适配新消毒器行为。6.assert_select基于 Nokogiri 重写带来的断言行为变化assert_select以及其底层 DOM 解析改为基于 Nokogiri导致三类既有写法需要更新。1属性选择器中的非字母数字值可能需要加引号# 之前 a[href/] a[href$/] # 现在 a[href/] a[href$/]2由包含“非法嵌套”HTML 构造的 DOM 结构可能不同。例如对内容divip/i/div# 之前: assert_select(div i) # true assert_select(div p) # false assert_select(i p) # true # 现在: assert_select(div i) # true assert_select(div p) # true assert_select(i p) # false3实体比较从“原始文本”变为“解析后文本”。例如内容为pATamp;T/p# 之前: assert_select(p, ATamp;T) # true assert_select(p, ATT) # false # 现在: assert_select(p, ATT) # true assert_select(p, ATamp;T) # false4替换substitution语法改变。现在需使用 CSS 风格的:match选择器assert_select :match(id, ?), comment_1且当断言失败时Regexp 替换的展示形式也变了。如下断言assert_select(:match(id, ?), /hello/)失败信息中/hello/会呈现为(?-mix:hello)Expected at least 1 element matching div:match(id, (?-mix:hello)), found 0.. Expected 0 to be 1.三、Railties 变更详细条目以组件 CHANGELOG 为准这里记录 4.2 中的摘要railties/CHANGELOG.md。移除项Removals应用生成器app generator的--skip-action-view选项被移除rails application命令被移除且没有替代品。弃用项Deprecations生产环境缺失config.log_level配置将被弃用提示显式配置rake test:all弃用改用rake test它现在会运行test目录下全部测试rake test:all:db弃用改用rake test:dbRails::Rack::LogTailer弃用无替代品。值得注意的变化Notable changes默认应用Gemfile引入web-console前文 Web Console 一节已述模型生成器为关联新增required选项引入config.x命名空间用于定义自定义配置项# config/environments/production.rb config.x.payment_processing.schedule :daily config.x.payment_processing.retries 3 config.x.super_debugger true随后通过配置对象读取Rails.configuration.x.payment_processing.schedule # :daily Rails.configuration.x.payment_processing.retries # 3 Rails.configuration.x.super_debugger # true这一机制的现代实现可以在 railties/lib/rails/application/configuration.rb 中直接看到attr_accessor列表含:x第 22 行初始化时x Custom.new第 72 行而Custom类第 656 行起用method_missing惰性创建任意层级的ActiveSupport::OrderedOptions——这就是config.x.任意键.任意层级能一路点下去的底层原理。引入Rails::Application.config_for按当前环境加载 YAML 配置并返回OrderedOptions# config/exception_notification.yml production: url: http://127.0.0.1:8080 namespace: my_app_production development: url: http://localhost:3001 namespace: my_app_development# config/environments/production.rb Rails.application.configure do config.middleware.use ExceptionNotifier, config_for(:exception_notification) end现代实现位于 railties/lib/rails/application.rb会读取config/#{name}.ymldeep_symbolize_keys后按当前环境取值还支持shared段与环境配置的deep_merge合并。应用生成器新增--skip-turbolinks选项用于不生成 turbolinks 集成引入bin/setup脚本作为搭建应用时的自动化设置约定开发环境下config.assets.digest默认值改为true引入 API允许为rake notes注册新的扩展注释标记Rails 模板引入after_bundle回调bundle 完成后执行引入Rails.gem_version便捷方法返回Gem::Version.new(Rails.version)。四、Action Pack 变更详细条目见 actionpack/CHANGELOG.md。移除项respond_with与类级respond_to从 Rails 移除、迁往responders2.0 gem对应前文“升级不兼容变更”第 2 条加gem responders, ~ 2.0即可继续使用移除已弃用的AbstractController::Helpers::ClassMethods::MissingHelperError改用AbstractController::Helpers::MissingHelperError。弃用项*_pathhelper 的only_path选项弃用assert_tag、assert_no_tag、find_tag、find_all_tag弃用统一改用assert_select路由:to选项不再支持指向“不含#的符号或字符串”get /posts, to: MyRackApp (无需修改) get /posts, to: post#index (无需修改) get /posts, to: posts get /posts, controller: :posts get /posts, to: :index get /posts, action: :indexURL helper 不再支持字符串键参数# 不推荐 root_path(controller posts, action index) # 推荐 root_path(controller: posts, action: index)值得注意的变化*_filter一族方法从文档中移除全面改用*_action一族after_filter after_action append_after_filter append_after_action append_around_filter append_around_action append_before_filter append_before_action around_filter around_action before_filter before_action prepend_after_filter prepend_after_action prepend_around_filter prepend_around_action prepend_before_filter prepend_before_action skip_after_filter skip_after_action skip_around_filter skip_around_action skip_before_filter skip_before_action skip_filter skip_action_callback若应用仍依赖这些方法应尽快迁移到对应*_action方法旧方法后续会正式弃用并移除。render nothing: true或渲染nilbody 时不再往响应体里补一个空格占位ETag 现在自动纳入模板 digest模板改动会自动使缓存失效传入 URL helper 的 path segment 会被自动转义引入always_permitted_parameters配置用于设定全局默认允许的参数默认值为[controller, action]按 RFC 4791 增加 HTTP 方法MKCALENDAR*_fragment.action_controller通知的 payload 中新增 controller 与 action 名路由错误页改进支持对路由进行模糊搜索匹配增加选项以关闭 CSRF 失败日志服务器托管静态资源时若客户端支持 gzip 且磁盘上存在预生成的.gz文件则直接提供 gzip 版本资产管道默认会为所有可压缩资源生成.gz文件从而减少传输量、加速资源请求集成测试中调用processhelper 族时路径必须带前导斜杠test list all posts do get /posts assert_response :success end五、Action View 变更详细条目见 actionview/CHANGELOG.md。弃用项弃用AbstractController::Base.parent_prefixes要自定义视图查找位置请覆写AbstractController::Base.local_prefixes弃用ActionView::Digestor#digest(name, format, finder, options {})参数应改为以哈希形式传入。值得注意的变化render foo/bar现在展开为render template: foo/bar而不再是render file: foo/bar对应“升级不兼容变更”第 1 条表单 helper 不再为隐藏字段包一层带内联 CSS 的div引入#{partial_name}_iteration局部变量供“以集合渲染的 partial”使用通过其index、size、first?、last?方法感知迭代状态placeholder 的 I18n 解析遵循与labelI18n 相同的约定。六、Action Mailer 变更详细条目见 actionmailer/CHANGELOG.md。弃用项邮件中弃用*_pathhelper一律改用*_urlhelper邮件通常需要完整 URL弃用deliver/deliver!改用deliver_now/deliver_now!即如今在 message_delivery.rb 中看到的命名体系。值得注意的变化模板中link_to与url_for默认生成绝对 URL不再需要传only_path: false引入deliver_later把邮件投递包装成 Job 入队、异步发送对应“核心特性”第 2 条新增show_previews配置项允许在 development 环境之外开启 mailer preview。七、Active Record 变更详细条目见 activerecord/CHANGELOG.md。移除项移除cache_attributes一族 API——现在所有属性都默认缓存移除已弃用的ActiveRecord::Base.quoted_locking_column移除已弃用的ActiveRecord::Migrator.proper_table_name请改在ActiveRecord::Migration实例上调用proper_table_name移除无用的:timestamp类型一律透明地别名到:datetime修复列类型在 Active Record 之外如 XML 序列化时的不一致。弃用项弃用after_commit/after_rollback内部“吞掉错误”的行为弃用has_many :through关联上自动探测 counter cache 的脆弱支持应在 through 记录对应的has_many与belongs_to上手工指定 counter cache弃用把 Active Record 对象直接传给.find/.exists?应先用对象调用id弃用对 PostgreSQL “排除起始边界 range”的半成品支持Ruby range 不支持排除起始边界当前通过递增起始值绕开但该做法不正确对无法succ的子类型会抛ArgumentError弃用无连接情况下调用DatabaseTasks.load_schema改用DatabaseTasks.load_schema_current弃用sanitize_sql_hash_for_conditions无替代推荐用Relation执行查询与更新弃用不带:null选项的add_timestamps与t.timestamps——4.2 默认null: trueRails 5 将改为默认null: false弃用Reflection#source_macro不再需要弃用serialized_attributes无替代弃用column_for_attribute在无对应列时返回nil的行为Rails 5.0 将返回 null object弃用对“依赖实例状态的关联”即 scope 带参数的关联执行.joins、.preload、.eager_load无替代。值得注意的变化SchemaDumper对create_table使用force: :cascade使外键存在时也能安全重载 schema与外键支持特性呼应单数关联新增:required选项会在关联上生成存在性校验ActiveRecord::Dirty现在能检测可变值的原地修改序列化属性在未变化时不再被保存也适用于 PostgreSQL 的 string、json 等列引入db:purgeRake 任务清空当前环境的数据库引入ActiveRecord::Base#validate!记录无效时抛ActiveRecord::RecordInvalid引入validate作为valid?的别名touch现在可一次触碰多个属性PostgreSQL 适配器支持 PostgreSQL 9.4 的jsonb数据类型PostgreSQL 与 SQLite 适配器不再给字符串列默认加 255 字符上限PostgreSQL 适配器新增citext列类型支持PostgreSQL 适配器支持用户自定义 range 类型sqlite3:///some/path现在解析为绝对路径/some/path相对路径请改用sqlite3:some/path此前的相对路径行为已在 4.1 弃用支持 MySQL 5.6 的秒以下小数位新增ActiveRecord::Base#pretty_print以更友好地打印模型ActiveRecord::Base#reload行为调整为等价于m Model.find(m.id)不再保留自定义SELECT带来的额外属性ActiveRecord::Base#reflections返回的哈希改为字符串键而非符号键迁移中的references方法支持type选项用于指定外键类型如:uuid。八、Active Model 变更详细条目见 activemodel/CHANGELOG.md。移除项移除已弃用的Validator#setup无替代。弃用项弃用reset_#{attribute}改用restore_#{attribute}弃用ActiveModel::Dirty#reset_changes改用clear_changes_information。值得注意的变化引入validate作为valid?的别名ActiveModel::Dirty引入restore_attributes方法把发生变更dirty的属性恢复到原值has_secure_password不再默认禁止纯空白密码启用校验时has_secure_password会校验密码长度小于 72 字符。九、Active Support 变更详细条目见 activesupport/CHANGELOG.md。移除项移除已弃用的Numeric#ago、Numeric#until、Numeric#since、Numeric#from_now移除已弃用的、基于字符串的ActiveSupport::Callbacksterminator 写法。弃用项弃用Kernel#silence_stderr、Kernel#capture、Kernel#quietly均无替代弃用Class#superclass_delegating_accessor改用Class#class_attribute弃用ActiveSupport::SafeBuffer#prepend!——prepend现在已具备相同功能。值得注意的变化引入active_support.test_order配置控制测试用例执行顺序当时默认:sorted官方预告 Rails 5.0 将改为:randomObject#try与Object#try!现在可在块中省略显式接收者Object#with_options也可省略显式接收者travel_to测试 helper 现在会把usec部分截断为 0提升时间冻结的确定性引入Object#itself恒等函数引入String#truncate_words按单词数截断字符串新增Hash#transform_values与Hash#transform_values!简化“只改值、不动键”的常见模式humanize现在会剥掉开头的下划线引入Concern#class_methods作为module ClassMethods的替代写法并引入Kernel#concern来消除module Foo; extend ActiveSupport::Concern; end样板新增关于常量自动加载与重载的指南4.2 时代针对“经典模式”。当前仓库中对应文档为 自动加载与重载指南。十、回到当前仓库4.2 特性的“今生”速查前文各节已在特性处穿插了源码佐证这里集中整理成一份“API 现在还能在哪里找到”的速查表方便读者按图索骥4.2 引入的能力当前仓库中的实现位置形态说明Active Job 框架activejob/lib/active_job队列抽象保留默认适配器由:inline演变为:asyncqueue_adapter.rb邮件异步投递message_delivery.rbdeliver_later/deliver_now并新增wait、wait_until、priority等选项投递默认走MailDeliveryJob迁移外键schema_statements.rbadd_foreign_key/remove_foreign_key/foreign_key_exists?选项大幅扩充on_delete、validate、deferrable等config.x自定义配置application/configuration.rbattr_accessor :x与同文件Custom类第 656 行通过method_missing支持任意层级链式读写config_forrails/application.rb按环境读取config/*.yml并支持shared公共段Web Console 进默认 GemfileGemfile.tt新应用默认仍带gem web-console整体上可以观察到 Rails 的两条演进主线一是 4.2 打下的“统一队列抽象 异步化”基础Active Job /deliver_later在十余年后的今天仍是核心骨架且默认执行模型从“同步 inline”进化为“进程内线程池 async”二是迁移 DSL 以“外键支持”为起点逐步扩展成一整套约束管理 API。若需要逐条核对 4.2 的完整变更清单包括 bug 修复与更多细节可直接查阅各组件根目录下的CHANGELOG.md文件railties/CHANGELOG.md、actionpack/CHANGELOG.md、actionview/CHANGELOG.md、actionmailer/CHANGELOG.md、activerecord/CHANGELOG.md、activemodel/CHANGELOG.md、activesupport/CHANGELOG.md。给计划升级或历史项目维护者的最后提醒升到 4.2 前务必先具备良好测试覆盖若尚未到 4.1 请先升 4.1升级后优先排查本清单中的“需要立即行动”项——render foo/bar语义、respond_with的 gem 化迁移、rails server默认绑定地址、:status符号更名、HTML sanitizer 输出差异与assert_select断言行为变化逐一确认后再进入正常开发流程。对应迁移步骤可随时回查 升级指南。【免费下载链接】railsRuby on Rails项目地址: https://gitcode.com/GitHub_Trending/rai/rails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Ruby on Rails 4.2 发布全览与升级实战：Active Job、异步邮件、Adequate Record、Web Console 与外键支持深度解析
Ruby on Rails 4.2 发布全览与升级实战Active Job、异步邮件、Adequate Record、Web Console 与外键支持深度解析【免费下载链接】railsRuby on Rails项目地址: https://gitcode.com/GitHub_Trending/rai/rails本文依据本仓库 guides/source/4_2_release_notes.md 整理撰写。Rails 4.2 的发布说明覆盖 Active Job、异步邮件、Adequate Record、Web Console、外键支持等五大核心特性同时列出了升级到 4.2 时必须关注的不兼容变更以及 Railties、Action Pack、Action View、Action Mailer、Active Record、Active Model、Active Support 各组件的移除、弃用与值得注意的变化。读完本文你将掌握 4.2 时代引入的关键 API 的设计意图、升级陷阱和完整参数用法并通过对照本仓库当前源码理解这些 API 在后续版本中的延续与演化。阅读前提本仓库当前主干的RAILS_VERSION文件内容为8.2.0.alpha也就是说本仓库源码对应的是现代 Rails 主开发版本guides/source/4_2_release_notes.md 是一份随仓库保留的历史版本发布说明。因此文中凡标注“当前仓库源码”的部分均指现代实现用于佐证 API 的延续形态其余内容均为 Rails 4.2 这一时间点的历史事实。原文档中对官方 HTML 指南页的相对链接如upgrading_ruby_on_rails.html本文已统一转换为本仓库根目录下的 Markdown 相对路径。一、Rails 4.2 的五大核心特性Rails 4.2 的版本说明开篇总结了五个高光特性本文逐一展开。特性一句话概括主要受益组件Active Job统一的后台任务队列接口新增activejob/组件Asynchronous mails邮件通过队列异步发送Action MailerAdequate Recordfind/find_by与部分关联查询提速Active RecordWeb Console错误页内置交互式 Ruby 控制台Railties / Action PackForeign key support迁移 DSL 原生支持外键Active Record1. Active Job统一的后台任务接口Active Job 是 Rails 4.2 新增的框架它把 Resque、Delayed Job、Sidekiq 等排队系统统一封装成“一套公共接口”。用 Active Job API 编写的任务Job可以在所有受支持的后端队列上运行——切换后端只需要更换对应的 adapter。Active Job 开箱自带一个内联inline执行器让任务“立即执行”方便开发与测试。一个关键设计是任务参数序列化任务经常需要接收 Active Record 对象作为参数但 4.2 的做法不是把对象本身做 marshal 序列化而是借助新的 Global ID 库把对象引用编码为 URI入队时只传引用出队执行时再由 URI 反查真实对象。于是把 Active Record 对象直接塞进任务参数“就是能正常工作”全程无需手工序列化。例如如果trashable是一个 Active Record 对象下面这个任务无需任何序列化代码即可正确执行class TrashableCleanupJob ActiveJob::Base def perform(trashable, depth) trashable.cleanup(depth) end end从当前仓库的源码结构可以印证这套设计在数个大版本后依然健在activejob/lib/active_job/base.rb 等文件组成了任务的核心执行框架activejob/lib/active_job/arguments.rb 与serializers相关机制延续了“参数/对象序列化”的职责activejob/lib/active_job/queue_adapters 目录下列出了内置适配器async、inline、resque、delayed_job、backburner、queue_classic、sneakers、test等。其中inline_adapter.rb就是 4.2 时代默认的“立即执行”适配器。有一点值得注意Rails 4.2 时 Active Job 默认配的是inline任务立即同步执行而在现代 Rails 中默认适配器已演变为:async。对照 activejob/lib/active_job/queue_adapter.rb 可以看到注释与代码均写明默认队列适配器是:async在应用进程内用线程池执行任务。这正说明了“换 adapter 即可换后端”这一抽象从 4.2 延续至今。想完整了解 Job 的编写、队列配置、重试等用法可阅读本仓库的 Active Job 基础指南。2. 异步邮件Action Mailer 的deliver_later在 Active Job 之上Action Mailer 在 4.2 新增了deliver_later方法它把邮件投递包装成一个 Job 塞进队列由队列异步发送从而不再阻塞控制器或模型前提是队列本身是异步的当时默认的 inline 队列会阻塞。如果确实需要立即发出仍可使用deliver_now。两个 API 的对比如下# 立即发送同步阻塞当前线程 UserMailer.welcome(user).deliver_now # 异步发送入队后由后台队列执行发送 UserMailer.welcome(user).deliver_later从当前源码看deliver_later的现代形态承载了远比 4.2 初期更丰富的入队选项。见 actionmailer/lib/action_mailer/message_delivery.rbNotifier.welcome(User.first).deliver_later Notifier.welcome(User.first).deliver_later(wait: 1.hour) Notifier.welcome(User.first).deliver_later(wait_until: 10.hours.from_now) Notifier.welcome(User.first).deliver_later(priority: 10):wait延迟指定时长后再投递:wait_until在指定日期时间之后投递:queue把邮件投递到指定队列:priority以指定优先级入队。默认使用ActionMailer::MailDeliveryJob对应源码 actionmailer/lib/action_mailer/mail_delivery_job.rb投递到默认队列邮件类可以通过类级设置定制队列名deliver_later_queue_name或完全替换投递任务delivery_job例如class AccountRegistrationMailer ApplicationMailer self.delivery_job RegistrationDeliveryJob end3. Adequate Record常见查询最多提速 2 倍Adequate Record 是 Active Record 的一组性能改进目标是让常见的find、find_by调用以及部分关联查询最多快约 2 倍。其工作原理是把常见 SQL 查询缓存为 prepared statement预编译语句后续相似调用直接复用缓存的语句从而跳过大部分查询生成开销。需要强调的是缓存的是 SQL 语句本身而不是调用时传入的值——语句中保留了占位符真正传参仍发生在每次执行时。因此 Active Record 会在受支持的操作上自动利用该特性无需用户改任何代码。受支持的典型操作包括Post.find(1) # 首次调用生成并缓存 prepared statement Post.find(2) # 后续调用复用缓存的 prepared statement Post.find_by_title(first post) Post.find_by_title(second post) Post.find_by(title: first post) Post.find_by(title: second post) post.comments post.comments(true)同时文档明确列出了不会走缓存的场景模型带有 default scope默认作用域模型使用了单表继承single table inheritance, STIfind传入 id 列表例如# 不会缓存 Post.find(1, 2, 3) Post.find([1, 2])find_by传 SQL 片段Post.find_by(published_at ?, 2.weeks.ago)值得一提的是若在当前仓库的activerecord/lib下检索AdequateRecord已找不到独立同名模块——可以推断这套“以模块形式存在的预编译语句缓存”在后续主干中已被吸收或重构进其他查询缓存/预编译机制中本文描述的内容以 4.2 时代发布说明为准。4. Web Console错误页上的交互式控制台Rails 4.2 生成的新应用默认在Gemfile中引入 Web Console外部项目此处仅转述文档gem。它的能力有两点错误页内置交互式 Ruby 控制台可以在异常发生处的上下文里执行代码调试console视图/控制器辅助方法只要在某个视图或控制器里调用consolehelper就会在渲染完成后弹出一个携带“最终上下文”的交互式控制台。这条约定一直延续到了现代 Rails查看本仓库的应用生成器模板 railties/lib/rails/generators/rails/app/templates/Gemfile.tt仍然可以看到默认生成的应用会带上gem web-console注释即 “Use console on exceptions pages”。5. 外键支持迁移 DSL 原生增删外键4.2 之前在迁移里手工维护外键约束比较痛苦4.2 起迁移 DSL 支持新增与删除外键并且外键会被同步 dump 到schema.rb。当时只有mysql、mysql2与postgresql三个适配器支持外键。文档给出的基础用法# 给 articles.author_id 增加外键引用 authors.id add_foreign_key :articles, :authors # 给 articles.author_id 增加外键引用 users.lng_id add_foreign_key :articles, :users, column: :author_id, primary_key: lng_id # 删除 accounts.branch_id 上的外键 remove_foreign_key :accounts, :branches # 删除 accounts.owner_id 上的外键 remove_foreign_key :accounts, column: :owner_id从当前仓库的抽象层源码 activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb 可以看到add_foreign_key/remove_foreign_key至今仍是迁移 DSL 的正式入口并演化出一套更完整的选项。外键约束默认以fk_rails_identifier命名identifier 由来源表与列名确定性生成也可用:name自定义。例如add_foreign_key :articles, :authors # 生成的 SQL # ALTER TABLE articles ADD CONSTRAINT fk_rails_e74ce85cbc # FOREIGN KEY (author_id) REFERENCES authors (id)当前实现中常用选项一览可作为理解参数语义的完整参考部分选项是 4.2 之后扩展的选项含义与默认值:column来源表上的外键列名默认是to_table.singularize _id传数组可建复合外键:primary_key目标表上被引用的主键列名默认id传数组可建复合引用:name约束名默认fk_rails_identifier:on_deleteON DELETE动作合法值为:nullify、:cascade、:restrict:on_updateON UPDATE动作合法值同上:if_not_exists已存在时不再重复添加add_foreign_key:if_exists不存在时静默忽略删除remove_foreign_key:validate仅 PostgreSQL约束是否校验默认true:deferrable仅 PostgreSQL是否可延迟约束:to_tableremove_foreign_key专用的目标表名写法# 级联删除示例4.2 之后的典型演进形态 add_foreign_key :articles, :authors, on_delete: :cascade # 查询外键是否存在 foreign_key_exists?(:accounts, :branches)此外SchemaDumper对create_table使用force: :cascade从而在外键存在的情况下也能安全 reload schema见下文 Active Record “值得注意的变化”。二、升级到 Rails 4.2不兼容变更与应对清单版本说明专门列出“升级后可能需要立即处理”的变更。升级前应保证测试覆盖良好如果还未升到 4.1文档建议先升 4.1 并确认应用行为正常再升 4.2。完整升级步骤参见本仓库的 升级指南从 4.1 升级到 4.2 部分。1.render的字符串参数语义改变此前控制器动作里调用render foo/bar等价于render file: foo/bar渲染文件。Rails 4.2 起它被改为等价于render template: foo/bar渲染模板。若确实要渲染文件请改为显式写法# 之前含义等价于 file: render foo/bar # 4.2 之后语义为 template:如需渲染文件请显式声明 render file: foo/bar这一行为变化在 Action View 的说明中同样被强调见下文 Action View 一节。2.respond_with/ 类级respond_to移出 Railsrespond_with与对应的类级respond_to被迁往respondersgem2.0 版。要继续使用请在Gemfile中加gem responders, ~ 2.0代码写法保持不变# app/controllers/users_controller.rb class UsersController ApplicationController respond_to :html, :json def show user User.find(params[:id]) respond_with user end end注意实例级respond_to块内按 format 分支不受影响仍在 Rails 内可用# app/controllers/users_controller.rb class UsersController ApplicationController def show user User.find(params[:id]) respond_to do |format| format.html format.json { render json: user } end end end3.rails server默认监听地址改为localhost受 Rack 侧变更影响原文档引用了对应 commitrails server默认从监听0.0.0.0改为监听localhost。对本机常规开发基本无感因为http://127.0.0.1:3000与http://localhost:3000在本机照常可用。但影响是不再能从其他机器访问该开发服务器。典型场景是开发环境跑在虚拟机里、想从宿主机访问。此时请显式绑定rails server -b 0.0.0.0恢复旧行为的同时务必配好防火墙只允许网络内可信机器访问你的开发服务器。4.render的:status选项符号更名同样受 Rack 变更影响render方法:status可用的状态符号发生了变化HTTP 状态码变更306:reserved被移除413:request_entity_too_large更名为:payload_too_large414:request_uri_too_long更名为:uri_too_long416:requested_range_not_satisfiable更名为:range_not_satisfiable另外请牢记如果传给render的是未知符号响应状态会默认落到 500。5. HTML 消毒器sanitizer整体重写4.2 用基于 Loofah 与 Nokogiri 的全新实现替换了旧 HTML 消毒器。新消毒器更安全消毒能力更强、更灵活但由于算法改变某些病态输入的消毒输出可能与旧版不同。如果业务强依赖旧消毒器的精确输出可以往Gemfile加rails-deprecated_sanitizergem 恢复旧行为。该 gem 为 opt-in不会发出弃用警告且官方仅对 Rails 4.2 提供支持不会为 Rails 5.0 维护。因此长期方案仍是适配新消毒器行为。6.assert_select基于 Nokogiri 重写带来的断言行为变化assert_select以及其底层 DOM 解析改为基于 Nokogiri导致三类既有写法需要更新。1属性选择器中的非字母数字值可能需要加引号# 之前 a[href/] a[href$/] # 现在 a[href/] a[href$/]2由包含“非法嵌套”HTML 构造的 DOM 结构可能不同。例如对内容divip/i/div# 之前: assert_select(div i) # true assert_select(div p) # false assert_select(i p) # true # 现在: assert_select(div i) # true assert_select(div p) # true assert_select(i p) # false3实体比较从“原始文本”变为“解析后文本”。例如内容为pATamp;T/p# 之前: assert_select(p, ATamp;T) # true assert_select(p, ATT) # false # 现在: assert_select(p, ATT) # true assert_select(p, ATamp;T) # false4替换substitution语法改变。现在需使用 CSS 风格的:match选择器assert_select :match(id, ?), comment_1且当断言失败时Regexp 替换的展示形式也变了。如下断言assert_select(:match(id, ?), /hello/)失败信息中/hello/会呈现为(?-mix:hello)Expected at least 1 element matching div:match(id, (?-mix:hello)), found 0.. Expected 0 to be 1.三、Railties 变更详细条目以组件 CHANGELOG 为准这里记录 4.2 中的摘要railties/CHANGELOG.md。移除项Removals应用生成器app generator的--skip-action-view选项被移除rails application命令被移除且没有替代品。弃用项Deprecations生产环境缺失config.log_level配置将被弃用提示显式配置rake test:all弃用改用rake test它现在会运行test目录下全部测试rake test:all:db弃用改用rake test:dbRails::Rack::LogTailer弃用无替代品。值得注意的变化Notable changes默认应用Gemfile引入web-console前文 Web Console 一节已述模型生成器为关联新增required选项引入config.x命名空间用于定义自定义配置项# config/environments/production.rb config.x.payment_processing.schedule :daily config.x.payment_processing.retries 3 config.x.super_debugger true随后通过配置对象读取Rails.configuration.x.payment_processing.schedule # :daily Rails.configuration.x.payment_processing.retries # 3 Rails.configuration.x.super_debugger # true这一机制的现代实现可以在 railties/lib/rails/application/configuration.rb 中直接看到attr_accessor列表含:x第 22 行初始化时x Custom.new第 72 行而Custom类第 656 行起用method_missing惰性创建任意层级的ActiveSupport::OrderedOptions——这就是config.x.任意键.任意层级能一路点下去的底层原理。引入Rails::Application.config_for按当前环境加载 YAML 配置并返回OrderedOptions# config/exception_notification.yml production: url: http://127.0.0.1:8080 namespace: my_app_production development: url: http://localhost:3001 namespace: my_app_development# config/environments/production.rb Rails.application.configure do config.middleware.use ExceptionNotifier, config_for(:exception_notification) end现代实现位于 railties/lib/rails/application.rb会读取config/#{name}.ymldeep_symbolize_keys后按当前环境取值还支持shared段与环境配置的deep_merge合并。应用生成器新增--skip-turbolinks选项用于不生成 turbolinks 集成引入bin/setup脚本作为搭建应用时的自动化设置约定开发环境下config.assets.digest默认值改为true引入 API允许为rake notes注册新的扩展注释标记Rails 模板引入after_bundle回调bundle 完成后执行引入Rails.gem_version便捷方法返回Gem::Version.new(Rails.version)。四、Action Pack 变更详细条目见 actionpack/CHANGELOG.md。移除项respond_with与类级respond_to从 Rails 移除、迁往responders2.0 gem对应前文“升级不兼容变更”第 2 条加gem responders, ~ 2.0即可继续使用移除已弃用的AbstractController::Helpers::ClassMethods::MissingHelperError改用AbstractController::Helpers::MissingHelperError。弃用项*_pathhelper 的only_path选项弃用assert_tag、assert_no_tag、find_tag、find_all_tag弃用统一改用assert_select路由:to选项不再支持指向“不含#的符号或字符串”get /posts, to: MyRackApp (无需修改) get /posts, to: post#index (无需修改) get /posts, to: posts get /posts, controller: :posts get /posts, to: :index get /posts, action: :indexURL helper 不再支持字符串键参数# 不推荐 root_path(controller posts, action index) # 推荐 root_path(controller: posts, action: index)值得注意的变化*_filter一族方法从文档中移除全面改用*_action一族after_filter after_action append_after_filter append_after_action append_around_filter append_around_action append_before_filter append_before_action around_filter around_action before_filter before_action prepend_after_filter prepend_after_action prepend_around_filter prepend_around_action prepend_before_filter prepend_before_action skip_after_filter skip_after_action skip_around_filter skip_around_action skip_before_filter skip_before_action skip_filter skip_action_callback若应用仍依赖这些方法应尽快迁移到对应*_action方法旧方法后续会正式弃用并移除。render nothing: true或渲染nilbody 时不再往响应体里补一个空格占位ETag 现在自动纳入模板 digest模板改动会自动使缓存失效传入 URL helper 的 path segment 会被自动转义引入always_permitted_parameters配置用于设定全局默认允许的参数默认值为[controller, action]按 RFC 4791 增加 HTTP 方法MKCALENDAR*_fragment.action_controller通知的 payload 中新增 controller 与 action 名路由错误页改进支持对路由进行模糊搜索匹配增加选项以关闭 CSRF 失败日志服务器托管静态资源时若客户端支持 gzip 且磁盘上存在预生成的.gz文件则直接提供 gzip 版本资产管道默认会为所有可压缩资源生成.gz文件从而减少传输量、加速资源请求集成测试中调用processhelper 族时路径必须带前导斜杠test list all posts do get /posts assert_response :success end五、Action View 变更详细条目见 actionview/CHANGELOG.md。弃用项弃用AbstractController::Base.parent_prefixes要自定义视图查找位置请覆写AbstractController::Base.local_prefixes弃用ActionView::Digestor#digest(name, format, finder, options {})参数应改为以哈希形式传入。值得注意的变化render foo/bar现在展开为render template: foo/bar而不再是render file: foo/bar对应“升级不兼容变更”第 1 条表单 helper 不再为隐藏字段包一层带内联 CSS 的div引入#{partial_name}_iteration局部变量供“以集合渲染的 partial”使用通过其index、size、first?、last?方法感知迭代状态placeholder 的 I18n 解析遵循与labelI18n 相同的约定。六、Action Mailer 变更详细条目见 actionmailer/CHANGELOG.md。弃用项邮件中弃用*_pathhelper一律改用*_urlhelper邮件通常需要完整 URL弃用deliver/deliver!改用deliver_now/deliver_now!即如今在 message_delivery.rb 中看到的命名体系。值得注意的变化模板中link_to与url_for默认生成绝对 URL不再需要传only_path: false引入deliver_later把邮件投递包装成 Job 入队、异步发送对应“核心特性”第 2 条新增show_previews配置项允许在 development 环境之外开启 mailer preview。七、Active Record 变更详细条目见 activerecord/CHANGELOG.md。移除项移除cache_attributes一族 API——现在所有属性都默认缓存移除已弃用的ActiveRecord::Base.quoted_locking_column移除已弃用的ActiveRecord::Migrator.proper_table_name请改在ActiveRecord::Migration实例上调用proper_table_name移除无用的:timestamp类型一律透明地别名到:datetime修复列类型在 Active Record 之外如 XML 序列化时的不一致。弃用项弃用after_commit/after_rollback内部“吞掉错误”的行为弃用has_many :through关联上自动探测 counter cache 的脆弱支持应在 through 记录对应的has_many与belongs_to上手工指定 counter cache弃用把 Active Record 对象直接传给.find/.exists?应先用对象调用id弃用对 PostgreSQL “排除起始边界 range”的半成品支持Ruby range 不支持排除起始边界当前通过递增起始值绕开但该做法不正确对无法succ的子类型会抛ArgumentError弃用无连接情况下调用DatabaseTasks.load_schema改用DatabaseTasks.load_schema_current弃用sanitize_sql_hash_for_conditions无替代推荐用Relation执行查询与更新弃用不带:null选项的add_timestamps与t.timestamps——4.2 默认null: trueRails 5 将改为默认null: false弃用Reflection#source_macro不再需要弃用serialized_attributes无替代弃用column_for_attribute在无对应列时返回nil的行为Rails 5.0 将返回 null object弃用对“依赖实例状态的关联”即 scope 带参数的关联执行.joins、.preload、.eager_load无替代。值得注意的变化SchemaDumper对create_table使用force: :cascade使外键存在时也能安全重载 schema与外键支持特性呼应单数关联新增:required选项会在关联上生成存在性校验ActiveRecord::Dirty现在能检测可变值的原地修改序列化属性在未变化时不再被保存也适用于 PostgreSQL 的 string、json 等列引入db:purgeRake 任务清空当前环境的数据库引入ActiveRecord::Base#validate!记录无效时抛ActiveRecord::RecordInvalid引入validate作为valid?的别名touch现在可一次触碰多个属性PostgreSQL 适配器支持 PostgreSQL 9.4 的jsonb数据类型PostgreSQL 与 SQLite 适配器不再给字符串列默认加 255 字符上限PostgreSQL 适配器新增citext列类型支持PostgreSQL 适配器支持用户自定义 range 类型sqlite3:///some/path现在解析为绝对路径/some/path相对路径请改用sqlite3:some/path此前的相对路径行为已在 4.1 弃用支持 MySQL 5.6 的秒以下小数位新增ActiveRecord::Base#pretty_print以更友好地打印模型ActiveRecord::Base#reload行为调整为等价于m Model.find(m.id)不再保留自定义SELECT带来的额外属性ActiveRecord::Base#reflections返回的哈希改为字符串键而非符号键迁移中的references方法支持type选项用于指定外键类型如:uuid。八、Active Model 变更详细条目见 activemodel/CHANGELOG.md。移除项移除已弃用的Validator#setup无替代。弃用项弃用reset_#{attribute}改用restore_#{attribute}弃用ActiveModel::Dirty#reset_changes改用clear_changes_information。值得注意的变化引入validate作为valid?的别名ActiveModel::Dirty引入restore_attributes方法把发生变更dirty的属性恢复到原值has_secure_password不再默认禁止纯空白密码启用校验时has_secure_password会校验密码长度小于 72 字符。九、Active Support 变更详细条目见 activesupport/CHANGELOG.md。移除项移除已弃用的Numeric#ago、Numeric#until、Numeric#since、Numeric#from_now移除已弃用的、基于字符串的ActiveSupport::Callbacksterminator 写法。弃用项弃用Kernel#silence_stderr、Kernel#capture、Kernel#quietly均无替代弃用Class#superclass_delegating_accessor改用Class#class_attribute弃用ActiveSupport::SafeBuffer#prepend!——prepend现在已具备相同功能。值得注意的变化引入active_support.test_order配置控制测试用例执行顺序当时默认:sorted官方预告 Rails 5.0 将改为:randomObject#try与Object#try!现在可在块中省略显式接收者Object#with_options也可省略显式接收者travel_to测试 helper 现在会把usec部分截断为 0提升时间冻结的确定性引入Object#itself恒等函数引入String#truncate_words按单词数截断字符串新增Hash#transform_values与Hash#transform_values!简化“只改值、不动键”的常见模式humanize现在会剥掉开头的下划线引入Concern#class_methods作为module ClassMethods的替代写法并引入Kernel#concern来消除module Foo; extend ActiveSupport::Concern; end样板新增关于常量自动加载与重载的指南4.2 时代针对“经典模式”。当前仓库中对应文档为 自动加载与重载指南。十、回到当前仓库4.2 特性的“今生”速查前文各节已在特性处穿插了源码佐证这里集中整理成一份“API 现在还能在哪里找到”的速查表方便读者按图索骥4.2 引入的能力当前仓库中的实现位置形态说明Active Job 框架activejob/lib/active_job队列抽象保留默认适配器由:inline演变为:asyncqueue_adapter.rb邮件异步投递message_delivery.rbdeliver_later/deliver_now并新增wait、wait_until、priority等选项投递默认走MailDeliveryJob迁移外键schema_statements.rbadd_foreign_key/remove_foreign_key/foreign_key_exists?选项大幅扩充on_delete、validate、deferrable等config.x自定义配置application/configuration.rbattr_accessor :x与同文件Custom类第 656 行通过method_missing支持任意层级链式读写config_forrails/application.rb按环境读取config/*.yml并支持shared公共段Web Console 进默认 GemfileGemfile.tt新应用默认仍带gem web-console整体上可以观察到 Rails 的两条演进主线一是 4.2 打下的“统一队列抽象 异步化”基础Active Job /deliver_later在十余年后的今天仍是核心骨架且默认执行模型从“同步 inline”进化为“进程内线程池 async”二是迁移 DSL 以“外键支持”为起点逐步扩展成一整套约束管理 API。若需要逐条核对 4.2 的完整变更清单包括 bug 修复与更多细节可直接查阅各组件根目录下的CHANGELOG.md文件railties/CHANGELOG.md、actionpack/CHANGELOG.md、actionview/CHANGELOG.md、actionmailer/CHANGELOG.md、activerecord/CHANGELOG.md、activemodel/CHANGELOG.md、activesupport/CHANGELOG.md。给计划升级或历史项目维护者的最后提醒升到 4.2 前务必先具备良好测试覆盖若尚未到 4.1 请先升 4.1升级后优先排查本清单中的“需要立即行动”项——render foo/bar语义、respond_with的 gem 化迁移、rails server默认绑定地址、:status符号更名、HTML sanitizer 输出差异与assert_select断言行为变化逐一确认后再进入正常开发流程。对应迁移步骤可随时回查 升级指南。【免费下载链接】railsRuby on Rails项目地址: https://gitcode.com/GitHub_Trending/rai/rails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考